IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Configure a data collector to use the Port Consolidator - WAS agent

If you have a firewall, to avoid allocation of an excessive number of ports for multiple data collectors, configure the Port Consolidator.

  1. Edit...

    ...and add the following lines to the end of the file...

      proxy.host=IP_address

    This is usually the same IP address as the data collector computer, but it could be different in a multiple IP or virtual host scenario.

  2. Edit...

      DC_home/itcamdc/etc/proxy.properties

    ...and specify the same IP address as the one specified in am.socket.bindip property...

      proxy.port=port

    Again, this is usually 8800.

  3. Specify the same port specified in the PROXY_PORT property in...

      DC_home/itcamdc/bin/proxyserverctrl_*

    Do not use the loopback address for the IP address. Use a valid IP address for the local system. proxy.port must match the port number for PROXY_PORT specified in the startup script you run in Step 4.

  4. Restart the application server.

  5. From a command prompt, move to the directory DC_home/itcamdc/bin.

  6. Start the Port Consolidator...

      ./proxyserverctrl_ws.sh start

    Do not close the command prompt window.

    The value for PROXY_PORT specified in the script must match the value that you specified for proxy.port in Step 1.

  7. Open the Self-Diagnosis page of the Visualization Engine (Application Monitor) user interface, and check to see that the following components are listed:

    • COMMANDAGENTPROXY
    • KERNELPROXY
    • PROBECONTROLLERPROXY

  8. Verify that the data collector is using the Port Consolidator:

    1. Look for the message labeled CYND4051I in one of the following files:

      Windows DC_home\logs\CYN\logs\node_name.server_name\java_msg_log_file. For example:

      C:\IBM\ITM\TMAITM6\wasdc\7.1.0.1\logs\CYN\logs\tivx44Node02.server1\msg-dc-ParentLast.log

      UNIX and Linux DC_home/logs/CYN/logs/node_name.server_name/java_msg_log_file. For example:

      /opt/IBM/AD7101_0505/li6263/yn/wasdc/7.1.0.1/logs/CYN/logs/tivx44Node02.server1/msg-dc-ParentLast.log

      That message includes the text Join Proxy Server and Kernel successfully.

    2. Run...

        cd DC_home/itcamdc/bin
        ./proxyserverctrl_ws.sh list

      You will see the data collector listed as one Service type, PPECONTROLLER. Keep this command prompt window open for future use.

  9. Verify the data collector connection to the Port Consolidator (again)...

      ./proxyserverctrl_ws.sh list

    You will now see the data collector listed as two Service types...

    • PPECONTROLLER
    • PPEPROBE

    The data collector is configured to use the Port Consolidator.


Parent topic:

Port Consolidator reference and configuration