Preinstallation on Solaris systems

Edit online

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:

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

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.