> Help Summary
 Maintenance -> 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 New Slave Add a new slave manually
- Device 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 a Device Add a new device to the Storage Automated Diagnostic Environment
- Maintain Devices Add, delete, update, and rename device information
- Update a Device Update the necessary fields for an existing device.
- Delete a Device Remove the device once it is no longer needed.
- Rename a Device Manually add the world wide name (WWN) into the configuration file.
- Customize Email Deliveries Configure Local Email Notification
- 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 Configs Update Slave Agent Configuration File
- Start/Stop Agents Control Agent activity
- Start/Stop Device 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
- Change Configuration Options Return the options depending on the location and status of the storage device.
 
 
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 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:

 

 

 
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.  

 

 
Add a New Slave [ Up ]

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

To access the Add New Slave window:

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

    Note: The Categories to Monitor choices indicate Sun Microsystem network storage devices that are supported with this instance of 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:

 

 

 
Device Discovery [ Up ]

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

Note:

As long as there are valid Sun StorEdge T3 and T3+ array entries in this log file, the auto-discovery will find them and add them. You can avoid adding older, unwanted Sun StorEdge T3 and T3+ arrays by rolling over the log file, much the same way the system log rolls over. Reference the scripts /usr/lib/newsyslog and /etc/cron.d/logchecker.

In a cascaded switch-configured SAN, only the switch with the Host attachment (that is, the local switch) needs to be in the /etc/fcswitch.conf file. The Storage Automated Diagnostic Environment will discover the cascaded switch when the first switch is discovered.

Note:

You must manually add Brocade Silkworm switches, or search the LAN for a Brocade Silkworm switch and then manually delete the unwanted devices which were discovered elsewhere on the specified LAN.  

 

 
Discover a Sun StorEdge 3900 or 6900 Series Cabinet [ 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 cabinet. The IP address or name of the service processor in the Sun StorEdge 3900 or 6900 series cabinet should be selected. The StorADE master will then query locally or the slave address selected for the 3600/6900 subsystem.

  1. Select the host from the Run on Host menu.
  2. Enable the Turn Monitoring On toggle button.
  3. Click Confirm 3900/6900 Discovery.

Note:

The discovery of Sun StorEdge 3900 and 6900 Series subsystems is dependent on the existence of the Solution.golden configuration file which resides in the SUNWstade /var/opt/SUNWstade/DATA directory. This file is created by running the Storage Automated Diagnostic Environment config_solution(1M) utility which is located in the SUNWstade /bin directory. This utility should always be run during manufacture, upgrades and component replacements.

Note:

The Storage Automated Diagnostic Environment employs a direct Ethernet connection (out-of-band) to the Sun StorEdge T3 and T3+ arrays, virtualization engines, Sun StorEdge network FC switch-8 and switch-16 switch devices, and Brocade Silkworm switches.  

 

 
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, 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 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+ Disk Tray Installation, Operation, and Service Manual for procedures on how to set up the Sun StorEdge T3 array and the host to forward syslog messages.
  2. Refer to Maintain Hosts section to configure each host with the name given to the T3 and T3+ array message log file.
 

 

 
Add New Device [ Up ]

To add a new device:

  1. Click the Add New Device link on the General Maintenance Menu.
  2. Complete the fields using the descriptions that follow.
 

 

 
Maintain Devices [ Up ]

Use the Maintain Devices window to configure the Host to monitor each agent 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:

The Primary Host column lists the registered host that will do the actual device probing.

The buttons indicate Sun StorEdge devices that are supported with this instance of the Storage Automated Diagnostic Environment.  

 

 
Manually Update a Device [ Up ]

  1. Click the Maintenance 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 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 once the device has been removed from the site or if device monitoring is no longer needed.

To delete a device:

  1. Click the Maintenance 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 Maintain Host: Update Device window is displayed.
  4. Click Delete.
    Deleting a device from the configuration will not remove the access to the device instrumentation in cache immediately. This will, however, be cleared the next time the agent runs. State information for that device will also be 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 execute the Storage Automated Diagnostic Environment.
 

 

 
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.

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 or perform a clean ras_install, the configuration file remains on the system between upgrades.  

 

 
Customizing Email Deliveries [ 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.  

 

 
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 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. This is the highest priority.
    • 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.

For events that produce frequent error messages, specify the number of times you are notified. If the maximum number is set to a value other than "no maximum" (the default), you can receive an email 5, 10, 20, or 50 times within an eight-hour period.

Note: If you have set the maximum number of emails to 10, have received 10 emails on the same component within an eight-hour time period, and want to receive more email notifications, you must click the Clear Email maximums button.  

 

 
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.

The Storage Automated Diagnostic Environment supports seven providers: HTTP, Email, SSTR, NetConnect, SRS, SNMP Traps, and RSS. The provider's main function is to relay events generated by health monitors. The providers do this either by pulling the events from the Persistent Data Manager (PDM) or by registering them with the PDM for a certain type of event.

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

Note: If the Storage Automated Diagnostic Environment is run either manually or from the cron, and the RSS Provider is selected but the RSS software is not installed or is not configured properly, the following error message appears:

***ERR: Cannot find Machine name in Permissions file.  

 

 
Push 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 agent's cron 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/Stop Device Monitoring window enables you to deactivate monitoring on a device-by-device basis.

  1. To start or stop devices, check the appropriate checkbox.
  2. Click Submit Changes. The Storage Automated Diagnostic Environment must update the configuration files on all the Slave hosts configured with this Master.
  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 NetConnect 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 Maintenance link in the Storage Automated Diagnostic Environment main window.
  2. Click the Test Email link on the Maintenance menu.
  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 canned 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 Maintenance menu.
  2. 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 returns the options depending on the location and status of the storage device. Use the following information to update existing configuration options: