IBM Support

Measuring storage-pool capacity when using the IBM Spectrum Protect Suite solution with the ProtecTIER Option

Technote (FAQ)


Question

I have IBM Spectrum Protect Suite installed on my system with the ProtecTIER Option. What tools are available to help me measure capacity in IBM Spectrum Protect primary storage pools and IBM Spectrum Protect for Workstations repositories?

Tip: Beginning with Version 7.1.3, IBM Tivoli Storage Manager Suite for Unified Recovery is now IBM Spectrum Protect Suite. Some applications such as the software fulfillment systems and IBM License Metric Tool use the new product name. However, the software continues to use the Tivoli Storage Manager product name. To learn more about the rebranding transition, see http://www.ibm.com/support/docview.wss?uid=swg21963634.

Answer

Using IBM Spectrum Protect Suite with the ProtecTIER Option
IBM Spectrum Protect Suite is a bundle of IBM Spectrum Protect products that offers simplified pricing and licensing with a tiered per-terabyte metric. You can install any number of products in your environment. There is no per-server, per-installation, or processor value unit (PVU) charge; you are charged only for the number of terabytes that are stored in IBM Spectrum Protect primary storage pools.

For a description of IBM Spectrum Protect Suite, see IBM Spectrum Protect Suite.

Tivoli Storage Manager Suite for Unified Recovery V6.4.1 and later offers a ProtecTIER Option for simplified pricing and licensing for IBM ProtecTIER Virtual Tape Libraries. The ProtecTIER Option enables customers to calculate license fees based on capacity that is used after ProtecTIER data deduplication.

Capacity Measurement Tool
Use the Capacity Measurement Tool to measure the number of terabytes stored in IBM Spectrum Protect primary storage pools without the ProtecTIER Option. Use the ProtecTIER Manager capacity and total utilization reports to measure the number of terabytes with the ProtecTIER Option.

Prerequisites

The following prerequisites apply:

  • The Capacity Measurement Tool must be run on a Microsoft Windows or Linux computer.
  • The IBM Spectrum Protect (Tivoli Storage Manager) command-line administrative client must be installed on the computer.
  • The ProtecTIER Manager must be installed on the computer. The ProtecTIER Manager must be at V3.3.3.0 or later.
  • The ProtecTIER server must be at V3.3.3.0 or later.
  • The IBM Spectrum Protect (Tivoli Storage Manager) server must be at V6.1 or later. The server can be installed on any supported operating system.

Acquiring the tool

The Capacity Measurement Tool is named tsm_tb_cap_ptoption_v641 and can be downloaded from the following links:

ftp://public.dhe.ibm.com/storage/tivoli-storage-management/capacity_measurement_tools/tsm_tb_cap_ptoption_v641.bat
ftp://public.dhe.ibm.com/storage/tivoli-storage-management/capacity_measurement_tools/tsm_tb_cap_ptoption_v641.sh
ftp://public.dhe.ibm.com/storage/tivoli-storage-management/capacity_measurement_tools/tsm_tb_cap_ptoption_v641_downlevel_pt.bat ftp://public.dhe.ibm.com/storage/tivoli-storage-management/capacity_measurement_tools/tsm_tb_cap_ptoption_v641_downlevel_pt.sh
ftp://public.dhe.ibm.com/storage/tivoli-storage-management/capacity_measurement_tools/tsm_tb_cap_v6.macro.template
ftp://public.dhe.ibm.com/storage/tivoli-storage-management/capacity_measurement_tools/tsm_tb_cap_v63.macro.template

You can use the Capacity Measurement Tool to calculate the number of terabytes in primary storage pools and the total number of terabytes.

Restriction: The Capacity Measurement Tool can be used only to display information about data in non ProtecTIER primary storage pools.

Using the tool

Complete the following steps:
1. Verify the system requirements as specified in the Prerequisites section.

