Where does aex-configure look for the .aex-agent-install-config.xml file?

Products

• IT Management Suite

Issue/Introduction

Where does the UNIX and Linux aex-configure utility look for the .aex-agent-install-config.xml file?

Resolution

 

The aex-bootstrap, aex-nsclt installers and the aex-configure utility will search for a .aex-agent-install-config.xml file in the following locations in this order. The search ends when the first occurrence is located:

 

1. Check the current directory
2. If the current directory is not the root directory (/), check the parent directory
3. Check in the folder specified by the AGENT_INSTALL_DIR environmental variable.
4. Check in the folder specified by the AEXCLIENT_CONFIG_XML_DIR environmental variable.
5. Check in folders: /tmp, /var, and /opt/altiris
6. On a Macintosh client, this file has been found in the ./private/tmp directory.

Note that this search does not use the clients $PATH environment variable for additional locations.

It has to be noted that the native package manager may change the current working folder when installing the Altiris UNIX Agent package (aex-nsclt). For this reason, aex-configure (Altiris UNIX Agent configuration tool) may be executed from a different place and thus may not be able to find the configuration XML file. This behavior is typical, for example, in case of the GNU/Linux platform and the RPM package manager. Therefore, we recommend the /tmp or /var directories when using aex-nsclt.

 

The .aex-agent-install-config.xml file can be created in the 'Install settings' screen of the Unix agent rollout screen.  Note the . in the name of the file, it is hidden.