Sun StorageTek Backup Manager Installation Guide
|
|
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:
- Sun StorageTek Backup Manager for x86
- Sun StorageTek Backup Manager for SPARC
- Sun StorageTek Backup Manager TSM Agent for Windows
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:
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:
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.
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
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:
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.
Sun StorageTek Backup Manager Installation Guide
|
820-2327-10
|
|
Copyright © 2007, Sun Microsystems, Inc. All Rights Reserved.