2. Download the files that are listed in the Acquiring the tool section and store them in the same folder. Ensure that the files have execute privileges. Ensure that the user ID that you use to run the tool has write privileges for the folder because the tool creates temporary files in the folder. Review the following information about the tool package:

  • The tsm_tb_cap_ptoption_v641.bat file is a Windows version tool for ProtecTIER Manager or ProtecTIER Server at V3.3.3.0 or later.
  • The tsm_tb_cap_ptoption_v641.sh file is a Linux version tool for ProtecTIER Manager or ProtecTIER Server at V3.3.3.0 or later.
  • The tsm_tb_cap_ptoption_v641_downlevel_pt.bat file is a Windows version tool for an earlier ProtecTIER Manager or ProtecTIER Server.
  • The tsm_tb_cap_ptoption_v641_downlevel_pt.sh file is a Linux version tool for an earlier ProtecTIER Manager or ProtecTIER Server.
  • The tsm_tb_cap_v6.macro.template and tsm_tb_cap_v63.macro.template files are administrative macro templates, which will be used to generate the administrative macro.
3. Open a command window where the tool will be run:
  • For Microsoft Windows systems, open a Command Prompt window. For example, select Start > All Programs > Accessories > Command Prompt.
  • For Linux systems, you can use telnet or scp through PuTTY to access the computer. Alternatively, start xterm or another terminal window.

4. To determine the capacity that is used in non ProtecTIER primary storage pools, start the Capacity Measurement Tool:

a) Use the following procedure if the ProtecTIER Manager and ProtecTIER Server are at V3.3.3.0 or later.
On Linux systems:
./tsm_tb_cap_ptoption_v641.sh -tsmcpath=<tsmcpath> -tsmopt=<tsmopt> -tsmadmin=<tsmadmin> -tsmpass=<tsmpass> -ptclipath=<ptclipath> -ptaddr=<ptaddr> -ptuser=<ptuser> -ptpass=<ptpass>

On Windows systems:
tsm_tb_cap_ptoption_v641.bat -tsmcpath=<tsmcpath> -tsmopt=<tsmopt> -tsmadmin=<tsmadmin> -tsmpass=<tsmpass> -ptclipath=<ptclipath> -ptaddr=<ptaddr> -ptuser=<ptuser> -ptpass=<ptpass>

You can use the following input parameters:

<tsmcpath> - Path to administrative client binary files. This parameter is mandatory.
<tsmopt> - Full name, including the path, of the IBM Spectrum Protect (Tivoli Storage Manager) client options file.
<tsmadmin> - Administrative user ID that will be used to connect to the IBM Spectrum Protect (Tivoli Storage Manager) server.
<tsmpass> - Password for the administrative user ID that will be used to connect to the IBM Spectrum Protect (Tivoli Storage Manager) server.
<ptclipath> - Path to the ProtecTIER Manager binary files.
<ptaddr> - IP address of the ProtecTIER server.
<ptuser> - User ID that will be used to connect to the ProtecTIER server.
<ptpass> - Password for the user ID that will be used to connect to the ProtecTIER server.

For example:
On Linux:
./tsm_tb_cap_ptoption_v641.sh -tsmcpath=/opt/tivoli/tsm/client/ba/bin -tsmopt=/opt/tivoli/tsm/client/ba/bin/dsm.opt -tsmadmin=admin -tsmpass=admin -ptclipath=/opt/IBM/PTManager -ptaddr=10.8.1.1 -ptuser=ptoper -ptpass=ptoper

On Windows:
tsm_tb_cap_ptoption_v641.bat -tsmcpath="C:\Program Files\Tivoli\TSM\baclient" -tsmopt="C:\Program Files\Tivoli\TSM\baclient"\dsm.opt -tsmadmin=admin -tsmpass=admin -ptclipath="C:\Program Files\IBM\ProtecTIER Manager" -ptaddr=10.8.1.1 -ptuser=ptoper -ptpass=ptoper


