C H A P T E R  5

Installing the Software on an HP-UX Host

This chapter provides procedures for installing Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, and the Sun StorEdge Command-Line Interface (CLI) on an HP-UX host. Topics covered in this chapter are as follows:


System Requirements

This section lists the system requirements for the HP-UX host.



Note - If you manage storage through the web, you will need Firefox 1.x, Netscape 4.79, or Mozilla 2.1, or later versions of these products. Refer to the Sun StorEdge 3000 Family Configuration Service User’s Guide for details on web-based management.



Installing the Software

Sun StorEdge Configuration Service software includes the following components:



Note - Before installing Sun StorEdge Configuration Service, be sure to read the release notes for your array.




Note - You must be superuser to install Sun StorEdge Configuration Service and run the console.


Upgrading Software - Agent and Console Version Compatibility

Because the communication protocol changes from version to version, you must install both the agent and console when upgrading. If different versions of the agent and console co-exist, Sun StorEdge Configuration Service is not able to discover previously configured arrays.

Installation Packages

The installation packages are contained on the Sun StorEdge 3000 Family Professional Storage Manager CD, and include the following files:

See To Download and Install the Updated Software From the Web Site for steps on how to download the software from the Sun Download Center web site.

Install the agent on each host that is part of Sun StorEdge Configuration Service. Install the console on the computer or workstation you plan to use for managing and maintaining the storage system.

The console can be installed on the host or on any client system. The agent must be installed on the host to which the storage is attached.

Complete the following steps to install the agent, console, or both. You must install at least one agent and one console for the program to run.

If you are upgrading, you must install both the agent and console. If different versions of the agent and console co-exist, Sun StorEdge Configuration Service is not able to discover previously configured arrays.



Note - Sun StorEdge Configuration Service on HP-UX supports Java runtime environment 1.2.2 through 1.5. Make sure that a compatible version of Java runtime environment is installed on the remote login host. If you are not using a remote login host environment, it must be installed on the HP-UX machine on which you are installing Sun StorEdge Configuration Service.



procedure icon  To Download and Install the Updated Software From the Web Site

If the Sun StorEdge 3000 Family Professional Storage Manager CD is not available, you can download the software from the Sun Download Center web site.

1. Go to:

http://www.sun.com/software/download/

2. Under System Administration right arrow Storage Management, click the StorageTek 3000 Family Storage Products - Related Software link.

You are taken to the Sun StorEdge 3000 Family Storage Products - Related Software page.

3. Click Download.

4. If not previously registered, register.

a. Click the Register Now link at the bottom of the left column.

b. On the registration page, enter applicable data in the required fields and click Register.

5. Log in.

a. Type your Username and Password in the left column, and click Login.

b. On the Terms of Use page, read the license agreement, click Yes next to Accept, and click the Continue button.

6. On the software download page, click the link for your array and operating system.

7. In the dialog box that is displayed, specify a destination directory and save the file.

8. Change to the directory that the file was downloaded to and unzip the file.

9. Type:


 cd filename /hpux

where filename is the name of the file that was downloaded.

10. To install the Sun StorEdge Configuration Service agent, type:


# swinstall -s SUNWscsd.depot

11. To install the Sun StorEdge Configuration Service console, type:


# swinstall -s SUNWscsu.depot

The agent is installed in /opt/SUNWsscs/ssagent. The console is installed in /opt/SUNWsscs/sscsconsole.


procedure icon  To Install the Sun StorEdge Configuration Service Agent and Console From the CD

1. If Java runtime environment software is not installed on the computer or workstation on which you are installing Sun StorEdge Configuration Service, install it now.

To check the Java runtime environment software version, type:


# java -version

2. Make sure that a mounting point has been created for the CD.

3. Insert the Sun StorEdge 3000 Family Professional Storage Manager CD.

4. Determine the device entry for the CD:


# ioscan -fnC disk

Note the device entry, for example:


/dev/dsk/c2t5d0

5. Mount the CD on your file system if it is not already mounted:


# mount -r device entry mounting point

6. To install the agent, type:


# swinstall -s /cdrom/product/hpux/SUNWscsd.depot

7. To install the console, type:


# swinstall -s /cdrom/product/hpux/SUNWscsu.depot

The agent is installed in /opt/SUNWsscs/ssagent. The console is installed in /opt/SUNWsscs/sscsconsole.


