Storage Automated Diagnostic Environment 2.3 Device Edition Release Notes
Patch 116720-03 Release Notes

Part Number: 817-6192-10
Date: Mar/01/04
=========================

READ BEFORE USING THIS REVISION

The Release Notes contain information specific to this
revision. This information is not elsewhere in the
product documentation set.

The Release Notes for this product are on the product media.
You can print them as you would any other ASCII file.

Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A. All rights reserved.

Sun Microsystems, Inc. has intellectual property rights relating to
technology embodied in the product that is described in this document.
In particular, and without limitation, these intellectual property
rights may include one or more of the U.S. patents listed at
http://www.sun.com/patents and one or more additional patents or
pending patent applications in the U.S. and in other countries.

This document and the product to which it pertains are distributed
under licenses restricting their use, copying, distribution, and
decompilation. No part of the product or of this document may be
reproduced in any form by any means without prior written authorization
of Sun and its licensors, if any.

Third-party software, including font technology, is copyrighted and
licensed from Sun suppliers.

Parts of the product may be derived from Berkeley BSD systems, licensed
from the University of California. UNIX is a registered trademark in
the U.S. and in other countries, exclusively licensed through X/Open
Company, Ltd.

Sun, Sun Microsystems, the Sun logo, AnswerBook2, Sun StorEdge,
docs.sun.com, Sun Enterprise, Sun Fire, SunOS, Netra, SunSolve, and
Solaris are trademarks or registered trademarks, or service marks of
Sun Microsystems, Inc. in the U.S. and in other countries. All SPARC
trademarks are used under license and are trademarks or registered
trademarks of SPARC International, Inc. in the U.S. and in other
countries. Products bearing SPARC trademarks are based upon an
architecture developed by Sun Microsystems, Inc.

The OPEN LOOK and SunTM Graphical User Interface was developed by Sun
Microsystems, Inc. for its users and licensees. Sun acknowledges the
pioneering efforts of Xerox in researching and developing the concept
of visual or graphical user interfaces for the computer industry. Sun
holds a non-exclusive license from Xerox to the Xerox Graphical User
Interface, which license also covers Sun's licensees who implement
OPEN LOOK GUIs and otherwise comply with Sun's written license
agreements.

U.S. Government Rights-Commercial use. Government users are subject to
the Sun Microsystems, Inc. standard license agreement and applicable
provisions of the FAR and its supplements.

DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED
CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH
DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.


Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, Etats-Unis. Tous droits réservés.

Sun Microsystems, Inc. a les droits de propriété intellectuels
relatantsà la technologie incorporée dans le produit qui est décrit
dans ce document. En particulier, et sans la limitation, ces droits
de propriété intellectuels peuvent inclure un ou plus des brevets
américains énumérés à http://www.sun.com/patents et un ou les brevets
plus supplémentaires ou les applications de brevet en attente dans
les Etats-Unis et dans les autres pays.

Ce produit ou document est protégé par un copyright et distribué
avec des licences qui en restreignent l'utilisation, la copie, la
distribution, et la décompilation. Aucune partie de ce produit ou
document ne peut être reproduite sous aucune forme, parquelque moyen
que ce soit, sans l'autorisation préalable et écrite de Sun et de
ses bailleurs de licence, s'il y ena.

Le logiciel détenu par des tiers, et qui comprend la technologie
relative aux polices de caractères, est protégé par un copyright et
licencié par des fournisseurs de Sun.

Des parties de ce produit pourront être dérivées des systèmes Berkeley
BSD licenciés par l'Université de Californie. UNIX est une marque
déposée aux Etats- Unis et dans d'autres pays et licenciée
exclusivement par X/Open Company, Ltd.

Sun, Sun Microsystems, le logo Sun, AnswerBook2, Sun StorEdge,
docs.sun.com, Sun Enterprise, Sun Fire, SunOS, Netra, SunSolve, et
Solari sont des marques de fabrique ou des marques déposées de Sun
Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

Toutes les marques SPARC sont utilisées sous licence et sont des
marques de fabrique ou des marques déposées de SPARC International,
Inc. aux Etats-Unis et dans d'autres pays. Les produits protant les
marques SPARC sont basés sur une architecture développée par Sun
Microsystems, Inc.

