Driver Configuration
Driver configurations reside in the driver.properties
file, which is included in the GridServer SDK. When you install the Manager, the driver.properties
file contains hostnames for the primary and secondary Director. To change the default values, edit the driver.properties
file. For example, edit this file to add a username and password for authentication, change the primary and secondary Director, change the Broker Timeout, and so on.
You can move the driver.properties
file to another directory. For Java, add the new directory to your classpath. For C++, .NET, R, and the UNIX PDriver, the DSDRIVER_DIR
environment variable must be set to the location of this directory. For Windows PDriver, the DS_PDRIVER_CONF
environment variable must be set to the location of this directory.
If you use the following characters in properties in the driver.properties
file, precede each with a backslash: #
, !
, #
=
, \
, and :
Backslash characters in hostname or directory properties receive special handling on Windows Drivers. The first backslash, indicating the root directory, translates as the current Windows drive. Other backslashes are ignored. Forward slashes translate as backslashes.
For example, to set a directory to c:\sdk\log
, use /sdk/log
in the driver.properties
file. To use a UNC path such as \\homer\job1-dir
, use //homer/job1-dir
in the driver.properties
file.
You can also set Driver properties programmatically with the API. When you do this, the driver.properties
file is unnecessary. You must at least set DSPrimaryDirector
, DSSecondaryDirector
(set them both to the same hostname when using a single Director), DSUsername
, and DSPassword
(unless using Windows or Kerberos authentication).
If your username or password is non-ASCII, you must express it in Unicode converted format rather than as the Unicode characters. For example:
DSUsername=\u6B21\u306E\u30E6\u30FC