Installing IBM Tivoli Storage Manager on Linux for iSeries and pSeries

Hints and tips for getting IBM Tivoli Storage Manager for Linux up and running on Power Architecture

This article offers installation basics, as well as steps to get you started with backing up and restoring your IT environment effortlessly using the IBM Tivoli® Storage Management (ITSM) server on Linux® for IBM eServer™ iSeries® and pSeries® servers.

Hans-Dieter Wehle, e-business Architect, IBM Developer Relations

Hans-Dieter Wehle Hans-Dieter is an e-business architect for IBM's Developer Relations group. He is a member of the IBM EMEA Technical Marketing Competence Center and Linux Center of Competence in Boeblingen, Germany. Hans-Dieter has more than 15 years of experience in the computer industry, ranging from field support to software development and consulting.



30 June 2004

This article covers the basics of installing and starting a simple IBM Tivoli Storage Management (ITSM) server for backing up and restoring your IT environment. While it discusses the general aspects of running a TSM server, it does not cover the TSM client in detail. Rather, it enables you to install the server environment on your machine so that you can begin exploring the Tivoli environment, and have a functional server running so that you can begin customizing it while you learn more from the additional documentation listed in Resources later in this article.

Introducing IBM Tivoli Storage Manager

As part of the TotalStorage Open Software family, IBM Tivoli Storage Manager protects your organization's data from hardware failures and other errors by storing backup and archive copies of data on offline storage.

Get the products and tools used in this article

If you are a developerWorks subscriber, you have a single user license to use Tivoli Storage Manager and other DB2®, Lotus®, Rational®, Tivoli, and WebSphere® products -- including the Eclipse-based WebSphere Studio IDE -- to develop, test, evaluate, and demonstrate your applications.

IBM Tivoli Storage Manager's core functions include data backup and restore, managed data archive and retrieve, protection for 24x365 business-critical applications, and support for small tape libraries.

IBM Tivoli Storage Manager includes extensive and flexible centralised management, customisable and complete automation, broad cross-platform and storage device support, and smart data-transfer and store technologies. These capabilities allow IBM Tivoli Storage Manager to scale up to manage, administer, and automate data protection for any size organisations.

To begin exploring TSM's many capabilities, we will install the server software.

At the time of this writing, SUSE Linux SLES 8 for iSeries and pSeries is the only certified distribution for TSM with Linux on POWER-based systems.


Installing the TSM server software

As mentioned, these installation steps will get you up and running quickly, so you can begin exploring ITSM on Linux on POWER on your own.

Installing TSM

To prepare for the ITSM installation:

  1. Log in as root with your system password.
  2. Create a temporary directory for the installation files, and change directory (cd) into it:

    # mkdir /tsmtemp
    # cd /tsmtemp

  3. Copy the tar installation file to the temporary directory. For example:

    # cp /labfiles/tsmv5/TIVtsm.tar /tsmtemp
    # tar -xvf TIVtsm.tar

For server installation, the following packages are now in the directory .../tsm/ppc64:

TIVsm-license-5.2.0-0.ppc64.rpm
TIVsm-server-5.2.0-0.ppc64.rpm
TIVsm-license_keys-5.2.0-0.ppc64.rpm
TIVsm-tsmscsi-5.2.0-0.ppc64.rpm

Additional packages like these are in ../noarch:

TIVsm-webadmin-5.2.0-0.noarch.rpm
TIVsm-webhelp.de_DE-5.2.0-0.noarch.rpm
TIVsm-webhelp.en_US-5.2.0-0.noarch.rpm
TIVsm-webhelp.es_ES-5.2.0-0.noarch.rpm

Installing packages

Use the following command for a standard installation:

# cd tsm/ppc64
# ./rpm -ivh TIVsm-license-5.2.0-0.ppc64.rpm \ TIVsm-license_keys-5.2.0-0.ppc64.rpm TIVsm-server-5.2.0-0.ppc64.rpm

Information similar to Listing 1 below is displayed. Note that, by default, the TSM Server installs under /opt/tivoli/tsm/server/bin. To install to a different file system, specify the --prefix option on the rpm command. For example:

rpm -ivh --prefix /usr TIVsm-server-5.2.0-0.ppc64.rpm

This rpm command installs the TSM server in /usr/tivoli/tsm/server/bin. For other non-standard installation procedures, see the Linux Quick Start and other documents listed in Resources.

