The Stay-Linked Client Software determines most of it’s behavior by using settings from the
‘staylink.ini’ file. The previous section of this document 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 Stay-Linked 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:
EXTKEYS.INI – Configures the tap-able button bar that can be displayed on PPC/CE devices.
SCANNER.INI – Configures the OEM scanner engine on devices that have no native user interface.
LOCALE.INI – Provides localization support for alternate language fonts on PPC/CE devices.
SERVERS.INI – Provides access to multiple and/or backup Stay-Linked Servers from a client.
COLORS.INI – Configures alternate host foreground/background color mapping on the devices.
These configuration files can also be managed centrally from the Stay-Linked Administrator in a manner that is very similar to the management of the individual device settings. You can use the
‘Device Settings’ management feature to deploy various versions of these files to specific devices.
Clicking the right mouse button in a blank area of the ‘Device Settings’ list or on a device setting will cause a small menu to appear. Select the ‘Add’ option and then in the ‘Setting’ drop-down list, find and select the ‘All – Configuration File Transfer’ device setting. The following dialog will be displayed:
• Enabled: Check this option to enable the setting. Only enabled settings will be kept current on the targeted devices.
• Setting Level: Use this drop-down list to select from the following distribution groups:
Global – Setting applies to all devices
Device Type – Setting applies only to the specified device type (a text box will appear for you to enter the device type or a drop-down list of devices will be provided if the setting only applies to certain devices). Note: when specifying a device type, enter the value exactly as reported by the device. The only exception to this would be the use of the ‘*’ wildcard character at the end of your entry. This will allow you to cover multiple, similar devices with a single entry. Use this option to define a setting for all devices of a specific type.
IP Range – Setting applies only to the specified range of IP addresses (2 text boxes will appear for you to enter the Low and High IP addresses)
MAC Address – Setting applies only to the specified MAC address (a text box will appear for you to enter the MAC Address). Use this option to define a setting for a single device.
• Import File Name: Use the ‘browse’ button to the right of this textbox to locate and select the configuration (.INI) file that you wish to transfer for this entry. This file will be transferred to the server and stored there to be deployed to devices that are selected for this setting.
• Server File Name: Enter a unique file name to be used for this file when it is stored on the server. All of the files selected for ‘Configuration File Transfer’ settings will be stored in a single folder on the Stay-Linked Server machine at ‘..\stay-linked\deploy\files’. Each of these files must have a unique file name in this folder on the server.
• Device File Name: Enter the name of this file as it should be stored on the device. You should provide a path as part of the name only if the file is not one that is recognized by and managed by the Stay-Linked Client on the device. The files listed at the top of this section are
automatically handled by the Stay-Linked Client and so only that name needs to be specified for this value.
Client Configuration File Deployment Example:
This example shows the dialog for sending a ‘locale.ini’ file to devices that are of a specific device type, in this case Symbol PDT9000 devices.
• Import File Name: The original ‘locale.ini’ file was located on the Administrator PC in the
‘c:\localize’ folder with the name ‘locale_greek.ini’. This file will be transferred to the server.
• Server File Name: The unique file name to be used for this file when it is stored on the server has been entered as ‘locale_greek_pdt9000.ini’. Since all of the files selected for ‘Configuration File Transfer’ settings will be stored in a single folder on the Stay-Linked Server machine, each of these files must have a unique file name in this folder on the server. The files are stored on the Stay-Linked Server at ‘..\stay-linked\deploy\files’.
• Device File Name: The name of this file as it will be stored on the device is ‘locale.ini’. The
‘locale.ini’ is a special configuration file that is recognized and managed by the Stay-Linked Client. In this case, it is not necessary to provide a path for the file on the device.
After configuring the dialog for ‘Add Device Setting’, press the OK button to validate the dialog. Once validated, the file will be transferred from the Administrator to the Stay-Linked Server where it will be stored for deployment to qualifying devices. When a Stay-Linked device creates a new connection to the Stay-Linked Server, and both ‘Configuration File Deployment Settings’ and ‘Device Settings’ are to be sent to the device, first the ‘Configuration Files’ will be transferred to the device and then immediately the ‘Device Settings’ will be sent to the device. The Stay-Linked Client will restart automatically after receiving these files and settings and then, upon connection, those settings will take effect immediately.