Configuration and Discovery

Download this manual as a PDF file

The following sections describe how to configure and discover IBM Tivoli Storage Manager environments for monitoring by SL1 using the IBM: Tivoli Storage Manager PowerPack:

Creating Credentials for IBM Tivoli Storage Manager

If you are connecting to your IBM Tivoli Storage Manager (TSM) environment using SSH with basic authentication, then you will need to create a SOAP/XML credential.

If you connecting to your TSM environment using SSH with public-key authentication, you will need to create an SSH/Key credential in addition to the SOAP/XML credential.

Creating a SOAP/XML Credential for IBM Tivoli Storage Manager

To use the Dynamic Applications in the IBM: Tivoli Storage Manager PowerPack, you must configure a SOAP/XML credential for your Tivoli Storage Manager (TSM) environment. The IBM: Tivoli Storage Manager PowerPack includes a template for SOAP/XML credentials that you can edit for use with your TSM environment.

To modify the template, perform the following steps:

  1. Go to the Credential Management page (System > Manage > Credentials).

  1. Click the wrench icon () for the "IBM: TSM Example". The Credential Editor modal page appears.

  1. Supply values in the following fields:
  • Profile Name. Enter a new name for the credential.
  • HTTP Auth User. Enter the username for the TSM server, or the proxy server that you are connecting to via SSH.

NOTE: The username you enter in the HTTP Auth User field must have the necessary permissions to successfully execute dsmadmc commands.

  • HTTP Auth Password. Enter the password for the TSM server, or the proxy server you are connecting to via SSH. This field is required when not using a private RSA key to connect.

  • Embed Value [%1]. Enter the dsmadmc username. The dsmadmc login is configured separately by the TSM administrator, but the default login is admin/passw0rd. This field is required.
  • Embed Value [%2]. Enter the dsmadmc password. This field is required.

  • Embed Value [%3]. If you are using a proxy server, enter the TSM server name in this field as defined in your dsm.sys file. If this field is left unchanged, it's assumed that you're connecting directly to the TSM server instance.
  • Embed Value [%4]. If you are using an SSH/Key credential for public/private key access, enter the credential ID of the SSH/Key credential in this field. Otherwise, leave this field blank.

  1. Click the Save As button to save your changes as a new credential.

Do not click the Save button, as it will save over the example credential, which you may need for future use.

Creating an SSH/Key Credential for IBM Tivoli Storage Manager

When configuring monitoring for IBM Tivoli Storage Manager devices, if you want to use a public/private RSA key pair for the SSH connection rather than a username and password, you must also create an SSH/Key credential. This credential allows the Dynamic Applications in the IBM: Tivoli Storage Manager PowerPack to connect with an IBM Tivoli Storage Manager server or proxy client using an RSA key pair. After you create this credential, you must then enter its credential ID number in the SOAP/XML credential you created.

The IBM: Tivoli Storage Manager PowerPack includes a template for SSH/Key credentials that you can edit for use with your TSM environment, if needed.

To create an SSH/Key credential:

  1. Generate an SSH RSA private/public key pair. This is commonly done using the "ssh-keygen" command-line utility.

  2. Go to the Credential Management page (System > Manage > Credentials).
  3. Click the wrench icon () for the "IBM: TSM SSH/Key Example" credential. The Credential Editor modal page appears.

  1. Supply values in the following fields:
  • Credential Name. Enter a new name for the credential.
  • Username. Enter N/A. The credential cannot be saved if this field is empty.
  • Password. Enter N/A. The credential cannot be saved if this field is empty.
  • Private Key (PEM Format). Paste the SSH private key that you copied from your collector into this field, in PEM format.

