> Help Summary
 Admin -> General
- General Maintenance Set up the Storage Automated Diagnostic Environment Agents
- Site Information Maintain customer and site information.(s)
- Maintain Hosts Enter customer and device information and configure host(s)
- Add a Host Add a new slave manually
- Discovery Probe the environments for the device types.
- Discover a Solution Cabinet Query for a Sun StorEdge 3900 or 6900 series cabinet
- Search the LAN Search the LAN for Sun StorEdge devices using Subnet
- Set up Sun StorEdge T3 and T3+ Array Monitoring Mirror the Sun StorEdge T3 array's /syslog to a host
- Add Devices Add a new device to the Storage Automated Diagnostic Environment
- Maintain Devices Add, delete, update, and rename device information
- Update Devices Update the necessary fields for an existing device.
- Delete Devices Remove the device once it is no longer needed.
- Rename a Device Manually add the world wide name (WWN) into the configuration file.
- Email Notification Customize the generation of local email to system administrators.
- Local Notification: Add New Entry Create a notification record for system administrator
- Send a Message Subset Send a customizable subset of event-driven messages from the host
- Notification Providers Relay events generated by the health monitors
- Push Slaves Update Slave Agent Configuration File
- Start/Stop Agents Control Agent activity
- Start/Stop Devices Deactivate monitoring on a device-by-device basis
- Test email Test Email functions
- Review Config Report results and make available pointers to areas that require review
- Configuration Options Change configuration options.
- Application Launcher Store URL bookmarks and launch management interface.
 
 
Maintenance [ Up ]

The Maintenance section includes all the functions that are necessary for setting up the Storage Automated Diagnostic Environment for the first time, or to make changes, to ensure proper monitoring, notification, and diagnosis.

Once you have configured the Storage Automated Diagnostic Environment master and slave hosts, you should use the Maintenance section only to update email notifications or to update the monitored devices.  

 

 
Maintain Site Information [ Up ]

From the General Maintenance window, select Site Information. The fields on this page must be completed before you proceed. The fields with an asterisk (*) are mandatory. To update the master configuration, click an existing Host Name link from the Maintain Hosts window and update the fields as required, then click Submit.  
 
 
Maintain Hosts [ Up ]

When the Storage Automated Diagnostic Environment package is installed on a host, it registers with the master agent and an entry is added to this page. For this automatic registration to work, you must first install and run the master agent. A 'Y' will appear in the Active field of the Maintain Hosts window. Once all hosts are installed, you can access this page to change the configuration of each host.

The three main functions of the Maintain Hosts window are:

 

 

 
Add a New Slave [ Up ]

If a slave agent does not automatically register, you can add a new slave manually.

To access the Add Host window:

  1. Click the Maintain Hosts link on the Storage Automated Diagnostic Environment window.
  2. Click the Add a new Slave button on the Maintain Host window.
  3. The Maintain Hosts: Add Host window is displayed.

    Note: The Categories to Monitor choices indicate Sun Microsystem network storage devices that are supported with the Storage Automated Diagnostic Environment.

  4. Click Add to add the new slave host.

  5. Caution:If the system you are adding as a slave is currently a master, the following message is displayed: WARNING: System is currently configured as a master. Please use the Push Slave Configs section to change this system to a slave.

  6. To automatically update the slave's configurations and to verify that all slaves agree with the master configurations, click Push Slave Configs from the Maintenance menu.

Notes:

 

 

 
Discovery [ Up ]

You can request the Storage Automated Diagnostic Environment to probe the environments for the device types shown on the Discovery window.

The Storage Automated Diagnostic Environment discovers storage devices in two ways:

The Storage Automated Diagnostic Environment discovers the following devices on the physical data path attachments to the host:

The Storage Automated Diagnostic Environment automatically discovers the Sun StorEdge network FC switch-8 and switch-16 switches, McData ED6064 switches and Brocade Silkworm 1 Gb and 2 Gb switches by reading the /etc/fcswitch.conf file. Additionally, the Subnet functionality asks for an IP network prefix to scan for Sun StorEdge Network 2 Gb Switch-16 switches, McData ED6064 switches and Brocade Silkworm 1 Gb and 2 Gb switches answering to SNMP queries.

The Storage Automated Diagnostic Environment automatically discovers the Sun StorEdge T3 and T3+ arrays by scanning the Sun StorEdge T3 and T3+ array logfile on all Hosts. Entries that contain a valid IP name or address are added to the configuration.

The Storage Automated Diagnostic Environment discovers the Sun StorEdge 3900 and 6900 series using the /etc/host file of the Storage Service Processor.

 

 

 
Discover a Sun StorEdge 3900 or 6900 Series System [ Up ]

Sun StorEdge 3900 series storage systems for direct attach storage (DAS) environments, and Sun StorEdge 6900 series storage systems for Storage Area Network (SAN) environments, are complete, preconfigured storage solutions. End users have only restricted accessibility to the internal components of the subsystems, but they do have full utilization of its storage functionality.

Select the Sun 3900/6900 button on the Device Discovery window to instruct the Storage Automated Diagnostic Environment to query for a Sun StorEdge 3900 or 6900 series system. The IP address or name of the Storage Service Processor in the Sun StorEdge 3900 or 6900 series system should be selected. The master will then query locally or the slave address selected for the Sun StorEdge 3600 or 6900 series system.

  1. From the Product/Discovery Method pull-down menu, select Sun 3900/6900.
  2. From the Run on Host pull-down menu:
  3. Disable the Turn Monitoring Off checkbox.
  4. Click Confirm Sun StorEdge 3900 and 6900 series Discovery.
  5. This function uses the local /etc/hosts file for discovery on the Storage Service Processor.

 

 

 
Search the LAN for Sun StorEdge Devices using Subnet [ Up ]

Use the Subnet button to search the LAN for Sun StorEdge network FC switch-8 and switch-16 switch devices, McData ED6064 switches, Brocade Silkworm switches, and Sun StorEdge T3 and T3+ arrays.

  1. Enter the IP address of the subnet you want searched.
  2. Enter the Subnet prefix for the search.

The Subnet functionality will search the subnet for valid devices.

The search results are sent back to the master agent. The master agent moves the recently discovered, valid devices that were previously in the subnet into the main configuration file.  

 

 
Set Up Sun StorEdge T3 and T3+ Array Message Monitoring [ Up ]

In order for the Storage Automatic Diagnostic Environment software to monitor messages from a Sun StorEdge T3 or T3+ array, you must mirror the Sun StorEdge T3 or T3+ array's /syslog to a host with the Storage Automated Diagnostic Environment installed and configured to monitor Sun StorEdge T3 and T3+ arrays.

  1. Refer to the Sun StorEdge T3 and T3+ Installation and Configuration Manual, part number 816-4769-10, for procedures on how to set up the Sun StorEdge T3 array and the host to forward syslog messages.
  2. Refer to the Maintain Hosts section to configure each host with the name given to the T3 and T3+ array message log file.
 

 

 
Add a Device Manually [ Up ]

To Add a Device Manually:

  1. Click the Add Devices link on the General Maintenance Menu.
  2. Complete the required fields:
  3. Required Input

    Sun StorEdge A3500FC array

    Sun StorEdge A5000 array

    Brocade Silkworm switches

    McData ED6064 switches

    Sun StorEdge D2 array

    Internal FC Disk

    Sun StorEdge network FC switch-8 and switch-16 switches

    Sun StorEdge T3 and T3+ Array

    FC Tape

    Sun Fire V880 FC-AL Disk

    Virtualization Engine

  4. After you have finished adding devices, click Update Selected Slaves using Push Slave Configs.

    The Update Selected Slaves functionality is required to update a slave's configuration after you have added or updated one or more devices.

 

 

 
Maintain Devices [ Up ]

Use the Maintain Devices window to configure the host to monitor each device. You can also use this window to change the name that the Storage Automated Diagnostic Environment will use as a reference to that device through its email notifications.

Be aware of the host's access method when making decisions about which devices the Storage Automated Diagnostic Environment will monitor.

Note:

 

 

 
Manually Update a Device [ Up ]

  1. Click the Admin link on the Storage Automated Diagnostic Environment main window.
  2. Click the Maintain Devices link on the General Maintenance menu.
  3. From the Maintain Devices window, select and click the device you want to update from the Device Name column.
  4. Once you have corrected the necessary fields, click Update.
  5. After you have added a device or updated a device, refresh the system by clicking Re-Discover.

Notes:

 

 

 
Delete a Device [ Up ]

You can delete an unwanted device after the device has been removed from the site or if device monitoring is no longer needed.

Note:

You can delete a slave, but the only way you can delete a master is to remove the package.

To delete a device:

  1. Click the Admin link on the Storage Automated Diagnostic Environment main window.
  2. Click the Maintain Devices link on the Maintenance menu.
    The Maintain Devices window is displayed.
  3. From the Maintain Devices window, select the device you want to delete from the Device Name column.
    The device's maintenance window is displayed.
  4. Click Delete.
    • Deleting a device from the configuration does not remove the access to the device instrumentation in the cache immediately. This will, however, be cleared the next time you manually run the agent.
    • State information for that device is also maintained until the agent's next run. Therefore, a device can be removed from a configuration and still be viewed in the Topology and Instrumentation as a snapshot in time, until you once again take a new Topology snapshot.

 

 

 
Rename a Device [ Up ]

If you rename a device and then execute the agent from the command line or from the GUI, the Storage Automated Diagnostic Environment displays a message that the previous device has been removed. The Storage Automated Diagnostic Environment topology will not, however, display the renamed device until you rediscover the device and take a new Topology snapshot.

You can avoid this problem by manually adding the world wide name (WWN) into the Storage Automated Diagnostic Environment configuration file, which is located in the file /var/opt/SUNWstade/DATA/rasagent.conf.

Note:

Unless you remove the SUNWstade directory and perform a new ras_install, the configuration file remains on the system between upgrades.  

 

 
Email Notification [ Up ]

You can use the Email Notification window to customize the generation of emails to yourself or to other administrators at their companies. For example, if you are interested in receiving only high-priority alerts coming from Sun StorEdge T3 and T3+ arrays, you can create a specialized notification for this instance only.

Alerts are sent only to valid email addresses that you have entered through the Email Notification function. Local notification does not send mail to the provider.
You can customize the following local notification information:

Note:

The local email/pager notifications feature is optional and does not affect the main transmission functions of the Storage Automated Diagnostic Environment. The master instance of the Storage Automated Diagnostic Environment is the only instance generating emails based on local notifications. slave instances of the Storage Automated Diagnostic Environment send their alerts to the master, which filters them and forwards them to the providers, if selected, and to local system administrators, if configured.  

 

  • Clear Email Notifications
    Press this button to reset the count of emails that have been sent on a device basis in an 8 hour period. This button has no effect if you have the Maximum number of emails set to "No maximum" under Config Options.
  •  

     

     
    Local Notification: Add New Entry [ Up ]

    Create a notification record for each system administrator who would like to be notified of the Storage Automated Diagnostic Environment findings. You can restrict the findings by Event Type, Priority, and Device Category. Multiple events can be selected and sent to an email or a pager. This flexibility enables a customized alert notification scheme.

    To add a new entry:

    1. Click an email link to update or delete an existing email address.
    2. Click the Add Notification button to add new email addresses to the notification list.

    In addition to sending the reliability, availability, and serviceability (RAS) information collected by the Storage Automated Diagnostic Environment, you can send a customizable subset of the event-driven messages from the host (configured as master) directly to local system administrators at the customer's site by email.

    Note: Email might not be sent if the system is not properly configured to send mail to the recipient. This is primarily evident in Storage Service Processor environments, where the Storage Service Processors are on a subnet, and there is no gateway to the intended recipient.  

     

     
    Send a Customizable Subset of Event-Driven Messages from the Host [ Up ]

    1. Enter one or more email addresses into the Email Address/Filename textbox.
    2. For each address, choose from:
      • Priority list:
        • 0 = normal (green), information only. This is the lowest priority.
        • 1 = warning (yellow)
        • 2 = error (red)
        • 3 = down (red), the system is down.
        • warning + error + down
        • actionable only
      • Category list - Select from the current suite of storage products that are monitored by the Storage Automated Diagnostic Environment.
      • Event Type list - Select from a list of event types, categorized by device type.

    3. Click Add.

    The Storage Automated Diagnostic Environment sends the specific event type messages, by device type, to the email address(es) you specified.  

     

     
    Notification Providers [ Up ]

    Storage Automated Diagnostic Environment providers encode data and interface with transport mechanisms, which transmit information to the NSCC about configured storage devices. A provider's main function is to relay events generated by health monitors.

    The Storage Automated Diagnostic Environment supports several providers: HTTP, Email, SSTR, SRS, Net Connect, SunMC, SNMP Traps, and SSRR.

    The types of providers are briefly described in the following sections:

  • SunMC Provider

    The SunMC Provider enables the Storage Automated Diagnostic Environment to send actionable events and monitoring topologies to the SunMC Console, which displays the alarms and alert text. SunMC information is similar and compatible with Sun Remote Services (SRS). SunMC can send information to SRS, in which case the SRS Provider need not be activated in the Storage Automated Diagnostic Environment.

     

     

     
    Push Slave Configs [ Up ]

    You will be prompted to push configurations whenever you change a configuration. The Review Configurations functionality lists settings that you might have missed or you need to correct.

    Note:

    The Push Configs functionality is very important. It synchronizes all slave instances under a master instance, with the instances of the master to ensure proper monitoring and notification.  

     

     
    Start or Stop Agents [ Up ]

    You can control agent activity to temporarily stop the Storage Automated Diagnostic Environment from running on a selected host. You can also avoid creating email notifications on false errors when a device is being tested and faults are injected intentionally.

    Note:

    By default, the master Monitoring function does not automatically default to On. You must manually enable Monitoring to On.

     

     

     
    Start/Stop Device Monitoring [ Up ]

    The Start Device window enables you to deactivate monitoring on a device-by-device basis.

    1. To start or stop devices, check the appropriate checkbox.
      • When Monitoring is 'on,' the 'Stop' checkbox is available.
      • When Monitoring is 'off,' the 'Start' checkbox is available.

    2. Click Submit Changes.

      The Storage Automated Diagnostic Environment must update the configuration files on all the slave hosts configured with this master.

      • Use the [Push Slave Configs] option on the Maintenance menu to accomplish this.

    3. If the device is being tested or if faults are being injected into the device intentionally, you can temporarily stop the local notifications for a specific device using the Start/Stop Device Monitoring window.

    NOTE:

    Monitoring continues when the device is deactivated (turned off). However, email notifications will not occur for any faults that are detected while the device monitoring is in this state. Consequently, any errors that may have been detected will be logged and sent by means of the SRS Net Connect or HTTP Providers, but not by means of email notification.  

     

     
    Test Email [ Up ]

    Use the Test Email window to send test emails and a message, and to verify that the mailing capability of the Storage Automated Diagnostic Environment is installed and working properly.

    To access the Test Email window:

    1. Click the Admin link in the Storage Automated Diagnostic Environment main window.
    2. Click the Test Email link on the General Maintenance menu.

      The Test Email window is displayed.

    3. Type your email address into the Email Address text box.
    4. Type a brief comment into the Message text field.
    5. If you leave the Message text field blank, the test email contains a default message with the words Test Message in the subject line.

    NOTE:

    If you place a carriage return in the Message text field, you cannot enter text. To restart, click in the Message text field and enter some text.  

     

     
    Review Configuration [ Up ]

    1. Once you have completed your configuration and you want to verify all settings, select the Review Configuration link on the General Maintenance menu.
    2. If necessary, follow the displayed instructions for settings that you might have missed or for those that you need to double-check.
     

     

     
    Change Configuration Options [ Up ]

    The Configuration Options window enables you to change the defaults on selected configuration options. Use the following information to update existing configuration options:

     

     

     
    Application Launcher [ Up ]

    The Application Launcher enables users to store URL bookmarks in the Storage Automated Diagnostic Environment on a device-by-device basis. Currently the devices for which URL bookmarks can be stored include the following:

    Note:

    The Application Launcher provides an easy way to launch the Brocade Silkworm Switch Management Interface directly from the Storage Automated Diagnostic Environment without having to open a new browser window and type the URL of the Brocade Silkworm switch manually.