![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Splash-MC92N0M_E5.jpg\")
<\/figure><\/div>\n\n\n\nThe\nimage to the right shows the \u2018About\u2019 screen of a Client. Not only does it show\nthe current value, but it also includes a button that allows the registry entry\nto be reset to the default value. During the next startup, this would be\nreplaced by the unique value determined by the StayLinked Client.<\/p>\n\n\n\n
Any device connecting to the StayLinked Server will pass on this UID value, allowing the Server to identify devices even if they have changed network address or adapter.<\/p>\n\n\n\n
Imaging and Cloning<\/h2>\n\n\n\n
One of the most common instances under the\ncategory, \u201cwhat can go wrong,\u201d is when devices are cloned or imaged for a\n\u2018known good\u2019 install. Replicating a populated UID value to multiple devices\nmakes each device report the same UID to the StayLinked Server. This \u2018less than\nunique\u2019 value would cause devices to steal an existing session from another\ndevice with that same UID. When creating\na device image, the UID should be reset before creating the image and before\nthe Client is run again.<\/strong> The Client restart would trigger a rebuild of the UID\nvalue that is specific to that host device.<\/p>\n\n\n\n There are six methods of resetting the UID on a current device. Not all Clients support all of these options.<\/p>\n\n\n\n Option 1)<\/strong> Many Windows-based devices can use the \u2018Reset UID\u2019 button on the About screen as shown on the image at the top of this article. The About screen would be displayed by selecting the File menu and selecting the About option. Devices using the full screen mode setting will not display these menus and must be taken out of full screen mode in order to access the About screen.<\/p>\n\n\n\n Option 2)<\/strong> Android and Java Clients\nstore the UID value as part of a persistent file called session.ini. For these\nclients, you can delete the session.ini and restart the client to generate a\nnew UID. Note that these clients will not be able to recover a session left\nunder an old UID. This means it\u2019s important to clean up old sessions when you\nreset an android or Java client, since they become orphaned without a client\nowning the associated UID.<\/p>\n\n\n\n Option 3)<\/strong> Windows CE and Windows Mobile devices can use a registry file or manually edit the device registry back to the default value. On most devices, the registry value would be found in the following hive:<\/p>\n\n\n\n This section can be copied to a text document with the .reg file extension and then manually merged on your device.<\/p>\n\n\n\n Option 4)<\/strong> Adjust the client configuration file staylink.ini with an entry for uid_override=XXXXXXXXXXXX where the 12-character value uses only hexadecimal values (0-9 and A-F) avoiding lower-case letters. Many clients v11 and higher support this entry to replace the standard method of retrieving a unique identifier.<\/p>\n\n\n\n Option 5)<\/strong> Create a Scan2Command barcode to reset the UID. These barcodes can be scanned into the StayLinked Client scan test. You should close existing sessions for this device and use the Tools > Scan Test option.<\/p>\n\n\n\n Option 6)<\/strong> Starting with Administrator version 15.5, the Scan2Configure setting for the UID override is available. This client setting should be configured for specific devices and can help avoid the need to manually find and configure remote devices. Be sure to set a value with exactly 12 characters in the Hexadecimal range 0-9 or A-F.<\/p>\n\n\n\n Be sure not to use the \u2018Restart Client\u2019 barcode if the device will be your image source.<\/strong> Create your image before the StayLinked Client is allowed to start again. These barcodes have been included in this article using the Code 128 symbology, but may need some print quality adjustments in order to be printed and readable by your device scanner.<\/p>\n\n\n\n When scanning these barcodes, the Randomize UID code should only be used on devices that are unable to normally return a unique value. Use the Reset UID and then Restart Client barcodes to immediately affect the UID on devices that were improperly cloned with a common UID. <\/p>\n\n\n\n Devices with tethered scanners must be configured properly for scanner-as-wedge before using these barcodes. More information on scanner-as-wedge can be found in the scanner-as-wedge<\/a> technical reference article.<\/p>\n\n\n\n Devices that are already in a session will be unable to reconnect to that session if their UID is changed and the device reconnects to the StayLinked Server.<\/p>\n\n\n\n When a device establishes a connection to the StayLinked Server, that session will be assigned a session ID. This value is stored by the Client, allowing it to ask for existing sessions on the Server by name. This image of the Administrator shows the session ID as the first visible column in the connections list. <\/p>\n\n\n\n Double\nclicking on a session in this list will display the connection details. The\nunique ID, hardware address and IP address are just a few of the details\nprovided in this panel.<\/p>\n\n\n\n Each Client writes the session ID to a local file on the device. This file, called session.ini allows the Client to check the last session ID when connecting to the StayLinked Server. Clients will pass a session ID of 00000 to the Server in order to ask for a new session.<\/p>\n\n\n\n It is important that file management utilities do not modify or replace this file as it may interfere with the session recovery features of the StayLinked Server. The StayLinked Server Settings dialogue\ncontains a checkbox for an \u2018Orphan Detection\u2019 feature. This will allow Clients\nrequesting session ID 00000 to connect to an existing session if one is found\nto match the unique ID of that Client. Servers using multi-session licensing\nwill always be provided a new session when session ID 00000 is requested.<\/p>\n\n\n\n Devices requesting an invalid session ID are not subject to orphan detection rules. As mentioned previously, if the session.ini is modified or replaced with an old or invalid session ID, the StayLinked Server will terminate any active sessions associated with the device\u2019s Unique ID and provide the device with a new session.<\/p>\n\n\n\n During the connection process, the Client and Server complete a handshake to initiate a connection. The details of this handshake is documented in several places, including the Secure Communications Guide<\/a> and Technical Reference for Host Timeout<\/a>. The following samples have several values color-coded here to help identify them. <\/p>\n\n\n\n The\ndetails included in this string provide enough information for the Server to\nget the Client back to an existing session, or start processing for a new\nsession.<\/p>\n\n\n\n This device had a later interruption in network communications, prompting it to query the StayLinked Server to confirm that the session was still valid. This \u2018query session status<\/em>\u2019 is recorded in the Manager log file with the request and response.<\/p>\n\n\n\n These features work together to provide users with session reliability for their telnet connections. They also allow the StayLinked Server to transfer sessions between different Clients, or share a single telnet session among multiple devices using \u2018session partnerships\u2019 and sharing from the StayLinked Administrator. Sessions cannot be transferred between different telnet servers or between production and backup StayLinked Servers.<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" As the key benefit of the StayLinked solution, the Server and Clients use a few different mechanisms to return users to their existing sessions. StayLinked should always return the user to where they left off, even in environments where devices can change network addressing or subnet. The only reason a…<\/p>\n","protected":false},"author":7,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[59],"ht-kb-tag":[],"yoast_head":"\n[HKEY_LOCAL_MACHINE\\Software\\Apps\\eSP Stay-Linked]
; Reset UID
\"eSP_UID\"=string:A0DEADBEEF0D<\/code><\/p>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2023\/11\/image-4.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2023\/04\/session_persist_01.png\")
<\/figure><\/div>\n\n\n\nThe Session ID<\/h2>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/3-Total-Connections.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Connection-Details.jpg\")
<\/figure><\/div>\n\n\n\n
<\/p>\n\n\n\nOrphan Detection<\/h3>\n\n\n\n
Session Cleanup<\/h3>\n\n\n\n
The StayLinked Manager Log<\/h2>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Manager-log-key.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/manager-log-results.jpg\")
<\/figure>\n\n\n\n