Listing 1. Installing TSM server-rpms
TIVsm-license ##################################################
TIVsm-license_keys ##################################################
TIVsm-server ##################################################

Allocated space for db.dsm: 17825792 bytes
Allocated space for log.dsm: 9437184 bytes
Tivoli Storage Manager for Linux/ppc64
Version 5, Release 2, Level 0.0

      Licensed Materials - Property of IBM
      (C) Copyright IBM Corporation 1990, 2003. All rights reserved.
      U.S. Government Users Restricted Rights - Use, duplication or
disclosure
      restricted by GSA ADP Schedule Contract with IBM Corporation.
      ANR7800I DSMSERV generated at 10:28:25 on Jun 13 2003.
      ANR7801I Subsystem process ID is 32092.
      ANR0905W Options file dsmserv.opt not found.
      ANR0300I Recovery log format started; assigned capacity 8 megabytes.
      ANR0301I Recovery log format in progress; 4 megabytes of 8.
      ANR0301I Recovery log format in progress; 8 megabytes of 8.
      ANR0302I Recovery log formatting took 19 milliseconds.
      ANR0303I Format rate: 107789.5 pages/second.
      ANR0304I Page service time: 0.0 ms.

<*SNIP*>

BACKUPPOOL (device class DISK).
ANR1305I Disk volume /opt/tivoli/tsm/server/bin/backup.dsm varied online.
ANR2206I Volume /opt/tivoli/tsm/server/bin/archive.dsm defined in storage
pool
ARCHIVEPOOL (device class DISK).
ANR1305I Disk volume /opt/tivoli/tsm/server/bin/archive.dsm varied online.
***********************************************************
IMPORTANT: Read the contents of file /README
for extensions and corrections to printed
product documentation.
***********************************************************

Installing TSM webadmin

Now you can also install TIVsm-webadmin-5.2.0-0.noarch.rpm, which is needed for management of the Storage Manager server via a browser interface. It is located in the noarch directory:

# rpm -ivh TIVsm-webadmin-5.2.0-0.noarch.rpm

This outputs:

Listing 2. Installing TIVsm-webadmin
# rpm -ivh TIVsm-webadmin-5.2.0-0.noarch.rpm

TIVsm-webadmin ##################################################

Tivoli Storage Manager for Linux/ppc64
Version 5, Release 2, Level 0.0
Licensed Materials - Property of IBM
(C) Copyright IBM Corporation 1990, 2003. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corporation.
ANR7800I DSMSERV generated at 10:28:25 on Jun 13 2003.
ANR7801I Subsystem process ID is 184.
ANR0900I Processing options file dsmserv.opt.
ANR0990I Server restart-recovery in progress.
ANR0200I Recovery log assigned capacity is 8 megabytes.
ANR0201I Database assigned capacity is 16 megabytes.

<*SNIP*>

ANR4991I Auditing Interface Driver Tasks.
ANR4992I Auditing Interface Driver Task Members.
ANR4989I Auditing Interface Driver Operations.
ANR4990I Auditing Interface Driver Operation Parameters.
ANR4982I Interface Driver audit completed - definitions are consistent.

After this installation step, your default server directory (/opt/tivoli/tsm/server/bin) contains:

  • Storage pool volumes (backup.dsm, archive.dsm, spcmgmt.dsm)
  • Database volume (db.dsm)
  • Recovery log volume (log.dsm)
  • Server and licensing

Now you need to edit the /opt/tivoli/tsm/server/bin/dsmserv.opt file and add the lines shown in the sample below. Change into /opt/tivoli/tsm/server/bin/ and open the file dsmserv.opt in your favorite text editor:

*** IBM TSM Server options file
*** Refer to dsmserv.opt.smp for other options
COMMMETHOD TCPIP
COMMMETHOD HTTP
TCPPORT 1500
HTTPPORT 1580
DEVCONFIG devcnfg.out

You will need to add the lines COMMETHOD HTTP and HTTPPORT 1580 to handle the ITSM server via browser.

And the installation is done! You can begin exploring the environment to confirm the installation and register some users.


Exploring the TSM environment

To start the TSM server, enter:

cd /opt/tivoli/tsm/server/bin
#./dsmserv

To verify your installation, type in the following command at the server console:

TSM:SERVER1>q status

Here, the q flag stands for "query," and status shows the TSM server status.

