Private queues for loopback calls

The AP:Admin-ServerSettings form provides the Private AR Server RPC Socket and Plugin Loopback RPC Socket fields for controlling loopback calls to the AR System server.

A loopback call occurs when the Approval Server plug-in initiates a call back to the AR System server while processing approval workflow. During heavy loads, this can cause a server deadlock if enough queues or threads are not available. To avoid this, use a dedicated loopback RPC queue. The valid RPC socket number ranges are:

  • 390621 – 390634
  • 390636 – 390669
  • 390680 – 390694

To use the approval preview feature, you must set either the Private AR Server RPC Socket or the Plugin Loopback RPC Socket.

Related topics

Enabling-and-analyzing-logs

Enabling-logs

 Private AR Server RPC Socket

The Private AR Server RPC Socket field creates a private queue dedicated only to Approval Server loopback calls. This setting appears in the AR System server configuration file with the tag Approval-RPC-Socket.

If both the Private AR Server RPC Socket and Plugin Loopback RPC Socket values are set, Approval Server uses the Private AR Server RPC Socket.

 Plugin Loopback RPC Socket

The Plugin Loopback RPC Socket field creates a private queue for all loopback calls from the plug-in server, regardless of which plug-in application initiates the call. If this value is set and the Private AR Server RPC Socket field is not set, the Plug-in server uses this queue for Approval Server loopback calls. In other words, Approval Server shares this queue with other plug-in applications, but not with AR System users.

This setting appears in the AR System server configuration file with the label Plugin-Loopback-RPC-Socket.

Important

The Plugin Loopback RPC Socket field of the Server Settings dialog box controls the same setting as the Plugin Loopback RPC Program Number field on the Ports and Queues tab of the AR System Administration: Server Information form.

If the Plugin Loopback RPC Program Number is already defined for the AR System server, enter the same RPC number in the Plugin Loopback RPC Socket field of the Server Settings window. If this queue is not already defined for the server, it will appear in the Server Information dialog box, on the Server Ports and Queues tab, after you enter it in the Server Settings dialog box.

For more information about defining server ports and queues, see System requirements.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*