Preinstallation on Solaris systems

You must complete the required preinstallation tasks before you install agents on Solaris systems. Some preinstallation tasks are agent-specific and other tasks apply to multiple agents.

Note: These requirements are in addition to the requirements identified in the Software Product Compatibility Reports for your agent: For the current version requirements and dependencies for your agent, see the IBM® Cloud Application Performance Management Software Product Compatibility Report for agents on Solaris.

All agents

The following preinstallation tasks are applicable to all agents:

Test connectivity
Before you install agents, ensure that your system can communicate with the Cloud APM server. For information about checking connectivity to the Cloud APM server, see Network connectivity.
Non-root user installation
You must have read, write, and execute permissions for the installation directory. Otherwise, the installation is canceled. For more information about non-root user installation, see Installing agents as a non-root user.
70-character limitation for installation path
The installation directory and the path to it must be no more than 70 characters.
100-character limitation for .tar file names
The default tar command on Solaris systems cannot handle file names that are longer than 100 characters. To avoid @LongLink error issues, complete the following steps:
  1. Download and install the GNU version of the tar command from the http://www.gnu.org website.
  2. Make the GNU version your default tar command. Complete one of the following steps:
    • In the PATH environment variable, put the following variable first:
      export PATH=/opt/freeware/bin:$PATH
    • Replace /bin/tar with symbolic link to /opt/freeware/bin/tar
Setting the CANDLEHOME environment variable
If you used the ITM Agent Converter to install and configure an agent on the same managed system before, the CANDLEHOME environment variable changed to that directory where you installed the agent with the Agent Converter. Before you install and configure a native Cloud APM agent, you must set the CANDLEHOME environment variable to a different directory, otherwise, the native Cloud APM agent cannot start.

Specific agents

The following preinstallation tasks are applicable to the specified agents:

HTTP Server agent
Install and run this agent as a root user. Use the same user ID to install and run the agent. If you install and run the agent as a non-root user, the non-root user must have the same user ID as the user who started the IBM HTTP Server. Otherwise, the agent has problems with discovering the IBM HTTP Server.