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/login 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