C H A P T E R  2

Installing the Software

This chapter describes how to install the software. It contains the following sections:


About the Software Installation CDs

The Sun StorageTek Backup Manager Installation software is distributed on three CDs:

The CDs for x86 and SPARC platforms include the following files and directories in the CD root directory:


TABLE 2-1 Sun StorageTek Backup Manager CD Layout

File or Directory Name

Contents

.version

Build version file

De-Installer.pl

De-Installer script

Installer.pl

Installation script

Pre-installer.pl

Prerequisite installation script

webapp directory

Web application software

utils directory

Utilities used during installation

postgresql directory

PostgreSQL database software

sbmjre directory

JDK which will be accessed by the SBM instance of the GlassFish server

pkg directory

Installation packages for both the infrastructure and data acquisition agents

dbSchema directory

Sun StorageTek Backup Manager database software

doc directory

Sun StorageTek Backup Manager documentation


The Sun StorageTek Backup Manager TSM Agent for Windows CD contains the executable file (setup.exe ) in the root directory.


Before You Begin

Before installing the product, complete the planning worksheets. You will have all the information required as you step through the installation process.

See Planning Worksheets.



Tip - Set the UNIX output window to the maximum number of lines allowed to ensure you can view all the command responses during the installation process.


SBM Installation Requirements

TABLE 2-2 lists the Sun StorageTek Backup Manager installation requirements, including prerequisites for tape libraries and backup master servers. See the release notes for updated support information.


TABLE 2-2 Sun StorageTek Backup Manager Installation Requirements

Installation Component

Version Information

Operating System: UNIX

Software

  • Solaris 10 11/06 Operating System (minimum) SPARC
  • Solaris 10 11/06 Operating System (minimum) x86

Hardware

  • 2 CPUs
  • 2 GB RAM
  • Minimum of 5 GB available disk space

Operating System: Windows

[Applicable to TSM Backup Agent only]

Software

Windows 2003 Standard or Enterprise Edition (recommended) w/ SP1

Windows 2003 Standard x64 or Enterprise x64 Edition (recommended) w/ SP1

Hardware

  • 1 CPU (1 GHz or higher)
  • 1 GB RAM
  • 500 MB available disk space

Database Server: PostgreSQL

PostgreSQL 8.2.3 (64-bit)

