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 the programs, take the following steps:
This section lists the system requirements for the Solaris host.
Note - For a list of Sun recommended patches, refer to the release notes for your array. |
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. |
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.
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. |
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.
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.
http://www.sun.com/software/download/
3. Under System Administration 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.
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.
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.
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.
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:
where $ARCH is either sparc or i386, depending on the Solaris OS platform.
3. To install the English package, type:
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.)
b. To continue with the installation, type y and press Return.
After the package is installed, the following message is displayed, indicating it was installed successfully.
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.
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:.
To enable Sun StorEdge Diagnostic Reporter to start automatically when the system boots, and to start it now, type:
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.
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:
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.
To Stop or Start the Sun StorEdge Configuration Service Agent |
To stop the Sun StorEdge Configuration Service agent, type:
To start the Sun StorEdge Configuration Service agent, type:
To stop the Sun StorEdge Diagnostic Reporter agent, type:
To start the Sun StorEdge Diagnostic Reporter agent, type:
To determine if the agents are running, type:
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:
Label the desired disks, and then restart the agent.
The following sections explain how to create users and passwords for Sun StorEdge Configuration Service.
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. |
To Create Passwords and Permissions |
Create a password for each of the new users by typing:
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. |
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.
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. |
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.
To Uninstall Earlier Versions of the Sun StorEdge CLI |
Use the pkgrm command to uninstall the CLI.
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.
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.
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:
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:
If the link is not to the latest version listed, type:
where xxx is the latest version of the Java runtime environment software.
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.