b) Use the following procedure if the ProtecTIER Manager or ProtecTIER Server is earlier than V3.3.3.0.
If you are using an earlier ProtecTIER Manager or ProtecTIER Server, the tool cannot directly query ProtecTIER for required information. Manual steps are required to collect data from ProtecTIER Server and from the IBM Spectrum Protect (Tivoli Storage Manager) server.
  • Get the data deduplication ratio from the ProtecTIER Manager graphical user interface.
  • Get output from the QUERY LIBRARY command by using the IBM Spectrum Protect (Tivoli Storage Manager) command-line administrative client. Identify which libraries are ProtecTIER VTLs, and then create a list of ProtecTIER library names. For example:
    "'FUSION3584VTL1','FUSIONLTO5','MYTEST'"
    Note the format of the liblist string. There are single quotation marks for each library name, separated by commas, and double quotation marks for the whole string. Create the list of ProtecTIER library names with the same format as the example. Include only ProtecTIER libraries in the list.
  • On Linux systems:
    ./tsm_tb_cap_ptoption_v641.sh -tsmcpath=<tsmcpath> -tsmopt=<tsmopt> -tsmadmin=<tsmadmin> -tsmpass=<tsmpass> -liblist=<librarylist> -dedupratio=<ratio>

    On Windows systems:
    tsm_tb_cap_ptoption_v641.bat -tsmcpath=<tsmcpath> -tsmopt=<tsmopt> -tsmadmin=<tsmadmin> -tsmpass=<tsmpass> -liblist=<librarylist> -dedupratio=<ratio>

    You can use the following input parameters:

    <tsmcpath> - Path to administrative client binary files. This parameter is mandatory.
    <tsmopt> - Full name, including the path, of the IBM Spectrum Protect (Tivoli Storage Manager) client options file.
    <tsmadmin> - Administrative user ID that will be used to connect to the IBM Spectrum Protect (Tivoli Storage Manager) server.
    <tsmpass> - Password for the administrative user ID that will be used to connect to the IBM Spectrum Protect (Tivoli Storage Manager) server.
    <liblist> - List of ProtecTIER library names.
    <dedupratio> - Data deduplication ratio of the ProtecTIER server.

    For example:
    On Linux:
    ./tsm_tb_cap_ptoption_v641.sh -tsmcpath=/opt/tivoli/tsm/client/ba/bin -tsmopt=/opt/tivoli/tsm/client/ba/bin/dsm.opt -tsmadmin=admin -tsmpass=admin -liblist="'FUSION3584VTL1','FUSIONLTO5','MYTEST'" -dedupratio=2.9

    On Windows:
    tsm_tb_cap_ptoption_v641.bat -tsmcpath="C:\Program Files\Tivoli\TSM\baclient" -tsmopt="C:\Program Files\Tivoli\TSM\baclient"\dsm.opt -tsmadmin=admin -tsmpass=admin -liblist="'FUSION3584VTL1','FUSIONLTO5','MYTEST'" -dedupratio=2.9
The previous steps create an output file that contains capacity information. The output file is similar to the following example:
***********************************************************
**** Tivoli Storage Manager Suite for Unified Recovery ****
**** Terabyte (TB) Capacity Report ****
**** For Use with V6.3 or later Servers ****
****************** (macro version: 1.9) *******************

Capacity Report for server: XXXXXX

Report generation date: XXXX-XX-XX

Data Managed by TSM Suite for Unified Recovery
TB within all Non-PT PRIMARY storage pools: 5.83
TB within all CONTAINER storage pools: 1.32

*----------------- Deduplication Benefits ----------------*
TSM Data deduplication resulted in
TB within all Non-PT PRIMARY storage pools being excluded from measurement: 36.78
TB within all CONTAINER storage pools being excluded from measurement: 4.69

*----------------- Notes and Explanations ----------------*

5. To obtain the total capacity, add the following values: "TB within all Non-PT PRIMARY storage pools" and "TB within all CONTAINER storage pools." In a system with multiple IBM Spectrum Protect (Tivoli Storage Manager) servers, repeat Step 4 for each server. To use the tool for other servers, update the input parameters.

6. To determine how much entitlement is required for ProtecTIER primary storage pools, open the ProtecTIER Manager graphical user interface and obtain the following values from the utilization reports:

A: Physical total space
B: Nominal replication
C: Data deduplication ratio