L'interface d'utilisation graphique OPEN LOOK et SunTM a été développée
par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun
reconnaît les efforts de pionniers de Xerox pour la recherche et le
développment du concept des interfaces d'utilisation visuelle ou
graphique pour l'industrie de l'informatique. Sun détient une license
non exclusive do Xerox sur l'interface d'utilisation graphique Xerox,
cette licence couvrant également les licenciées de Sun qui mettent en
place l'interface d 'utilisation graphique OPEN LOOK et qui en outre
se conforment aux licences écrites de Sun.

LA DOCUMENTATION EST FOURNIE "EN L'ÉTAT" ET TOUTES AUTRES CONDITIONS,
DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT
EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS
NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A
L'APTITUDE A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE
CONTREFAÇON.


DOCUMENT STRUCTURE
==================

These Release Notes contain the following sections:

o Introduction
o Audience
o Deliverables
o Related Documentation
o Qualified Platforms
o New Features
o Installation Instructions
o Product Hints
o Known Problems
o Resolved Problems
o Media Contents


INTRODUCTION
============

The Storage Automated Diagnostic Environment 2.3 package
provides a graphical user interface, enabling the user to remotely
monitor and diagnose Sun storage devices.  The Agent can be used
to collect data and analyze the condition of Sun StorEdge devices.
The Diagnostics can be used to verify the condition
of a system, identify failing FRUs and verify FRU replacement.


AUDIENCE
========

The Storage Automated Diagnostic Environment is for use by
system administrators and support personnel
who are familiar with Sun's disk array and SAN products.


DELIVERABLES
============

Documentation Delivered With This Product
-----------------------------------------
The following documentation is delivered with this product:

Application     Title
-----------     -----

Man Pages       6120ofdg.1m
                6120ondg.1m
                6120volverify.1m
                a3500fctest.1m
                a5ksestest.1m
                a5ktest.1m
                brocadetest.1m
                checkcron.1m
                clearcache.1m
                config_solution.1m
                d2disktest.1m
                daksestest.1m
                daktest.1m
                dex.1m
                discman.1m
                disk_inquiry.1m
                fcdisktest.1m
                fctapetest.1m
                ifptest.1m
                lbf.1m
                linktest.1m
                qlctest.1m
                ras_admin.1m
                ras_fccheck.1m
                ras_install.1m
                ras_revcheck.1m
                rasagent.1m
                sanbox.1m
                save_password.1m
                snapshot.1m
                socaltest.1m
                stresstest.1m
                switchtest.1m
                switch2test.1m
                t3ofdg.1m
                t3test.1m
                t3volverify.1m
                testt3.1m
                vediag.1m
                veluntest.1m

User/Admin      Storage Automated Diagnostic Getting Started Guide
                (817-3284-10)


PRODUCT PACKAGING
=================

The Storage Automated Diagnostic Environment 3.2 software is
distributed as an unbundled product in the pkgadd format as SUNWstade.


RELATED DOCUMENTATION
=====================

User/Admin      Best Practices for Deploying the Storage Automated Diagnostic
                Environment to Monitor Storage (XXX-XXXX-XXX)

Sun StorEdge T3 and T3+ Array documentation:
    Sun StorEdge T3 and T3+ Array Start Here (816-0772-10)
    Sun StorEdge T3 and T3+ Array Installation, Operations and
                            Service Manual (816-0773-10)
    Sun StorEdge T3 and T3+ Array Administrator's Guide (816-0776-10)
    Sun StorEdge T3 and T3+ Array Configuration Guide (816-0777-10)
    Sun StorEdge T3 and T3+ Array Site Preperation Guide (816-0778-10)
    Sun StorEdge T3 and T3+ Field Service Manual (816-0779-10)
    Sun StorEdge T3 and T3+ Array Release Notes (816-0781-12)

Sun StorEdge A5000 Array documentation:
    Sun StorEdge A5000 User's Guide (806-1946-10)
    Sun StorEdge A5000 Release Notes (806-1947-10)
    Sun StorEdge A5000 Product Note (805-1018-13)
    Sun StorEdge A5000 Configuration Guide (805-0264-15)
    Sun StorEdge A5000 Installation and Documentation Guide (805-1903-15)

