--------------------------------------------------------------------
README.TXT

Sun StorageTek RAID Manager (SSRM)
as of November 12, 2009
--------------------------------------------------------------------
Please review this file for important information about issues
and erratas that were discovered after completion of the standard
product documentation. In the case of conflict between various
parts of the documentation set, this file contains the most
current information.

The following information is available in this file:

   1. Software Versions and Documentation
      1.1   Sun StorageTek RAID Manager
      1.2   Documentation
   2. Installation and Setup Notes
      2.1   Supported Operating Systems
      2.2   Minimum System Requirements
      2.3   General Setup Notes
      2.4   Linux Setup Notes 
      2.5   VMware Setup Notes 
   3. General Cautions and Notes
      3.1   General Cautions
      3.2   General Notes
   4. Operating System-Specific Issues and Notes
      4.1   All
      4.2   Windows - All
      4.3   Windows 64-Bit
      4.4   Linux
   5. RAID Level-Specific Notes
      5.1   RAID 1 and RAID 5 Notes
      5.2   RAID 10 Notes
      5.3   RAID x0 Notes
   6. Other Issues and Notes

--------------------------------------------------------------------
1. Software Versions and Documentation

   1.1. Sun StorageTek RAID Manager

   1.2. Documentation on this CD

        PDF format:

        -  Sun StorageTek RAID Manager User's Guide for Internal RAID Storage
        -  Command Line Interface for Internal RAID Storage
        
        HTML and text format:
        
        -  Sun StorageTek RAID Manager Online Help        
        -  Sun StorageTek RAID Manager README.TXT file
        