Then, use the following formula to determine the usable physical capacity minus the ProtecTIER based replication:
A - (B/C) = PTC

PTC is the IBM Spectrum Protect (Tivoli Storage Manager) ProtectTIER entitlement capacity.

Repeat this step for each ProtecTIER device that is used in the storage environment.

Exception: If any ProtectTIER devices are used entirely as replication targets, do not include them when you calculate the entitlement.

Then, add the PTC values to obtain the total ProtectTIER capacity measurement for your environment. For example, if you have four ProtecTIER systems, add the values from each system to obtain the total:

PTC1 + PTC2 + PTC3 + PTC4 = Total PTC

Limitations and restrictions

The following limitations and restrictions apply:
  • The Capacity Measurement Tool cannot be used with Tivoli Storage Manager Version 5 because of limitations on the SQL capability of Tivoli Storage Manager V5.
  • The Capacity Measurement Tool cannot be used to obtain information about data in ProtecTIER primary storage pools.
  • The Capacity Measurement Tool is designed to report the in-use primary storage pool capacity on an IBM Spectrum Protect (Tivoli Storage Manager) server. The results from the Capacity Measurement Tool might differ from other QUERY command output, in particular, the output from the QUERY AUDITOCCUPANCY command. The differences in reported values are expected, and are caused by differences in database data and differences in algorithms that are used to derive this data.

How data is measured

The process measures data in the following way:

· Measures the amount of deduplicated data in a deduplicated primary storage pool where IBM Spectrum Protect (Tivoli Storage Manager) has deduplicated data. This measurement shows the cost efficiency of using data deduplication when the number of terabytes in the primary storage pools is reduced.
· Measures the amount of deduplicated data in a primary storage pool that is stored in ProtecTIER virtual tape libraries in which IBM Spectrum Protect (Tivoli Storage Manager) has deduplicated data. This measurement shows the cost efficiency of using ProtecTIER data deduplication when the number of terabytes in primary storage pools is reduced.
· Excludes copy pool and active data pools. These are copies of primary storage pools and are not measured for capacity-reporting purposes.
· Excludes data from IBM Spectrum Protect HSM for Windows (Tivoli Storage Manager HSM for Windows) and IBM Spectrum Protect for SharePoint (Tivoli Storage Manager for SharePoint). These products are sold on a PVU basis and are not included in IBM Spectrum Protect Suite (Tivoli Storage Manager Suite for Unified Recovery).
· Measures virtual volume source data, excluding target data. A source server can store the results of database backups, export operations, storage-pool operations, and the output of the DRM PREPARE command on an IBM Spectrum Protect (Tivoli Storage Manager) target server. The data is stored as virtual volumes. In server queries, virtual volume data appears in primary storage pools on both the target server and the source server. The data that is stored on the target server is a disaster recovery copy, which is not measured.
· Excludes data that is replicated by IBM Spectrum Protect for Workstations (Tivoli Storage Manager FastBack) to IBM Spectrum Protect (Tivoli Storage Manager), and excludes data that was backed up from an IBM Spectrum Protect for Workstations (Tivoli Storage Manager FastBack) server by using an IBM Spectrum Protect (Tivoli Storage Manager) client. This data represents a copy of data on the IBM Spectrum Protect for Workstations (Tivoli Storage Manager FastBack) server that is already measured.
· Excludes other duplicated data. Other duplicated data represents data that is reported in primary storage pools. This is a copy of data that is already stored by other means. For example, the table of contents for a backup set is stored in a primary storage pool. The table of contents is metadata that describes the data in a backup set. Therefore, this data is excluded from the measurement.
· Excludes data from client nodes that are configured as REPL_MODE of RECEIVE or SYNCRECEIVE on the target server where IBM Spectrum Protect (Tivoli Storage Manager) is configured to perform server-to-server replication.

Document information

More support for: IBM Spectrum Protect
Server

Software version: 7.1, 7.1.3, 7.1.4, 7.1.5, 7.1.6, 7.1.7, 8.1, 8.1.1, 8.1.2

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Software edition: All Editions

Reference #: 1647140

Modified date: 23 September 2014