Updating the DS-Client configuration file parameters
The DS-Client configuration file (dsclient.cfg) is a text file that stores basic configuration information for the DS-Client, such as the account number and account key of the DS-Client and the IP address of the DS-System. The DS-Client configuration file is created during installation and is only available in the Linux or Mac DS-Client. For the Windows DS-Client, the equivalent information resides in the registry and the database.
The DS-Client configuration file also stores any values of the DS-Client advanced parameters that differ from the default value. When you modify a parameter, the most recently configured value of the parameter is stored in the DS-Client configuration file.
In the DS-Client configuration file, information is listed as key-value pairs, in which a colon (“:”) separates the key from the value. The name of the key can be followed by any number of spaces before the colon (“:”). Depending on the key, the value may or may not be case sensitive.
IMPORTANT: We recommend that you do not access or modify the DS-Client configuration file except when performing database migration or troubleshooting database issues. If the dsclient.cfg file is improperly configured, damaged, or missing, DS-Client might not start.
To update the DS-Client configuration file parameters:
1. On the Linux or Mac computer, access the DS-Client configuration file in the following location:
/<DS-Client HOME>/etc/dsclient.cfg
2. Find the key-value pair that represents the parameter that you want to modify.
3. Specify the value of the parameter.
NOTE: When modifying the value of a parameter, always assume that the value is case sensitive wherever applicable.
4. When you have made the necessary changes, save the DS-Client configuration file.
To update passwords in the DS-Client configuration file:
NOTE: Passwords must be stored in an encrypted format in the configuration file.
• Before typing a password in the configuration file, use the asigraenc tool to encrypt the string manually.
This tool is provided in the DS-Client installation directory. It generates an encrypted string for any input string. The encrypted string can vary between different runs performed by the tool.
NOTE: Separately store passwords in a secure place. No tool is available to decrypt the strings that are encrypted by the asigraenc tool.