Sun StorEdge PCI FC-100 Host Adapter documentation:
    Sun StorEdge PCI FC-100 Host Adapter Installation Manual (805-3682-10)

Sun StorEdge SBus FC-100 Host Adapter documentation:
    Sun StorEdge SBus FC-100 Host Adapter Installation and
                                          Service Manual (802-7572-11)

Sun StorEdge PCI Dual Fibre Channel Host Adapter documentation:
    Sun StorEdge PCI Dual Fibre Channel Host Adapter Product Notes (806-5857-10)
    Sun StorEdge PCI Dual Fibre Channel Host Adapter Installation
                                                     Guide (806-5600-10)

Sun StorEdge 2Gb PCI Single Fibre Channel Host Adapter documentation:
    Sun StorEdge 2Gb PCI Single Fibre Channel Host Adapter Product Notes (X6767A)
    Sun StorEdge 2Gb PCI Single Fibre Channel Host Adapter Installation
                                                     Guide (X6768A)

Sun StorEdge 2Gb PCI Dual Fibre Channel Host Adapter documentation:
    Sun StorEdge 2Gb PCI Dual Fibre Channel Host Adapter Product Notes (806-5857-10)
    Sun StorEdge 2Gb PCI Dual Fibre Channel Host Adapter Installation
                                                     Guide (806-5600-10)

Sun StorEdge 2Gb cPCI Dual Fibre Channel Host Adapter documentation:
    Sun StorEdge 2Gb cPCI Dual Fibre Channel Host Adapter Product Notes
    Sun StorEdge 2Gb cPCI Dual Fibre Channel Host Adapter Installation
                                                     Guide (X6769A)

Sun StorEdge A3500/A3500FC documentation:
    Sun StorEdge A3500/A3500FC Hardware Configuratoin Guide (805-4981-13)
    Sun StorEdge A3500/A3500FC Controller Module Guide (805-4980-11)
    Sun StorEdge A3500/A3500FC Task Map (805-4982-11)

Sun StorEdge RAID Manager 6.22 documentation:
    Sun StorEdge RAID Manager 6.22 User's Guide (806-0478-10)
    Sun StorEdge RAID Manager 6.22 Release Notes (806-3721-10)

Sun StorEdge Network FC Switch-8 and Switch-16 documentation:
    Sun StorEdge Network FC Switch-8 and Switch-16 Installation and Config
                                                   Guide (806-6922-10)
    Sun StorEdge Network FC Switch-8 and Switch-16 Field Troubleshooting
                                                   Guide (816-0252-10)
    Sun StorEdge Network FC Switch-8 and Switch-16 Release Notes (816-0842-15)

Sun StorEdge Network 2 Gb FC Switch-8, Switch-16, and Switch-64 documentation:
    Sun StorEdge SAN 4.0 Release Guide to Documentation (816-4470-10)
    Sun StorEdge SAN 4.0 Release Installation Guide (816-4469-10)
    Sun StorEdge SAN 4.0 Release Configuration Guide (806-5513-10)
    Sun StorEdge SAN 4.0 Release Notes (816-4472-10)

McData ED6064 and ES3232 FC switches:
    The following documents may be found on the McData Website,
       http://www.mcdata.com:
     Intrepid TM 6064 Director Planning Manual
     Intrepid TM 6064 Director Manager User Manual
     SAN Plannning Guide
     Manager Software User Manual
     Command Line Interface User Manual

     This information can be found under:
       Knowledge Center Link -> Technical Documents

     Additional publications are available by means of McData's secure web
     site. Please contact webmaster@mcdata.com for access.

Sun StorEdge 3900 and 6900 Series documentation:
    Sun StorEdge 3900 and 6900 Series Reference and Service Guide (816-5253-10)
    Sun StorEdge 3900 and 6900 Series Site Perperation Guide (816-5256-10)
    Sun StorEdge 3900 and 6900 Series Regulatory and Safety Compliance
                                      Manual ( 816-5257-10)
    Sun StorEdge 3900 and 6900 Series Installation Guide (816-5252-10)
    Sun StorEdge 3900 and 6900 Series Troubleshooting Guide (816-5255-10)

Solaris:
    Solaris Handbook for Sun Peripherals (806-2210-10)


QUALIFIED PLATFORMS
===================

