IBM Performance Management

Creating the agent image

Use this procedure to create the agent package. You can use this image to install the agent in the IBM® Tivoli® Monitoring and IBM Performance Management environments.

Procedure

  1. Select the itm_toolkit_agent.xml file by using one of the following methods:
    • Right-click the itm_toolkit_agent.xml file and select IBM Tivoli > Generate Agent.
    • Select the itm_toolkit_agent.xml file and select the Generate Agent icon on the toolbar.
    • Double-click the itm_toolkit_agent.xml file and select IBM Tivoli Monitoring Agent Editor > Generate Agent.
  2. Enter the name of the directory where you want to keep the expanded files or the compressed file or files in the Generate Agent Image section,
  3. Optional: Select the Keep intermediate files check box to keep the generated files separated from the zip or tar file.
  4. Select the Create a ZIP file check box to create a compressed file in the specified directory. The compressed file is named smai-agent_name-version.zip for Windows systems by default.
  5. Select the Create a TAR file check box to create a tar file in the specified directory. The compressed file is named smai-agent_name-version.tgz for UNIX and Linux systems by default.
  6. Select the agent components to generate. You can select Base Agent, Cognos Reporting, or both.
    Important: For the IBM Performance Management environment, do not select Cognos® reporting, because the reports are currently not supported and including the reports increases the size of the package.
  7. You can optionally provide security signing for agent application files. This might be required by a future release of IBM Performance Management. If you want to provide security signing, select Sign self-describing support JAR, then click Edit all JAR signing preferences to specify details about your Java™ Keystore File.
    Important: You can create the Java Keystore File by using Java tools. For example, to generate a private key and certificate with a corresponding public key in a Java Keystore File, you can run this command:
    • ab_install_path/jre/bin/keytool -genkeypair -keystore keystore_file_path -storepass key_store_password -alias key_store_alias -dname "CN=common_name, OU=organizational_unit, L=city_or_locality, ST=state_or_province, C=country" -keypass key_password
    Where:
    • ab_install_path is the location where Agent Builder is installed
    • keystore_file_path is the path where an existing JKS key store resides, or where one will be created
    • key_store_password the password needed to access any items in this key store
    • key_store_alias a name identifying this key within the key store (defaults to "mykey")
    • key_password the password needed to access this particular key (defaults to key_store_password)
    Include this certificate in the server key store.
  8. Click Finish.