C H A P T E R  7

Installing the Sun StorEdge SMI-S Provider on a Solaris Host (FC and SATA Only)

The Sun StorEdge 3510/3511 SMI-S Provider enables Sun StorEdge Enterprise Storage Manager Advanced Applications Management Software for SE3500 (ESM-AA) 3.0 and higher to monitor Sun StorEdge 3510 FC and Sun StorEdge 3511 SATA RAID arrays. This solution requires that you install and configure ESM-AA 4.1, the WBEM Solutions J WBEM Server (from the ESM-AA 4.1 Accessory CD), Sun StorEdge Configuration Service version 2.5, and Sun StorEdge 3510/3511 SMI-S Provider version 2.4.

This chapter provides procedures for installing the Sun StorEdge 3510/3511 SMI-S Provider. Topics covered in this chapter include:


Prerequisites

The following components must be installed and configured before installing the Sun StorEdge 3510/3511 SMI-S Provider:


procedure icon  To Download the Software From the Web Site

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 to which the file was downloaded and unzip the file.

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


Preparing for Installation

Before installing the Sun StorEdge 3510/3511 SMI-S Provider, perform the following steps:

1. If an older version of the Sun StorEdge 3510/3511 SMI-S Provider is installed, remove it.

See Uninstalling the Sun StorEdge 3510/3511 SMI-S Provider.

2. If an older version of the WSI CIMOM is installed, remove it.

See Uninstalling the WSI CIMOM.

3. If an older version of the Sun StorEdge 3000 Family software is installed, remove it.

See Uninstalling the Software.

a. To check which version of Sun StorEdge Configuration Service is currently installed, perform the following command:


# sccli version

4. Install Sun StorEdge Configuration Service 2.5.

See Installing the Software.

5. Set passwords for the ssconfig, ssadmin, and ssmon users, if they are not already set.

See Users and Passwords.

6. To confirm that you are able to manage a Sun StorEdge 3510 FC or Sun StorEdge 3511 SATA array, launch a Sun StorEdge Configuration Service console and log in using the ssconfig username.

a. To launch a console, enter the following command:


# ssconsole

b. To log in as ssconfig, from the File menu, choose Login, select ssconfig from the Login name drop-list, and enter the password.

7. Set the JAVA_HOME environment variable, if it is not already set.

8. Confirm that Java Runtime Environment 1.4.2 or higher is installed.

a. Perform the following command:


# $JAVA_HOME/bin/java -version


Installing the WSI CIMOM

To install the WSI CIMOM, insert the Sun StorEdge Enterprise Storage Manager Advanced Applications 4.1 Management Software for SE3500 CD and enter the following commands:


# cd <path_to_ESM-AA_Accessory_CD>
# pkgadd -d . WSIjapi WSIwslib WSIutils WSIjwsrlog WSIjws
# pkgadd -d . WSIjwsdoc WSIjwsmof WSImof WSInpi WSIrmicpa



Note - The Sun StorEdge Enterprise Storage Manager Advanced Applications 4.1 Management Software for SE3500 CD is only available to Enterprise Storage Manager customers.



Installing the Sun StorEdge 3510/3511 SMI-S Provider

To install the Sun StorEdge 3510/3511 SMI-S Provider, perform the following commands:


# cd /cdrom/se3000_sw_2.5/product/solaris/sparc
# pkgadd -d . SUNWagsdk SUNW3x10a


Post-Installation Procedures

There are several procedures that must be performed following the installation of the Sun StorEdge 3510/3511 SMI-S Provider. Perform the following steps.

1. Edit the file /opt/SUNW3x10a/config.sh to reflect your local configuration.

The key options which might need modification are:



Note - The /opt/SUNW3x10a/config.sh file is read by shell scripts used by the Provider. Changes to the file must follow normal UNIX shell conventions.


2. To verify that your changes have the correct syntax, perform the following command:


# env - /bin/bash -ac ‘source /opt/SUNW3x10a/config.sh; env’

Check for any error messages or incorrect values. (Note that you will see several additional environment variables which are defined automatically by the ‘bash’ shell. These can be ignored.)

