Previous Topic Next topic Print topic


Environment Variables

When an enterprise server starts, it inherits its environment from the Directory Server. This means that all the environment variables that you need to run your servers' workload, including directory settings for third-party software, must be set in the session where you start the Directory Server.

You can set environment variables for an enterprise server in Configuration Information on the Add Server or Edit Server page. These apply to all services that run in the server.

The format for environment variables is

[ES-Environment]
environment-variable-name=environment-variable-setting

Use a semi-colon to separate elements within the string. For example:

[ES-Environment]
COBPATH=/home/adirectory:home/anotherdirectory
Note:

We recommend that you do not set the COBDIR environment variable for an enterprise server. This is because $COBDIR is used to point to the product location. The results of setting $COBDIR are undefined. Use the COBPATH environment variable if you want to specify the location of service programs at the enterprise server level. If you do set the COBPATH environment variable at enterprise server level, you also need to specify "$COBPATH" in Package Path in the Add Package or Edit Package page.

When you specify an environment variable, you can use the resolved value of another already-created variable as part of the environment variable value. To do this, prefix the environment variable you want to include with a dollar ($) sign, for example:

FILEROOT=/home/data
FILEA=$FILEROOT/mydata.dat

This resolves to /home/data/mydata.dat

If you want to include a dollar sign in an environment variable value as part of the actual value, rather than as an indicator that another environment variable is being referred to, you can enable the dollar sign character to be escaped by inserting a backslash (\) character, for example:

This resolves to $$fsserver1/mydata.dat

Previous Topic Next topic Print topic