![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_72-1024x577.jpg\")
<\/figure>\n\n\n\nClient Settings – Delete<\/strong> \u2013 Select this menu option in order to\ndelete a client setting from the list.<\/p>\n\n\n\n Client Settings \u2013 Search Settings<\/strong> \u2013 Select this menu option to\naccess a search dialog that can help you find the Client Setting that you wish\nto add to the list. The search dialog will provide a text box where you can\nenter a search term. Press ENTER to have the results list populated with any\nClient Settings that contain your search term found in the \u2018Setting Name\u2019 or\nthe \u2018Setting Description\u2019. When you find the desired Client Setting in the\nlist, double-click on it to open the \u2018Add\u2019 dialog.<\/p>\n\n\n\n Client Settings – Add<\/strong> \u2013 Select this menu option in order to add a new client setting to the list.<\/p>\n\n\n\n Group:<\/strong> Use this drop-down list to select a group of client settings\nto work with.<\/p>\n\n\n\n Setting:<\/strong> Use this drop-down list to select from the client settings\nincluded in the selected group. After a selection is made, a brief description\nof the setting is provided below. You can hover your mouse-pointer over the\n\u2018setting\u2019 to display a \u2018tool-tip\u2019 that will show the syntax for the current\nclient setting and the selected value.<\/p>\n\n\n\n Enabled:<\/strong> Check this option to enable the setting. Only enabled\nsettings will be kept current on the targeted devices. If this option is not\nchecked, the server will completely ignore the setting.<\/p>\n\n\n\n Show Advanced:<\/strong> Check this option to have the contents of the\n\u2018Setting\u2019 drop-down list include less-frequently used advanced settings. This\noption will be remembered the next time you use this dialog.<\/p>\n\n\n\n Setting Level:<\/strong> Use this drop-down list to select from the following\ndistribution groups: <\/p>\n\n\n\n Global<\/strong> \u2013 Setting applies to all devices<\/p>\n\n\n\n Device Type<\/strong> \u2013 Setting applies only to the specified device type (a\ntext box will appear for you to enter the device type or a drop-down list of\ndevices will be provided if the setting only applies to certain devices). Note:\nwhen specifying a device type, enter the value exactly as reported by the\ndevice. The only exception to this would be the use of the \u2018*\u2019 wildcard\ncharacter at the end of your entry. This will allow you to cover multiple, similar\ndevices with a single entry. Use this option to define a setting for all\ndevices of a specific type.<\/p>\n\n\n\n IP Range<\/strong> \u2013 Setting applies only to the specified range of IP\naddresses (3 text boxes will appear for you to enter the Low and High IP\naddresses plus a Device Type filter).<\/p>\n\n\n\n MAC Address<\/strong> \u2013 Setting applies only to the specified MAC address (a\ntext box will appear for you to enter the MAC Address). Use this option to\ndefine a setting for a single device.<\/p>\n\n\n\n Setting Value:<\/strong> Depending on the Setting, you enter a value into a\ntext box or select from a drop-down list of available options.<\/p>\n\n\n\n Notes:<\/strong> Provided for your convenience. These notes have no effect on\nsetting processing. They can, however, help you to organize and manage your\nclient settings by providing a place to record why you created this client\nsetting for future reference.<\/p>\n\n\n\n Client Settings – Edit<\/strong> \u2013 Select this menu option to update an existing client setting in the list.<\/p>\n\n\n\n Setting:<\/strong> Displays the current setting and a description below. You\ncan hover your mouse-pointer over the \u2018setting\u2019 to display a \u2018tool-tip\u2019 that\nwill show the syntax for the current client setting and the selected value.<\/p>\n\n\n\n Enabled:<\/strong> Check this option to enable the setting. Only enabled\nsettings will be kept current on the targeted devices. If this option is not\nchecked, the server will completely ignore the setting.<\/p>\n\n\n\n Setting Level:<\/strong> Use this drop-down list to select from the following\ndistribution groups: <\/p>\n\n\n\n Global<\/strong> \u2013 Setting applies to all devices<\/p>\n\n\n\n Device Type<\/strong> \u2013 Setting applies only to the specified device type (a\ntext box will appear for you to enter the device type or a drop-down list of\ndevices will be provided if the setting only applies to certain devices). Note:\nwhen specifying a device type, enter the value exactly as reported by the\ndevice. The only exception to this would be the use of the \u2018*\u2019 wildcard character\nat the end of your entry. This will allow you to cover multiple, similar\ndevices with a single entry. Use this option to define a setting for all\ndevices of a specific type.<\/p>\n\n\n\n IP Range<\/strong> \u2013 Setting applies only to the specified range of IP\naddresses (3 text boxes will appear for you to enter the Low and High IP\naddresses plus a Device Type filter).<\/p>\n\n\n\n MAC Address<\/strong> \u2013 Setting applies only to the specified MAC address (a\ntext box will appear for you to enter the MAC Address). Use this option to\ndefine a setting for a single device.<\/p>\n\n\n\n Setting Value:<\/strong> Depending on the Setting, you enter a value into a\ntext box or select from a drop-down list of available options.<\/p>\n\n\n\n Notes:<\/strong> Provided for your convenience. These notes have no effect on\nsetting processing. They can, however, help you to organize and manage your\nclient settings by providing a place to record why you created this client\nsetting for future reference.<\/p>\n\n\n\n The StayLinked Client Software determines most of its behavior by using settings from the \u2018staylink.ini\u2019 file. The previous section of this article describes how to centrally manage the settings that are stored in this file. There are, however, additional configuration files that might be used by the StayLinked Client Software to control other aspects of the behavior of the device or the client software. Here is a list of some of these files:<\/p>\n\n\n\n EXTKEYS.INI<\/strong> \u2013 Configures the tap-able button bar that can be displayed\non PPC\/CE devices. <\/p>\n\n\n\n SCANNER.INI<\/strong> \u2013 Configures the OEM scanner engine on devices that\nhave no native user interface.<\/p>\n\n\n\n LOCALE.INI<\/strong> \u2013 Provides localization support for alternate language\nfonts on PPC\/CE devices.<\/p>\n\n\n\n SERVERS.INI<\/strong> \u2013 Provides access to multiple and\/or backup StayLinked\nServers from a client.<\/p>\n\n\n\n CONNECTIONS.INI<\/strong> \u2013 Provides access to multiple, individually\nconfigured connections to one or more StayLinked Servers from a client.<\/p>\n\n\n\n COLORS.INI<\/strong> \u2013 Configures alternate host foreground\/background color\nmapping on the devices.<\/p>\n\n\n\n These configuration files can also be managed centrally from the StayLinked Administrator in a manner that is very similar to the management of the individual device settings. You can use the \u2018Device Settings\u2019 management feature to deploy various versions of these files to specific devices. Clicking the right mouse button in a blank area of the \u2018Device Settings\u2019 list or on a device setting will cause a small menu to appear. Select the \u2018Add\u2019 option and then in the \u2018Setting\u2019 drop-down list, find and select the \u2018All \u2013 Configuration File Transfer\u2019 device setting. The following dialog will be displayed: <\/p>\n\n\n\n Enabled:<\/strong> Check this option to enable the setting. Only enabled\nsettings will be kept current on the targeted devices. If this option is not checked,\nthe server will completely ignore the setting.<\/p>\n\n\n\n Setting Level:<\/strong> Use this drop-down list to select from the following\ndistribution groups: <\/p>\n\n\n\n Global<\/strong> \u2013 Setting applies to all devices<\/p>\n\n\n\n Device Type<\/strong> \u2013 Setting applies only to the specified device type (a\ntext box will appear for you to enter the device type or a drop-down list of\ndevices will be provided if the setting only applies to certain devices). Note:\nwhen specifying a device type, enter the value exactly as reported by the\ndevice. The only exception to this would be the use of the \u2018*\u2019 wildcard\ncharacter at the end of your entry. This will allow you to cover multiple,\nsimilar devices with a single entry. Use this option to define a setting for\nall devices of a specific type.<\/p>\n\n\n\n IP Range<\/strong> \u2013 Setting applies only to the specified range of IP\naddresses (3 text boxes will appear for you to enter the Low and High IP\naddresses plus a Device Type filter).<\/p>\n\n\n\n MAC Address<\/strong> \u2013 Setting applies only to the specified MAC address (a\ntext box will appear for you to enter the MAC Address). Use this option to\ndefine a setting for a single device.<\/p>\n\n\n\n Import File Name:<\/strong> Use the \u2018browse\u2019 button to the right of this\ntextbox to locate and select the configuration (.INI) file that you wish to\ntransfer for this entry. This file will be transferred to the server and stored\nthere to be deployed to devices that are selected for this setting.<\/p>\n\n\n\n Server File Name:<\/strong> Enter a unique file name to be used for this file\nwhen it is stored on the server. All of the files selected for \u2018Configuration\nFile Transfer\u2019 settings will be stored in a single folder on the StayLinked Server\nmachine at \u2018..\\stay-linked\\deploy\\files\u2019. Each of these files must have a\nunique file name in this folder on the server.<\/p>\n\n\n\n Device File Name:<\/strong> Enter the name of this file as it should be stored\non the device. You should provide a path as part of the name only if the file\nis not one that is recognized by and managed by the StayLinked Client on the\ndevice. The files listed at the top of this section are automatically handled\nby the StayLinked Client and so only that name needs to be specified for this\nvalue.<\/p>\n\n\n\n Notes:<\/strong> Provided for your convenience. These notes have no effect on setting processing. They can, however, help you to organize and manage your client settings by providing a place to record why you created this client setting for future reference.<\/p>\n\n\n\n Client Configuration File Deployment Example:<\/strong><\/p>\n\n\n\n This example shows the dialog for\nsending a \u2018locale.ini\u2019 file to devices that are of a specific device type, in\nthis case Symbol PDT9000 devices. <\/p>\n\n\n\n Import File Name:<\/strong> The original \u2018locale.ini\u2019 file was located on the\nAdministrator PC in the \u2018c:\\localize\u2019 folder with the name \u2018locale_greek.ini\u2019.\nThis file will be transferred to the server.<\/p>\n\n\n\n Server File Name:<\/strong> The unique file name to be used for this file when\nit is stored on the server has been entered as \u2018locale_greek_pdt9000.ini\u2019.\nSince all of the files selected for \u2018Configuration File Transfer\u2019 settings will\nbe stored in a single folder on the StayLinked Server machine, each of these\nfiles must have a unique file name in this folder on the server. The files are\nstored on the StayLinked Server at \u2018..\\stay-linked\\deploy\\files\u2019.<\/p>\n\n\n\n Device File Name:<\/strong> The name of this file as it will be stored on the\ndevice is \u2018locale.ini\u2019. The \u2018locale.ini\u2019 is a special configuration file that\nis recognized and managed by the StayLinked Client. In this case, it is not\nnecessary to provide a path for the file on the device.<\/p>\n\n\n\n After configuring the dialog for \u2018Add Device Setting\u2019, press the OK button to validate the dialog. Once validated, the file will be transferred from the Administrator to the StayLinked Server where it will be stored for deployment to qualifying devices. When a StayLinked device creates a new connection to the StayLinked Server, and both \u2018Configuration File Deployment Settings\u2019 and \u2018Device Settings\u2019 are to be sent to the device, first the \u2018Configuration Files\u2019 will be transferred to the device and then immediately the \u2018Device Settings\u2019 will be sent to the device. The StayLinked Client will restart automatically after receiving these files and settings and then, upon connection, those settings will take effect immediately.<\/p>\n\n\n\n Begging with server version 15.5 build 220, files on the server can be modified without having to remove and re-create the setting. An edit button appears on files that have been uploaded, but not on the initial creation of the client setting. This is available only on a configuration file transfer setting:<\/p>\n\n\n\n The StayLinked Client Deployment\nfeature provides a method to centrally manage and wirelessly upgrade StayLinked\nClient software running on your devices. From the StayLinked online portal, you\ncan download StayLinked Client Deployment Packages for your specific wireless\ndevices. These deployment packages can be imported into the StayLinked\nAdministrator which will install the package onto the StayLinked Server. Using\nthe StayLinked Administrator, you can control when these packages will be\ndeployed, to what devices and how to deploy them. When a device starts a new\nStayLinked session, if it has a different version of client software waiting,\nthen depending upon the configuration of the package on the server, they may be\nprompted to upgrade the client software or they may have no choice. If the\nclient software is upgraded, the user will be shown a progress indicator on the\ndevice screen and after the software package is transferred, the software will\nbe installed and the devices will be rebooted or restarted, depending upon the\nplatform.<\/p>\n\n\n\n When you select Client Deployment\nfrom the server tree or the Manage menu, a list will appear in the main display\npanel, showing all of the client packages that are currently installed onto the\nselected server. <\/p>\n\n\n\n Clicking the right mouse button on a client package will cause a small menu to appear with options to Import, Edit, or Remove a client package and control the number of concurrent client updates that are allowed to be processed at one time. You can also \u2018double-click\u2019 a package to \u2018Edit\u2019 the package.<\/p>\n\n\n\n When you select the Import option from the menu, the following window will appear: <\/p>\n\n\n\n Package File:<\/strong> Type or browse for the client deployment package file\nname (with the .sdp extension) that you wish to import. Client deployment\npackage files are available on the StayLinked portal site.<\/p>\n\n\n\n Verify:<\/strong> Click on this button to verify the deployment file and\ncontents. If the file is a valid deployment package, the Package information\nwill be displayed in the window and the \u2018Verify\u2019 button will transform into an\n\u2018Install\u2019 button.<\/p>\n\n\n\n Install:<\/strong> Click this button to install the package onto the StayLinked\nserver. By default, when a new package is installed, it will be disabled until\nit has been manually reviewed and enabled. While the package is being imported\nto the server, the \u2018Import Status\u2019 will be updated.<\/p>\n\n\n\n When you select the Edit option from the menu, or double-click on the package, the following window will appear:<\/p>\n\n\n\n Package Enabled:<\/strong> Use this check box to indicate that this deployment package is enabled and should be transferred to the appropriate client devices. If this option is not checked, the server will completely ignore the package.<\/p>\n\n\n\n Mandatory Update:<\/strong> Use this check box to indicate that this\ndeployment package is mandatory, and that the client will not be allowed to run\na StayLinked session until the update has been accomplished. If this check box\nis not selected, the user will be given a choice to update now or to update\nlater.<\/p>\n\n\n\n Deploy DM Agent:<\/strong> Use this check box to cause the \u2018Device Management\nAgent\u2019, if included in the Deployment Package, to be transferred to and\ninstalled onto the device.<\/p>\n\n\n\n Deployment<\/strong> Address\n Range<\/strong>:<\/strong> Enter the range of device IP addresses\nthat will affected by this client deployment package.<\/p>\n\n\n\n Package Devices:<\/strong> Displays a list of device types to which this\nclient deployment package will be applied. This list is predefined and is not\nmanaged by the administrator. The client software in the package is designed\nfor the device types that appear in this list.<\/p>\n\n\n\n Add Custom Device Type:<\/strong> This right-click menu option for the\nPackage Devices listing will allow you to add a custom device type to the list\nof devices that will be upgraded using this deployment package. You must make\nsure that any device types added here are compatible with this deployment\npackage.<\/p>\n\n\n\n Delete:<\/strong> This right-click menu option for the Package Devices\nlisting will allow you to delete a device type from the list of devices that\nwill be upgraded using this deployment package.<\/p>\n\n\n\n When you select the Remove option\nfrom the menu, you will be prompted to have the client deployment package\nremoved from the list of packages. This option does not physically remove the\nclient package from the server. This option only removes the entry from the\nlist of deployment packages, making it no longer be available for deployment.\nYou may re-import the package again in order to make it available to devices.<\/p>\n\n\n\n When you select the Set Max Transfers option from the menu, you will be prompted for the number of concurrent transfers that you wish to allow from this server to the devices. This feature provides you with control over the bandwidth that will be available for client software updates. If a device starts a new session, is eligible for a client software update, but there are already the maximum allowed number of transfers in process, then the user at the device will be notified and given the choice to try the upgrade again or to start a session using their current client software.<\/p>\n\n\n\n Please note that the client configuration file and logs are not <\/strong>staylinked.ini, staylinked.log, client.ini, or client.log. The actual files are staylink.ini and staylink.log due to old DOS 8.3 naming conventions.<\/p>\n","protected":false},"excerpt":{"rendered":" This section describes the various methods provided to centrally manage the StayLinked Client software on your devices. Topics include managing the client control settings, deploying client configuration files and managing automated client software deployment. Managing Client Settings Client Settings are stored on the device in the \u2018staylink.ini\u2019 file and they…<\/p>\n","protected":false},"author":7,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[23],"ht-kb-tag":[],"yoast_head":"\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_73.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_74.jpg\")
<\/figure>\n\n\n\nManaging Client Configuration File Deployment<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_75.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_76.jpg\")
<\/figure>\n\n\n\nMaking Changes to Configuration File Transfers<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2024\/07\/image.png\")
<\/figure>\n\n\n\nManaging Client Deployment<\/h3>\n\n\n\n
![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_77-1024x588.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_78.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/01\/UserAdminGuide_79.jpg\")
<\/figure>\n\n\n\nNotes<\/h2>\n\n\n\n