Configuring the agent on Linux or UNIX systems by using the GUI

Do the following steps to configure the ITCAM Agent for WebSphere DataPower Appliance on Linux or UNIX systems before you can use it to monitor your WebSphere DataPower appliance:

1. Open the Manage Tivoli Enterprise Monitoring Services window.
2. Right-click DataPower Monitoring Agent and then click Configure. The Manage Application Instances window is displayed.
3. If you want to reconfigure an existing agent instance, select the agent instance name and click OK. If you want to create an agent instance, click Add Instance.
4. Enter a unique instance name for the agent that you want to create. The Agent Configuration window is displayed and the instance name that you enter is displayed in the Instance Name field.
   Attention: Do not enter a long instance name because the combination of the instance name and the hostname on which the agent runs must not exceed 30 characters. The instance name must also consist of only alphanumeric characters.
5. Click Next.
6. Enter the SNMP properties for receiving events:
   1. In the Port Number field, enter the destination UDP port for SNMP Traps and Notifications that are generated by the local SNMP agent or engine. By default, SNMP Traps and Notifications are sent to port 162. This port must be unique across all instances of this agent.
   2. From the Security Level list, select the security level to use for notifications to this recipient.
   3. In the SNMP User Name field, enter the user name for connecting to the SNMP agent.
   4. From the SNMP Authentication Protocol list, select the SNMP authentication protocol that is used to connect to the SNMP agent.
   5. If you selected Authentication, No Privacy or Authentication, Privacy as the SNMP security level in step 6b, in the SNMP Authentication Secret field, enter the authentication pass phrase for connecting to the SNMP agent.
   6. If you entered the authentication pass phrase in the previous step, re-enter the same authentication pass phrase in the Confirm SNMP Authentication Secret field.
   7. If you selected Authentication, Privacy as the SNMP security level in step 6b, in the SNMP Privacy Secret field, enter the privacy pass phrase for connecting to the SNMP agent.
   8. If you entered the privacy pass phrase in the previous step, re-enter the same privacy pass phrase in the Confirm SNMP Privacy Secret field.
   9. Click Next.
7. Enter information about the WebSphere DataPower appliance that you want to monitor:
   1. Click New.
   2. Enter the managed system name of the agent. This name is displayed in the Navigation tree of the Tivoli Enterprise Portal. It must be unique among all instances of the agent and it must consist of only alphanumeric characters.
   3. In the Device host field, enter the host name or IP address of the monitored DataPower appliance and then confirm the password.
   4. In XML Management Interface Port field, input the port number for the XML Management Interface. The default number is 5550.
   5. Enter the User ID and Password for logging in to the monitored DataPower appliance and then confirm the password.
   6. In the System Log field, type the system log file name. The file name must be fully qualified. The file name can also be a dynamic file name. For more information, see dynamic file name syntax (http://pic.dhe.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.itm.doc_6.2.2fp2/agentBuilder_6224/dynamicfilenamesyntax.htm) in the Agent Builder User's Guide.
   7. In the SSL Proxy Profile field, Enter the absolute path of your custom SSL proxy profile, or click Browse and select it.
      Note: For information about how to set the custom SSL policy profile, refer to Chapter 4. Securing communication channels with SSL in the DataPower Redbook (http://www.redbooks.ibm.com/redpapers/pdfs/redp4327.pdf).
8. Click OK.
9. Click Next. The Managed System Details panel opens.
10. Enter a name in the Managed System Name field. The name must consist of only alphanumeric characters.
    1. Click New.
    2. Enter the managed system name of the agent. This name is displayed in the Navigation tree of the Tivoli Enterprise Portal. It must be unique among all instances of the agent and it must consist of only alphanumeric characters.
    3. Enter the device host name in the Device Host field.
    4. Enter the community name that you configured when you set up the XC10 Appliance to be monitored in the SNMP Community field and then confirm the password.