Skip to main content

Path

Add directories to the default path environment variable. UNIX® systems only.

Synopsis

[config]    Path=directory:directory2:directory3[...]

directory is the full path to a valid directory. The maximum length for Path is 1024 characters. By default, no directories are listed.

Description

As part of InterSystems IRIS® data platform startup, UNIX® systems assign new processes a UNIX® PATH environment variable. By default, the UNIX® PATH variable is:

PATH=/usr/bin:/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin

InterSystems IRIS processes that use PATH include system daemons, processes started by SYSTEM^%ZSTART, and processes the Super Server creates (such as JDBC/ODBC servers).

Customer applications may require that the UNIX® PATH environment variable for these processes have additional search directories appended to the default PATH provided by InterSystems IRIS. You can append directories to this path using the CPF Path variable. If you modify this setting, you must restart the instance for the change to take effect.

Note:

Terminal processes do not set their PATH this way; their PATH should be set by their login scripts.

Example

Path=/usr/customerapp/bin

This sets the PATH environment variable for system processes to:

PATH=/usr/bin:/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/usr/customerapp/bin

Changing This Parameter

On the Advanced Memory page of the Management Portal (System Administration > Configuration > Additional Settings > Advanced Memory), in the Path row, select Edit. Enter one or more directories, separated by colons.

Instead of using the Management Portal, you can change Path in the Config.config class (as described in the class reference) or by editing the CPF in a text editor (as described in the Editing the Active CPF section of the “Introduction to the Configuration Parameter File” chapter in this book).

Feedback