You can use the SUNWstade package on the following platforms and
operating systems:

Sun Platforms        : All Sun Sparc Solaris servers

Sun StorEdge         : Sun StorEdge A5000 Array (14 slot)
                       Sun StorEdge A5200 Array (22 slot)
                       Sun StorEdge A3500-FC Array
                       Sun StorEdge T3 Array (F/W 1.17 or greater)
                       Sun StorEdge T3+ Array (F/W 2.0 or greater)
                       Sun StorEdge 6120 Array
                       Sun StorEdge FC Tape T9840
                       Sun StorEdge FC Tape T9840B
                       Sun V880 Internal Fibre Channel Disks
                       Sun E3500 Internal Fibre Channel Disks
                       Sun StorEdge D2
                       Sun StorEdge 3510 FC Array
                       Sun StorEdge 3900 Series
                       Sun StorEdge 6900 Series
                       Sun StorEdge 6320 System
                       Sun StorEdge 9910
                       Sun StorEdge 9960
                       Sun StorEdge 9970
                       Sun StorEdge 9980

SAN                  : Sun StorEdge Network FC Switch-8 and Switch-16.
                       Sun StorEdge Network 2 Gb FC Switch-8, Switch-16
                       and Switch-64.
                       Brocade Silkworm 2400/2800 FC Switch
                       Brocade Silkworm 3200/3800/12000 FC Switch
                       Brocade 3900 32 Port FC Switch
                       McData ED6064 FC Switch
                       McData ES3232 FC Switch
                       McData 4500 2GB 24 Port FC Switch
                       McData 6140 FC Switch
                       Inrange FC 9000 Director FC Switch

Host Bus Adpaters    : Sun StorEdge PCI FC-100 Host Adapter
                       Sun StorEdge SBus FC-100 Host Adapter
                       Sun StorEdge PCI Dual Fibre Channel Host Adapter
                       Sun StorEdge 2 Gb FC PCI Single Channel Network Adapter
                       Sun StorEdge 2 Gb FC PCI Dual Channel Network Adapter
                       Sun StorEdge 2 Gb FC cPCI Dual Channel Network Adapter
                       JNI FC Host Adapter

Operating Systems    : Solaris 9
                       Solaris 8 4/01 or greater.
                       Reference the "Best Practices for Deploying Storage
                       the Sun StorADE Utility" (817-5205-10)
                       or the Storage Automated Diagnostic Getting
                       Started Guide (817-3284-10) for details on monitoring
                       data hosts with other Solaris or non-solaris OEs.

                       http://www.sun.com/blueprints

Browsers:            : Netscape 4.76, 7.x, Mozilla 1.2.1, IE 5.x, 6.x

Perl                 : 5.005 thru 5.6 is mandatory.  Use the following URL
                       to acquire the proper version if necessary.
                       http://www.perl.com/pub/language/info/software.html

                       If the proper version does in fact already exist,
                       create a symbolic link of the executable to
                       /usr/bin/perl.


FEATURES
========

o Collects and reports information about Sun StorEdge devices. Type of
  information reported on includes device configuration, device statistics,
  device state and availability, device message-log information, and
  system configuration.

o Incorporates a graphical user view of FC StorEdge devices and the
  interconnects.

o Contains an event grid that provides recommended service actions for
  each event.

o Creates a model of the device and its components, storing state
  information about that device and saving log information.

o Contains revision checking functionality of Fiber Channel devices.


INSTALLATION INSTRUCTIONS
=========================

o You must be superuser to install this package.

o Sun Download Center

  # su
  # cd /tmp

    download compressed tar image to /tmp

  # uncompress SUNWstade.tar.Z
  # tar xvf /tmp/SUNWstade.tar
  # pkgadd -d .
    .
    .
    .

o Installation CD

  # su
  # cd /cdrom/cdrom0/product/packages
  # pkgadd -d .

o Locate potential patch(es) on sunsolve and download/install.

o After the package and patch(es) are completely installed, execute the program
  "/opt/SUNWstade/bin/ras_install" to install the Agent service and cron.

  # /opt/SUNWstade/bin/ras_install -h
  # /opt/SUNWstade/bin/ras_install

o After installing, set the environment
  variables PATH and MANPATH to include the
  directories "/opt/SUNWstade/bin" and "/opt/SUNWstade/man".

  # man ras_install

o Review the User's Guide which applies to your locale

o Following the ras_install procedure, connect to the
  system using a supported browser using port 7654.
  (ie. http://{hostname}:7654)

o Default login as user "ras" with the password "agent". The default
  ras password can be changed under Admin->System Utilities->Root
  Password.  Additional user's can also be added under Admin->System
  Utilities->Login/Roles.

o Follow the "Basic Installation Steps" or Select "Basic Steps in Popup"
  from the Master's Home Page. Complete all required steps.

o Revision Checking should be run before creating a topology.
  Updating all firmware and software components to the current revisions,
  ensures that the devices have the capabilities required to be
  discovered, monitored and diagnosed properly.


PRODUCT HINTS
=============

o If you previously had JNI HBA cards installed with the base version of
  StorADE (2.2.00.03), you will need to run topology discovery again in
  order for this patch to see the JNI HBA cards.

o StorADE is a device monitoring tool that probes devices on the ethernet
  and for direct attached storage devices, accesses the device on the
  datapath (Fibre Channel).
  ***************************************************************************
  ***************************************************************************
  For most storage arrays, it is important to queiesce any and all monitoring
  during upgrade operations.
  ***************************************************************************
  ***************************************************************************

  Use the following information that best suits
  this site for stopping StorADE from monitoring:

  Stopping StorADE
  ----------------
  There are several ways to accomplish the task of stopping the StorADE
  monitoring agents from probing a storage array during an upgrade.

  One way would be to disable the specific agent from executing.  This would
  allow for the continuing of the monitoring of other types of devices.

    Disabling the Agent
    -------------------
      GUI
      ---
        Select General Maintenance -> Maintain Hosts -> host_name
        Deselect the Device as a Category to monitor -> Submit

      CLI
      ---
        There is no cli command in 2.0 to directly affect individual
        categories to monitor.

  The most efficient way to stop StorADE from monitoring entirely would
  be to set the stop bit or stop the cron from executing.

    Disabling StorADE
    -----------------
      GUI
      ---
        Select General Maintenance -> Stop Agents -> Stop -> Submit

      CLI
      ---
        Execute ras_install and select "P" to postpone the execution of
        rasagent from cron.  This will remove the cron entry that starts
        the agent every 5 minutes.

        NOTE: This will not immediately stop any existing execution of
        the StorADE agent.  Use the 'ps` command to ensure all storade
        activity has ended.

                 `ps -ef | grep ras'



o If a Sun StorEdge 3510 FC array was already discovered before applying this
  patch, the user will need to delete this device, rediscover the device and
  create a new topology snapshot after applying this patch.

o With old Brocade switch firmware, Storade's use of SNMP may trigger
  a memory leak in the Brocade firmware, causing a reboot.
  See BugID:  4819138

o You should be familiar with UNIX commands and Sun's disk array
  products before attempting to use this product.

o System administrators should know about security risks associated with
  installing a web server. Take the appropriate action to protect access
  to the SUNWstade port 7654.

o The SUNWsan package is a component of the San Foundation Software kit
  (www.sun.com/storage/san).  There are separate kits for each of Solaris 8
  and 9. In addition to the SFS kit, the luxadm patches required are:

  Solaris 8:  111413-xx (current -11) and 109529-xx (current -06)
  Solaris 9:  113043-xx (current -05)

o All communicating Master and Slave Agents MUST be executing the
  same version and patch level of Sun's Storage Automated Diagnostic
  Environment.

o If upgrading from SUNWstade 2.0, you must remove the /var/opt/SUNWstade
  directory after pkgrm of SUNWstade 2.0.

o Must use "/opt/SUNWstade" as the package base directory.

o When installing a new patch to SUNWstade:
  stop the agents before installing the update
  and execute the /opt/SUNWstade/bin/ras_install program
  after installing the update

o If there are existing problems with a storage device when the package
  is installed, these problems may not be detected or reported.
  They will, however, generate an event (type of event is based on the
  type of failure) when the error condition is corrected.

o Brocade FC Switch configurations using segmented loop
  (SL) zones can be monitored and diagnosed but the topology
  views will not show connections between devices.

o switchtest and linktest may not provide diagnostics for
  fibre channel links between downrev'd HBAs and/or downrev'd switches
  as well as fibre channel links between switches and virtualization
  engines (VE). This is a result of the current lack of support for the
  fabric ECHO test command in these products.

o Some browsers such as Netscape 7 will prompt for a username/password
  when applets are loaded.  Enter the same username/password which was
  used to initially log in.

o When using Netscape 6.2.1 with SSL enabled the user MUST point
  the browser to https://hostname w/o the port #.

 When using Netscape 4.79 the following error may occur if
  seperate browser sessions are initiated from the command line. The user
  may or may not see this specific message but this error will prevent the
  user from seeing the topology view screens:

  #error The certificate issuer for this server is not recongized by Netscape.
  The security certificate may or may not valid.
  Netscape refuses to connect to this server (-8179) java40.tar/ifc11.jar
  java.lang.SecurityExcpetion: system classes not signed

  exit Netscape (close all windows)

  Solaris:
  cd .netscape
  mv key3.db key3.bad
  mv cert7.db cert7.bad
  restart Netscape

  Windows:
  C:/Program Files/Netscape/Users/username/
  rename key3.db key3.bad
  rename cert7.db cert7.bad

o Creation of /etc/deviceIP.conf file may be utilized for discovery
  of all StorADE supported FC devices that have ethernet connectivity.
  In order to discover 3510 devices with this method, you must put the
  device type in the deviceIP.conf file (because they don't support SNMP).
  Example:

  # device_ip  device_name [device_type]  # comments
  # The device_type is optional but required for devices that do not support
     snmp
  10.0.0.1 t3-1a
  10.0.0.2 minnow1  3510
  10.0.0.3 indy1    se

o Subnet discovery is the preferred method of discovery. This will discover
  all devices that support SNMP. NOTE: 3510 do not support SNMP, use
  the /etc/deviceIP.conf to discover these devices.

o When removing patches, turn off the monitoring of all devices under:

  Administration -> Maintain Hosts

  before removing a patch.
  Turn the monitoring back on after the patch has been removed.


o If the Solaris host that the StorADE Master is installed on uses 'compat'
  in the /etc/nsswitch.conf file, the Administrator must manually set the
  User Password. Checking the "NIS Password" box does not work in
  conjunction with 'compat'.

o In order to monitor HDS, the monitoring host must be given SNMP access to the
  HDS array.

o Support for Inrange switches includes topology and port status only.


2.3 CHANGES AND ENHANCEMENTS
============================

o Support Inrange FC9000 Switches
o Support for JNI Host Bus Adapters
o Support for HDS
o Support for 6140 McData FC Switch
o Periodic vol verify scheduling
o Updated revision matrix
o Bug fixes


2.2 CHANGES AND ENHANCEMENTS
============================

o  Added monitoring support for McData ED6064 and ES3232 FC switches
o  Added HUB support
o  Added support for 2Gb T9840B Tape Drive
o  Support 3900SL/6900SL
o  Support StorEdge 6120
o  Support StorEdge 6320
o  Support StorEdge 3510 FC array


2.1 CHANGES AND ENHANCEMENTS
============================

o  Added notification provider for SunMC
o  Support Internal FC disks
o  Support V880 Disk Array
o  Support D2
o  Support Sun StorEdge(TM) Network FC 2 GB-8/16/64
o  Support Brocade Silkworm Fibre Channel Switch
o  Support Brocade Silkworm 2GB Fibre Channel Switches
o  Support 3900SL/6900SL
o  Support Solaris 9
o  Added link and launch interface for management applications
o  Added CLI stresstest
o  Added CLI interfaces
o  Improved User Interface
o  Added revision checking matrix 3.13
o  Add SSL
o  Support Netscape 6
o  Support IE 5.0
o  Miscellaneous additions and bug fixes
o  Documentation updates
o  Improved online help
o  I18N ready
o  L10N ready


EXTERNAL PRODUCTS AND PACKAGES
==============================

o SunMC - Storage Automated Diagnostic Environment is capable of sending alerts
to the Sun Management Center (SunMC). Two packages must be installed for this
functionality.  These packages are installed using the pkgadd(1) utility and
are located in the /System/SunMC directory of the Storage Automated Diagnostic
Environemnt base directory.

  o SUNWesraa - This SunMC Module package is designed for the SunMC agent
    environment and must be installed on a host that has the SunMC agent
    running on it. This may or may not be the Storage Automated Diagnostic
    Environment host. This module module receives data from the Storage
    Automated Diagnostic Environment and forwards it to the SunMC server.
    The host IP address for the server containing the SunMC server must be
    provided in the Providers page.

  o SUNWesras - This SunMC Module package is designed for the SunMC server
    environment and is optionally installed on the SunMC server host.
    When installed, this package adds the ability for "Group Operations".
    The package is installed using the standard Solaris pkgadd(1) utility.

  The following process is recommended in order to install and activate SunMC
  for Storage Automated Diagnostic Environment and assumes that the SunMC
  application is running.

  (a) Install the SunMC agent on the selected host. It is recommended that this
      also be the Storage Automated Diagnostic Environment station.  If StorADE
      slave agents are used, this package should be installed on the StorADE
      host which is configured as the master agent.  Refer to the appropriate
      SunMC documentation for additional information.

  (b) Install the module package SUNWesraa on the same machine identified in
      step (a).

  (c) Use the SunMC command/console to start the SunMC agent and load the module
      called "rasagent". While the module is loaded you will be required to
      provide the IP address of the Storage Automated Diagnostic Environment
      management station in the "Provider IP Address" field.

  (d) In Storage Automated Diagnostic Environment, add the IP address of the
      SunMC "Server".  The "Port" used is normally 18055 and the "Resource" can
      be anything.

  (e) If user wants to perform the "Group Operation" in SunMC, he should install
      the module package SUNWesras on the SunMC server host.

Once activated the SunMC module will receive information on what devices are
being monitored and will display alarms in the SunMC.  If further information
is required for the alarms, log into the instance of Storage Automated
Diagnostic Environment to view alert details.


KNOWN, UNRESOLVED PROBLEMS
==========================

o 4812682 add logic to recognize an upgrade process and consequently block
          access
          Be sure to disable StorADE from monitoring while upgrading T3 disk firmware.

o 4825088 6120:Loopback test does not work with loopback connector installed
          Until this bug is fixed by the array firmware, StorADE will indicate
          that the array is bad, even though it may be okay.


PATCH MEDIA CONTENTS
====================

See the corresponding README file.


RESOLVED PROBLEMS with patch 116720-03
======================================

Bug Id  Synopsis
------- ------------------------------------------------------------------
5004265 remove references to 6920
4997540 Severity of disk sense key messages incorrect and improperly grouped
4997545 Disk sense key messages generating seperate events
4966100 Cannot install Netconnect 3.0.4 SUNWsrssp pkg with Storade 2.3
4988108 NSCC: NWS_System had a null Name attribute for mcdata.StateChangeEvent
4991012 SUNWstade install_netconnect fails to include library
4977589 NSCC: 6020 firmware versions are not being displayed in the NSCC
4899903 change 0x3 0x11 and 0x01 18 errors to notice
4976847 Recovered disksense event 38.20.100 severity to high
4984533 Version number not updated after applying StorADE 2.3 patch.
4964395 NSCC: the nscc email provider is hanging on a 663K email xfer
4970881 I18N: need to update version number and names of the compressed packages
4971229 I18N: Language Browser choice does not show "Traditional Chinese" when package a
4975099 ESM: Instrumentation report for Brocade 1Gb & 2Gb switches is missing port speed
4954827 add the ability to send a notice thru the snmp trap provider
4837280 send  vol-id with each lun in storade -> DE interface
4907410 ESM: Provide slice wwn in rack insrumentation report
4943724 Three different statuses in a single field is confusing  (explain in doc)
4956885 SENSE KEY: disk_scrubber repair lower severity to warning
4965660 No PC or RA with actionable host.AlarmEvent 7.5.ERR_lun.SExxxx
4969128 Actionable se2.StateChangeEvent 30.5.197 needs PC or RA
4969214 se2.StateChangeEvent from datahost monitoring rack has no PC or RA
4969221 Datahost monitoring rack did not report repair of loop cable on u1l2
4969368 Aggregated event 38.20.103 repeats the events
4970686 SUNWstade datahost link fails to arrayXX and dsp00 for se2 solution
4971412 multiple alarms created for single disk failure in a5k
4971873 Wrong disk FW revision for seagate 18gb Half Height Model# ST118202FC
4975073 Actionable 6020.LinkEvent_ITW 38.44.16 should be re-classified as an "Error"
4975152 monitor logs on slave gives error for /var/adm/messages
4975204 killvolverify does not read the default password::needs device summary override
4977022 StorADE 2.3 patch installation changes file permissions to bin:bin.
4460070 Should monitor for reallocation of blocks as indication of drive going bad
4524940 Req user notification if multiple users are logged on and password changes
4673002 Perform low overhead tasks more frequently than high overhead tasks
4675730 Request that baterry fresh cycles on T3's are phonehome as nobeep notifications
4743552 Storade Error From T3 Notification of Data Auto Re-Allocated
4922781 need ability to print topology with graphics
4971063 6320 : se_extract should collect the properties files from 6020 arrays.
4848813 HELP: Stoplight not documented in online guide
4926912 Alarms > Current Alarms : [All] - Grid Code link does not work.
4948019 Monitor->Diagnose->Test Detail Options should read Display Command
4955440 Site Information duplicate mandatory label
4958211 event code 13.3.156 in t3.grid has no action
4964368 storade warnings about xml parse error on raidbaseview
4973887 Host Instrumentation report lists patch applied to SUNWstads on device edition
4974872 M2b9,11:Monitor>Topo doesn't display links between the monitored devices.
4974988 icon for system1 isn't big enough
4848857 Service Advisor popup should contain event code for the event.
4851192 chunk rasagent executions into segments so that notifications can ocurr sooner
4943669 add carriage return to make output from "Generate New Inventory" clearer to read
4966564 Alarms -> Current Alarms page truncates names and topics
4944749 HBA port not red when path is disconnected
4955165 review config not Warning topology not created
4962794 Execution errors in alarms, event maint, and monitor pages
4963073 Negative value in Email and Event Maximums Not set count for driver.SSD_WARN.
4965930 After communication is regained to a 3510, old events and alarms are displayed.
4967065 Storade_pvr registration should be change from 002.002.000 to 002.003.000
4968616 3510: rasagent -d3 does not excute diag error -chan on the disk 0.
4969126 HBA port on host topology not red after being disconnected
4809298 6120-ofdg is unpredictable, int passes/fails, leaves unit in unknown state
4947845 Event Maintenance page contains column marked "Component" not same as Alarm page
4947849 Event Maintenance page has "Delete All Green" and "Delete All Yellow" buttons
4956749 2g Brocade switch is listed as DOWNREV but does not have an upgrade id.
4969159 Linktest should refer to dsp slot and port numbers when isolating
4959059 Revision matrix out of date
4812633 agent reports ERR cron_conflict
4846729 Summary report is not reporting associated 6320 lun name like 6120 and t3b does.
4863264 se2configcheck never automatically updates status to Done, must "sync"
4911311 Maintain Devices not removing Admin Group when groups deleted
4918213 ESM: Diagnostic request from ESM fails to elicit a response
4937370 Storade no longer drawing links between datahost and monitored xxxx rack
4938572 6120 (background)  discovery not showing in discovery page.
4947903 Event Advisor Pane is incomplete
4947922 Reference to host:sp-87.central.sun.com could mislead customer
4955212 Restart of standby SFC causes 3 actionable and 1 non-actionable ssrr events
4955229 Storade not checking dsp Log_Info messages for positive going events
4959644 clicking on link of mcdata switch results in "cannot access device"
4963845 Incorrect category for xxxx in notification.
4964378 Lost comm events on dsp when array00 master ctr disabled, not w/array01
4966402 subnet discovery tries to add an invalid IP, then post error
4897981 ras_revcheck -M ALL leaves out some modules in report.
4947855 Revision_check dead process not isolated.
4947939 names in Monitor->Device table should read device:name
4948058 Diagnose->Utilities->Continuous Vol Verify page has no data - VolVerify running
4956941 LogEvent.driver.SSD_ALERT & .SSD_WARN recieved eventcode 7.20.329 & 7.20.330
4964587 ras-admin device_delete does not remove the SE3510 from the configuration
4965968 Event 17.3.36 not in Event Advisor.
