The Network Storage Agent Graphical User Interface Documentation
- Introduction Help Introduction
- Start Starting the Network Storage Agent
 Maintenance
- General Maintenance Set up the Network Storage Agent(s)
- Maintain Hosts Enter customer and device information and configure host(s)
- Master Configuration Maintain customer and site information.(s)
- Add a New Slave Add a new slave manually
- Discovery Discover new devices
- Discover a Solution Cabinet Instruct the Network Storage Agent to query for a Solution cabinet
- Search the LAN Search the LAN for sun StorEdge devices using Subnet
- Set up T3 Array Monitoring Mirror the Sun StorEdge T3 array's /syslog to a host
- Maintain Devices Add/Delete/Discover 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.
- Add a Device Add a new device to the Network Storage Agent
- Email Notification 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
- 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
 Monitor
- Instrumentation Display FRU level information of the selected device and access components
- Message Summary Generate a report from the /var/adm/messages files
- Snapshot Schedule the execution of the StorTools configuration snapshot
- Revision Checking Check the current revision of software and firmware
- Snapshot History Show a list of previous Snapshot log files
 SAN
- Using the SAN Functionality Display, merge, clear, and check the health of SAN topologies
- Display Topology Display topology drawings of SAN configurations
- Merge Topology Select multiple host topology graphs to be merged into a single view
- Clear Topology Delete the current topology from the database in order to force the discovery of a new topology information
- FC Check Test the condition of the SAN by gathering counter information twice and comparing the values. The SAN agents will look for counters that have incremented between the two runs and report it.
- FC Utilities This page is reserved for trained service personel and has been locked by your system administrator
 Log
- /var/adm/messages Review the content of /var/adm/messages files from any host
- Event Log Search for events on a given log
- Alert Log Display events generated by the Network Storage Agent
- Agent Errors Display and log errors that the Network Storage Agent encounters
 System
- System Time-outs Change the default settings for scheduled time-outs
- Erase Cache Erase cache and regenerate discovery events
- RUN Agent Manually run the rasagent program, rather than execute from the cron facility
- Thresholds List threshold rules for Sun StorEdge devices
- Email-Configuration Email a detailed report of the Agent configuration
- Check Statistics Determine the execution time required to run modules.
- Change Password Change the security password for the Admin GUI
 Online Help
- Utilities Documentation Find online explanations of man(1M) pages
- Help This page
- All Menus Display all the menus along the left window

 

 

 

 

 
Introduction [ Back ]

You can perform the administration of all Network Storage Agent functions from one centralized web page: the Network Storage Agent graphical user interface (GUI).

Note: Before you use the GUI, you must completely install the Network Storage Agent.

By running the ras_install program (/opt/SUNWrasag/bin/ras_install), you add a web server service to the host on port 7654.  

 

 

 

 
Starting the Network Storage Agent [ Back ]

The Network Storage Agent GUI is a browser-based tool that enables you to maintain and tune the Network Storage Agent functions. To access the GUI:

  1. Open a web browser and go to http://hostname:7654.
  2. Log in to the Network Storage Agent by typing:

    Login: ras

    Default password: agent

The Master Configuration window opens automatically the first time you initiate the GUI. The Master Configuration screen may also appear if there are empty mandatory fields, which may occur after an upgrade.

Note: The Network Storage Agent is always accessed on port 7654 of the host configured as the master agent. All the agents communicate with one another through this port to synchronize their configurations.  

 

 
Maintenance [ Back ]

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

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

 

 
Maintain Hosts [ Back ]

You can use the Maintain Hosts window to maintain a list of hosts from where the Network Storage Agent is running. When the Network Storage Agent package is installed on a host, it registers with the master Network Storage Agent and an entry is added to this page. For this automatic registration to work, you must first install the master agent. Once all hosts are installed, you can access this page to change the configuration of each host.

The three main functions of this window are:

 

 

 
Master Configuration [ Back ]

To access the Master Configuration window, click on a hostname from the Maintain Hosts window. The Master Configuration window enables you to maintain customer and site information. In addition, you can enter default storage logfiles and local Network Storage Agent information. You can select the monitoring frequency, which can vary from five to 120 minutes. This window also enables you to turn on and turn off the monitoring on a device-by-device basis.

The fields for the Master Configuration window follow.

 

 

 
Add a New Slave [ Back ]

If an agent does not automatically register, or you anticipate to registering in the future, you can add a new slave manually.

To access the Maintain Hosts: Add New Slave window:

  1. Click the Maintenance link on the Network Storage Agent window.
  2. Click the Maintain Hosts link from the Maintenance menu.
  3. Click the Add New Slave button.
  4. The fields for the Add New Slave window follow.

     

     

     
    Device Discovery [ Back ]

    Use the Device Discovery function to request the Network Storage Agent to probe the environments for the desired device types.

    You can request the Network Storage Agent to probe the environments for the device types shown on the Device Discovery window.

    To Access the Device Discovery window:

    1. Click the Maintenance link on the Network Storage Agent window.
    2. Click the Discovery link from the Maintenance menu.

    The Device Discovery window will be displayed.

    Note:

    As long as there are valid T3 entries in this log file, the auto-discovery will find them and add them. You can avoid adding older, unwanted T3s 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 needs to be in the /etc/fcswitch.conf file. The Network Storage Agent will discover the cascaded switch when the first switch is discovered.

    If a switch is not in the /etc/fcswitch.conf file, you can manually add it. Be aware, however, that the SAN topology will display the name you give to the switch and not necessarily the switch's official trademarked name.

    Note:

    Once you have added a switch to the /etc/fcswitch.conf file, you must return to the Maintain Hosts window and select the host. The Master Configuration window will be displayed. Scroll down to the section "Enter Local Network Storage Agent Information" and click on the "Show OutofBand devices in topology" button.  

     

     
    Discover a Solution Cabinet [ Back ]

    Use the Solution button from the Device Discovery window to instruct the Network Storage Agent to query for a Solution cabinet.

    1. Select the host from the Run on Host menu.
    2. Enable the Turn Monitoring On toggle button.
    3. Select a host from the Data Path Host pull down menu. This host may be the same as, or different from, your local host.
    4. Click SE Series Discovery.

    Note:

    With this functionality, made available with Patch 111893-03, the Network Storage Agent employs a direct fibre channel connection (in-band) to the Sun StorEdge T3 arrays and Sun StorEdge switch devices.  

     

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

    Use the Subnet button to search the LAN for Sun StorEdge SAN Release 3.0 switch devices and Sun StorEdge T3 arrays.

    1. Enter the address of the subnet you want searched.
    2. Enter the prefix to call the name of the device.

    The Subnet functionality can search two subnets at a time (for example, Subnet 10.1.0 and Prefix 10.1Net, with Subnet 10.2.0 and Prefix 10.2Net).

    All discovery results are sent back to the master agent, which stores them in the main configuration file.  

     

     
    Set Up Sun StorEdge T3 Array Message Monitoring [ Back ]

    In order for the Network Storage Agent software package to monitor messages from a Sun StorEdge T3 array, you must mirror the Sun StorEdge T3 array's /syslog to a host with the Network Storage Agent installed and configured to monitor Sun StorEdge T3 arrays.

    1. Refer to the Sun StorEdge 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 message log file.
     

     

     
    Maintain Devices [ Back ]

    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 Network Storage Agent will use as a reference to that device through its email notifications.

    NOTE: This will not affect the naming of the device from the perspective of the host's operating system.

    Be aware of the host's access method when making decisions about which devices the Network Storage Agent will monitor.

    Note:

    The Primary Host column lists the registered host that will do the actual device probing. The buttons indicate Sun Network Storage devices that are supported with this instance of the Network Storage Agent.  

     

     
    Update a Device [ Back ]

    1. From the Maintain Devices window, select the device you want to update from the Existing Devices list.
    2. Once you have corrected the necessary fields, click Update.

    Note:

    Changing the name of the device changes only the reference to that device within the Network Storage Agent. It does not affect the access or reference to that device within the operating system.  

     

     
    Delete Devices [ Back ]

    You can delete a 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 Network Storage Agent's main window.
    2. Click the Maintain Devices link from the Maintenance menu.
      The Maintain Devices window is displayed.
    3. From the Maintain Devices window, select the device you want to delete from the Existing Device list.
      The Maintain Host: Update Host window is displayed.
    4. Click Delete.
      By deleting a device, the Network Storage Agent does not remove the agent from the slave host, but instead renders the agent on that host inactive, in anticipation of being readded to the Master Configuration.
    5. To temporarily deactivate a device from sending alerts to local notification(s), refer to "Deactivate Monitoring on a Device-by-Device Basis."
     

     

     
    Add Devices [ Back ]

    From the Add a New Device section of the Maintain Devices window, select the type of device you want to add to the Network Storage Agent.

    Complete the fields using the descriptions that follow.