IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Configure a data collector to use the Port Consolidator - J2EE Agent

If you have a firewall, you can avoid allocation of an excessive number of ports in the firewall for multiple data collectors by configuring and using the Port Consolidator.

To configure a data collector to use the Port Consolidator:

  1. Edit thecustom_directory/datacollector_custom.properties file. 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 server, but it could be different in a multiple IP or virtual host scenario. In any case, specify the same IP address as the one specified in the am.socket.bindip property in DC_home/itcamdc/etc/proxy.properties. 
    proxy.port=port
    This is usually 8800. In any case, specify the same port specified in the PROXY_PORT property in DC_home/itcamdc/bin/proxyserverctrl_*.

    1. Do not use the loopback address for the IP address. Use a valid IP address for the local system.

    2. proxy.port must match the port number for PROXY_PORT specified in the startup script you run in Step 4.

  2. Restart the instance of the application server monitored by the data collector.

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

  4. Start the Port Consolidator using one of the following commands:


    Command for starting the Port Consolidator

    Windows 
    proxyserverctrl_ws.bat start
    UNIX and Linux 
    ./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.

  5. Open the Self-Diagnosis page of the Application Monitor user interface, and check to see that the following components are listed:

    • COMMANDAGENTPROXY

    • KERNELPROXY

    • PROBECONTROLLERPROXY

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

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


      Location of the CYND4051I message

      Windows C:\IBM\tivoli\common\CYN\logs\node_name.server_name\java_msg_log_file. For example:

      C:\IBM\tivoli\common\CYN\logs\IBMNode01.server1\msg-dc-Ext.log

      UNIX and Linux /var/ibm/tivoli/common/CYN/logs/node_name.server_name/java_msg_log_file. For example:

      /var/ibm/tivoli/common/CYN/logs/IBMNode01.server1/msg-dc-Ext.log

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

    2. From a new command prompt, move to the directory DC_home/itcamdc/bin, and enter one of the following commands:


      Entering the proxyserverctrl_ws command

      Windows 
      proxyserverctrl_ws.bat list
      UNIX and Linux 
      ./proxyserverctrl_ws.sh list

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

  7. Verify the data collector's connection to the Port Consolidator (again) by entering one of the following commands:


    Entering the proxyserverctrl_ws command

    Windows 
    proxyserverctrl_ws.bat list
    UNIX and Linux 
    ./proxyserverctrl_ws.sh list

    You should now see the data collector listed as two Service types, PPECONTROLLER and PPEPROBE.

    The data collector is configured to use the Port Consolidator.


Parent topic:

Port Consolidator reference and configuration

+

Search Tips   |   Advanced Search