--------------------------------------------------------------------
2. Installation and Setup Notes

   - The Sun RAID Controllers Installation Guide contains
     complete installation information for internal RAID
     controllers and drivers. The Sun StorageTek RAID Manager 
     User's Guide contains complete instructions for all utilities 
     and Sun StorageTek RAID Manager software for internal RAID storage. 
     
   2.1 Supported Operating Systems
   
     - Microsoft Windows*:

       o Windows Server 2008, Enterprise, Standard, Datacenter (32-bit, 64-bit)
       o Windows Server 2008 R2, Enterprise, Standard, Datacenter (32-bit, 64-bit)
       o Windows Server 2003, Enterprise, Standard, Datacenter (32-bit, 64-bit)
       o Windows Server 2003 R2, Enterprise, Standard, Datacenter (32-bit, 64-bit)
       o Windows XP Professional (32-bit, 64-bit)
       o Windows Vista, Premium, Ultimate, Business (32-bit, 64-bit)
       o Windows 7, All versions (32-bit, 64-bit)

     - Linux 32-Bit*:

       o Red Hat Enterprise Linux 4.7
       o Red Hat Enterprise Linux 5.4

       o SuSE Linux Enterprise Server 9
       o SuSE Linux Enterprise Server 10
          
       o VMware ESX Server 3.5, 4.0

     - Linux 64-Bit*:

       o Red Hat Enterprise Linux 4.7
       o Red Hat Enterprise Linux 5.4

       o SuSE Linux Enterprise Server 9
       o SuSE Linux Enterprise Server 10
     
     - Solaris:
     
       o Sun Solaris 10 Update 4     
     
   *Out-of-box and current quarterly update or service pack
     
   2.2  Minimum System Requirements

     o  Intel Pentium Compatible 1.2 GHz processor
     o  512 MB RAM
     o  80 MB hard disk drive space
     o  256 color video mode   

   2.3 General Setup Notes

   - You can configure Sun StorageTek RAID Manager settings on other
     servers exactly as they are configured on one server. To
     replicate the Sun StorageTek RAID Manager Enterprise view tree   
     and notification list, do the following:

     1.  Install Sun StorageTek RAID Manager on one server.

     2.  Start Sun StorageTek RAID Manager. Using the 'Add remote system' 
         action, define the servers for your tree.

     3.  Open the Notification Manager. Using the 'Add system' 
         action, define the notification list.

     4.  Exit Sun StorageTek RAID Manager.

     5.  Copy the following files onto a diskette from the directory
         where the Sun StorageTek RAID Manager is installed:

         RaidMSys.ser --> to replicate the tree
         RaidNLst.ser --> to replicate the notification list
         RaidSMTP.ser --> to replicate the SMTP e-mail notification list
         RaidJob.ser  --> to replicate the jobs in the Task Scheduler

     6.  Install Sun StorageTek RAID Manager on the other servers.

     7.  Copy the files from the diskette into the directory where
         Sun StorageTek RAID Manager is installed on the other servers.
         
   2.4 Linux Setup Notes
    
   - To run Sun StorageTek RAID Manager under Red Hat Enterprise Linux  
     for x64, the Standard installation with "Compatibility Arch Support"
     is required. 

   - To install Sun StorageTek RAID Manager on Red Hat Enterprise Linux,
     you must install two packages from the Red Hat installation CD:
     
     o  compat-libstdc++-7.3-2.96.122.i386.rpm
     o  compat-libstdc++--devel-7.3-2.96.122.i386.rpm
                   
     NOTE:  The version string in the file name may be different 
            than above. Be sure to check the version string on the 
            Red Hat CD.
     
     For example, type:
            
     rpm --install /mnt/compat-libstdc++-7.3-2.96.122.i386.rpm
            
     where mnt is the mount point of the CD-ROM drive.            

   - To install Sun StorageTek RAID Manager on Red Hat Enterprise Linux 4,
     you must install the following package from the Red Hat
     installation CD:
       
     o  xorg-x11-deprecated-libs-6.8.1-23.i386.rpm 

     NOTE:  The version string in the file name may be different 
            than above. Be sure to check the version string on 
            the Red Hat CD.
   
   - To install Sun StorageTek RAID Manager on Red Hat Enterprise Linux 5,
     you must install one of these packages from the Red Hat
     installation CD:
       
     o  libXp-1.0.0-8.i386.rpm    (32-Bit)
     o  libXp-1.0.0-8.x86.rpm     (64-Bit)  
   
   - To install Sun StorageTek RAID Manager on Novell Linux Desktop 9 
     Service Pack 1 for 64-bit systems, you must install two   
     packages from the Novell Linux installation CD:
     
     - liblcms-devel-1.12-55.2.x86_64.rpm
     - compat-32bit-9-200502081830.x86_64.rpm
                   
     NOTE:  The version string in the file name may be different 
            than above. Be sure to check the version string on the 
            Novell Linux CD.
  
   2.5 VMware Setup Notes
   
   - To install and use Sun StorageTek RAID Manager on the VMware ESX Server:
   
     1.  Mount the Sun StorageTek RAID Manager installation CD:
         
         mount -r /dev/cdrom /mnt/linux/
         
     2.  Change to the manager directory on the CD-ROM:
     
         cd /mnt/cdrom/linux/manager         
   
     3.  Type one of the following commands to install the 32-bit
         or 64-bit Linux Sun StorageTek RAID Manager on the VMware 
         ESX Server: 
   
         rpm --install ./StorMan*.rpm             [32-bit]

         rpm --install --nodeps ./StorMan*.rpm    [64-bit]
    
     4.  Type the following command to open the range of ports required
         by Sun StorageTek RAID Manager to connect remotely:
     
         esxcfg-firewall -o 34570:34581,tcp,in,"StorMan"

     5.  Install Sun StorageTek RAID Manager on a Windows or Linux machine.
    
     6.  From the Windows or Linux client, connect to the Sun StorageTek      
         RAID Manager Agent on the VMware ESX Server using the SSRM GUI.        
       
   - Upgrading the VMware driver to ESX 4.0 is currently supported 
     only for non-bootable arrays. For bootable arrays, upgrading
     will result with booting only to an ESX recovery shell with no
     option to reboot to ESX server normally.
            
   - On the VMware ESX Server, the Sun StorageTek RAID Manager Agent   
     cannot be monitored from a guest operating system.
     
--------------------------------------------------------------------
3. Sun StorageTek RAID Manager General Cautions and Notes

   3.1 General Cautions
   
   - While building a pool or (for internal RAID) clearing a pool,  
     do not remove and reinsert any drive from that pool. Doing
     so may cause unpredictable results.

   - Do not move drives containing a pool or volume from one 
     controller to another while the power is on. Doing so could 
     cause the loss of the pool configuration or data, or both. 
     Instead, power off both affected controllers, move the drives, 
     and then restart.

   - When using Sun StorageTek RAID Manager and the CLI concurrently, 
     configuration changes may not appear in the Sun StorageTek RAID 
     Manager console until you refresh the display (by pressing F5).

   3.2 General Notes

   - Sun StorageTek RAID Manager requires the following range of ports
     to be open for remote access: 34570-34580 (TCP), 34570 (UDP),
     34577-34580 (UDP).
     
   - Sun StorageTek RAID Manager generates log files automatically to
     assist in tracking system activity.  The log files are
     created in the directory where the Sun StorageTek RAID Manager is
     installed.  
   
     o RaidEvt.log  - Contains the information reported in the
                      Sun StorageTek RAID Manager event viewer for all
                      local and remote systems.

     o RaidEvtA.log - Contains the information reported in the
                      Sun StorageTek RAID Manager event viewer for the
                      local system.
                       
     o RaidNot.log  - Contains the information reported in the
                      Notification Manager event viewer.
                                              
     o RaidErr.log  - Contains Java messages generated by 
                      Sun StorageTek RAID Manager.
                    
     o RaidErrA.log - Contains Java messages generated by the
                      Sun StorageTek RAID Manager agent.
                      
     Information written to these files is appended to the existing
     files to maintain a history.  However, if any of the files reach
     a size of 200,000 bytes, the file is copied to a new file with 
     the extension .OLD and the original (that is, the LOG file) is 
     deleted and recreated.  If a .OLD file already exists, the 
     existing .OLD file is destroyed.

   - The blink LED feature is supported for management-processor-enabled
     enclosures only.
          
   - In the Event viewer, Sun StorageTek RAID Manager reports both the 
     initial build task for a pool and a subsequent Verify/Fix
     as a "Build/Verify" task.
   
   - Task priority is not retained after rebooting. If you change
     a priority to LOW or MEDIUM, and reboot, the controller resets the
     priority to the default (HIGH).

   - When displaying information about a physical device, the device, 
     vendor and model information may be displayed incorrectly.

   - After using a hot spare to successfully rebuild a redundant 
     pool, information about the hot spare drive may not display 
     as expected. Sun StorageTek RAID Manager may continue to display 
     it as a global hot spare.     
          
--------------------------------------------------------------------
4. Operating System-Specific Issues and Notes

   4.1 All
  
   - Sun StorageTek RAID Manager will not start on a system that uses
     only 16 colors. Sun StorageTek RAID Manager supports a minimum of 256 
     colors. See section 4.2 for a special note about Windows color
     requirements.

   - If the Sun StorageTek RAID Manager console does not repaint correctly,
     select the View->Refresh menu item to repaint the screen.       

   4.2 Windows - All
             
   - The Java Virtual Machine has a problem with the 256-color 
     palette. (The Sun StorageTek RAID Manager display may be distorted 
     or hard to read.) Set the Display Properties Settings to a  
     color mode with greater than 256 colors. 
     
   - If the network connection is disconnected while the Sun StorageTek  
     RAID Manager agent is running, the agent cannot communicate 
     with the Sun StorageTek RAID Manager console. As a result, Sun StorageTek    
     RAID Manager will not report task status in the Event  
     viewer. Reestablish network commmunication; then, restart the  
     Sun StorageTek RAID Manager agent and console.     
  
   - When you shut down Windows, you might see the message 
     "unexpected shutdown". Windows displays this message if the
     Sun StorageTek RAID Manager  Agent fails to exit within 3 seconds. 
     It has no affect on file I/O or other system operations and can
     be ignored.        

   4.3 Windows 64-Bit
        
   - RAID adapters do not produce an audible alarm on the following 
     64-bit Windows operating systems:

     o  Windows XP Professional x64 Edition
     o  Windows Server 2003 x64 Edition (all versions)

   4.4 Linux

   - When you delete a pool, the operating system can no longer see
     the last pool. WORKAROUND: To allow Linux to see the last pool, 
     restart your system.

   - The controller does not support attached CD drives during OS 
     installation.    
              
   - To remotely manage a Linux system from a Windows system, you must
     use the standalone GUI.

   - If you cannot connect to a local or remote Sun StorageTek RAID Manager  
     installed on a Linux system, verify that the TCP/IP hosts file  
     is configured properly.
      
     1.  Open the /etc/hosts file.
       
         NOTE:  The following is an example:
           
                127.0.0.1 localhost.localdomain localhost matrix
       
     2.  If the hostname of the system is identified on the line
         with 127.0.0.1, you must create a new host line.
       
     3.  Remove the hostname from the 127.0.0.1 line.
       
         NOTE:  The following is an example:
           
                127.0.0.1 localhost.localdomain localhost

     4.  On a new line, type the IP address of the system.
       
     5.  Using the Tab key, tab to the second column and enter the 
         fully qualified hostname.
           
     6.  Using the Tab key, tab to the third column and enter the 
         nickname for the system.
           
         NOTE:  The following is an example of a completed line:

                1.1.1.1 matrix.localdomain matrix
                  
                where 1.1.1.1 is the IP address of the server and
                matrix is the hostname of the server.
           
     7.  Restart the server for changes to take effect.
                            
   - On certain versions of Linux, you may see messages concerning font 
     conversion errors. Font configuration under X-Windows is a known 
     JVM problem. It does not affect the proper operation of the  
     Sun StorageTek RAID Manager software. To suppress these messages,  
     add the following line to your .Xdefaults file:
       
     stringConversionWarnings: False
                                                      
   - On rare occasions, the online help system may generate a Java 
     exception. This is due to a known problem in the HTML rendering 
     section of JFC/Swing.        
 
