Installing the Software on a Linux Host

C H A P T E R 4

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

System Requirements

Installing the Software

Users and Passwords

Uninstalling the Software

Troubleshooting

System Requirements

This section lists the system requirements for the Linux host.

A web browser is required to view the online help. If you encounter help display problems, update your browser to a more recent version.

TCP/IP-compliant network interface - Each console must have a TCP/IP-compliant network interface (such as an Ethernet or Token Ring network card, or a serial line with a modem). Each agent must have a TCP/IP-compliant network interface and driver set (included with the operating system).

Color monitor - The console is best viewed with a monitor resolution of 1024 x 768 pixels with 256 colors.

Operating system, memory, and disk space - The following table lists the system requirements for the Linux operating system.

TABLE 4-1 Linux System Requirements for Sun StorEdge Configuration Service, Sun StorEdge Diagnostic Reporter, and Sun StorEdge CLI
Linux OS Version	Memory	Disk Space
Sun Linux 5.0 on a Sun LX50 server (SCSI only) Red Hat Advanced Server 3.0 SUSE Linux Enterprise Server 9.0 (32-bit and 64-bit)	256 Mbyte minimum, 512 Mbyte recommended	40 Mbyte minimum, 100 Mbyte recommended

Installing the Software

Sun StorEdge Configuration Service software includes the following components:

Sun StorEdge Configuration Service agent

Sun StorEdge Configuration Service console

Sun StorEdge Diagnostic Reporter (optional utility)

Sun StorEdge CLI

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:

SUNWscsd.rpm - Sun StorEdge Configuration Service agent

SUNWscsu.rpm - Sun StorEdge Configuration Service console

SUNWscsa.rpm - Sun StorEdge Diagnostic Reporter agent

SUNWscui.rpm - Sun StorEdge Diagnostic Reporter Config Tool (UI)

SUNWsccli.rpm - Sun StorEdge CLI

See To Download 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 - Make sure that Java runtime environment software is installed on the computer or workstation on which you are installing Sun StorEdge Configuration Service. The earliest release of the Java runtime environment software that is compatible with Sun StorEdge Configuration Service is 1.2.2.

Note - Sun StorEdge Configuration Service requires the gettext package from the Linux distribution. Make sure that gettext is installed on the computer or workstation on which you are installing Sun StorEdge Configuration Service.

For more information on gettext, see the following link:

http://www.gnu.org/software/gettext/

If you don’t have a Linux CD, you can download gettext from the following FTP site:

ftp://ftp.gnu.org/gnu/gettext/

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. 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/linux

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

10. Go to Step 5 in To Install Sun StorEdge Configuration Service Agent and Console From the CD.

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

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

To check to see if gettext is installed, type:

# rpm -qa | grep gettext

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

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

# cd mount /dev/cdrom /mnt/cdrom

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

# cd /mnt/cdrom/product/linux

5. Install the packages in one of the following ways:

To install only the agent, type:

# rpm -ivh SUNWscsd.rpm

To install only the console, type:

# rpm -ivh SUNWscsu.rpm

Note - The installation program checks that Java runtime 1.2.2 or later is installed. If it cannot find it, you are asked to specify the path. If you know that Java runtime environment 1.2.2 or later has been installed but the installation program cannot find it, check the /usr directory to confirm that there is a link from Java to the latest version instead of Java 1.1. For instructions on creating the link, see Troubleshooting.

6. To access online help, install Netscape Navigator on the system on which you are installing the console.

Versions earlier than 4.0 are not supported. If Netscape Navigator is not detected, you are asked to specify the path.

a. Change to /opt/SUNWsscs/sscsconsole and type:

# ./config_sscon

b. Type the absolute path to the web browser.

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.

After the agent is installed, the following message is displayed, indicating the components were installed successfully and have started:

# rpm -ivh SUNWscsd.rpm Preparing...
########################################### [100%] 1:SUNWscsd########################################### [100%] add user ssmon add user ssadmin add user ssconfig Configuring and starting Sun StorEdge(tm) Configuration Service daemons[ OK ] 
Starting Sun StorEdge(tm) Configuration Service agent daemon[ OK ] 
Starting Sun StorEdge(tm) Configuration Service agent monitor daemon[ OK ]

After the console is installed, the following message is displayed, indicating the components were installed successfully and have started:

# rpm -ivh SUNWscsu.rpm Preparing...
########################################### [100%] 1:SUNWscsu########################################### [100%] Installation completed successfully!

The agent and console are installed in/opt/SUNWsscs/sscsconsole.

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.

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

2. If you are installing the software from the CD, insert the Sun StorEdge 3000 Family Professional Storage Manager CD, and type:

# cd /cdrom/cdrom0/product/linux

3. To install the agent, type:

# rpm -ivh SUNWscsa.rpm

4. To install the Config Tool (UI), type:

# rpm -ivh SUNWscui.rpm

5. When the installation procedure is complete, the agent starts automatically.

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

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. The 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. The package must be installed on a host that is attached to the array.

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

Note - You must be superuser to install the CLI.

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

# mount /dev/cdrom /mnt/cdrom

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

3. If you are installing the software from the CD, insert the Sun StorEdge 3000 Family Professional Storage Manager CD, and type:

# cd /mnt/cdrom/product/linux

4. Type:

# rpm -ivh SUNWsccli.rpm

To access the CLI, log in as root on the host on which you installed the CLI (and that is attached to the array), and type:

# sccli (with options and subcommands)

For a list of options and subcommands, see the man page.

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

To Stop or Start the Agents

The Sun StorEdge Configuration Service and Sun StorEdge Diagnostic Reporter agents can be stopped or started manually by using the run commands scripts.

Note - You must be superuser to start the agents.

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.

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

# service ssagent start

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

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 a Linux 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:

ssmon

Represents the monitoring level of the software.

ssadmin

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

ssconfig

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.

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.

To Uninstall Sun StorEdge Configuration Service

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

# rpm -e SUNWscsd
# rpm -e SUNWscsu

To Uninstall Sun StorEdge Diagnostic Reporter

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

# rpm -e SUNWscsa
# rpm -e SUNWscui

To Uninstall the Sun StorEdge CLI

Use the rpm -e command to uninstall the CLI.

# rpm -e SUNWsccli

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 or higher installed. If this happens, confirm that there is a link from Java runtime environment software to the latest version.

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

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