Web Application Server: GlassFish

  • Sun Java System Application Server Platform Edition 9.1
  • Sun recommended patch cluster, available on SunSolve (http://sunsolve.sun.com/pub-cgi/show.pl?target=patchpage)
  • See the GlassFish document at: https://glassfish.dev.java.net/nonav/javaee5/docs/SJSASEERN.pdf

Note: The SBM application requires jdk-1_5_0_09 (SPARC) or jdk-1_5_0_11 (x86) and is installed during preinstallation.

Tape Library:
STK Agent

Supported Tape Library Models:

  • L20, L40, L80, L180, L700, L700e, L1400

Library Prerequisites:

  • Version 1.0 & 2.0 of the SUN StorageTek SNMP MIB
  • Requires version 2.11.01 or higher firmware on L20/L40/L80 libraries
  • Requires version 3.01.02 or higher firmware on L180/L700/L1400 libraries
  • SNMP enabled on the library
  • Network connectivity to the library

Tape Library:
ACSLS Agent

Supported Tape Library Models:

  • L5500
  • PowderHorn 9310
  • SL500 (requires ACSLS 7.1)
  • SL8500 (requires ACSLS 7.1)

Library Prerequisites:

  • Version 6.0/7.0/7.1 on Solaris 9/10 ACSLS API
  • Agent cannot be installed on ACSLS server or backup application server
  • Network connectivity to ACSLS server

Backup Software:
Legato Agent

Backup Application:

  • NetWorker 6.1, 7.0 (Windows)
  • NetWorker 6.1, 7.0-7.3 (Solaris)

Backup Server Platforms:

  • Solaris 8/9/10
  • Windows 2000 /2003

Backup Server Prerequisites: (Refer to Appendix B)

  • Network connectivity to master backup server (For example, you can use RSH/SSH to connect the agent remotely to the master server.)

Backup Software: NetBackup Agent

Backup Application:

  • Netbackup 5.x & 6

Backup Server Platforms:

  • Solaris 8/9/10
  • Windows 2000/ 2003

Backup Server Prerequisites: (Refer to Appendix B)

  • Network connectivity to the master backup server (For example, you can use RSH/SSH to connect the agent remotely to the master server.)

Backup Software:
TSM Agent

Backup Application:

  • TSM 5.2, 5.3

Backup Server Platforms:

  • Solaris 10
  • Windows 2000/2003 server

Note: The TSM Agent runs on a Windows server and communicates with backup server platforms that run Solaris 10 and Windows and 2000/2003.a

Backup Server Prerequisites: (Refer to Appendix C)

  • Network connectivity to the TSM server
  • Configured ODBC Data Source Name (DSN) on the Windows server
  • Obtained a valid login and password on the TSM server with permissions the TSM agent can use to log into and issue queries for each TSM database connection

Web Client:
UNIX

Hardware

  • Solaris 10 11/06 Operating System (minimum) SPARC
  • Solaris 10 11/06 Operating System (minimum) x86

Software

  • Mozilla 1.4 and above
  • Netscape 6.2 and above
  • FireFox 1.0 and above

Web Client:
Windows

Operating System

  • Windows 98, Windows XP, Windows 2000, Windows Server 2003

Software

  • Internet Explorer 5.5 and above
  • Mozilla 1.4
  • FireFox 1.0 and above
  • Netscape 6.2 and above

 


Installing Prerequisite Components

Before you install the Sun StorageTek Backup Manager software, you must install the prerequisite software components on the SBM server.



Note - The prerequisite components are only required for the Solaris platform.


TABLE 2-3 lists the Sun StorageTek Backup Manager preinstallation requirements.


TABLE 2-3 Preinstallation Component Requirements

Application

Version

PostgreSQL Database Server

PostgreSQL 8.2.3 (64-bit)

GlassFish Web Application Server

Sun Java System Application Server Platform Edition 9.0_01 (build b02-p01) jdk 1.5


The following procedures are contained in this section:

Running the Preinstallation Script

1. Log in as root on the server where you want to install SBM.

2. Insert the SBM preinstallation CD into a local drive.

If the compressed installation files do not appear in a directory window:

a. Change to the /cdrom/cdrom0 directory:

cd /cdrom/cdrom0

b. Display the contents of the CD:

ls -l

3. To initiate the Installer program, type:

./Pre-Installer.pl

The following menu is displayed.


Pre-installer is performing environment checking.  Please wait...
Please select component(s) to install.  Select [0] to install All components.
Select [3] once you are done with selection. 
 
        [0] [ ] All Components
        [1] [ ] PostgreSQL Database Server
        [2] [ ] Web Application Server
        [3] [ ] Done Selection
        [4] [ ] Quit the installation.
 
[ [X] Indicates selected option.] 
[ [INSTALLED] indicates the item is already installed on system. ] 
[ Selecting [INSTALLED] item will re-install it. ] 
[ To toggle on/off option press the selected number again. ] 
[ Press [0] to select All Components. 
 
Input :

Each line is written in the following format:

[Menu #] [Selection Status] Component Name [Install Status]

The first time you run the install script, you will notice the Selection Status field (indicated by the brackets [ ] ) is empty. The Install Status field is also empty [ ] if a component is not installed or has been de-installed.

4. To select the component you want to install, type the corresponding number.


If you want to install...

Type this...

All components

0

PostgreSQL Database Server

1

Web Application Server

2


5. Press Return.

An "[X]" is displayed beside the selected component.

6. Repeat Step 4 and Step 5 for each component you want to install.

You can deselect a component by typing its number again.

7. (Optional) To exit the script without installing any components, type 4.

8. When you finish selecting components, type 3 and press Return.

Result: The software initiates the preinstallation process and displays a message indicating the process has completed. The menu displays [INSTALLED] after the name of each component currently installed.

You will be asked the following questions during the installation process.


Question...

Explanation / Action...

Default Value

Pre-installer is creating sbm, sbmdb, and sbmapp unix user accounts.Please enter existing base directory for sbm, sbmdb, and sbmapp login home directories.
Base directory [/export/home]?

Displays if you are running the installer for the first time and the user accounts do not exist. You can:

  • Accept the default location by pressing Enter.
  • Change the default location by entering the new value and pressing Enter.
/export/home
SBM install path [/opt/sbm] ? 

Displays the first time the preinstallation script is run. You can:

  • Accept the default location by pressing Enter.
  • Change the default location by entering the new value and pressing Enter.
/opt/sbm
PostgreSQL listening port [4000] ?

Displays during the PostGreSQL database server installation process. You can:

  • Accept the default port by pressing Enter.
  • Change the default port by entering the new value and pressing Enter.
4000
Do you agree to the above license terms? [yes or no]

Displays during the Web Application Server installation process.

You must agree to accept the Binary Code License Agreement to continue with the installation. Type: yes.

Note: If you do not accept the agreement, the application will exit the installation.

 

Accept or Decline? [A,D,a,d]

Displays during the Web Application Server installation.

You must accept the GlassFish Software License Agreement to continue with the installation. Type either "A" or "a".

Note: If you do not accept the agreement, the application will exit the installation.

 


Reviewing the Preinstallation Log Files

The installation process creates log files to support the PostgreSQL database and web application server installations. The third party vendor also creates a log file. You can review these files to verify or troubleshoot the preinstallation.

Web Application Server Log File

To access the web application server log file, go to the following directory:

SBM_install_path/sbmapp/log/SBMAPP_PreInstall_log

To access the server log file, go to the following directory.

SBM_install_path/sbmapp/glassfish/domains/domain1/log/server.log

PostgreSQL Database Server Log File

To access the database log file, go to the following directory:

SBM_install_path/sbmdb/log/SBMDB_PreInstall_log

To access the server log file, go to the following directory.

SBM_install_path/sbmdb/postgresql/log/server.log

Verifying the Preinstallation of SBM Components

You must verify that each of the components was installed successfully.

PostgreSQL Database Server

TABLE 2-4 describes how to verify the database server was installed successfully.


TABLE 2-4 PostgreSQL Database Server Installation Verification Procedure

Step

Verify...

Action

1.

Install package ran successfully and the database server is running.

To display the PostgreSQL status, type:

# svcs postgresql:sbm
 

Command Output:

STATE dddSTIME    FMRI 
online dd1:28:10ddsvc:/application/sbm/database/postgresql/sbm
 
Note: The database server is controlled by the Service Management Facility (SMF).

2.

PostgreSQL data directory exists.

To display the status of the directory, type:

svcprop -p sbmpg/data postgresql:sbm
 

Command Output:

/SBM_install_path/sbmdb/postgresql/data

Web Application Server

TABLE 2-5 describes how to verify the SBM database was installed successfully.


TABLE 2-5 Web Application Server Installation Verification Procedure

Step

Verify...

Action

1.

Web Application Server Admin site is accessible.

From a browser, type:

http://SBM_Server:4848

This may take a few minutes the first time you launch this site.



Installing the SBM UNIX Components

The Sun StorageTek Backup Manager (SBM) installation process requires that you install three major components: the SBM database, web server, and agents.


TABLE 2-6 SBM Installation Components

Component

Description

SBM Database

Stores the collected device information.

SBM Web Server

Provides the user interface.

SBM Agents

Collects the data. There are three agent components:

  • Infrastructure Agents - Collects the information from the lower-level device agents and passes them to the database.
  • Data Acquisition Agents - Collects data from backup applications and tape libraries. SBM supports one agent per supported device. You decide which agents to install based on what devices you want to monitor.
  • Agent Util package - Provides additional tools used by the SBM application.

You can install the Sun StorageTek Backup Manager software on a SPARC or x86 system running the Solaris 10 Operating System.



Note - Before continuing, please verify the prerequisites are installed. For information, see SBM Installation Requirements and Installing Prerequisite Components.


The following procedures are contained in this section:

Running the Installation Script

1. Log in to the Solaris OS as root.

2. Insert the SBM installation CD into a local drive.

3. Change to the /cdrom/cdrom0 directory:

cd /cdrom/cdrom0

4. Display the contents of the CD:

ls -l



Note - For a list of the CD contents, see Sun StorageTek Backup Manager CD Layout.


5. To initiate the Installer program, type:

./Installer.pl

The "Installation Menu" is displayed.


Please select component(s) to install.  Select [0] to install All Components. Select [11] once you are done with selection. 
      [0] [ ] All Components 
       [1] [ ] Database Instance and Schema 
       [2] [ ] Web Application 
       [3] [ ] All Infrastructure and Device Agents
               [4] [ ] SBM Agent Util package
               [5] [ ] SBM Routing Agent package
               [6] [ ] SBM Aggregator package
               [7] [ ] SBM ACSLS Agent package
               [8] [ ] SBM Legato Agent package 
               [9] [ ] SBM Netbackup Agent package
               [10] [ ] SBM STK Agent package
       [11] [ ] Done Selection 
       [12] [ ] Quit the installation. 
=========================== MENU HELP ===========================
[ [X] indicates selected option. ] 
[ [INSTALLED] indicates the item is already installed on system. ] 
[ Selecting [INSTALLED] item will re-install it. ] 
[ To toggle on/off option press the selected number again. ] 
[ Press [0] to select All Components.  Press [3] to select All agent sub-components. ] 
 
Input :



Note - The TSM agent does not display in the list of agents. The TSM agent must be installed on the Windows operating system. For more information, see Installing the TSM Agent.


Each line is written in the following format:

[Menu #] [Selection Status] Component Name [Install Status]

The first time you run the install script, you will notice the Selection Status field (indicated by the brackets [ ] ) is empty. The Install Status field is also empty [ ] if a component is not installed or has been de-installed.

6. To select a component you want to install, type the corresponding number.


To install...

Type this...

All components

0

Database Instance and Scheme

1

Web application

2

All agents

3

Agent Util package

4

SBM Routing Agent

5

SBM Aggregator

6

SBM ACSLS Agent

7

SBM Legato Agent

8

SBM Netbackup Agent

9

SBM STK Agent

10


You must install at least one agent.

The minimum installation requires that you install components #1, #2, #4, #5, and #6 from the Installation Menu.



Note - The first time you install an agent, you must also install the Agent Util package. You only need to install this package once.


7. Press Return.

An "[X]" is displayed beside the selected component.

8. Repeat Step 6 and Step 7 for each component you want to install.

You can deselect a component by typing its number again.

9. (Optional) To exit the script without installing any components, type 12.

10. When you finish selecting components, type 11 and press Return.

Result: The software initiates the installation process and displays a message indicating when the process has completed. The Installation Menu displays "[INSTALLED]" after the name of each component currently installed.

Reviewing the Installation Log Files

The SBM installation process creates log files to support the database and web application installations. Log files are not produced for agent installations.

You can review these files to verify or troubleshoot the installation.

SBM Web Application Log File

To access the SBM web application log file, go to the following directory:

SBM_install_path/sbmapp/log/SBMAPP_Install_log

SBM Database Log File

To access the SBM database log file, go to the following directory:

SBM_install_path/sbmdb/log/SBMDB_Install_log

Verifying the Installation of SBM Components

You must verify that each of the components was installed successfully.

SBM Database

TABLE 2-7 outlines the tasks required for verifying the SBM database was installed successfully.


TABLE 2-7 SBM Database Installation Verification Procedure

Step

Verify...

Action

1.

Install package ran successfully.

Review install output (on the screen) and verify the following message is displayed:

executing install_opt_1 is done...

2.

LD_LIBRARY_PATH environmental variable is initialized to point to the location of the libpq.so library.

Using the account you are currently logged into, type:

echo $LD_LIBRARY_PATH
 

Command Output:

/opt/sbm/sbmdb/postgresql/lib
 

If the variable is not initialized and does not return the result above, temporarily log in to the user account.

From the command line, type:

su - sbmdb
echo $LD_LIBRARY_PATH

 

Command Output should now display:

/opt/sbm/sbmdb/postgresql/lib

3.

SBM database instance is accessible.

From the command line, type:

/opt/sbm/sbmdb/postgresql/bin/psql -h host_name -p port_number -U bbuser -d bb

 

where

  • host_name - IP of the local host
  • port_number - To find the port number, type:
ddddsvcprop -p sbmpg/port postgresql:sbm

SBM Web Application

TABLE 2-8 describes how to verify the SBM database was installed successfully.


TABLE 2-8 SBM Web Application Installation Verification Procedure

Step

Verify...

Action

1.

SBM GUI interface is accessible.

From a browser, type:

http://hostname/IP:8080/sbm

This may take a few minutes the first time you launch this site.


Agents

TABLE 2-9 describes how to verify the individual SBM Agent packages were installed successfully.


TABLE 2-9 SBM Agent Package Installation Verification Procedure

Step

Verify...

Action

1.

Agents were installed on the local host.

To see all agents installed on the box, type:

svcs -a | grep sbm\/agent

where

"\/" is typed as back slash "\" followed by the forward slash "/".

Command Output:

online Jun_27 svc:/application/sbm/agents/routingAgent:default
online Jun_27 svc:/application/sbm/agents/acslsAgent:default
online Jun_27 svc:/application/sbm/agents/legatoAgent:default
online Jun_27 svc:/application/sbm/agents/netbackupAgent:default
online Jun_27 svc:/application/sbm/agents/stkAgent:default
online Jun_27 svc:/application/sbm/agents/aggregator:default
v210:obe-70#
 

Note: All agents are controlled by the Service Management Facility (SMF).

2.

Individual agent package is installed.

Search the command output for "status: completely installed"

Type:

pkginfo -l SUNWsbmagent name

Note: The following example output displays for the STK Library agent. You must repeat this step for each agent you install.

 
Command Output:
   PKGINST:  SUNWsbmstk
      NAME:  Sun STK Library Agent
  CATEGORY:  application
      ARCH:  sparc
   VERSION:  prod-1.0.9-qa
   BASEDIR:  /opt/sbm
    VENDOR:  Sun Microsystems, Inc.
      DESC:  Agent binaries and support files for monitoring STK Library
Environments
    PSTAMP:  qabuild@sbur-bldsol01-20070619
  INSTDATE:  Jun 27 2007 11:33
    STATUS:  completely installed
     FILES:       13 installed pathnames
                   3 shared pathnames
                   7 directories
                   5 executables
               10277 blocks used (approx)


Installing the Windows Application Components

The IBM Tivoli Storage Manager (TSM) agent can only be installed on the Windows platform.

Before you install the TSM agent:

The following procedures are contained in this section:

TABLE 2-10 lists the installation requirements for the Windows operating system and TSM backup agent.


TABLE 2-10 TSM Installation Requirements for Windows

Category

Version

Windows Operating System

Software

Windows 2003 Standard or Enterprise Edition (recommended) with SP1

Windows 2003 Standard x64 or Enterprise x64 Edition (recommended) with SP1

Hardware

  • 1 CPU (1 GHz or higher)
  • 1 GB RAM
  • 500 MB available disk space

Backup Software

Backup Application:

  • TSM 5.2 , 5.3

Backup Server Platforms:

  • Solaris 10
  • Windows 2000/2003 server

Prerequisites: (Refer to Appendix C)

  • Network connectivity to the TSM server
  • Configured ODBC Data Source Name (DSN) on the Windows server
  • Obtained a valid login and password on the TSM server with permissions the TSM agent can use to log into and issue queries for each TSM database connection

When you have met the ODBC requirements described in TABLE 2-10 and completed the TSM Server Worksheet", you are ready to install the TSM Agent.

Installing the TSM Agent

1. On a Windows system, insert the Sun StorageTek Backup Manager Windows Installation CD into the CD-ROM drive.

2. From the CD-ROM drive, double-click the setup.exe file.

3. From the "Welcome to the Install Wizard for Sun Microsystems TSM Agent" screen, click Next.

4. From the License Agreement screen, click "I accept" to accept the terms of the software license agreement.

5. Click Next.

6. Modify the User Name and Organization.

7. Click Next.

8. Modify the Destination Folder details.

If you want to change the default destination, click Change and browse through the directory list until you find the correct location. Click Next to continue with the installation.

9. Click Install.

Once the installation is complete the "Enter Text" screen appears.

10. Modify the SBM server IP address entry for the Routing Agent to which the TSM agent will talk.

11. Click Next.

12. Click Finish.

Result: The TSM agent is installed on the Windows server. The agent runs from the Windows server, but stores the data on the SBM server.

Verifying TSM Agent Installation

1. Verify the TSM Agent software exists in the following directory:

C:\Program Files\Sun Microsystems\SBM\Agents\Sun TSM Agent

2. Verify the Sun TSM Agent service is in the list of services.

a. From the Windows desktop, click Start.

b. Go to Control Panel > Administrative Tools > Services.

c. Scroll down the list of services for "Sun TSM Agent" and verify the following settings.


Field...

Value...

Startup Type

Automatic

Status

<blank>


d. Close the Services dialog box.

3. Start the TSM Agent service.

The status of the service changes to Started.


Next Steps

1. After the agents have been installed, verify you have completed the tasks listed in TABLE 2-11.


TABLE 2-11 Installation Verification Checklist

Verify Task is complete...

Where to find procedures...

Tape library and backup software prerequisites are met

PostgreSQL database server and GlassFish web application server are installed

SBM database, SBM web application, and SBM agents are installed


2. Set up agent connectivity with the backup master server and tape libraries as outlined in TABLE 2-12.


TABLE 2-12 Agent Connectivity Checklist

Task...

Where to find procedures...

Set up network connectivity between the SBM server and UNIX or Windows backup master servers

Set up network connectivity between the SBM server and the TSM server

Verify network connectivity exists between the SBM server and tape libraries

  • Verify that SNMP is configured and running for each tape library

3. After you set up and verify network connectivity for each agent, log in to the SBM browser interface and perform the initial configuration as described in Chapter 3.