Web2Publish on Linux

Introduction

This guide provides step-by-step instructions for installing the Web2Publish application on Linux.

Prerequisites

• PubServer: Version 4.7.0.x
• Knowledge requirements: Basic understanding of configuring PubServer (Autodeploy, deployment packages, Eclipse ISON plugin).

---

Installation Steps

1. Download the Package from Priint WebFTP

Depending on your PubServer version, download the corresponding Web2Publish package.
For example, for version 4.7.0, the folder is:

https://webftp.priint.com/#/priint_suite_4.7.0/publishing%20server%20add-on%20zips/latest/

Unzip the package — it contains all materials required for installation.

---

2. Install the Web2Publish Application (Spring Boot)

From the unzipped package, locate the JAR file (e.g., Web2Publish.4.7.x.jar).

Steps

1. Install the required Java SDK
   For example, version 21 is required for Web2Publish 4.7.0.

2. Upload the JAR file to your preferred directory on the server (rename if desired).
   Example:

   /opt/pubserver/w2p/w2p.jar

3. Add the Spring Boot configuration file (application.properties or application.yml) to the same directory. A sample file (application_sample.properties) is included in the unzipped package.

• Update the following custom configurations:

Property	Description	Example
pubserver.baseUrl	Base URL of the PubServer. The public domain is required here.	https://pubserver.com/
pubserver.admin.service.baseUrl	Base URL of the AdminAPI API. It should be {YOUR_PUBSERVER_DOMAIN}/AdminAPI/api/. In case the Web2Publish and PubServer are hosted in the same server, the internal IP address or domain is allowed.	https://pubserver.com/AdminAPI/api/
pubserver.w2p.service.baseUrl	Base URL of the Web2Publish Service API. In case the web2publish and PubServer are hosted in the same server, the internal IP address or domain is allowed.	https://pubserver.com/w2p-service/api/
pubserver.w2p.appId	The app ID configured in the PubServer AuthService for authentication.	w2p
app.path	The application path (must be /w2p).	/w2p

• Review and update the following Spring Boot configurations based on your requirements:

  Property	Description	Example
  spring.servlet.multipart.max-file-size	Maximum allowed size for a single uploaded file when handling multipart/form-data requests (used for Media Asset uploads).	20MB
  spring.servlet.multipart.max-request-size	Maximum allowed size of the entire multipart HTTP request, including all files and form data.	500MB
  server.port	TCP port on which the Spring Boot application listens for incoming HTTP requests.	8688
  management.endpoints.web.exposure.include	Specifies which Spring Boot Actuator endpoints are exposed over HTTP. Should not be changed, as this is required to display application information in PubServer Admin.	health,info
  management.endpoints.web.base-path	Base URL path under which all Spring Boot Actuator endpoints are exposed. Should not be changed, as this is required to display application information in PubServer Admin.	/w2p/
  management.endpoints.web.path-mapping.health	Custom URL path for the Actuator health endpoint. Should not be changed, as this is required to display application health information in PubServer Admin.	healthz
  management.endpoints.web.path-mapping.info	Custom URL path for the Actuator info endpoint. Should not be changed, as this is required to display application information in PubServer Admin.	infoz
  server.forward-headers-strategy	Defines how Spring Boot processes forwarded headers (X-Forwarded-*, Forwarded) when running behind a reverse proxy or load balancer. Should not be changed, as this setting is required by the framework to correctly resolve the original request scheme, host, and port.	framework

4. Configure the systemd service to run the application

   Create a service file /etc/systemd/system/w2p.service with the following content:

   [Unit]
   Description=Web2Publish Application
   
   [Service]
   WorkingDirectory=/opt/pubserver/w2p
   ExecStart=/usr/lib/jvm/zulu21/bin/java -jar /opt/pubserver/w2p/w2p.jar -Dspring.config.location=file:///opt/pubserver/w2p/application.properties
   Restart=always
   
   [Install]
   WantedBy=multi-user.target

   Then run:

   sudo systemctl daemon-reload           # Reload systemd to detect the new service
   sudo systemctl enable w2p              # Enable auto-start on boot
   sudo systemctl start w2p               # Start the service
   sudo systemctl status w2p              # Verify service status

5. Configure the Reverse Proxy

Refer to this guideline to determine whether a reverse proxy needs to be configured for your environment.

---

3. Install the Web2Publish Service (PubServer Plugin)

In order for the application to work properly, install the Web2Publish Service.

You can find it in the unzipped package as a WAR file, for example:

Web2PublishService-4.7.0.x.war

Because it’s a PubServer plugin:

• You can install it via the Payara Admin Console, or
• Place it in the PubServer autodeploy (hot-deploy) folder.

Note:
The context root should be w2p-service.
If you change it, make sure to update the corresponding Spring Boot configuration (pubserver.w2p.service.baseUrl).

---

4. Update the PubServer AuthService Configuration

To enable PubServer AuthService as the authentication provider for the application:

1. Locate the configuration file:
   [path_to_your_domain_folder]/config/AuthService/config.xml
   (for example: /opt/pubserver/glassfish/payara6/glassfish/domains/pubserver/config/AuthService/config.xml)

2. Add a new application entry for Web2Publish:

   <authService>
       <apps>
           <app name="priint:w2p" id="web2publish" visible="true">
               <uri>[W2P_HOME_PAGE]/auth/callback?sessionId={sessionId}</uri>
               <sessionCookieName>w2pSessionId</sessionCookieName>
           </app>
       </apps>
   </authService>

Note: Please replace [DATA-W2P_HOME_PAGE] with your server information, such as: https://priintsuite.com/w2p

3. If the file doesn’t exist, follow this guide to create it.

5. Add and Update the ISON Configuration File

All features of the Web2Publish application are configurable through an ISON configuration file, which can be managed in PubServer using the ISON plugin.

Please refer to the sample file and the full explanation of all configuration options here: Sample Configuration

Then, update the configuration according to your specific requirements.

If you encounter any issues during setup, please contact our support team at support@priint.com.