The private key can have a maximum of 64 characters per line. Therefore, you cannot use keys in the OpenSSH format, because that format uses 70 characters per line. When you attempt to save the credential, SL1 will validate that the private key entered is in the correct format. You will be able to save the credential only if the private key is correctly formatted.

  1. Click Save As. In the Credential Management, note the credential ID of the SSH/Key credential you just created.
  2. Save the corresponding public key to the authorized_keys file on your SSH target (the TSM server or proxy client). This is typically found at /root/.ssh/authorized_keys
  3. In the SOAP/XML credential you created, enter the credential ID of the SSH/Key credential in the Embed Value [%4] field.

Discovering IBM Tivoli Storage Manager Component Devices

To discover an IBM Tivoli Storage Manager (TSM) system:

  1. Go to the Discovery Control Panel page (System > Manage > Classic Discovery).
  2. In the Discovery Control Panel, click the Create button. The Discovery Session Editor page appears.
  1. Supply values in the following fields:
  • IP Address Discovery List. Type the IP address of the first controller listed in the Embed Value [%3] field of the SOAP/XML credential.
  • Other Credentials. Select the credential you created for the TSM system.
  • Discover Non-SNMP. Select this checkbox.
  1. Optionally, supply values in the other fields in this page. For a description of the fields in this page, see the Discovery and Credentials section.
  2. Click the Save button.
  3. The Discovery Control Panel page will refresh. Click the lightning bolt icon () for the discovery session you just created.
  4. In the pop-up window that appears, click the OK button. The page displays the progress of the discovery session.

Verifying Discovery and Dynamic Application Alignment

To verify that SL1 has automatically aligned the correct Dynamic Applications during discovery:

  1. After discovery has completed, click the device icon for the Tivoli Storage Manager (TSM) device (). From the Device Properties page for the TSM device, click the Collections tab. The Dynamic Application Collections page appears.
  2. All applicable Dynamic Applications are automatically aligned to the root device during discovery.

It can take 10 to 15 minutes after the discovery session has completed for Dynamic Applications to appear in the Dynamic Application Collections page.

As data is collected and cached on the first polling interval and displayed on the second, you might not see any data until the second polling interval is completed. This could take as long as 30 minutes.

You should see the following Dynamic Applications aligned to the TSM device:

  • IBM: TSM Admin Schedule Discovery
  • IBM: TSM Collection Cache
  • IBM: TSM Components Config
  • IBM: TSM Events Cache
  • IBM: TSM Library Discovery
  • IBM: TSM Policy Domain Discovery
  • IBM: TSM Server Config
  • IBM: TSM Storage Pool Discovery

If the listed Dynamic Applications have not been automatically aligned during discovery, you can align them manually. To do so, perform the following steps:

  1. Click the Actions button and then select Add Dynamic Application. The Dynamic Application Alignment page appears.
  1. In the Dynamic Applications field, select the Dynamic Application you want to align.
  2. In the Credentials field, select the credential you created.
  3. Click the Save button.
  4. Repeat steps 1-4 for the other unaligned Dynamic Applications.

Viewing IBM Tivoli Storage Manager Component Devices

In addition to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface), you can view the IBM Tivoli Storage Manager (TSM) environment and all associated component devices in the following places in the user interface:

  • All devices, virtual devices, and component devices appear in the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface).

  • The Device Components page (Registry > Devices > Device Components) displays a list of all root devices and component devices discovered by SL1 in an indented view, so you can easily view the hierarchy and relationships between child devices, parent devices, and root devices. To view the component devices associated with IBM Tivoli Storage Manager (TSM), find the TSM root device and click its plus icon (+):

  • The Device Component Map page (Classic Maps > Device Maps > Components) allows you to view devices by root node and view the relationships between root nodes, parent components, and child components in a map. This makes it easy to visualize and manage root nodes and their components. SL1 automatically updates the Component Map as new component devices are discovered. The platform also updates each map with the latest status and event information. To view the map for IBM Tivoli Storage Manager (TSM) devices, go to the Component Map page and select the map from the list in the left NavBar. To learn more about the Component Map page, see the section on Views.