Running Multiple Clients on the Same Device (Java Only)

The Java Client supports running multiple instances on the same device with a few specific setting adjustments.

Below are the client configuration entries required to allow multiple instances to function simultaneously on a Windows PC. These can be added to the staylink.ini manually or using the Administrator. Connect a first session of the client to the server and the use the right-click context menus in the connections list selecting Commands > Edit Client INI.

client_query_port = 0
client_session_port = 0
client_alternate_port = 0

For the best results, utilizing the custom configuration for more than two sessions with connections.ini is recommended, allowing more than two open copies of the client. Without this custom configuration, only two copies can operate. The SmartTE server will require multi-session licensing to allow multiple sessions from this same client Unique ID.

You can then open multiple windows by launching the JAR file, usually called Stay-Linked-java-client.jar. If you want 3 sessions on different windows you will run the jar 3 times. Using the preferred_host_name option in connections ini helps direct Windows to specific sessions helping prevent subsequent windows from overlapping sessions which may cause issues. 

Note that this feature is not an option on Android devices which have specific coding to prevent multiple copies of the client from running simultaneously.