Upon running the command, you will see the current status of your TSM server.

For help, typing the command help will show TSM administration commands.

Registering an administrator

To register an administrative user, enter the following at the server console (where uadmin is the user id, and padmin is the password):

TSM:SERVER1> register admin uadmin padmin

Check the registration with the command:

TSM:SERVER1> q user

Listing 3. Checking the registration
TSM:SERVER1>
q user
ANR20171 Administrator SERVER_CONSOLE issued command: QUERY USERID


Administrator	Days Since	Days Since	Locked? 	Privilege
Name		Last Access	Password Set			Classes
-------------	-----------	------------	-------		---------
ADMIN			  1		   1	  No		System
SERVER_CONSOLE					  No		System
UADMIN			 <1		  <1	  No

As shown in Listing 3, the administrator user udamin has no Privilege Classes. Authorize the user udamin to join the TSM administrator Privilege Class by issuing a grant command:

TSM:SERVER1> grant authority uadmin classes=system

Now you have a new administrator to handle your environment.


Exploring the TSM server

Use a browser to open the TSM Web administrator console. By default, the TSM Web console is installed on port 1580:

#URL:http://"yourhostname":1580/

You will see the standard login screen, where you can log in with the uadmin/padmin combo you specified earlier. Once you are logged in, TSM will open to the TSM admin screen, where you can configure various TSM options. The menu for exploring these options is on the left.

Figure 1. ITSM admin screen
Figure 1. ITSM admin screen

TSM client registration

To register any additional backup-archive clients, click Clients > Client Nodes.

To register a new node, click Operations, and the screen to register a new node appears.

Figure 2. Registering a new node
Figure 2. Registering a new node

Fill in the node name, password, and contact information; then press the Finish button. Now your client node can access the TSM server environment.

Figure 3. New node form
Figure 3. New node form

Working with the TSM database

The first-time installation procedure creates a default 17-MB database volume (db.dsm).

From the Web console, click Objectview > Database to start monitoring the TSM database.

From this screen, you have different operations options such as Back up database, Extend, Reduce, and so on. Click the Operations pull-down menu.

The database size is largely determined by the number of client files being stored on the server storage.

As you add clients, you may need to increase your database size. The recovery log size may also need to be increased depending on the current utilization. You can do this easily from the Objectview screen.

Working with the TSM log

The first-time installation procedure creates a default 9-MB recovery log volume (log.dsm).

From the Web console, click Objectview > Recovery Log to begin monitoring the TSM log.

Figure 4. ITSM Recovery log
Figure 4. ITSM Recovery log

Here you have different operations options. Click the Operations pull-down menu.

Automating client operations: Defining a TSM client schedule

You can schedule most client operations, such as backup, to begin automatically.

Click Objectview > Automation > Client schedules to open the Client schedules screen.

Click Operations > Define schedule to define a TSM client schedule. The following screen appears:

Figure 5. ITSM Client schedules forms
Figure 5. ITSM Client schedules forms

Type in a schedule name and a description (such as test/test).

Change Day of Week to WEEKDAY, and click Finish. The schedule for the TSM client is now defined for daily backups every weekday, and your TSM node will be managed by the TSM client schedule.

Stopping the TSM server

To shut down the server from the server console, use this command:

TSM:SERVER1> halt

Information similar to Listing 4 is displayed:

Listing 4. Shutting down the server
ANR7822I Thread 21 terminated in response to server shutdown.
ANR7822I Thread 22 terminated in response to server shutdown.
ANR7822I Thread 23 terminated in response to server shutdown.
ANR7822I Thread 24 terminated in response to server shutdown.
ANR7822I Thread 25 terminated in response to server shutdown.
ANR7822I Thread 26 terminated in response to server shutdown.
ANR7822I Thread 28 terminated in response to server shutdown.
ANR7822I Thread 29 terminated in response to server shutdown.
ANR7822I Thread 30 terminated in response to server shutdown.
ANR7822I Thread 31 terminated in response to server shutdown.
ANRO99II Server shutdown complete.

This concludes your brief introduction to the TSM server; keep exploring the left-hand menu and the help pages to learn more. And for thorough tutorials and other resources, see the Resources below.

Resources

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Linux on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Linux, Tivoli
ArticleID=11404
ArticleTitle=Installing IBM Tivoli Storage Manager on Linux for iSeries and pSeries
publish-date=06302004