procedure icon  To Install Sun StorEdge Diagnostic Reporter



Note - You must install the Sun StorEdge Configuration Service agent before installing the Sun StorEdge Diagnostic Reporter agent and Config Tool.




Note - Make sure that Java runtime environment software is installed on the remote login host. The earliest release of Java runtime environment software that is compatible with Sun StorEdge Diagnostic Reporter is 1.2.2. If you are not using a remote login host environment, it must be installed on the HP-UX machine on which you are installing Sun StorEdge Diagnostic Reporter.


1. If you are installing the software from the web site, follow Step 1 through Step 9 in To Download and Install the Updated Software From the Web Site, and then go to Step 6.

2. If you are installing the software from the CD, make sure that a mounting point has been created for the CD.

3. Insert the Sun StorEdge 3000 Family Professional Storage Manager CD.

4. Determine the device entry for the CD:


# ioscan -fnC disk

Note the device entry, for example:


/dev/dsk/c2t5d0

5. Mount the CD on your file system if it is not already mounted.


# mount -r device-entry mounting-point

6. If you installed the software from the web site, to install the agent type::


# swinstall -s SUNWscsa.depot 

If you installed the software from the CD, to install the agent, type:


# swinstall -s /cdrom/product/hpux/SUNWscsa.depot

7. If you installed the software from the web site, to install the Config Tool (UI) type::


# swinstall -s SUNWscui.depot

If you installed the software from the CD, to install the Config Tool (UI), type:


# swinstall -s /cdrom/product/hpux/SUNWscui.depot

The agent is installed in /opt/SUNWsscs/ssdiagreporterd. The Config Tool is installed in /opt/SUNWsscs/ssdiagreporterui.


procedure icon  To Install the Sun StorEdge CLI

The CLI enables you to perform many of the same operations you perform by choosing menu options from the firmware application or Sun StorEdge Configuration Service. CLI commands have the advantage of being scriptable, which is especially useful in large data center environments with many arrays that need to be configured similarly.



Note - Make sure that a logical drive is mapped to the primary controller.


1. If you are installing the software from the web site, follow Step 1 through Step 9 in To Download and Install the Updated Software From the Web Site, and then go to Step 6.

2. Make sure that a mounting point has been created for the CD.

3. Insert the Sun StorEdge 3000 Family Professional Storage Manager CD.

4. Determine the device entry for the CD:


# ioscan -fnC disk

Note the device entry, for example:


/dev/dsk/c2t5d0

5. Mount the CD on your file system if it is not already mounted.


# mount -r device-entry mounting-point

6. If you installed the software from the web site, type:


# swinstall -s SUNWsccli-hpux.depot

If you installed the software from the CD, type:


# swinstall -s /cdrom/product/hpux/SUNWsccli-hpux.depot

The CLI is installed in /opt/SUNWsscs/sbin/sccli.


procedure icon  To Display the Console

You cannot start the console until you set the display to show the console.

1. Specify a name for the remote login host and press Return.

If you are not using a remote login host environment, specify the name of the HP-UX machine:


# xterm -display ipaddress of remote login host:0.0 -title name of remote login host or HP-UX machine

A terminal window is displayed with the name of the remote login host or HP-UX machine you specified in the previous step. This is the terminal window from which you start Sun StorEdge Configuration Service, as described in the Sun StorEdge 3000 Family Configuration Service User’s Guide.

2. Specify the default web browser.

To access online help, Netscape Navigator must be installed on the system on which you are installing the console. Netscape Navigator is usually installed in either /opt/netscape/netscape or /usr/bin/netscape.



Note - You can configure the web browser path name at any time; however, if you do not specify a path name at some point, you cannot access online help.



procedure icon  To Stop or Start the Agents

The Sun StorEdge Configuration Service and Sun StorEdge Diagnostic Reporter agents can be stopped or started manually.



Note - You must be superuser to start the agent.


If you use start without first using stop, the script restarts any agents that have stopped. If all the agents have stopped (as with a stop option), the script reconfigures the runtime environment before restarting the agents.


procedure icon  To Stop or Start the Sun StorEdge Configuration Service Agent

To stop the Sun StorEdge Configuration Service agent, type:


# /sbin/init.d/ssagent stop

To start the Sun StorEdge Configuration Service agent, type:


# /sbin/init.d/ssagent start


procedure icon  To Stop or Start the Sun StorEdge Diagnostic Reporter Agent

To stop the Sun StorEdge Diagnostic Reporter agent, type:


# /sbin/init.d/ssdgrptd stop 

To start the Sun StorEdge Diagnostic Reporter agent, type:


# /sbin/init.d/ssdgrptd start


procedure icon  To Determine Whether Agents are Running

To determine if the agents are running, type:


# ps -e | grep ss

Both ssmon and ssserver are displayed in the output if the Sun StorEdge Configuration Service agent is running. If Sun StorEdge Diagnostic Reporter is running, ssdgrptd is displayed. If you have enabled SNMP trap generation, you also see the name sstrapd.


Users and Passwords

The following sections explain how to create users and passwords.

Administrative (User) Security Levels and Guidelines

If you are running the program on an HP-UX host, administrator security levels are automatically created during the installation process. You only need to set passwords and assign users according to the desired permission level.

Administrative functions require access logins and passwords to prevent the possibility of one administrator reallocating or removing storage resources belonging to other clients and hosts without authorization.

You assign separate passwords for the three levels of security for the program. You do this by setting up three users on the agents that have storage devices that are managed by the program. These three users are automatically added during the installation of the agent.

The security levels must have these exact names:

Represents the monitoring level of the software.

Represents the administration level of the software and provides access to the Rebuild, Parity Check, and Schedule Parity Check functions, as well as monitoring.

Represents the configuration level of the software and gives the installer direct access to the configuration functions and all other related aspects of the program.

These names are required for the three security levels. After installation, you must assign a password to each security name.



Note - User passwords are deleted when Sun StorEdge Configuration Service is uninstalled. If you had a previous configuration, you have to reenter the ssmon, ssadmin, and ssconfig passwords.




Note - In the event that one of these usernames is already in use, either modify the existing username, use one of the other Sun StorEdge Configuration Service usernames, or combine the two roles.


The ssmon, ssadmin, and ssconfig names are logins that correspond only to security levels within the program. For UNIX operating environments, the default shell for these accounts is assigned to /bin/false to prevent the user IDs from being used for interactive logins.

You can set up Sun StorEdge Configuration Service so that monitoring does not require users to type the ssmon password. To do so, select the Auto Discovery option when the hosts are added to the Managed Servers list at the console. You can set up these three logins and passwords locally on each host. (The accounts can have different passwords on each host, if desired.)

Once you have set up these three logins on the agents to be managed, the system administrator typically provides user access to the program by assigning employees appropriate passwords, which are based on the level of security required to complete tasks. For example, everyone who has administration privileges on a particular host is assigned the same password that was established for the user ssadmin.



Note - To add servers to the Managed Servers list, refer to the Sun StorEdge 3000 Family Configuration Service User’s Guide.



procedure icon  To Create Passwords and Permissions

Create a password for each of the new users by typing:


# passwd user-name

You will be prompted to re-enter the password before receiving confirmation.

Administrators might also want to change group permissions, which are defined in the svrlist.dat file located in the /opt/SUNWsscs/sscsconsole directory during installation.

The console is a Java technology-based utility, and as such, cannot provide facilities to control permissions or ownership of files that Sun StorEdge Configuration Service creates. The svrlist.dat file is easily readable by various forms of ASCII text processors. It contains the encrypted password for the user ssmon and can be decrypted.



Note - Do not change the permissions and group ownership of svrlist.dat after adding all agents that are being monitored.



Uninstalling the Software

You must uninstall all components of Sun StorEdge Configuration Service when upgrading to a newer version of the software. Note that some files are not removed because they are created after the installation and are still valid for the upgrade environment.


procedure icon  To Uninstall Sun StorEdge Configuration Service

Use the swremove command followed by the package you want to uninstall, SUNWscsd (agent) or SUNWscsu (console).


# swremove SUNWscsd
# swremove SUNWscsu


procedure icon  To Uninstall Sun StorEdge Diagnostic Reporter

Use the swremove command followed by the package you want to uninstall, SUNWscsa (agent) or SUNWscui (Config Tool).


# swremove SUNWscsa
# swremove SUNWscui


procedure icon  To Uninstall the Sun StorEdge CLI

Use the swremove command to uninstall the CLI.


# swremove SUNWsccli