3. Ensure that the config.sh file is protected and cannot be read by users other than root:


# cd /opt/SUNW3x10a
# ls -l config.sh
# chown root config.sh
# chmod 0700 config.sh

4. Complete the installation of the provider by performing the following commands:


# cd /opt/SUNW3x10a/wbem/mof
# ./setup.sh



Note - Execution of the setup.sh script will take several minutes. Do not interrupt it. If setup.sh takes more than 15 minutes to complete or displays excessive error messages, see Troubleshooting.


5. Configure the ESM to discover storage managed by the Sun StorEdge Configuration Service agent identified in /opt/SUNW3x10a/config.sh.

To discover storage managed by the Sun StorEdge Configuration Service agent, you must specify the complete URL, including the port number specified by the HTTPPort variable in /opt/SUNW3x10a/config.sh.

For example, if the provider is running on a host with IP address 10.1.2.3, using the default HTTPPort value of 25988, you would specify the following URL when the ESM prompts for the “IP Address/DNS Name” of an element to be discovered:

http://10.1.2.3:25988



Note - If multiple storage devices are managed by the Sun StorEdge Configuration Service agent running on the host specified in /opt/SUNW3x10a/config.sh, then all of the storage devices will be discovered together.



Stopping and Starting the SMI-S Provider

The following commands read the /opt/SUNW3x10a/config.sh file to determine the correct parameters for starting and stopping the CIMOM. Do not use the start_server and stop_server commands provided in the WSI package.

To stop the SMI-S provider, perform the following command:


# /etc/init.d/se3510_proxy stop

To start the SMI-S provider, perform the following command:


# /etc/init.d/se3510_proxy start


Uninstalling the Sun StorEdge 3510/3511 SMI-S Provider

To uninstall the Sun StorEdge 3510/3511 SMI-S Provider, perform the following commands.


# pkgrm SUNWagsdk SUNW3x10a
# rm -rf /opt/SUNWagsdk
# rm -rf /opt/SUNW3x10a


Uninstalling the WSI CIMOM

To remove an older version of the WSI CIMOM, perform the following commands:


# pkgrm WSImof WSIjwsmof WSIjwsdoc
# pkgrm WSInpi WSIrmicpa WSIjws
# pkgrm WSIjwsrlog WSIutils WSIwslib WSIjapi
# rm -rf /opt/wsi


Troubleshooting

During the execution of the setup.sh script, the following messages might be displayed. These messages are normal and might occur several times each during installation.


WBEMSolutions_ObjectManager.StopService returned 0
 
/usr/java/bin/java -server -classpath ...
 
Could not connect to the specified CIM Server

If the following error message is seen, perform the steps below.


ERROR: tag SE3510-CIM28 exists. setup.sh cannot continue.

1. Stop the SMI-S provider:


# /etc/init.d/se3510_proxy stop

2. Remove entries from the CIMOM database via the following commands:


# cd /opt/SUNW3x10a/wbem/mof
# ./unsetup.sh

3. Run the setup script again:


# ./setup.sh

4. If you suspect that the CIMOM database is corrupted, perform the following steps:

a. Remove the WSI packages by removing the /opt/wsi directory:


# rm -r /opt/wsi

b. If an older version of the Sun StorEdge 3510/3511 SMI-S Provider is installed, remove it.

See Uninstalling the Sun StorEdge 3510/3511 SMI-S Provider.

c. If an older version of the WSI CIMOM is installed, remove it.

See Uninstalling the WSI CIMOM.

d. Reinstall the WSI CIMOM.

See Installing the WSI CIMOM.

e. Edit the config.sh file to reflect your local configuration.

Perform Step 1through Step 3 in Post-Installation Procedures.

If the ESM does not recognize an array, make sure that the array is manageable via the Sun StorEdge Configuration Service console. If it is not visible in the Sun StorEdge Configuration Service console, it will not be accessible to the ESM.

The CIMOM might need to be restarted if it is not running or new arrays are added which are not recognized by the ESM immediately. To restart the CIMOM, perform the following commands:


# /etc/init.d/se3510_proxy stop
# /etc/init.d/se3510_proxy start