Troubleshoot OneAgent installation on Solaris

While downloading, you may encounter the following error:

Releasing 0x0000000239ae1890 (new refcount 1).
Initiating SSL handshake.
SSL handshake failed.
Closed fd 5
Unable to establish SSL connection.

This can be caused by selecting the wrong SSL or TLS protocol on handshake. As different operating systems act differently (both server and client side), you must specify some protocols manually under certain conditions.

For this specific case, to select the correct protocol, you must specify --secure-protocol=tlsv1_2 as an additional parameter of the wget command. The command should appear as follows:

wget --secure-protocol=tlsv1_2  
   -O DESK-OneAgent-Solaris-xxx-1.xxx.xxx.zip
   "https://xxx/xxx/api/v1/deployment/installer/agent/solaris/paas/latest?Api-Token=xxx&arch=x86"

It can also be set permanently by creating the file ~/.wgetrc with the following content:

secureprotocol = tlsv1_2

You may encounter the following error message when you start your Java application:

severe  [hooking   ] Could not find required opcodes in caller trying to resolve main

This happens if you use one of the unified monitoring scripts desk-agentXX.sh but additionally have OneAgent referenced in JAVA_OPTS.

• 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

Following this, the error message should go away.

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] LD_PRELOAD_64: parameter not set

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

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

You may encounter an error like this when you set LD_PRELOAD in your execution environment and call sudo or su. This happens because OneAgent isn't installed in the secure ld_preload directory. This error message has no negative impact and can be ignored. To avoid this, ensure that you don't set LD_PRELOAD in an execution context where you want to use sudo.

See Further detail on this topic

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 .

It's fine to use service apache2 restart on Ubuntu systems. Note however that whatever commands you use, you'll likely need superuser rights (sudo).