Common Errors in Remote Staging in Liferay DXP

This article documents the activation and setup errors in Remote Staging, and lists steps to resolve the issue or avoid it altogether. If users want to know about activating staging in general, please see Enable Remote Live Staging.

解決

Error: Users are unable to publish content to Remote Staging.

Summary: Users are attempting to publish content to a remote live server from their staged environment but encounter errors.

Common Causes

  1. Servers are missing the correct tunnel.servlet.hosts.allowed= in the remote server’s portal-ext.properties.
  2. SSL has been improperly configured.

Recommended Solution

As already explained on the user interface, and in other documentation, put the tunnel.servlet.hosts.allowed= setting in remote server's portal-ext.properties with the IP address of the staged server.

Alternately, users can use the Control Panel on the Remote Server. To use the Control Panel, execute the following steps:

  1. Navigate to Control Panel > Configuration > System Settings
    remotestaging_01.PNG
  2. Search for the Tunnel Auth Verifiers setting and click it.

    (For users working on DXP 7.1, the setting has been renamed Tunnel Authentication)
    remotestaging_02.PNG

  3. Click on /api/liferay/do.
  4. In the list of Hosts allowed, enter the URL of the Staged Server.
    remotestaging_03.PNG
  5. Click Update
Caution: As a general principle, Control Panel settings will override portal-ext.properties settings. Ensure that any changes made in the Control Panel are the desired changes.

If users desire to publish content across a secure connection, enable the application server's SSL connections and consult the appropriate application server documentation.

Prevention Tips

  1. If the user has enabled SSL, ensure that Java security files have been generated correctly and that they are in the right file folder for each application server. Ensure that the application server's secure ports have been activated (e.g. 8443, in most cases).

  2. Ensure that the target's IP, port, and site ID (e.g. 10444) are correct in the staged server.

追加情報

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています