Home > Articles > Operating Systems, Server

  • Print
  • + Share This
Like this article? We recommend

Installing StorADE

This section describes how to install and configure the StorADE utility with best practice recommendations.

Installation Overview

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.

  1. Download the Sun StorADE package from the Sun Download Center.

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

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

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

  5. Apply the StorADE patch. Perform this task for each master and slave in your environment.

  6. Initialize the StorADE configuration using the ras_install script. Perform this task for each master and slave in your environment.

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

  8. Verify StorADE functionality. Perform this task for each master and slave in your environment.

To Download the StorADE Package

  1. In a browser, go to the Sun Download Center: http://wwws.sun.com/software/download/sys_admin.html

  2. Scroll down the page to the Storage Management section.

  3. Select the Download link for Storage Automated Diagnostic Environment 2.2.

  4. On the Storage Automated Diagnostic Environment Global Release page, select the Download link.

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

  1. Log in to the Sun Download Center.

  2. Read and accept the License Agreement.

  3. Download the StorADE compressed tar file to your system.

  4. Perform the download according to the download procedures presented by your browser.

  5. Uncompress and untar the StorADE file.

  6. Example:

    # 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

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

  1. Log in as root.

  2. Run the pkgrm command as follows:

  3. # pkgrm SUNWstade

To Identify the Hosts You Plan to Use as StorADE Hosts

  1. Assess your needs based on the type of storage devices you want to monitor.

  2. See "Deploying StorADE" on page 7.

  3. Make sure each host for which StorADE will be installed meets the requirements listed in TABLE 7.

TABLE 7 StorADE System Requirements

Category

Requirement

CPU Platform

Sun SPARC system

Operating Environment

Solaris 9 OE

Solaris 8 4/01 OE (or above)

Make sure you have the latest recommended OS, security, and SAN patches installed.

Browser

Netscape 4.47, 6.x, 7.x

Internet Explorer 5.x, 6.x

Perl

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.

SendMail

Only necessary on the StorADE master host

Disk space

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

  1. Log in as root.

  2. Change to the directory where you copied the installation package.

  3. Install the package using the standard Solaris pkgadd command:

  4. # pkgadd -d . SUNWstade
  5. Answer the prompts for the License Agreement.

To Install the StorADE Patch

  1. Use the patchadd command to install the StorADE patch.

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

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

Option

Description

-m

Initialize host as a StorADE master.

-s master_IPaddress

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.

-c

Enable the crontab entry.


To Configure the StorADE Environment

  1. In a browser, go to the StorADE Master URL: http://master_IPaddress:7654

  2. Log in to StorADE.

  3. The initial login is:

    • username = ras

    • password = agent

    Best Practice: Change the ras password.

    The initial StorADE page (FIGURE 7) is displayed.

    Figure 7FIGURE 7 Initial StorADE Page

  4. 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:

    1. Select Review Site Info.

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

    3. Select Review Hosts.

    4. Tips:

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

    5. Select Discover Devices.

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

    7. Select Setup Email.

    8. This configuration is for local notification, and can be configured to send the notification to email or to a pager.

    9. Select Setup Notifications.

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

      • Click Update.

    11. Select Create Topology.

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

    13. Select Review Config.

    14. This runs a quick check for basic StorADE configuration parameters.

  5. Finish the StorADE installation by selecting Start Agents.

  6. The monitoring process starts. FIGURE 8 shows an example of the StorADE BUI with monitoring underway.

    Figure 8FIGURE 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.

  1. Log in to the StorADE host as root.

  2. Verify the StorADE crontab entry as follows:

  3. # 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 
  4. Verify the web server installation as follows:

  5. # 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 
  6. (Best Practice) Run the agent from the command line to verify output:

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

  1. As root, use the pkgrm command to remove the StorADE utility:

  2. # pkgrm SUNWstade 

    This removes the StorADE utility software, but does not remove your StorADE configuration database.

  3. (Optional) Perform the following command to remove the StorADE configuration database:

  4. # rm -rf /var/opt/SUNWstade
  • + Share This
  • 🔖 Save To Your Account