Advanced Options

Table of Contents

What Gets discovered

After the first full discovery process is complete, each Tivoli Storage Manager component, such as client nodes, schedules, etc. is mapped to the appropriate CommCell entity. The following versions of Tivoli Storage Manager are supported for these TSM components:

*Both Windows and Unix platforms are supported.

Configuration entities

The following table lists the TSM configuration entities that are discovered and how they are mapped to CommCell entities.

job entities

The following table lists the TSM job entities that are discovered and how they are mapped to CommCell entities.

Verify discovery

After discovery is complete, you can verify the mappings of the TSM data in the CommCell Browser. The following provides some examples.

advanced discovery options

Several additional options are available if you require more comprehensive information about the discovered clients. The following sections describe the options available.

To configure these settings, perform the following steps:

1. In the CommCell Browser, right-click the default subclient for which you want to discover Tivoli Storage Manager data and click Discover.
2. From the General tab of the Discovery Options dialog box, click Advanced.
3. From the Advanced Discovery Options dialog box, select the desired options and click OK.

The following table describes the advanced operations available.

Assigning Discovered Client Nodes to Additional Client Computer Groups

All TSM client nodes discovered are initially grouped into a single Client Computer Group based on the instance from which the discovery operation was run.

Prior to a discovery operation, you can assign discovered client nodes to additional client computer groups as follows:

1. From the CommCell Console, right-click on the External Data Connector node, select an instance.
2. Right-click the subclient for which you want to discover TSM data and click Properties.
3. From the General tab, specify a client computer group by:
   • In Select a Client Group for Discovered Clients, choose a client group from the pulldown menu.
   • Click Create New Group. Enter a name for the group, add clients to the group, and click OK.
4. Click OK.

capture metadata using decoupled install

This method uses External Data Connector to save TSM information into an XML file, which is then applied to an existing CommServe. This method does not require any direct connectivity between the TSM and the CommServe, which is useful if deploying a new CommServe is not desirable in a particular environment.

This method consists of three phases:

1. Install External Data Connector on the TSM
2. Collect and Save TSM Data into an XML File
3. Merge TSM Data from XML File into CommServe Database

The following sections describe these phases in detail.

Install External Data Connector on the TSM

External Data Connector must first be installed on the TSM Server. To perform this installation in the absence of a CommServe, use the Decoupled Install feature.

collect and save TSM data into an XML File

Run the CVForeignHandler command to collect TSM data and save it into a bundle file. This can be accomplished from the command line as follows:

1. From the command line, navigate to the base folder for the External Data Connector software.
2. On Windows, execute the following command:

   CVForeignHandler –collectdata –vendor 8 –user "<External_Database_Admin_User_Name>" –password "<External_Database_Admin_User_Password>" -vm "<Instance_Name>" –cn "<Client_Name>"

   For example:

   CVForeignHandler –collectdata –vendor 8 –user "<External_Database_Admin_User_Name>" –password "<External_Database_Admin_User_Password>" -vm "Instance001" –cn "client1"

   By default, this command will save all contents of the TSM server into a .zip file in the JobResults folder.

3. On Linux and Unix, execute the following command:

   ../iDataAgent/CVForeignHandler –collectdata –vendor 8 –user "<External_Database_Admin_User_Name>" –password "<External_Database_Admin_User_Password>" -vm "<Instance_Name>" –cn "<Client_Name>"

   For example:

   ../iDataAgent/CVForeignHandler –collectdata –vendor 8 –user "<External_Database_Admin_User_Name>" –password "<External_Database_Admin_User_Password>" -vm "Instance001" –cn "client2"

   By default, this command will save all contents of the TSM server into a .gz file in the JobResults folder.

merge TSM data from XML File into CommServe Database

Once the TSM data is collected and saved in an XML file, copy the XML file to the CommServe computer and merge the TSM data into the CommServe database. To do so:

1. Copy the XML file into the desired location on the CommServe computer.
2. From the CommCell Console, initiate a Discovery operation.
3. From the General tab of the Advanced Discovery Options dialog box, select the following options:
   • Full Sync to populate all information in the XML file.
   • Merge from folder to identify the XML file that contains the TSM information. You can use the Browse option to navigate to the location of the XML file.
4. Click OK.

The TSM information will be merged into the CommServe database.

troubleshooting

Discovery operations may fail if the TSM password is entered incorrectly or TSM services are not running. To determine which failure occurred, right-click the failed discovery job in the Job Controller window and select Job Details. The Description field will display the job failure reason.

scheduling discovery jobs

If External Data Connector was installed on a client computer using the advanced install option, a Tivoli Storage Manager instance was created automatically for you and Steps 1 and 2 can be skipped below. Otherwise, you will need to create an instance before running a Discovery operation.

1.	From the CommCell Console, right-click on the External Data Connector node, select New Instance, and select the desired instance type.
2.	Enter the following information: The instance name. The username with admin privileges for accessing Tivoli Storage Manager. The password of TSM. Click OK. An instance, default backup set, and subclient are now created and ready for the discovery process.
3.	Right-click the subclient for which you want to discover TSM data and click Discover.
4.	From the Job Initiation tab of the Discovery Options dialog box, select Schedule.
5.	From the Schedule Details dialog box that appears, select the appropriate scheduling options.
6.	Click Options to view the Advanced Schedule Options dialog box. Specify the following options: Range of recurrence: Specify the date on which you want this schedule to take effect. Repeat: Select the value for which you want to run the job repeatedly on the day in which the job is scheduled to run. Time Zone: Select a specific time zone from which the job schedule time will be based. You can also confirm and/or edit (where applicable) your choices from the Job Summary tab. For a monthly or yearly schedule, you can select either a standard calendar or a custom calendar. Click OK once all the desired options have been configured.
7.	Click OK. Your discovery operation will execute according to the specified schedule. You can track the progress of the backup job from the Job Controller window. When the backup has completed, the Job Controller displays Completed.

Related Reports

Reports are available that provide detailed information on previously run TSM jobs, as well as jobs run using the CommCell software after migration, as described below:

CommCell Reports

After your first discovery, you can run these CommCell Reports to obtain information on all past TSM data protection and recovery jobs.

• CommCell Configuration
• Scheduling

By default, the reports display information according to CommCell entities; that is, a TSM schedule will appear as a subclient, and so on. However, several reports can be customized to display information according to the original TSM entity. While the details of the report remain the same in either case, this option is useful as a tool for new CommCell users who may not be familiar with CommCell components.

Refer to the Reports - Overview topic for complete details.

Back to Top