Enable Transport Layer Security (TLS) logs to help diagnose and troubleshoot secure communication issues between the OpenEdge Command Center components. These logs provide detailed insights into the SSL/TLS handshake, certificate validation, encryption protocols, and potential errors during secure connections.

Before you begin:
  • Ensure that you have administrator privileges to modify configuration files.
  • Stop the relevant OpenEdge Command Center component:
    • Stop the server if you are enabling logs for the server.
    • Stop the agent if you are enabling logs for the agent.

Enable TLS logs on OpenEdge Command Center server

To enable TLS logs on the OpenEdge Command Center server, perform the following steps:
  1. Configure the NODE_DEBUG=tls environment variable either at the system level or from the command line.
  2. Start the server. For details, see Start OpenEdge Command Center server.

Alternatively, you can enable TLS logs by modifying the startup script to include NODE_DEBUG=tls environment variable and then starting the server.

Enable TLS logs on OpenEdge Command Center agent

To enable TLS logs on the OpenEdge Command Center agent, perform the following steps:
  1. Navigate to the agent installation directory and locate the startup script:
  2. Open the script using any text editor and search for the following line:
    %JAVAHOME%\bin\java" -Dlog4j.configurationFile="%SELFDIR%resources\log4j2.properties" -jar "%SELFDIR%%agentjar%"
  3. Add the SSL handshake debug property -Djavax.net.debug=ssl:handshake as shown below:
    "%JAVAHOME%\bin\java" ^
     -Dlog4j.configurationFile="%SELFDIR%resources\log4j2.properties" ^
     -Djavax.net.debug=ssl:handshake ^
     -jar "%SELFDIR%%agentjar%"
    
  4. Save the file and start the agent. For details on starting the agent, see Start the OpenEdge Command Center agent.