--------------------------------------------------------------------
5. RAID Level-Specific Notes

   5.1 RAID 1 and RAID 5 Notes

   - During pool migration from a RAID 1 or RAID 5 to a RAID 0, if 
     the original pool had a spare drive attached, the resulting 
     RAID 0 retains the spare drive.     

   5.2 RAID 10 Notes

   - You cannot change the priority of a RAID-10 verify. Setting
     the priority at the start of a verify has no effect. The
     priority is still shown as high. Changing the priority of
     a running verify on a raid-10 changes the displayed priority
     until a rescan is done, then the priority shows as high again.

   - Performing a Verify or Verify/Fix on an RAID 10 displays the 
     same message text in the event log, "Build/Verify started on 
     second level pool of pool 'Pool_0.'" You may see the message 
     three times for a Verify, but only once for a Verify/Fix.

   - During a migration from a RAID 0 to any redundant pool like 
     RAID 5 or 10, Sun StorageTek RAID Manager shows the status as  
     "Degraded Reconfiguring" for a moment, then the status changes  
     to "Reconfiguring." The "Degraded" status does not appear in the 
     event log.
          
   5.3 RAID x0 Notes

   - After building or verifying a leg of a second-level pool, the 
     status of the second-level pool is displayed as a "Quick 
     Initialized" pool.
     
--------------------------------------------------------------------
6. Other Issues and Notes
     
   - While a drive is being cleared, do not try to include it in a
     new pool. Doing so may cause unpredictable results.
        
   - With Linux kernel versions 2.4 and 2.6, the ARCCONF 
     DELETE <logical_drive> command may fail with a Kernel Oops 
     error message. Even though the drives are removed from the 
     Sun StorageTek RAID Manager console, they may not really be deleted. 
     Reboot the controller; then, issue the ARCCONF DELETE command
     again.   
     
  - SDK Limitations:
  
    NOTE: This section applies to users who use the management API
          libraries to develop custom RAID management applications.

    Windows applications, using the Visual Studio 2008 tool chain,
    may not function reliably with the existing binaries. These 
    binaries have been built using the Visual Studio 2005 tool chain.


--------------------------------------------------------------------
(c) 2009 Sun Microsystems, Inc. All Rights Reserved. 

Sun, Sun Microsystems, the Sun logo, Sun StorageTek, Solaris, Java, 
Solstice, Solstice DiskSuite, Solstice Backup, and N1 are trademarks
or registered trademarks of Sun Microsystems, Inc. in the United States
and other countries. 

All SPARC trademarks are used under license and are trademarks or 
registered trademarks of SPARC International, Inc. in the United States
and other countries. Products bearing SPARC trademarks are based 
upon an architecture developed by Sun Microsystems, Inc. 

