Sun StorageTek™ Common Array Manager Software Release Notes Release 6.0.1 Sun Microsystems, Inc. www.sun.com Part No. 820-3997-11 Apri 2, 2008, Revision B Submit comments about this document at: http://www.sun.
Copyright 2008 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 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.
Tables vii Sun StorageTek Common Array Manager Software Release Notes Common Array Manager Software Features New features in Release 6.0.
Firmware 18 Array Expansion Module Support Firmware Files 18 20 Firmware Version 21 Upgrading Array Firmware / Installing the Firmware Baseline Known Issues and Operational Information Common Array Manager-Specific Issues Configuration Issues 32 40 43 In-Band Array Management Issues Localization Issues Solaris Issues 32 36 Documentation Issues Firmware Issues 27 43 49 50 Service Contact Information Third-Party Web Sites 51 51 iii
iv
v Sun StorageTek Common Array Manager Software Release Notes, Release 6.0.
Tables TABLE 1 Sun StorageTek Common Array Manager CD Contents 2 TABLE 2 Available Licenses for Premium Features, by Array TABLE 3 Management Host Platforms TABLE 4 Required Solaris Packages TABLE 5 Required Linux Packages TABLE 6 Patch Number and Platform TABLE 7 Sun StorageTek Common Array Manager File Space Requirements TABLE 8 Remote CLI Client Platforms TABLE 9 Supported Web Browsers TABLE 10 Supported Expansion Modules - 6000 Series Arrays TABLE 11 Supported Expansion Module - 2
TABLE 20 Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 Array IOM Information 25 TABLE 21 Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 Array Disk Drive Information 25 viii Undefined BookTitleFooter • April 2008
Sun StorageTek Common Array Manager Software Release Notes This document contains important information about Release 6.0.1 of the Sun StorageTek™ Common Array Manager software, including issues and requirements that can affect installation and operation.
Common Array Manager Software Features The Sun StorageTek Common Array Manager software provides an easy-to-use interface from which you can configure, manage, and monitor Sun StorageTek storage arrays. New features in Release 6.0.
Licensing Optional Premium Features To use optional premium features, you must purchase licenses. When you order licenses, they will be sent to you with instructions on how to activate the features.
Release Documentation Following is a list of documents related to the Sun StorageTek Common Array Manager. For any document number with nn as a version suffix, use the most current version available.
Supported Arrays Common Array Manager software supports the following Sun storage systems: ■ Sun StorageTek Flexline 240 Array ■ Sun StorageTek Flexline 280 Array ■ Sun StorageTek Flexline 380 Array ■ Sun StorageTek 2510 (iSCSI) ■ Sun StorageTek 2530 Array (SAS) ■ Sun StorageTek 2540 Array (FC) ■ Sun StorEdge 6130 Array ■ Sun StorageTek 6140 Array ■ Sun StorageTek 6540 Array iSCSI Support New to the Sun StorageTek CAM software in release 6.0.
Consult the Sun StorageTek Common Array Manager software online Help for further information and procedures, such as configuring iSCSI targets and ports, mutual authentication for an iSCSI session, unnamed discovery sessions, and Internet Storage Name Service (iSNS), and more. Supported Platforms and Required Packages CAM software runs on the platforms described in TABLE 3.
TABLE 4 Required Solaris Packages File Description SUNWcsl Core Solaris, (Shared Libs) SUNWcsr Core Solaris, (Root) SUNWcsu Core Solaris, (Usr) SUNWkvm Core Architecture, (Kvm) SUNWlibC Sun Workshop Compilers Bundled libC SUNWmfrun Motif RunTime Kit SUNWxwice X Window System Inter-Client Exchange (ICE) Components SUNWxwplt X Window System platform software SUNWxwrtl X Window System & Graphics Runtime Library Links in /usr/lib TABLE 5 lists Linux packages and libraries that must be inst
Required Patches For the latest patches available for your system, check SunSolve at http://www.sunsolve.sun.com TABLE 6: lists the patch numbers and corresponding platforms.
File Space Requirements TABLE 7 lists the disk and directory space requirements.
UDP 161 - SNMP used for event notification traps from FMS TCP 2463 - used for RPC (remote procedure calls) with the arrays Supported Platforms for the CLI Client The remote scripting command-line interface client sends commands to a management host, which in turn sends the commands to the array. TABLE 8 lists remote platforms that can run the CLI client.
Supported Web Browsers TABLE 9 lists supported browsers. TABLE 9 Supported Web Browsers Browser Minimum Version Netscape Navigator 6.2 Mozilla 1.4 Firefox 1.0 Microsoft Internet Explorer 5.5 (7 is not supported) Best Practices for Browser Performance For best web browser performance while using the Sun StorageTek Common Array Manager software, do the following: ■ Enable pop-up windows.
Supported Languages For Solaris, Linux and Windows, the browser user interface for the Sun StorageTek Common Array Manager is available in: ■ English ■ Simplified Chinese ■ Japanese ■ French The command-line interface is available in: ■ English The online Help is available in: ■ English ■ Japanese ■ Simplified Chinese The man pages are available in: 12 ■ English ■ Japanese Book Title without trademarks, or an abbreviated book title • March 2008
Installing Packages and Patches The array installation procedures are described in the Sun StorageTek Common Array Manager Software Installation Guide (part number 820-0213-nn).
■ Unsupported versions of related software such as Common Array Manager 4.x, Storage Automated Diagnostic Environment 2.x and unsupported versions of the sscs CLI ■ Unsupported versions of operating systems or software ■ Insufficient disk space (see “Sun StorageTek Common Array Manager File Space Requirements” on page 9) If the host meets the requirements, the script will search for earlier versions and determine if a new installation or an upgrade/baseline installation is necessary.
Uninstalling a Previous CAM Version 1. Log in to the CLI on the management host or using the remote CLI client as documented in the Sun StorageTek Common Array Manager Software Installation Guide (part number 820-0213-nn). 2. Navigate to the appropriate directory for your operating system: For Windows, navigate to: %systemdrive%\Sun\CommonArrayManager\Host_Software_6.0.0.10\ bin\uninstall.bat For Solaris and Linux, navigate to: /var/opt/CommonArrayManager/Host_Software_6.0.0.
Command-Line (Minimal) Installation You can perform a minimal installation that enables only command-line interface (CLI) functionality. This feature is new in release 6.0.1. Array firmware files are not installed with this option. Because firmware is not installed, the firmware analysis feature is not available with this installation. The CLI in previous versions of Sun StorageTek Common Array Manager software required the web server in order to run.
■ installs Sun StorageTek Configuration Service BUI ■ installs Sun StorageTek Fault Management Services ■ installs Sun StorageTek Array Firmware ■ installs Sun StorageTek Common Array Manager ■ creates uninstaller ■ finalizes the Vital Product Data Registry. The system will notify you that the installation has been successful. 3. Press 3 to Finish or 5 to Redisplay. Uninstalling a (Minimal) CLI Common Array Manager Software Installation 1. From the host software installer, select Uninstall. 2.
Firmware This section describes the main features of the firmware, including the following: ■ “Array Expansion Module Support” on page 18 ■ “Firmware Files” on page 20 ■ “Firmware Version” on page 21 ■ “Upgrading Array Firmware / Installing the Firmware Baseline” on page 27 Array Expansion Module Support To add trays with data already on them, contact your service representative for assistance to avoid data loss.
CSM200 Best Practices When you add a new CSM200 expansion module to an existing array in a production or active environment, it is best practice to cable and add the trays while the RAID controller module is powered on. Before connecting any replacement drive or additional expansion module to an existing functioning array, it is best practice to contact Sun Microsystems Support Services.
TABLE 10 and TABLE 11 list the supported expansion modules. TABLE 10 Supported Expansion Modules - 6000 Series Arrays Supported Expansion Modules with Controller Firmware 06.19.25.
Common Array Manager firmware is installed in the following locations: ■ Solaris: /opt/SUNWstkcam/share/fw ■ Windows: :\Program Files\Sun\Common Array Manager\ Component\SunStorageTekArrayFirmware\ ■ Linux: /opt/sun/cam/share/fw/ Within the directory where you installed the firmware, a README file for each array type define the firmware baseline. ■ README_2500.txt defines the firmware baseline for the Sun StorageTek 2500 Series Arrays. ■ README_6000.
Sun StorageTek 2500 Series Array and Disk Firmware Version Information For the latest patches available for your system, check SunSolve at: http://www.sunsolve.sun.com. In the following tables, the file path listed in the Firmware File column (for example, nge/RC_0617xxxx.dlp) is the relative path to the /images subdirectory where the firmware files are located.
TABLE 17 lists the disk drive information for the 2500 Series Arrays: TABLE 17 Sun StorageTek 2500 Series Array Disk Drive Information Disk Drive Version Firmware File ST314655SSUN146G 0892 sun/D_ST314655SSUN146G_0892.dlp ST330055SSUN300G 0892 sun/D_ST330055SSUN300G_0892.dlp ST373455SSUN72G 0892 sun/D_ST373455SSUN72G_0892.
Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 Array and Disk Firmware Version Information For the latest patches available for your system, check SunSolve at: http://www.sunsolve.sun.com. TABLE 18 lists the controller information for the Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 arrays. TABLE 18 Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 Array Controller Information Controller Version Firmware File 6130 06.19.25.
TABLE 20 lists the IOM information for the Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 arrays. TABLE 20 Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 Array IOM Information IOM Version Firmware File 6130 FC 9643 nge/esm9643.s3r 6130 iSATA 9726 nge/esm9726.dl 6140 9887 nge/esm9887.esm FLA300 9643 nge/esm9643.s3r FLA200 9330 nge/esm9330.s3r FLC200 iSATA 9726 nge/esm9726.dl FLC200 dSATA 9565 nge/esm9565.
TABLE 21 Sun StorageTek 6130, 6140, 6540, FLX240, FLX280, and FLX380 Array Disk Drive Information Disk Drive Version Firmware File MAW3300FCSUN300G 1303 sun/D_MAW3300FCSUN300G_1303.dlp MAX3073FDSUN72G 0403 sun/D_MAX3073FDSUN72G_0403.dlp MAX3147FDSUN146G 0403 sun/D_MAX3147FDSUN146G_0403.dlp ST314655FSUN146G 0691 sun/D_ST314655FSUN146G_0691.dlp ST314670FSUN146G 055A sun/D_ST314670FSUN146G_055A.dlp ST314680FSUN146G 0407 sun/D_ST314680FSUN146G_0407.
Upgrading Array Firmware / Installing the Firmware Baseline The Install Firmware Baseline function is available as a separate feature in the Sun StorageTek Common Array Manager software. The software prompts you when the array’s firmware needs to be upgraded. It is not necessary to uninstall the existing firmware before following this procedure. If you are adding new expansion trays, see “Upgrading Firmware for Additional Expansion Trays” on page 28.
Upgrading Firmware for Additional Expansion Trays Controller firmware 06.19.nn.nn allows tray mixing of array controllers modules, two versions of expansion modules for the Sun StorageTek 6130, 6140, and 6540 arrays, and the FLX240, FLX280, and FLX380 arrays. ■ To add trays with data already on them, contact your service representative for assistance to avoid data loss. ■ Mixing trays is not supported for the Sun StorageTek 2500 Series Arrays.
Upgrading Expansion Modules Prerequisite: Before discovering a Sun StorageTek FLX240, FLX280, FLX380 array using Common Array Manager and before performing any tray migration (for example, adding FLA300 expansion trays behind an existing 6130, 6140 or 6540 controller), you must use existing management software to upgrade the arrays and associated trays to the firmware version 6.19.25.00. After you register the arrays using Common Array Manager, you can upgrade to the current baseline firmware, 6.19.25.26.
Upgrading Firmware for Additional Expansion Modules For adding trays to arrays managed by Sun StorageTek Common Array Manager Software: 1. Do not cable the additional expansion tray. 2. Install the Common Array Manager release following the standard installation procedure. ■ There are separate procedures for Solaris, Windows, and Linux management hosts. The software update places a copy of the latest firmware on the management software server. ■ For CSM100 trays, you must manually set the tray IDs. 3.
Firmware Rollbacks Each release or patch of the Sun StorageTek Common Array Manager software spools the latest firmware on the management host during the software or patch installation. When you register an array with the management software, it sends an alarm if you need to upgrade/install the baseline for the firmware. To begin the procedure: From the Storage System Summary page or Array Administration page, click the Install Firmware Baseline button.
Known Issues and Operational Information The following sections provide information about known issues and recommended workarounds, as well as operational information not found elsewhere in the documentation: ■ “Common Array Manager-Specific Issues” on page 32 ■ “Configuration Issues” on page 36 ■ “Documentation Issues” on page 40 ■ “Firmware Issues” on page 43 ■ “In-Band Array Management Issues” on page 43 ■ “Localization Issues” on page 49 Common Array Manager-Specific Issues 6130 Battery does
Cache Stop % Cannot be Greater than Cache Start % Bug 6590637 –Attempting to modify the Cache Start% and Cache Stop% parameters from the array’s Administration page so that the value assigned to Cache Stop% is greater than the value assigned to Cache Start% results in the error message “setCacheParams operation failed:43”. Workaround – Use valid values.
Defragmentation Jobs may not Display in the Jobs Summary Page Bug 6592811 –For small virtual disks, disk defragmentation jobs may complete too quickly for a job task to be created and listed on the Jobs Summary page. If an error does occur during execution, the user will be notified. Workaround –Run defragmentation jobs using the CLI. Drive Order Cannot Be Specified During Volume Creation Bug 6515237 –Common Array Manager does not allow the disk drive order to be specified during volume creation.
Workaround – If the queue includes multiple jobs for the array to perform, the job can be cancelled at the point where the GUI sends the next job to the array. Ports Link Status Down when Functioning Bug 6650124 –Sometimes the link status of all ports (A1, A2, A3, B1, B2, and B3) when viewed by CAM are reported as down when they are functioning properly. This was tested with CAM Build 6.0.1.10 and ST2530. Workaround – This bug is fixed in CAM Build 6.0.1.11.
Volumes with Persistent Reservations Cause Array Configuration Resets to Fail Bug 6569930 –Attempting to reset the array configuration while a volume has a persistent reservation appears successful; however, the job status displays as in error, indicating that the configuration reset failed. Workaround – Release the persistent reservation on the volume and retry the array configuration reset.
CLI - sscs list fru Command does not list FLX240 and FLX280 Fans Bug 6587666 –The CLI command sscs list fru does not list the number of fans installed on the Sun StorageTek FLX240 and FLX280 arrays. Workaround –Use the Common Array Manager to view the number of fans installed. CLI Command sscs switch type Command Options not yet Implemented Bug 6584193 –Although type generic and type vlac are listed as options with the CLI sscs switch command, these options are not yet implemented.
Firmware Upgrade can Lock Volumes While Appearing Completed and Array Showing Optimal State. Bug 6595884 –A firmware upgrade/baseline installation can lock volumes longer than the process indicates. The array can report the upgrade completed and show an optimal state but the process can still lock the volumes. Workaround –Wait an extra five to ten minutes and try again.
Snapshot Reserve Space is Insufficient and Fails Resnap Bug 6523608 –Refreshing a snapshot does not update the filesystem if there is insufficient reserve space, yet a message displays indicating success. The array’s event log says the resnap completed successfully. Workaround –In the snapshot feature of the management software, configure snapshots to fail if sufficient reserve space is not available. The fail message will prompt you to increase the reserve space.
Example –When you create a volume with 17.352GB under the standard “en” locale, you can enter the size as 17.352 and select GB as unit. However, under the “de” locale, the dot is interpreted as 1000-separator. A 17.352 size with a 1GB unit would try to create a ~17 TB volume and likely fail with this error message: “The size entered for the new volume exceeds the maximum space available on the selected pool.” Workaround –For GB and TB values you can multiply by 1024 and enter as MB or GB.
CLI - List Firmware Command Correction In “list firmware,” “-x unit-type” should be “-x fru-type.” In synopsis and options, fru-type and unit-type are used in an interchangeable way. For both -t and -x, use “fru-type” instead of “unit-type” to be consistent. Disk Drive Failure Affects Volume Group Redundancy Bug 6592877–When a drive fails, the volume group to which it belongs is no longer redundant. A stand-by hot-spare drive is chosen and integrated into that volume group automatically if possible.
■ Do not install Baseline (this is the only option when firmware is already up-todate) Installation Guide says “Solaris” instead of “SSCS” on page 44 Page 44 of the Sun StorageTek Common Array Manager Software Installation Guide, v.6.0 ((part number 820-0213-nn) should state: “...remotely logging in to a management software station or by using the SSCS remote client on a remote host.” The Installation Guide currently says “Solaris” instead of “SSCS.
Volume-Copy not Supported for 2500 Arrays Sun StorageTek 2500 series does not support volume-copy. Any instances in the user interface or documentation that imply there is a command or function for this task is misleading. Firmware Issues Install Wizard Might Display a False Warning Bug 6593508 – The review step of firmware Install wizard might display a false warning that the array health is not optimal. Workaround –Check the Alarm Summary page to verify the alarm.
packages are RPM based and a runtime package is also needed. For windows, the installation packages are executable files that include their own “Install Anywhere” installer. Known Proxy Agent Limitations A proxy agent restart is required after disruptive changes to the storage configuration. This does not apply to changes in volumes exposed from a single array but it does apply if storage arrays are re-cabled differently or if the storage array configuration has changed (i.e.
Linux: Checking The UTM LUNs and Start/Stop of the Proxy Agent Note – The SMagent requires Red Hat 5.1 (also known as “5 update 1”) or higher. It is not supported on Red Hat 5.0. Download CAM in-band proxy agents for Linux here: http://www.sun.com/download/products.xml?id=471e7573 To verify the host sees the arrays management (UTM) LUN, do the following: 1. Start/Stop Agent [root@nsvr-150 agent]# /opt/SMgr/agent/SMagent start Stopping Agent process 12632. SMagent started.
Windows: Checking The UTM LUN's and Start/Stop of the Proxy Agent Note – Support for the Windows proxy agent is not qualified in CAM 6.0.1. To verify the host sees the arrays management (UTM) LUN, do the following: 1.Start/Stop Agent E:\Program Files (x86)\StorageManager\agent>net start “SANtricity Storage Manager Agent” The Storage Manager Agent service is starting. The Storage Manager Agent service was started successfully. 2. Checking for UTM LUN E:\Program Files (x86)\StorageManager\agent>C:\Java\ jdk1.
A/2 A Up FC 2 Gbps 20:04:00:A0:B8:2F:BC:3C B/1 B Up FC 2 Gbps 20:05:00:A0:B8:2F:BC:3B B/2 B Up FC 2 Gbps 20:05:00:A0:B8:2F:BC:3C c. Correlate WWN’s In this example, Port A/2 exposes c9t0d31 and Port B/2 exposes c8t0d31 Array Removal Might Not Complete Successfully Bug 6593318 – When a number of in-band managed arrays are selected for removal, the operation appears to complete successfully. However, one array may still be listed on the Storage System Summary page.
Workaround –Change the Current Volume Ownership when a “communication error” is encountered during volume expansion: From the Volumes page, select the “Specific Volume” and then change the value of the “Owning Controller.” Changing the Current Volume Ownership will create an Alarm because the volume is not on the preferred controller. Select one of two actions: ■ Change the Volume back to the original owner after performing the desired command.
Localization Issues Copyright and License Information Issues in French Bug 6490238 –When installing the French version of Common Array Manager on Solaris and LINUX platforms, non-ASCII characters display as garbled text in the copyright and license sections when the correct locale is not used. Workaround –Use the correct locale (for example, fr_CA.ISO8859-1 for Solaris and fr_FR.iso88591 for LINUX) or use the browser in the English locale.
Solaris Issues SES vs. SD Paths for UTM LUNs Bug 6500605 –For Solaris 10u4 and Solaris 8 and 9, the host cannot see the storage device's management UTM LUN. Workaround –Perform the following commands on the data host: # setenv LD_LIBRARY_PATH /opt/SMgr/agent # java -classpath /opt/SMgr/agent/SMagent.jar devmgr.versioned.agent.
WARNING: This operation will require a reboot. Do you want to continue? [y/n] (default: y) y The changes will come into effect after rebooting the system. Reboot the system now? [y/n] (default: y) y Service Contact Information If you need help installing or using this product, go to: http://www.sun.com/service/contacting Note – For the latest patches available for your system, check SunSolve at: http://www.sunsolve.sun.
52 Book Title without trademarks, or an abbreviated book title • March 2008
