C H A P T E R  2

Installing the Software on a Solaris Host

The software installation package for a Solaris host includes all the software components for Sun StorEdge 3000 family arrays. This chapter provides procedures for installing Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, and the Sun StorEdge Command-Line Interface (CLI) on a Solaris host. Topics covered in this chapter include:


Before Installing

Before installing the programs, take the following steps:


System Requirements

This section lists the system requirements for the Solaris 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.




Note - For a list of Sun recommended patches, refer to the release notes for your array.



Installing the Software

The software installation package, SUNWsscs, includes the following components:



Note - Before installing the software, be sure to read the release notes for your array.




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


Upgrading Software - Agent and Console Version Compatibility

Because the communication protocol changes from version to version, you must install the SUNWsscs package on all systems that manage the storage 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

Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, and the CLI are included in one installation package, SUNWsscs, that is contained on the Sun StorEdge 3000 Family Professional Storage Manager CD. If the CD is not available, you can download the software from the Sun Download Center web site.

Sun StorEdge Configuration Service offers language support for French, Japanese, Simplified Chinese and Traditional Chinese. TABLE 2-2 specifies which files are required for each language.



Note - Sun StorEdge Configuration Service offers Korean language support for documentation only. The software user interface is in English.




Note - Each language requires that the English installation package be installed first.



TABLE 2-2 Installation Packages for Solaris OS Language Support

English

French

Japanese

Simplified Chinese

Traditional Chinese

SUNWsscs

SUNWfsscs

SUNWjsscs

SUNWcsscs

SUNWhsscs


If you are installing only the English version of the package, follow only the instructions for installing the English package. If you are adding language support, you must install the English version of the package first.

If you are upgrading, you must install the SUNWsscs package on all systems that manage the storage. If different versions of the agent and console co-exist, Sun StorEdge Configuration Service is not able to discover previously configured arrays.



Note - Make sure that Java runtime environment software is installed on the computer or workstation on which you are installing Sun StorEdge Configuration Service. Solaris 9 and Solaris 10 support Java runtime environment 1.2.2 through 1.5.



procedure icon  To Download 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. If you are upgrading, be sure you uninstall earlier versions of Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, and the CLI, including the agents.

Individual software packages have been replaced by one package, SUNWsscs, starting with version 2.0. The individual packages must be removed before you can install SUNWsscs. For details on uninstalling, see Uninstalling the Software.

2. Go to:

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

3. 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.

4. Click Download.

5. 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.

6. 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.

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

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

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

10. Type:


 cd filename/solaris/$ARCH

where filename is the name of the file that was downloaded and $ARCH is either sparc or i386, depending on the Solaris OS platform.

11. Go to and Step 3 in To Install the Software From the CD.


procedure icon  To Install the Software From the CD

1. If you are upgrading, be sure you uninstall earlier versions of Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, and the CLI, including the agents.

Individual software packages have been replaced by one package, SUNWsscs, starting with version 2.0. The individual packages must be removed before you can install SUNWsscs. For details on uninstalling, see Uninstalling the Software.

2. Insert the Sun StorEdge 3000 Family Professional Storage Manager CD and type:


# cd /cdrom/cdrom0/product/solaris/$ARCH

where $ARCH is either sparc or i386, depending on the Solaris OS platform.

3. To install the English package, type:


# pkgadd -d . SUNWsscs

where x is f, j, c or h, depending on what language you are installing. See TABLE 2-2 for package names.

4. Provide appropriate responses to each of the installation prompts.

a. If asked if you want to restore the agent configuration, type y. (If you type n, you will need to re-enable the managing servers.)


The previous configuration was saved. Do you want to restore the configuration [y,n,?,q]: y

b. To continue with the installation, type y and press Return.


Do you want to continue with the installation of <SUNWsscs>[y,n,?] y

After the package is installed, the following message is displayed, indicating it was installed successfully.


Installation of <SUNWsscs> was successful.

The Sun StorEdge Configuration Service components are installed in the following directories:

The Sun StorEdge Diagnostic Reporter components are installed in the following directories:

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

5. If you are using Sun StorEdge Configuration Service and Diagnostic Reporter to manage and monitor the storage, the following additional steps are required.

a. You must set passwords for all Sun StorEdge Configuration Service users.

See Users and Passwords for more information.



Note - User passwords are deleted when Sun StorEdge Configuration Service is uninstalled. You must reenter the ssmon, ssadmin, and ssconfig passwords as described in Users and Passwords.


b. Before starting the Sun StorEdge Configuration Service console, you must run the following command to specify the web browser to access online help.


# /opt/SUNWsscs/sscsconsole/config_sscon 

c. The Sun StorEdge Configuration Service agent and the Sun StorEdge Diagnostic Reporter agent (daemon) have been installed but are not configured to start at boot time by default. To enable the Sun StorEdge Configuration Service agent to start automatically when the system boots, and to start it now, type:.


# /etc/init.d/ssagent enable start

To enable Sun StorEdge Diagnostic Reporter to start automatically when the system boots, and to start it now, type:


# /etc/init.d/ssdgrptd enable start

6. For Sun StorEdge 3310 SCSI and Sun StorEdge 3320 SCSI arrays, edit /kernel/drv/sd.conf if LUNs other than LUN 0 are mapped from the array to the host and an onboard HBA for Sun hosts or third-party HBAs is used for connecting the device.

