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.
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.
To prepare for the ITSM installation:
- Log in as root with your system password.
- Create a temporary directory for the installation files, and change
directory (
cd) into it:# mkdir /tsmtemp
# cd /tsmtemp - 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
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.
***********************************************************
|
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.
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.
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.
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
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
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
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.
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
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
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.
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.
- The Tivoli software
from IBM page is an excellent starting point for all sorts of
information on Tivoli products and services. See also the IBM Tivoli
Storage Manager, the Tivoli
Storage Manager for Linux, and
New to Tivoli pages.
- Download a copy of IBM Tivoli
Storage Manager and see the benefits of this powerful storage
management software tool in your environment.
-
IBM
Tivoli Storage Manager for Linux Quick Start,
IBM
Tivoli Storage Manager for Linux Administrator's Reference,
IBM
Tivoli Storage Manager for Linux Storage Agent User's Guide, and
IBM Tivoli Storage Manager for UNIX:
Backup-Archive Clients Installation and User's Guide all
offer excellent in-depth installation and usage
instructions for new and experienced users of TSM.
For troubleshooting, see the
Tivoli Storage Manager support page.
- The Tivoli
for Linux on PowerPC Release Notes (in PDF format) also cover
troubleshooting as well as installation and upgrade information.
- The IBM Redbooks IBM
Tivoli Storage Resource Manager: A Practical Introduction and IBM Tivoli
Storage Resource Manager: A Technical Introduction are both available
online in html or PDF versions.
- The developerWorks Linux zone has articles on installing Linux on
iSeries and on pSeries.
- Find more resources about Tivoli in the developerWorks
Tivoli zone.
- Find more resources for Linux developers in the developerWorks Linux
zone.

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.




