Configuring DSO for firewalls

The information in this topic is applicable only for on-premises deployments.

When you install an AR System server, a DSO server is automatically installed on the same host as the AR System server. By default, that DSO server processes all distributed transfer operations for the AR System server. If an AR System server is configured to run behind a firewall, however, you can set up a DSO server outside the firewall to support that AR System server, as shown in the following figure:

DSO firewall configuration

For information about configuring a firewall for an AR System server, see Configuring-firewalls-with-AR-System-servers.

To configure DSO for firewalls

In this procedure,

• AR System server A is the DSO source AR System server behind the firewall.
• AR System server B is outside the firewall.

1. On server A, open the AR System Administration: Server Information form, then click the DSO tab.
2. Select Placeholder Mode, then click OK.
   This disables the DSO server that was automatically installed with server A. That DSO server can no longer process distributed operations.
   The corresponding entry in the AR System Configuration Generic UI form is DSO-Placeholder-Mode.
3. To make this change take effect, restart server A.
4. On server B, open the AR System Administration: Server Information form, then click the DSO tab.
5. In the Source Server field, enter the name of server A.
   The corresponding entry in the AR System Configuration Generic UI form is DSO-Source-Server.

6. In the Backup Polling Interval field, enter an appropriate number of seconds, then click Apply.
   This instructs the DSO server on Host B to check the distributed pending queue on server A every x seconds. This is necessary because the DSO server on Host B cannot receive real-time signals from workflow on server A.
   The corresponding entry in the AR System Configuration Generic UI form is DSO-Polling-Interval.

   Setting this field does not make the DSO server on Host B a polling server.

7. Click the Connection Settings tab, then click the DSO Server tab on the Connection Settings tab.
8. In the DSO Local Password field, enter the password that the active DSO server outside the firewall uses to communicate with server A. See Configuring-a-password-for-the-DSO-user.
9. (Optional) In the DSO Local RPC Program Number field, enter a dedicated RPC program that the active DSO server outside the firewall uses to communicate with server A. See Assigning-an-RPC-program-number-to-DSO.
10. In the left table, enter the name and TCP/IP port of server A, then click OK.
    See 2024-07-10_01-44-14_Setting ports and RPC numbers.
11. To make these changes take effect, restart server B.
    Server A is now the source AR System server for the active DSO server that was installed with server B.