About connections

For a client to submit workload, it connects to an application and interacts with a session created on this connection.

The API binds this logical connection to an actual physical connection, which uses a socket between the client and Symphony. Multiple concurrent logical connections within the same client are multiplexed on a single physical connection.

Number of file descriptors opened per connection

One socket per client connection to a session manager.

All communications between the client and session manager are multiplexed on a single connection.

Length of time the connection is maintained

The client maintains a persistent connection to the session manager. This connection exists until the client explicitly closes the connection or terminates.

Setting client reconnection timeout

By default, the API attempts to refresh the connection between the client and the system if a client abruptly disconnects. If the attempt fails, the API throws an exception.

To control the way a client reconnects, set the following environment variables on the client machine:

  • SOAM_RECONNECTION_RETRY_INTERVAL

  • SOAM_RECONNECTION_RETRY_LIMIT

  • SOAM_RELOCATED_RECONNECTION_RETRY_INTERVAL

  • SOAM_RELOCATED_RECONNECTION_RETRY_LIMIT

For more details on these environment variables, see the Symphony Reference.