This section describes how to install and configure the StorADE utility with best practice recommendations.
The following list describes the high-level tasks you perform when installing StorADE. Step-by-step instructions for each task are provided in subsequent sections.
Download the Sun StorADE package from the Sun Download Center.
If you are upgrading from StorADE 2.1 to StorADE 2.2, remove the StorADE 2.1 software before you install the StorADE 2.2 package.
Identify the hosts you plan to use as the StorADE master and slaves. Take note of the solutions described in "Deploying StorADE" on page 7, and the system requirements described in TABLE 7.
Install the StorADE package as a master or slave based on your desired deployment configuration. Perform this task for each master and slave in your environment.
Apply the StorADE patch. Perform this task for each master and slave in your environment.
Initialize the StorADE configuration using the ras_install script. Perform this task for each master and slave in your environment.
Use the StorADE BUI to configure the StorADE Environment to suit your monitoring needs. Perform this task for each master and slave in your environment.
Verify StorADE functionality. Perform this task for each master and slave in your environment.
To Download the StorADE Package
In a browser, go to the Sun Download Center: http://wwws.sun.com/software/download/sys_admin.html
Scroll down the page to the Storage Management section.
Select the Download link for Storage Automated Diagnostic Environment 2.2.
On the Storage Automated Diagnostic Environment Global Release page, select the Download link.
If you are not already registered at the Sun Download Center, register now.
You must be registered at the Sun Download Center before you can download the scripts and tools. If this is your first visit, select Register now. You only have to register once, and it's free. Whenever you come back to the Download Center, just enter your user name and password to log in.
Log in to the Sun Download Center.
Read and accept the License Agreement.
Download the StorADE compressed tar file to your system.
Uncompress and untar the StorADE file.
Perform the download according to the download procedures presented by your browser.
# zcat SUNWstade_2.2.00.03.tar.Z | tar xvf -
After untarring, you will have the following StorADE items:
SUNWstade The StorADE package
StorADE documentation the user's guide and release notes are located in the download_directory/SUNWstade/reloc/SUNWstade/docs directory
Copy the SUNWstade directory to each host for which you plan to install a StorADE master or slave agent.
To Upgrade from StorADE 2.1
The recommended best practice for upgrading StorADE is to remove any previously installed StorADE software. The StorADE configuration and historical monitoring data is kept in /var/opt and is preserved by default during package removal. Master StorADE installations should always be at the latest revision.
Log in as root.
Run the pkgrm command as follows:
# pkgrm SUNWstade
To Identify the Hosts You Plan to Use as StorADE Hosts
Assess your needs based on the type of storage devices you want to monitor.
Make sure each host for which StorADE will be installed meets the requirements listed in TABLE 7.
See "Deploying StorADE" on page 7.
TABLE 7 StorADE System Requirements
Sun SPARC system
Solaris 9 OE
Solaris 8 4/01 OE (or above)
Make sure you have the latest recommended OS, security, and SAN patches installed.
Netscape 4.47, 6.x, 7.x
Internet Explorer 5.x, 6.x
5.005 or 5.006 (visit http://www.perl.com/pub/language/info/software.html)
Once the proper version ins installed, create a symbolic link of the executable to /usr/bin/perl.
Only necessary on the StorADE master host
50 MByte available in /opt for binaries and system libraries.
25 MByte available in /var/opt. This accommodates monitoring of 100 devices. Add 100 KByte for each additional device.
Refer to the StorADE release notes for the latest information on host requirements.
To Install StorADE on a Host
Log in as root.
Change to the directory where you copied the installation package.
Install the package using the standard Solaris pkgadd command:
Answer the prompts for the License Agreement.
# pkgadd -d . SUNWstade
To Install the StorADE Patch
Use the patchadd command to install the StorADE patch.
# patchadd 114590-xx
You can use the PatchPro utility to check patch levels and to download the latest patches from Sun.
To Initialize the StorADE Configuration
Start the StorADE initialization script in one of the following ways:
To initialize a StorADE master host:
# /opt/SUNWstade/bin/ras_install -m -S Y -c
To initialize a StorADE slave host:
# /opt/SUNWstade/bin/ras_install -s master_IPaddress -S Y -c
TABLE 8 ras_install Options
Initialize host as a StorADE master.
Initialize host as a StorADE slave. Replace master_IPaddress with the IP address of the StorADE master host.
-S Y | N
Specifies the security mode in one of the following ways:
Y Configure the StorADE host to use secure communications. This is the recommended best practice.
N Configure the StorADE host to use non-secure communications.
Enable the crontab entry.
To Configure the StorADE Environment
In a browser, go to the StorADE Master URL: http://master_IPaddress:7654
Log in to StorADE.
The initial login is:
username = ras
password = agent
Best Practice: Change the ras password.
The initial StorADE page (FIGURE 7) is displayed.
FIGURE 7 Initial StorADE Page
Under Basic Installation Steps (FIGURE 7) configure the StorADE environment by selecting each of the eight links (left to right) as described in the following steps:
Select Review Site Info.
Select Review Hosts.
Enter the name of your company in the Customer Name field.
The Site Name can be your location (for example, North Data Center). This convention allows for multiple sites under a single company name.
By default, most Device Categories are checked (enabled). There is no harm in leaving the settings like this.
Set the polling interval. The default is 5 minutes.
Select Monitor In-Band data path. This ensures FC Counters are collected from the HBA to the storage link.
Set the messages log location for host and T3.
Select Discover Devices.
Devices can be found in the following ways:
By product category.
By subnet search (used for Ethernet and SNMP-capable devices).
(Best Practice) Devices From IP edit the /etc/deviceIP.conf file and list your devices, then select Devices From IP.
Click Add to Configuration.
Input the passwords for all monitored devices that have passwords (switches, Sun StorEdge T3 arrays, and so on) into Maintain Devices.
Select Setup Email.
This configuration is for local notification, and can be configured to send the notification to email or to a pager.
Select Setup Notifications.
This is for the alert stream to Sun Microsystems when a device has an event.
Best Practice recommendations:
Choose encrypted email.
Click the checkbox to select Active.
Select Create Topology.
If you cannot create a topology, the problem might be due to out of date patches. In this case, run the StorADE Revision Check routine (available under the Diagnosis Tab) to get a revision report.
Once Topologies are created (indicated by Done), they can be viewed under Monitor Topology.
Select Review Config.
This runs a quick check for basic StorADE configuration parameters.
Finish the StorADE installation by selecting Start Agents.
The monitoring process starts. FIGURE 8 shows an example of the StorADE BUI with monitoring underway.
FIGURE 8 StorADE BUI During Monitoring
Once StorADE is installed, initialized, and configured, you can find details on how to use StorADE in the Storage Automated Diagnostic Environment 2.2 User's Guide. This guide is installed on each StorADE host, and is also available at: http://docs.sun.com.
To Verify StorADE Functionality
Usually you can tell if a StorADE host is functioning by viewing the various StorADE tabs in the StorADE BUI. If you want to further investigate StorADE functionality, the following steps describe how to check the fundamental StorADE infrastructure.
Log in to the StorADE host as root.
Verify the StorADE crontab entry as follows:
Verify the web server installation as follows:
(Best Practice) Run the agent from the command line to verify output:
# crontab -l 0,5,10,15,20,25,30,35,40,45,50,55 * * * * /opt/SUNWstade/bin/rasagent -c >> /opt/SUNWstade/log/cron.log 2>&1
# grep ras /etc/services rashttp2 7654/tcp # Rasagent service # grep ras /etc/inetd.conf rashttp2 stream tcp nowait root /opt/SUNWstade/bin/rashstart rashstart -d /opt/SUNWstade
# /opt/SUNWstade/bin/rasagent -d2
StorADE generates lots of messages. At this point you soul watch for errors indicating that StorADE is not able to function. Other errors might be an indication of a storage problem, in which case StorADE is doing its job, and the messages help you isolate the problem.
To Uninstall StorADE
If for some reason you need to uninstall StorADE, perform the following steps:
As root, use the pkgrm command to remove the StorADE utility:
(Optional) Perform the following command to remove the StorADE configuration database:
# pkgrm SUNWstade
This removes the StorADE utility software, but does not remove your StorADE configuration database.
# rm -rf /var/opt/SUNWstade