Sun StorageTek Common Array Manager Software Release Notes |
This document contains important information about Release 6.1.1 of the Sun StorageTek Common Array Manager software, including issues and requirements that can affect installation and operation.
These Release Notes include the following sections:
The Sun StorageTek Common Array Manager (CAM) software provides an easy-to-use interface from which you can configure, manage, and monitor Sun StorageTek and Sun Storage arrays.
CAM software provides the following:
The Command Line Interfaces (CLIs) perform the same control and monitoring functions as the browser interface.
For most new users, managing the array with the browser interface is recommended.
Note - See Release Documentation for more information about managing the J4200 and J4400 arrays using CAM software, installation and configuration instructions. |
TABLE 1 lists the version information for the software included in this release.
Firmware files, as listed in Firmware |
|
Note - Premium features are not supported for the J4000 Array Family. |
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. For more information, search for these topics in the online Help:
The following licenses for premium features are available from Sun:
Combo Data Snapshot, Data Volume Copy, Data Replicator, and 64 Domains |
|||||||
Following is a list of documents related to CAM.
In addition, CAM software includes online Help and man pages for CLI commands.
For hardware information, refer to the array’s release notes and hardware installation guide. You can search for this documentation at http://www.sun.com/documentation.
The following pages lists release documentation for the Sun Storage J4000 Array Family and the Sun Storage J4500 Array Family.
System requirements for the Sun StorageTek Common Array Manager software are described in the following sections:
CAM software supports the following Sun storage systems:
Windows 2000 with Service Pack 4 Windows 2003 with Service Pack 1 Windows XP Professional with Service Pack 2[1] |
|||
Red Hat Enterprise Linux AS Release 4 (Nahant update 4) Red Hat Enterprise Linux AS Release 3 (Taroon update 8) |
|||
TABLE 8 lists Solaris packages that must be installed on your Solaris host. Installing the minimum Solaris operating system package as listed in TABLE 7 will install all but the last four packages. Those packages are required by Java, but are not used by the management software.
X Window System & Graphics Runtime Library Links in /usr/lib |
TABLE 9 lists Linux packages and libraries that must be installed on your Linux host. The 32-bit versions of the packages and files are required.
For the latest patches available for your system, check SunSolve at http://www.sunsolve.sun.com
Windows 2000 with SP (Service Pack) 4 or higher Windows 2003 with SP1 or higher Windows XP Professional Edition with SP2 or higher |
||
If needed, download the files from the Microsoft Download site. You must be logged in to the Windows system as an administrative user.
The array installation files and installers are provided in a compressed file on the CD. The process unpacks the contents of the file on the host and then proceeds with the installation.
After the installation on a Windows platform, you will need to configure the Windows firewall on each host to allow an exception for port 6789.
Open the following incoming and outgoing ports for secure-by-default Solaris, Linux, and Windows platforms:
If a proxy agent is used, then ann open port is required, in addition to the above ports. This allows for TCP (protocol) traffic. Use open port 8653 only if a proxy agent is used.
For Windows, refer to the documentation for instructions on how to open a port through the firewall.
The remote scripting command-line interface client sends commands to a management host, which in turn sends the commands to the array.
TABLE 11 lists remote platforms from which you can run the CLI client:
For best web browser performance while using CAM, do the following:
Note - Microsoft Internet Explorer version 7 is not supported. |
To avoid DNS-lookup delays, be sure arrays are connected. Otherwise, Windows might take a long time looking up information for arrays that are not being managed by CAM, if you have them listed in the system as being connected to the system. Make sure the array names are in DNS or add them to the hosts table in the Windows OS.
Note - This does not apply to JBOD array unless there is a mixture of JBOD's along with arrays that are communicated with via Ethernet. |
For Solaris, Linux and Windows, the Browser User Interface for the Sun StorageTek Common Array Manager is available in:
The command-line interface is available in:
The online Help is available in:
The man pages are available in:
CAM installation procedures are described in the Sun StorageTek Common Array Manager Software Installation Guide (part number 820-4193) and the Sun StorageTek Common Array Manager User Guide for the J4000 Array Family (part number 820-3765). This section describes release-specific steps for firmware and management software patch upgrades that you must perform:
Before you perform an installation procedure, do the following:
1. Locate the management software.
The management software is distributed on the Sun StorageTek Common Array Manager Software CD and is also available from the Sun Download Center (Systems Administration > Storage Management) from http://www.sun.com/download/
You can also navigate to the most current release by clicking the New Downloads tab from http://www.sun.com and scrolling to find it in the list.
2. Locate the most current patches.
For the latest patches available for your system, check SunSolve at http://www.sunsolve.sun.com
3. If supported by your array types, verify that you have license certificates for all premium features, including storage domains.
See Licensing Optional Premium Features.
4. Read the installation instructions.
See your Sun StorageTek Common Array Manager Software Installation Guide (part number 820-4193) or Sun StorageTek Common Array Manager User Guide for the J4000 Array Family (part number 820-3765).
5. Log in as root (Solaris and Linux) or as a user with administrator privilege (Windows) on the management host.
6. Note that before starting the installation script, the CD verifies host requirements, such as the following:
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. If the script detects that there is no earlier version installed, it will perform a complete new installation.
For more information, contact Sun Microsystems Support Services. (Service Contact Information)
Solaris: Upgrades from CAM 5.0.0.8, 5.0.1.1, 5.0.2.1, 5.1.0.10, 5.1.0.11, 5.1.1.2, 5.1.2.2, 5.1.3.2, and 6.x to this release are supported. You are not required to uninstall the existing CAM version before installing this release.
Linux: Upgrades are supported.
Windows: Upgrade to this build is not supported in 64-bit Windows 2003. Uninstall of previous CAM version is required before installing this build in 64-bit Windows 2003. In other Windows platforms, upgrade to this build is supported.
If installation failure occurs, check the available disk space.
For more information, consult the installation log:
Solaris: /var/sadm/install/se6000/se6000_Host_SW.log
Linux: /var/opt/cam
Windows: \Program Files\Common Files\Sun Microsystems\se6000
If you are installing the management software on a new host, check the installation requirements and follow the entire installation and configuration procedure described in the Sun StorageTek Common Array Manager User Guide for the J4000 Array Family (part number 820-3765) or the Sun StorageTek Common Array Manager Software Installation Guide (part number 820-4193).
You can install CAM on a local management host or on a central management server
Before installing the management software, do the following:
Download the latest version of the Common Array Manager software (Systems Administration > Storage Management) from http://www.sun.com/download.
The current URL is: http://www.sun.com/download/index.jsp?cat=Systems%20Administration&tab=3&subcat=Storage%20Management
After initial installation and configuration, you can upgrade the management software and firmware with each release.
During installation, the firmware update bundle is installed on the host server. For details about upgrading array firmware, see the Sun StorageTek Common Array Manager Software Installation Guide (part number 820-4193) or Sun StorageTek Common Array Manager User Guide for the J4000 Array Family (part number 820-3765).
The Sun StorageTek Common Array Manager Installation Software CD provides three installation-related wizards:
You can download the latest version of the Common Array Manager software (Systems Administration > Storage Management) from http://www.sun.com/download.
The current URL is: http://www.sun.com/download/index.jsp?cat= Systems%20Administration&tab=3&subcat=Storage%20Management
You can perform a minimal installation that enables one of two options: a command-line interface only or a command-line interface with firmware.
The CLI in previous versions of CAM software required the web server in order to run. Minimal installation does not require the web server to be running in order to function and is limited to calls on the management host where the management software is installed.
This light-weight management solution is installed on a data host attached to the array. The data host can also serve as a management host using the CLI only installation option and provides:
This option is also used to load the proxy agent that allows communication between the full management software on a central management server and the array.
Minimal Installation can stand alone, whereas Remote Client installation requires a fully installed image on a separate host.
Note - The CLI-only software manages the array without using the proxy agent. Be sure to deactivate the proxy agent when the management host is directly attached. |
For complete instructions on CLI Minimal Installation, see the Sun StorageTek Common Array Manager User Guide for the J4000 Array Family (part number 820-3765) or the Sun StorageTek Common Array Manager Software Installation Guide (part number 820-4193).
For complete instructions on CLI Minimal Installation, see the Sun StorageTek Common Array Manager User Guide for the J4000 Array Family (part number 820-3765) or the Sun StorageTek Common Array Manager Software Installation Guide (part number 820-4193).
1. From the Common Array Manager Installation page, select one of these options in the Select a feature bundle list:
Note - Array firmware files are not installed with the Command-Line Only option. Because firmware is not installed, the firmware analysis feature is not available with this installation. |
2. Click Next and follow the prompts by pressing 1 for Next, 3 to Cancel, or 5 to Redisplay.
The software will notify you as it checks your system and does any or all of the following:
3. Press 3 to Finish or 5 to Redisplay.
1. From the host software installer, select Uninstall.
2. Click Next and follow the prompts by pressing 1 for Next, 3 to Cancel, or 5 to Redisplay.
The software will notify you as it checks your system and does any or all of the following:
The system will notify you that the un-installation has been successful.
3. Press 3 to Finish or 5 to Redisplay.
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-4193) and the Sun StorageTek Common Array Manager User Guide for the J4000 Array Family (part number 820-3765).
Navigate to the appropriate directory for your operating system:
%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.10/bin/uninstall
For the Suse 9 platform, CLI uninstall requires the following rpm packages:
2. Enter the command uninstall -f
If you still have problems, enter the command uninstall -f -s
The command will remove the current installation.
Note - Contact Sun Microsystems Support Services (see Service Contact Information) to install the new 07.10.x.xx firmware for the 6140, 6540, and FLX380 arrays. |
For the latest patches available for your system, check SunSolve at: http://www.sunsolve.sun.com.
CAM firmware is installed in the following locations:
Within the directory where you installed the firmware, a README file for each array type define the firmware baseline.
Check the build notes file distributed with the software for the exact firmware build. CAM will support one prior version of the firmware for legacy features on previously supported arrays. (This does yet apply to the new Sun StorageTek 2500 Series Arrays or the J4000 Family Series).
For information about how to install firmware, see Installing the Firmware Baseline.
Note - Contact Sun Microsystems Support Services (see Service Contact Information) to install the new 07.10.x.xx firmware for the 6140, 6540, and FLX380 arrays. |
For the latest patches available for your system, check SunSolve at: http://www.sunsolve.sun.com.
In the following tables, the paths listed in the Firmware File column is relative to the images subdirectory where firmware files are located.
In the following tables, the path listed in the Firmware File column is relative to the images subdirectory where firmware files are located.
You can upgrade array firmware by using CAM’s Install Firmware Baseline feature. The software prompts you when it’s time to upgrade array firmware.
Note - You do not need to uninstall existing firmware before following this procedure. |
For optimal performance, Sun Microsystems recommends that the firmware on all arrays be at the level of the current firmware baseline. New features are not supported with non-baseline firmware. You can update your array firmware by clicking the Install Baseline Firmware button on the Storage System Summary page or the array’s Administration page.
As part of the CAM installation, the script puts the array firmware files in a directory on the management host. When you upgrade the firmware, the software analyzes the firmware installed on the array. If the baseline firmware on the host is newer, and you choose to install, the software installs the baseline firmware on the array.
3. From the Java WebConsole page, click Sun StorageTek Common Array Manager.
4. From the Storage System Summary page, select the array for which the firmware needs to be installed/upgraded.
5. Click Install Firmware Baseline, and follow the prompts.
To add trays with data already on them, contact your service representative for assistance to avoid data loss.
Refer to Upgrading Firmware for Additional Expansion Trays for the procedure to upgrade trays without data.
Controller firmware 06.19.x.x or higher allows tray mixing of 6540, 6140, 6130, FLX240, FLX280, and FLX380 array controllers modules and the Sun StorageTek CSM100, CSM200, FLA200, FLC200, and FLA3 expansion modules. After installing the firmware, 6130 controllers can use CSM200 expansion modules and CSM100 expansion modules can be used with 6540 and 6140 controllers.
When you add a new CSM200 expansion module to an existing array in a production or active environment, you must 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 (see Service Contact Information). One reason for this is to avoid issues related to DACstore, the configuration and status database maintained by the array firmware, that stores its information on each of the disk drives.
Note - Not following correct procedures could result in loss of customer data. |
Because corrective actions for a DACstore issue may require a configuration restoration, it is important to maintain a current image of the configuration. And, as always, it is best practice to maintain recoverable backups of your data.
Contact Sun Microsystems Support Services (see Service Contact Information) promptly upon experiencing any of the following symptoms:
Note - There are no expansion modules for the J4000 Array Family. |
The following tables list the supported expansion modules:
Supported Expansion Modules with Controller Firmware 06.19.25.16 |
||
---|---|---|
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.
You must contact Sun Microsystems Support Services (see Service Contact Information) to install the new 07.10.x.xx firmware for the 6140, 6540, and FLX380 arrays. After the initial installation, you can install future changes to the 07 baseline firmware using the procedure that follows.
Note - 07.10.x.xx is not available for the 6130, FLX240, 280, 2500 and J4000 arrays. |
This following does not apply to J4000 arrays: After an upgrade to the 7.10 firmware version, the Cache Block size will reset to 4KB. In previous firmware levels, the default size was 16K. The GUI and CLI have options to change the default Cache Block size, if necessary, to the previous 16KB size.
Prerequisite: Before discovering a Sun StorageTek FLX240, FLX280, FLX380 array using CAM and before performing any tray migration (for example, adding FLA300 expansion trays behind an existing 6130, 6140 or 6540 controller), you must upgrade the arrays and associated trays to the firmware version 6.19.25.00 or later. After you register the arrays with CAM, you can upgrade to the current baseline firmware.
1. Before cabling the newly supported expansion module, upgrade the existing controller and trays.
1. Install the new controller and trays.
2. Perform the firmware upgrade.
For adding trays to arrays managed by CAM:
1. Do not cable the additional expansion tray.
2. Install the Common Array Manager release following the standard installation procedure.
3. Register the array, if needed.
4. From the Storage Summary page or Array Administration page, click the Install Firmware Baseline button.
6. Use Service Advisor to cable the additional expansion tray and add it to the array.
7. Upgrade the array again to update the firmware on the new tray.
Support has been added for a third expansion tray and 48 drives.
For the most current cabling information, see the Sun StorageTek 2500 Series Release Notes.
The following sections provide information about known issues and recommended workarounds, as well as operational information not found elsewhere in the documentation:
Bug 6590617 -Since the Sun StorageTek 6130 array does not report asset data for the cache backup batteries, the management software inserts a dash (-) instead of a value in the Unique Identifier field on Component Summary for Battery page (Troubleshooting > FRUs > Battery).
Workaround -Use the sscs CLI service command to manage data channels 3 and 4.
Bug 6698254 -When you select the device name link from the Alarm Summary page, you might get an exception or an error. For instance, a java stack trace might display in the main UI window.
Workaround -Select the device from the main window.
When an array is out of compliance, a number of operations might not occur, such as:
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. Since the Cache Stop% is the percentage of unwritten data in the cache that will stop a cache flush that is currently in progress, it must not be greater than the value for Cache Start%, which is the percentage of unwritten data in the cache that will trigger a cache flush.
Bug 6600387 -Some jobs, like volume creation jobs, cannot be cancelled on the array once they have started. However, if multiple jobs are queued up for an array, any job in the queue can be cancelled before the array actually starts the job.
Bug 6681173 -List devices can show multiple unlabeled entries. List storage systems can show multiple unlabeld entries as well. The CLI user is unable to differentiate between unlabeled entries.
Workaround -Rename each unlabeled device to a unique Temporary Name. Use list controller to determine IP address for the TN. Then rename TN to desired.
Bug 6698735 -When a power cord for a power/fan CRU on a J4200 is disconnected, the following CAM critical alarm is generated:
“The property Status for PowerSupply.00 on 0744QCJ005 has changed from OK to CRITICAL.”
Workaround -Check the following and take appropriate action:
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 820-4996-11 does occur during execution, the user will be notified.
Workaround -This should have no impact but if the status needs to be seen, run defragmentation jobs using the CLI.
Bug 6592877-When a drive fails, the vdisk 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.
The drive is chosen to satisfy the following conditions:
Bug 6682034 -Attempting to reconstruct a disk results in message “error.reason.100404.” The vdisk to which the drive belongs is in an invalid state and cannot be reconstructed.
This occurs because of the loss of redundancy that results from more disk failures than a given RAID level can recover. This fix is in progress and will be available by release 6.2.
To avoid DNS-lookup delays, be sure arrays are connected. Otherwise, Windows might take a long time looking up information for arrays that are not being managed by CAM, if you have them listed in the system as being connected to the system. Make sure the array names are in DNS or add them to the hosts table in the Windows OS.
Note - This does not apply to JBOD array unless there is a mixture of JBOD's along with arrays that are communicated with via Ethernet. |
Bug 6515237 -CAM does not allow the disk drive order to be specified during volume creation.
Workaround - Use the CLI to specify disk drive order.
Bug 6498717 -When creating a data replication set, if the primary array cannot communicate with the secondary array, a misleading error message displays stating that it is “unable to get volume candidate list from array.”
Workaround - Verify that the arrays can communicate before replicating data.
Bug 6590097, 6577775, 6592717, 6592703 -Using an invalid array password may result in configuration error messages.
Workaround - Use the correct array password.
Bug 6661200 - Lockhart 3.0.4 cannot be installed or upgraded in a sparse-root zone.
Workaround - Before you install CAM in a sparse-root zone, install Lockhart 3.0.5 with its L10N packages in the global zone.
Bug 6684195 -Unable to register J4200/4400 on Win2003 server. Process stops at 99% complete.The windows disk and device manager can see the JBODs. CAM and the Quanta management tool can not.
Workaround -Upgrade the 4200 JBOD to Firmware 3A24 or the 4400 JBODs to 3R11. See Release Firmware Level for more information. The issue appears to resolve with CAM 6.1.1.8, as long as the hotfix and JBOD firmware levels are in sync with the installed CAM version.
Bug 6600387 -When a long job is running, such as large volume creation, the Cancel checkbox does not display on current job status. Some jobs cannot be cancelled once they have started on the array.
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.
When you install the CAM software for the first time, upon logging into the Browser User Interface, a registration page will display. Fill out the information before continuing.
During the initial storage array registration process, CAM prompts you to register with the Auto Service Request service by displaying the Auto Service Request (ASR) Setup page. This page continues to display until you either fill out the page and click OK, or click Decline to either decline or defer ASR service registration.
Note - You must register the array with ASR before using the Test button. |
Bug 6620034 -Upgrading from an existing 5.1.x installation causes non-default users to be removed. Default users are: root, storage, and guest.
Workaround -To add non-default users to the system:
1. Create a temporary “root” or “storage” user on host.
2. Log into the WebConsole as the temporary “root” or “storage” user.
3. Select Common Array Manager > General Administration > User Roles.
4. Click Add, and add non-default users back into the system.
5. Remove the temporary users as necessary.
Bug 6684322 -Cannot enable volume copy license by specifying the license file using Internet Explorer 7.
Workaround -Internet Explorer version 7 is not supported. Use a supported browser listed in TABLE 12.
There may be significant DNS delays on Windows hosts.
Workaround -To avoid DNS-lookup delays, be sure arrays are connected. Otherwise, Windows might take a long time looking up information for arrays that are not being managed by CAM, if you have them listed in the system as being connected to the system. Make sure the array names are in DNS or add them to the hosts table in the Windows OS.
Note - This does not apply to JBOD array unless there is a mixture of JBOD's along with arrays that are communicated with via Ethernet. |
Bug 6709828 -When using either the command-line interface only or command-line interface with firmware option for installation on the Windows platform, other CAM installations are unable to discover the JBOD array via the Windows proxy (%ProgramFiles%\Sun Microsystems\Common Array Manager\Component\fms\sbin\proxycfg.bat).
Workaround -Because the proxy has not been set up correctly on the Windows platform during installation, you must manually execute the proxycfg.bat file.
Bug 6577194 -The sscs CLI client does not allow mapping to the access volume for in-band management.
Workaround -To map the access volume, use the Common Array Manager Browser User Interface.
Bug 6698905 - The Administration page is not displaying. An NPE was observed in the UI log file. Alarms, Volumes, and other pages display, but the Administration page will not display.
Workaround -Try refreshing your system. A fix for this bug is in progress.
Bug 654985 -In the sscs CLI, special shell characters (or phrases that use them) have to be enclosed in double quotes.
For Windows only, the comma (,) is a special character. Options separated by commas should be enclosed in quotes, as shown in the following example:
sscs create -p Default -s 100MB -d “t1d01, t1d02, t1d03” volume dhamo_new_vdisk
Bug 659945 -Logging into the sscs CLI client remotely may fail when a Solaris machine is configured to use NIS for name resolution if the login host is not contained in the NIS map.
Bug 661094 -The sscs manpage was delivered only on the Solaris platform.
Workaround -Refer to the CLI Quick Reference Guide (part number 820-4192) for a command list and command syntax.
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 Browser User Interface to view the number of fans installed.
Bug 6584193 -Although type generic and type vlac are listed as options with the CLI sscs switch command, these options are not yet implemented.
Bug 6597344 -Clicking the Test Communications button for an offline controller may erroneously report that the communications test has passed.
Workaround -Verify a controller’s offline state by viewing its alarms.
Bug 6529172 -A snapshot volume that is disabled will be automatically reenabled after a firmware update occurs. If the snapshot volume is full, it can start generating warning events.
Workaround-Disable the snapshot again after the firmware update.
Bug 6612858 -The Event list from two different hosts against the same array shows different events, even though the alarms generated are consistent.
Workaround -To display results based on the polling frequency and polling times of the arrays, select the Advanced Aggregation Filter option from the CAM Events page. When this option is de-selected, all hosts show consistent output. Therefore, this is working as designed.
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.
Bug 6701605 -WebConsole 3.1 patch is breaking the CAM UI on Linux host.
Workaround -Download patch 125954-16 or later from sunsolve.sun.com for Linux hosts and apply it to the CAM server to upgrade the WebConsole to 3.1. For Solaris and Windows, the upgrade is seamless but for Linux the CAM interface might have problems in which case you can refer to your Linux documentation.
Fix in progress. Look for version -17 to come out for the WebConsole 3.1 patch soon.
Note - For the latest patches available for your system, check SunSolve at http://www.sunsolve.sun.com |
Bug 6608890 -The array is limited in commands it can process simultaneously and CAM is not doing validation and queuing of (primarily volume create) commands.
Workaround -Check scripts for volume modification status before you issue new volume modification commands.
Bug 6596281 - If a data replication set is created between two volumes with the primary volume having a size less than the secondary volume, the primary volume can be expanded till it reaches the size of the secondary volume.
Bug 6561709 -When the primary volume in a replication set fails, the management software may incorrectly list the volume as replicating.
Bug 6684018 -Replication Set Detail page shows an incorrect replication dedicated port for 6540 array.
The fix will be delivered with the 6.2 release of the CAM software.
Bug 6501029 -When the management software lists a disk as failed and the Service Advisor procedure for replacing drives is followed, the step to verify that the disk is ready to remove may not list the failed disk.
Workaround -Use an alternative menu option, Array Troubleshooting and Recovery, to view the status of the disk.
Bug 6681459 -There is a discrepancy in the snapshot quantity shown on Snapshot details and License summary pages.
Workaround -Use the License page for accurate snapshot quantity details.
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.
Bug 6560461 -Although both the base volume and the snapshot reserve volume support read-ahead, the snapshot volume itself does not support read-ahead. As a result, the Read-ahead Enabled Option is set to False on the Snapshot Details page.
Bug 6665635 -Creating volumes with sizes that contain a fraction does not work in locales using a comma as decimal point. The check for a legal numeric value is not localized, but the interpretation of the number afterwards is. If you correctly enter the locale with a comma as 17,352, you will get this error message: “You must provide a numeric capacity value.”
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.
Bug 6599933 -Changing a volume created with a one segment size to one with a different segment size requires that you create a new profile with the desired segment size, create a pool using that profile, and apply the new pool to the volume. However, if the original profile was created using a fixed number of disks instead of a variable number of disks, then an error is returned.
Workaround -Adjust the new profile so that the number of disks is variable instead of fixed.
Bug 6598844 -Members of a replication write consistency group should all have matching attributes and roles.
Sun StorageTek Common Array Manager sscs (1M) CLI Quick Reference Guide (part number 820-4192) says: “Do not use spaces, commas, colons (:), or the special characters ?,*,!,@,%, or & as a character in any name you specify. Numbers in braces {0} and {1} represent variables.”
The correct wording in the note should be as follows:
Do not use spaces, commas, colons (:), or the special characters ?,*,!,@,%, or & as a character in any name you specify unless you are prepared to escape them in the shell. Numbers in braces {0} and {1} represent variables in some error messages.
Bug 6599146 -Although the CLI command sscs map initiator is listed in the CLI manpage, it is not implemented. And, although the CLI manpage lists the -i option for use with the CLI commands sscs map volume and sscs map initiator, this option is not yet implemented.
The CLI Quick Reference Guide and the CLI manpage docs do not specify that when using the -p option with the sscs modify firmware command, you must supply the file path of the firmware image file.
Bug 6592776 - The manpage for the CLI command sscs modify volume should define the usage for the -c option, which enables you to select a controller, as follows:
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.
Bug 6540170 - CAM can be used to create up to 1022 volumes (volumes 0 through 1021) on the Sun StorageTek 6130 array. However, if the Access LUN is in use, up to 1023 volumes (volumes 0-1022) can be created. If you attempt to create more than the supported number of volumes, an error message is returned.
Sun StorageTek 2500 series does not support volume-copy. Any instances in the Browser User Interface or documentation that imply there is a command or function for this task is misleading.
To avoid issues regarding the new 7.10.x.xx firmware:
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.
In this release, SAS is not an available drive type for the 6xxxx and Flexline arrays. It will be available in future firmware releases and documented as such in Release Notes. However, SAS is an available drive type for the 2500 Series arrays.
For the complete list of drives, refer to Table 5 in the Sun StorageTek 2500 Series Array Release Notes, Version 1.3.
There are two different agents that can be used for communication to arrays via the in-band (data) path, dependant upon the array type: the CAM Proxy Agent and the RAID Array LSI Proxy Agent. In-band management is supported on the Sun StorageTek 6130, 6140, 6540, 2530 and 2540 arrays.
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
The in-band management proxy agent is a package which is added to a host (or group of hosts) with in-band connectivity via Fibre Channel to the storage array. An external management station can then talk to this proxy host via an out-of-band connection and the management commands are then relayed to the storage device via the in-band path. This is a transparent proxy agent which simply converts the RPC request packets to UTM SCSI- specific messages. The API CAM uses to manage the arrays is identical whether the array is managed via the in-band or out-of-band path.
Multiple in-band proxy hosts may be used to access the same array and multiple arrays are allowed behind a single proxy host.
Installation of the proxy agents is accomplished via the standard package addition tools inherent to the specific operating system. For example, the pkgadd(1M) command would be used to install the Solaris agent and the associated Java Runtime package should also be installed. For Linux, the 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.
Note - CAM 6.1 added support for Solaris (x86) and Windows proxy agents. |
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
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. adding new storage arrays to the configuration).
The in-band proxy agents will start when the host boots, but they will terminate if storage is not immediately seen. A restart of the agent (instructions below) will force a re-scan for storage arrays and, if any are found, the agent will remain running.
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Download CAM in-band proxy agents for Solaris from 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 the Agent (Solaris):
If the agent is already running, this will stop and then restart it.
2. Check the status of the agent:
# ps -ef | grep SMagent | grep -v grep
root 5144 1 0 11:58:24 pts/3 0:01 /opt/SMgr/agent/jre/bin/java -classpath
/opt/SMgr/agent/SMagent.jar devmgr.launch
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. |
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Download CAM in-band proxy agents for Linux from here: http://www.sun.com/download/products.xml?id=471e7573
To verify the host sees the arrays management (UTM) LUN:
[root@nsvr-150 agent]# /opt/SMgr/agent/SMagent start
[root@nsvr-150 agent]# SANtricity Storage Array Host Agent, Version 09.17.A0.03
Built Tue Dec 05 14:52:38 CST 2006
Copyright (C) 1999-2006 LSI Logic Corporation. All rights reserved.
Checking device /dev/sda (/dev/sg0): Skipping
Checking device /dev/sdb (/dev/sg1): Skipping
Checking device /dev/sdc (/dev/sg2): Activating
[root@nsvr-150 agent]# java -classpath /opt/SMgr/agent/SMagent.jar devmgr.versioned.agent.DeviceIdentifier | grep “Volume Access” /dev/sdc
(/dev/sg2) [Storage Array fms-lca1, Volume Access, LUN 31, Volume ID <600a0b80002fc0740000000000000000>]
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
To verify the host sees the arrays management (UTM) LUN, do the following:
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.
E:\Program Files (x86)\StorageManager\agent>C:\Java\jdk1.5.0_11\bin\java -classpath SMagent.jar devmgr.versioned.agent.DeviceIdentifier |
\\.\PHYSICALDRIVE0 [Storage Array fms-lca1, Volume Access, LUN 31, Volume ID <600a0b80002458d20000000000000000>]
\\.\PHYSICALDRIVE1 [Storage Array fms-lca1, Volume Access, LUN 31, Volume ID <600a0b80002fc074
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Bug 6584815 -When an access LUN is mapped to a proxy agent host for in-band management use, you must correlate the mappings between the LUNs and the host by using the format command at the UNIX prompt. The system will list the access LUNs and the array ports from the UI or the CLI, and it will then compare the results.
7. c8t0d31 <SUN-UniversalXport-9617 cyl 8 alt 2 hd 64 sec 64>
/pci@8,700000/fibre-channel@2/fp@0,0/ssd@w200500a0b82fbc3c,1f
13. c9t0d31 <SUN-UniversalXport-9617 cyl 8 alt 2 hd 64 sec 64>
/pci@8,700000/fibre-channel@2,1/fp@0,0/ssd@w200400a0b82fbc3c,1f
b. List the array ports using the UI or CLI:
A/1 A Up FC 2 Gbps 20:04:00:A0:B8:2F:BC:3B
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
In this example, Port A/2 exposes c9t0d31 and Port B/2 exposes c8t0d31
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.
Note - For best performance, ensure both controllers are connected during configuration. |
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Bug 6603978 -The controller for an in-band managed array cannot not be reset even when physical connectivity between the array and the management host has been verified.
Workaround -If physical connectivity is valid, un-register and then re-register the array.
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Bugs 6610504, 6609734, 6609155, 6607104, 6609732, 6612120 -An occasional problem exists where the in-band proxy agent may return the paths to the controllers in reverse order. This error can occur on any platform.
The net result is an immediate communications error. The error message will typically read “Error: Could not communicate with the controller to complete this request. Possible causes include network or connection problems, controller problems, or no power to the host or storage array. Check these possible causes, then retry the operation.”
This error might occur when performing the following operations:.
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:
Note - For best performance, ensure both controllers are connected during configuration. |
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Bug 6588699 - When an in-band managed array loses communication with management host, the network address listed in the Storage Summary page displays as an out-of-band address instead of an in-band address.
Workaround - If communication is lost with the array, view the alarms to determine if an in-band or out-of-band connection is lost.
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Bug 6661742 - SMagent-LINUX-10.00.A2.02-1.i386.rpm will not load. SMagent is not supported on Redhat 5.0.
Workaround - The SMagent requires Red Hat 5.1 (also known as “5 update 1”) or higher.
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Bug 6612214 - When one of the arrays behind an in-band management proxy is removed in CAM, the software will change the management of the other arrays behind the proxy to out-of-band management if that path exists. An in-band discovery of the proxy agent would return them to in-band management in this case.
Note - This information applies only to FLX240, FLX280, FLX380, 6130, 6140, 6540, 2510, 2530 and 2540 arrays. |
Bug 6681582 -Performance Monitoring page lists the Performance statistics as Unavailable.
Workaround -Check the physical connectivity from the management host to the array. If the connectivity is good, try un-registering and then re-registering this array.
Bug 6648569 -Apostrophes display incorrectly in the Browser User Interface in some cases for the French language.
Workaround -Please set your browser language to en-us instead.
6700357 -Array name may be displayed as “??” for zh and ja on the left panel, when CAM software is working on asia locales.
Workaround -Install the software under C locale and make sure the array name contains ASCII characters only.
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.
Bug 6688583 -J4200 and J4400 message files are missing in localized packages.
Workaround -Please set your browser language to en-us.
Note - This information applies only to 6000 and 2500 arrays. |
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.DeviceIdentifier | grep “Volume Access”
You should then receive output like the following, indicating which arrays have access LUNs visible to the agent:
/dev/rdsk/c5t200600A0B82458D4d31s2 [Storage Array fms-lca1, Volume
Access, LUN 31, Volume ID <600a0b80002458d20000000000000000>]
/dev/rdsk/c5t200700A0B82458D3d31s2 [Storage Array fms-lca1, Volume
Access, LUN 31, Volume ID <600a0b80002fc0740000000000000000>]
This information applies only to 6000 and 2500 arrays.
Bug 6594360 -After you upgrade to S10U3 (or later), the in-band management UTM LUN's are controlled by Solaris Traffic Manager (MPxIO). In most cases, in-band management will not fail as a result of this; however, it is best practice to ensure that the UTM LUN's are not controlled by MPxIO. Performing the following workaround task will help prevent problems.
Workaround -Use the format inquire command to get the Vendor and Product IDs. (The VID needs to be 8 characters.)
1. Edit the file /kernel/drv/scsi_vhci.conf
The following line should read:
device-type-scsi-options-list = "SUN Universal Xport", "disable-option"; disable-option = 0x7000000
2. Run the stmsboot -u command.
Respond to the prompts as follows:
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
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.com |
Note - To download Common Array Manager software, go to http://www.sun.com, click the New Downloads tab, and scroll down the list to find the link. |
Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services available on or through such sites or resources.
Copyright © 2008, Sun Microsystems, Inc. All Rights Reserved.