Storage Automated Diagnostic Environment
Patch 115704-01 Release Notes

Part Number:  817-0192-10 
Jun/18/03

=========================


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 2003 Sun Microsystems, Inc., 901 San Antonio Road,
Palo Alto, CA 94303 USA. All rights reserved. 

This product or document is protected by copyright and distributed 
under licenses restricting its use, copying, distribution, and 
decompilation. No part of this product or 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 other countries, exclusively licensed through X/Open 
Company, Ltd.

Sun, Sun Microsystems, the Sun logo, AnswerBook, Sun StorEdge, Sun
StorTools, Sun StorEdge T3, and Solaris  are trademarks, registered 
trademarks, or service marks of Sun Microsystems, Inc. in the U.S. 
and other countries. All SPARC trademarks are used under license 
and are trademarks or registered trademarks of SPARC International, 
Inc. in the U.S. and  other countries. Products bearing SPARC 
trademarks are based upon an architecture developed by Sun 
Microsystems, Inc.


The OPEN LOOK and Sun(TM) 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.

RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government 
is subject to restrictions of FAR 52.227-14(g)(2)(6/87) and FAR 
52.227-19(6/87), or DFAR 252.227-7015(b)(6/95) and DFAR 227.7202-3(a).

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 2003 Sun Microsystems, Inc., 901 San Antonio Road, 
Palo Alto, CA 94303 Etats-Unis. Tous droits reserves. 

Ce produit ou document est protege par un  copyright et distribue avec des 
licences qui en restreignent l'utilisation, la copie, la distribution, 
et la decompilation. Aucune partie de ce produit ou document ne peut etre 
reproduite sous aucune forme, par quelque moyen que ce soit, sans 
l'autorisation prealable et ecrite de Sun et de ses bailleurs de licence, 
s'il y en a. Le logiciel detenu par des tiers, et qui comprend la 
technologie relative aux polices de caracteres, est protege par un 
copyright et licencie par des fournisseurs de Sun.

Des parties de ce produit pourront etre derivees des systemes  
Berkeley BSD licencies par l'Universite de Californie. UNIX est une 
marque deposee  aux Etats-Unis et dans d'autres pays et licenciee 
exclusivement par X/Open Company, Ltd. 

Sun, Sun Microsystems, le logo Sun, AnswerBook, Sun StorEdge, Sun 
StorTools, Sun StorEdge T3, et Solaris  sont des marques de fabrique 
ou des marques deposees, ou marques de service, de Sun Microsystems, Inc. 
aux Etats-Unis et dans d'autres pays. Toutes les marques SPARC sont 
utilisees sous licence et sont des marques de fabrique ou des marques
deposees de SPARC International, Inc. aux Etats-Unis et dans d'autres 
pays.  Les produits portant les marques SPARC sont bases sur une 
architecture developpee par Sun Microsystems, Inc.

L'interface d'utilisation graphique OPEN LOOK et Sun(TM) a ete 
developpee par Sun Microsystems, Inc. pour ses utilisateurs et licencies. 
Sun reconnait les efforts de pionniers de Xerox pour la recherche et le 
developpement du concept des interfaces d'utilisation visuelle ou 
graphique pour l'industrie de l'informatique. Sun detient une licence 
non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, 
cette licence couvrant egalement  les licencies de Sun qui mettent en 
place l'interface d'utilisation graphique OPEN LOOK et qui en outre se 
conforment aux licences ecrites de Sun.

CETTE PUBLICATION EST FOURNIE "EN L'ETAT" ET AUCUNE GARANTIE, 
EXPRESSE OU IMPLICITE, N'EST ACCORDEE, Y COMPRIS DES GARANTIES 
CONCERNANT LA VALEUR MARCHANDE, L'APTITUDE DE LA PUBLICATION 
A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT 
QU'ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. 
CE DENI DE GARANTIE NE S'APPLIQUERAIT PAS, DANS LA MESURE 
OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.


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.2 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
                brocadetest.1m   
                checkcron.1m   
                clearcache.1m 
                config_solution.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 Environment 
                2.2 User's Guide (817-0192-10)
	

                                

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

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


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

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 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 Perihperals (806-2210-10)


QUALIFIED PLATFORMS
===================
You can use the SUNWstads package on the following platforms and
operating systems:


Sun Platforms        : Sun StorEdge Service Processor 

Sun StorEdge         : Sun StorEdge 3900 series
                       Sun StorEdge 6900 series
		       Sun StorEdge 6320 series
                       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 3510 FC Array


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
		       McData ED6064 FC Switch
		       McData ES3232 FC Switch

Operating Systems    : Solaris 9
                       Solaris 8 4/01 or greater.

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

Perl                 : 5.005 or better 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 Solutions. Types of
  information 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 
  intercoonects.

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 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 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 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 In order to launch the Configuration Service browser, you must install the
  packages with the same security options which is normally security turned
  on.

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 SE 3600/6900 series solutions must have the file
  /var/opt/SUNWstade/DATA/Inventory.golden
  created on the Service Processor before bringing up the GUI.  
  This is performed at the factory. However, if an upgrade is performed
  execute /opt/SUNWstade/sysbin/config_solution on
  the Service Processor to update the file.

  This enables proper discovery of the Sun StorEdge 3600/6900 Series.

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

o When using Netscape 4.79 the following error may occur if 
  seperate browser sessions are initiated from the command line. 

  #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


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

o  Added monitoring support for McData ED6064 and ES3232 FC switches
o  Support 3900SL/6900SL
o  Support StorEdge 6120
o  Support StorEdge 6320
o  Support StorEdge 3510


RESOLVED PROBLEMS with patch 115704-01
======================================
This is the L10N patches.

Bug Id  Synopsis
------- ------------------------------------------------------------------

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.




2.2 PATCH MEDIA CONTENTS
========================
See README
