Required Environment Variables
Required Environment Variables
There are a number of installation parameters available for use in configuring unattended installation of InterSystems IRIS instances on UNIX and Linux; their use is described and they are listed in Unattended InterSystems IRIS Installation. If you install InterSystems IRIS instance from a kit in your Dockerfile, rather than using an InterSystems image as a base as described in Creating InterSystems IRIS Images, the installation parameters that are required as environment variables in the container runtime environment must also be built into the image; without them, container creation from the image will fail. These variables are included in all images from InterSystems and are shown, with the values set by InterSystems, in the following table:
| Parameter/Variable | Description | InterSystems Value |
|---|---|---|
|
ISC_PACKAGE_INSTANCENAME |
Name of the instance to be installed. |
IRIS |
|
ISC_PACKAGE_INSTALLDIR |
Directory in which the instance will be installed. |
/usr/irissys |
|
ISC_PACKAGE_IRISUSER |
Effective user for the InterSystems IRIS superserver. |
irisowner |
|
ISC_PACKAGE_IRISGROUP |
Effective user for InterSystems IRIS processes. |
irisowner |
|
ISC_PACKAGE_MGRUSER |
Username of the installation owner. |
irisowner |
|
ISC_PACKAGE_MGRGROUP |
Group that has permission to start and stop the instance. |
irisowner |
If you are building your own InterSystems IRIS image, you can optionally set the IRISSYS variable to specify the registry directory. InterSystems sets it to /home/irisowner/irissys in all images. If you do not include this environment variable, the registry directory is /usr/local/etc/irissys.
The environment variables discussed here are used to specify the configuration details described in Ownership and Directories.