Add lines for LUNs as appropriate for your configuration. LUNs can be numbered from 0-31. Generally, do not add more LUN definitions than you actually plan to have, since doing so increases the time needed to scan each SCSI bus. For information on modifying the sd.conf file, refer to the Sun StorEdge 3000 Family Installation, Operation, and Service Manual for your SCSI array.

7. If the sd.conf file has been edited, perform a reconfiguration reboot.

If the sd.conf file has not been edited, you do not have to perform a reconfiguration reboot and the agent starts automatically.


procedure icon  To Install a Japanese Version of the Man Page

The CLI for the Solaris host offers a Japanese version of the man page. To install it, insert the Sun StorEdge 3000 Family Professional Storage Manager CD and type:


# pkgadd -d /cdrom/cdrom0/product/solaris SUNWjsccl

Manually Stopping and Starting Sun StorEdge Configuration Service and Sun StorEdge Diagnostic Reporter

During installation, you were provided with steps to start the Sun StorEdge Configuration Service agent and the Sun StorEdge Diagnostic Reporter agent automatically when the system boots. You can also start and stop the agents manually.



Note - You must be superuser to start and stop 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:


# /etc/init.d/ssagent stop

To start the Sun StorEdge Configuration Service agent, type:


# /etc/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:


# /etc/init.d/ssdgrptd stop

To start the Sun StorEdge Diagnostic Reporter agent, type:


# /etc/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.

If the storage system is not being displayed after initial boot, stop the agent, and at the command prompt, run:


# format

Label the desired disks, and then restart the agent.


Users and Passwords

The following sections explain how to create users and passwords for Sun StorEdge Configuration Service.

Administrative (User) Security Levels and Guidelines

If you are running Sun StorEdge Configuration Service on a Solaris 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 levels.

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 login names are required for the three security levels. After installation, you must assign a password to each security name.



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.




Note - User passwords are deleted when Sun StorEdge Configuration Service is uninstalled. You must reenter the ssmon, ssadmin, and ssconfig passwords.


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 servers 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

Individual software packages have been replaced by one package, SUNWsscs, starting with version 2.0. The individual packages must be removed before you can install SUNWsscs. See To Uninstall Earlier Versions of Sun StorEdge Configuration Service and Sun StorEdge Diagnostic Reporter and To Uninstall Earlier Versions of the Sun StorEdge CLI for more information.

To uninstall version 2.0 or later of the software, see To Uninstall Version 2.x of the Software.

If you want to uninstall the Japanese version of the man page, see To Uninstall Version 2.x 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 Earlier Versions of Sun StorEdge Configuration Service and Sun StorEdge Diagnostic Reporter

Use the pkgrm command followed by the package you want to uninstall.



Note - If you added French, Japanese, or Simplified Chinese language support, you must uninstall those packages before uninstalling the English package.



# pkgrm package-name

where package-name is the package you are uninstalling. See TABLE 2-3 for a list of Sun StorEdge Configuration Service and Sun StorEdge Diagnostic Reporter 1.5 package names.


TABLE 2-3 Sun StorEdge Configuration Service and Sun StorEdge Diagnostic Reporter 1.5 Installation Packages

English

 

French

 

Japanese

 

Simplified
Chinese

Sun StorEdge Configuration Service

Agent

SUNWscsd

SUNWfscsd

SUNWjscsd

SUNWcscsd

Console

SUNWscsu

SUNWfscsu

SUNWjscsu

SUNWcscsu

Sun StorEdge Diagnostic Reporter

Agent

SUNWscsa

SUNWfscs

SUNWjscs

SUNWcscs

Config Tool (UI)

 

SUNWscui

SUNWfscui

 

SUNWjscui

 

SUNWcscui



procedure icon  To Uninstall Earlier Versions of the Sun StorEdge CLI

Use the pkgrm command to uninstall the CLI.


# pkgrm SUNWsccli


procedure icon  To Uninstall Version 2.x of the Software

Use the pkgrm command to uninstall Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, and the CLI.


# pkgrm SUNWsscs


procedure icon  To Uninstall the Japanese Version of the Man Page

If you installed the Japanese version of the man page, use the pkgrm command to uninstall it.


# pkgrm SUNWjsccl


Restoring a Configuration

If you reinstall Sun StorEdge Configuration Service, during the installation procedure you are asked whether you want to restore the configuration. Version 2.0 of the software stores the configuration information in the following file:

Earlier versions of Sun StorEdge Configuration Service store the configuration information in separate .tar files:



Note - If you are removing Sun StorEdge Configuration Service permanently, you might want to manually remove these files; however, if you later reinstall the program, you will not be able to restore the agent and console configurations.



Troubleshooting

When installing Sun StorEdge Configuration Service, running java -version might return a pre-1.2.2 software version even if the machine has Java runtime environment 1.2.2 through 1.5 installed. If this happens, verify that there is a link from the Java runtime environment software to the latest version.

Check the /usr directory to confirm there is a link to the latest version of the Java runtime environment by typing:


# cd /usr
ls | grep java

If the link is not to the latest version listed, type:


rm java
ln -s /usr/xxx /usr/java

where xxx is the latest version of the Java runtime environment software.