IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Change data collector maintenance level using GUI - WAS agent

If an application server instance is monitored by the data collector version 7.1, and more than one maintenance level for this version is installed by the host (for example, 7.1.0 and 7.1.0.1), you can change the maintenance level. After installing a new maintenance level, perform this change to update the monitoring of application server instances. You can not remove an old maintenance level until all monitored server instances are moved to another level.

To change the data collector maintenance level for monitored application server instances:

  1. Enter the Agent Configuration window. See Enter the Agent Configuration window.

    Figure 1. Changing data collector maintenance level, window 1

  2. Select Change the maintenance level of data collectors and click Next.

  3. Select the required maintenance level, and the server instances you want to change. All the instances monitored by this installation of the agent are listed.

    Figure 2. Changing data collector maintenance level, window 2

    • For a stand alone environment, instances must be running during the configuration.

    • For a Network Deployment or Extended Deployment environment, the Node Agent and Deployment Manager must be running.

    Set the connection parameters for the application server instances. By default, the information that was set during initial data collector configuration for each instance will be displayed (except username and password). The following table lists the fields:


    Fields for establishing data collector and application server communication

    Field What to do
    Host Name Type the fully qualified host name or IP address of the application server instance that the data collector monitors. Do not include a protocol in the host name. For example, type...

      myserver.ibm.tivoli.com

    ...not...

      https://myserver.ibm.tivoli.com

    If using a Network Deployment environment, provide the host name of the deployment manager instead.

    Connector Type Select the type of connection the data collector and application server will use for communication.
    Port If you selected SOAP as the connector type, enter the SOAP port used by the application server instance.

    The SOAP port is identified in the AppServer_home/profiles/profile_name/config/cells/cell_name/nodes/node_name/serverindex.xml file for the instance of application server that the data collector will monitor.

    If using Network Deployment, provide the SOAP port of the deployment manager instead.

    If you selected RMI as the connector type, enter the RMI port used by the application server instance.

    Username Only for Global Security enabled. Type the user ID of a user authorized to log on to the WAS administrative console. This user must have the agent role on the application server.

    Alternatively, to retrieve the user ID from a properties file, select Use 'soap.client.props' or 'sas.client.props'.

    Password Only for Global Security enabled. Type the password corresponding to the user specified in the Username field.

    Alternatively, to retrieve the password from a properties file, select Use 'soap.client.props' or 'sas.client.props'.

    Check the boxes next to the instances you want to configure. Then, click Next.

  4. In the following window, choose whether the update is to preserve modifications that were made to custom data collector configuration files Unless you have special requirements, preserve the customizations; ensure that both checkboxes are selected.

    You can only choose whether to preserve common configuration files if this is the first time you are changing instances on this host to this maintenance level. At this time the common files will be processed. If you have already changed any instances to the level, this checkbox is unavailable.

    Figure 3. Changing data collector maintenance level, window 3

    Click Next.

  5. In the next step, you can choose to create a response file to save your configuration settings. You can use the response file to perform a silent configuration with the same parameters.

    Figure 4. Changing data collector maintenance level, window 4

    To create a response file, check the box...

      Save your settings in a response file

    ...and click Browse to select the file location; otherwise leave the box unchecked. If you uncheck Apply Configuration, the new configuration will not be applied; you can still save it in the response file. When the boxes are set correctly, click Next.

  6. The configuration utility will validate the applications server connection and apply the change.

    Figure 5. Changing data collector maintenance level, window 5

    Click Next.

  7. Summary information is displayed.

    Figure 6. Changing data collector maintenance level, window 6

    To export the summary report to a file, click the button...

      Export Summary Report

    The application server needs to be restarted before the data collector configuration takes effect. Click Home to return to the Agent Configuration window.

    Tip: If an older maintenance level is no longer used, you can remove it. See Remove a data collector maintenance level using GUI.


Parent topic:

Configure the agent using GUI