Troubleshoot OneAgent installation on AIX

If you used OneAgent for AIX prior to v1.137 you may have configured it via JAVA_OPTS using the desk-java-env.sh script. You need to remove this prior to using the unified monitoring scripts desk-agentXX.sh.

• Ensure that desk-java-env.sh isn't called anywhere in your shell when you use the desk-agentXX.sh script. desk-java-env.sh is deprecated and should only be used as a fallback.

• Check for and remove the following parameter from your Java command line or startup scripts (specific directory may vary):

  -agentpath:/opt/desk/oneagent/agent/lib64/liboneagentloader.so

You may encounter an error like this when you use desk-agentXX.sh in a shell script.

Info: using DT_HOME: /opt/desk/oneagent
.profile[33] LDR_PRELOAD64: parameter not set

This happens if you use set -u to treat unset variables and parameters as errors. The desk-agentXX.sh script exports variables which, though they may not yet exist in your script, are nevertheless needed and key to proper operation. To overcome this, call set +u ahead of the desk-agentXX.sh script.

# avoid error
set +u
export DT_HOME=/opt/desk/oneagent
. $DT_HOME/desk-agent64.sh

Following installation of OneAgent, your Apache web server must be completely restarted to enable monitoring. To do this correctly, it's important to understand the difference between "partial" and "complete" restarts. In the case of partial restarts, the main Apache process re-reads its configuration files, re-opens its log files, and then restarts its worker processes. OneAgent however, requires a complete Apache web server restart in which all workers and—most importantly—the main Apache process are shut down entirely and then restarted.

See Stopping and Restarting Apache HTTP Server for more information on the different types of available restarts.

How to perform a complete restart

You may be accustomed to restarting Apache by issuing an apachectl restart command. However, this command only results in a partial Apache restart.

To execute a complete Apache restart and enable deep monitoring with DESK OneAgent, you need to first invoke a complete shutdown using the apachectl stop command. Only following this step can you restart the server using apachectl start .

OneAgent consists of different processes that communicate via a TCP port with a watchdog. At startup, OneAgent watchdog attempts to open the first available port between port 50000 and 50100. In some cases you may need this port for your own applications that are started after OneAgent. In such cases, you can change the port range that the OneAgent watchdog uses by modifying the file watchdoguserconfig.conf.

The file watchdoguserconfig.conf is located in the following directory:
/var/lib/desk/oneagent/agent/config

You can change the watchdog listening port by modifying the following line in the file:

From, for example: -portrange=50000:50100

To: -portrange=3000:3010

Be sure to restart OneAgent service following your changes.

Please see Which network ports does DESK Server use? for information on the ports used by DESK.