Release Notes RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris This document summarizes features and characteristics of the StorageWorks HSG80 Array Controller (Array Controller Software Version 8.5) for Sun Solaris systems that are supported in the 8.5 release of the HSG80 Solution Software for Sun Solaris platform kit. These Release Notes provide information not covered elsewhere in the documentation.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Release Package Contents The HSG80 Version 8.5 Solution Software kit consists of the following: • A customer letter • The HSG80 Array Controller documentation set: - Installation Reference Guide, RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris - SWCC 2.2 User’s Guide - HSG80 Array Controller ACS Version 8.5 Configuration and CLI Reference Guide - HSG80 Array Controller ACS Version 8.
Release Notes 1.0 IDENTIFYING YOUR ACS SOFTWARE REVISION LEVEL You can identify ACS Software Version 8.5 by entering the following command at the CLI prompt: SHOW THIS_CONTROLLER The resulting display lists the software revision level as one of the following: V8.5F-0 2.0 HARDWARE AND SOFTWARE SUPPORT This section lists the hardware and software supported by HSG80 Solution Software V8.5. 2.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris NOTE: This release of the RAID Array 8000 has been qualified with the following Sun Solaris patches installed: Version 2.6 2.7 Patch Number 106226-01 105600-07 105181-16 106125-05 Patch Description format isp kernel patchadd 108148-01 106541-07 107544-02 prtconf kernel fsck 2.2 Device Support ACS Software Version 8.5 supports the devices listed in the Table 2 below at the indicated hardware levels.
Release Notes Table 2 Supported Disk Drives Device Capacity in Gigabytes Spindle Speed (RPM) Minimum Microcode Version Minimum Hardware Version 4.3 7,200 LYJ0 or 0656 A01 DS-RZ1CD-VW 4.3 10,000 0306 A01 DS-RZ1CF-VW 4.3 7,200 N1H1 or 1614 A01 DS-RZ1CB-VW 380691-B21 DS-RZ1DB-VW 9.1 7,200 LYJ0 or 0307 A01 DS-RZ1DF-VW 9.1 7,200 N1H1, 0372, or 1614 A01 9.1 10,000 0306 A01 18.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 2.3 StorageWorks Command Console The StorageWorks Command Console (SWCC) version 2.2 is included in this release. SWCC provides a graphical user interface that can be used to configure and monitor your storage subsystem. Use of SWCC is highly recommended. Refer to the Compaq StorageWorks RA8000/ESA12000 HSG80 Sun Solaris Installation Reference Guide for information about installing and using SWCC.
Release Notes Verification of the individual components can be done with Explorer by rightclicking on the particular executable program in its folder and selecting the Properties option. In the resulting Properties window, click on the Version tab and select the Product Version to display the version of the program. Compaq Insight Manager Integration This release of the SWCC Client kit is not integrated with Compaq Insight Manager.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 3.2 Dynamic Volume Expansion Dynamic Volume Expansion creates a specialized volume, called a concatset (short for concatenation set), from a storageset that has been given a unit number. Another storageset can then be added to the concatset by the SET concatset command. Dynamic Volume Expansion is supported on the Sun platform. Refer to section 7.18 for information on using this feature. 3.
Release Notes 3.4 Host Ports The HSG80 controller has two host ports. You can specify a maximum of 64 units per port, for a total of 128 LUNs total (127 if CCL is enabled). The StorageWorks solution software only enables 16 LUNs per port, however. If you need support for more than 32 LUNs, refer to Section 7.8 of these notes. 4.0 CONFIGURATION RULES The following list outlines the configuration rules for the controller: 5.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 5.1 Using FRUTIL to Insert a New Controller When using FRUTIL to insert a new controller in a dual-redundant controller configuration, the user will see a new set of instructions after the new controller has been inserted: If the other controller did not restart, follow these steps: 1. Press and hold the other controller’s reset button. 2. Insert the other controller’s program card. 3. Release the reset button.
Release Notes If any storageset within your configuration was previously initialized with the INITIALIZE container-name SAVE_CONFIGURATION command to save your configuration to disk, it will not be necessary to reconfigure your devices with a new controller. SAVE_CONFIGURATION also retains code patch information to the software. This option is supported on single controller configurations only. ACS Software Version 8.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris • If you are using Solaris 2.6, you must have patch # 106226-01 loaded, or format will dump core. 7.2 Solaris 2.7 Support Solaris 7 (2.7) is supported in both 32-bit and 64-bit modes with this release. 7.3 Per-instance Device Configuration By default, all instances of a driver for a particular adapter type are configured in the same mode (FC-SW or FC-AL) depending on the mode selected during driver installation.
Release Notes The installation program (install_stgwks) will check that you have the required patches loaded, and notify you if any are missing. Note that if any patches are missing, the installation will list all required patches, not just the missing ones. Use the following command to list the patches already installed on your system: showrev -p 7.7 Minimum System Memory Requirements Due to the increased functionality and performance of the 2.3 drivers, the Sun server memory requirements have increased.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris However, the HSG80 controller, and Solaris, can support up to 64 LUNs per port/Target. If your environment requires more than 16 LUNS/Target, you may perform the following work-around, keeping the following notes in mind: NOTE • You should be running Solaris 2.6 or Solaris 2.7 with the required patches installed. • You may need to adjust the ad_max_throttle setting in /etc/system (see Section 7.
Release Notes The solution is to restrict the maximum queue depth by setting sd_max_throttle in the /etc/system file. The StorageWorks Solution software has already throttled the queue depth back to 32 during the installation. This will work fine for most environments. If you will be doing heavy I/O to 16 or more luns, you will need to set sd_max_throttle even lower. Edit your /etc/system file, and change the sd_max_throttle entry in the CPQhsg80 section.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris To properly configure a storageset whose logical geometry exceeds these values, follow these steps: 1. Get the size of the storageset by performing a show on the unit from the CLI on the HSG80 controller (e.g. SHOW D100).
Release Notes 3. The goal of the calculation process is to ensure that all parameters end up in the valid ranges specified earlier in this section. Throughout the calculation, the total number of blocks should remain constant or as close to the original value without exceeding it. This is achieved by dividing one value (e.g. cylinders) by the same amount as one of the other values (e.g. heads) is multiplied.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 7.13 Using the “fsck” Utility on Large Storagesets When attempting to fsck a large storageset, you may get the following error: Cannot alloc 115667202 bytes for aclinop The actual number is irrelevant. This error means that your system does not have enough virtual memory to fsck a large device. This is a known problem with fsck. The solution is to add swap space with the swap -a command.
Release Notes The maxcontig value is somewhat dependent on the number of units that are active in your HSG80 configuration. In our testing, values of 128 and 256 blocks have worked very well. Your exact value will depend on the number of storagesets in use. If your system is reporting excessive numbers of warnings (ddi_iopb_alloc failed or fca_dma_zalloc failed) your value may be too high.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris • • • • storageset command done) Concatsets cannot be partitioned, and a partitioned storageset cannot be used in a concatset Once created, the only way to delete the concatset is to delete the unit that is on top of the concatset, then delete the concatset. An entity can be inserted into a concateset, but not removed. When going from a build that supports concatsets to a build that does not support a concatset, a shutdown must be done.
Release Notes 9. The filesystem is now expanded. Use the following command to verify: df –F vxfs We are developing a utility that will update the unit label without unmounting it. This will allow for truly dynamic filesystem expansion. Check our web site for more information on this utility. 8.0 AVOIDING PROBLEM SITUATIONS Under certain conditions, you may experience unusual controller behavior. This section presents information to help you avoid such situations and to recover from them if they occur.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 8.3 Adding, Moving, and Changing Controllers, Cache Modules, or External Cache Batteries It is permissible to replace the controller, cache module, or external cache battery while the subsystem is shut down. However, you must enter the SHUTDOWN THIS_CONTROLLER command before shutting the subsystem down to make configuration changes.
Release Notes Table 1-2 HSG80 Fibre Channel Array Controller Item Description Part Number 1 Gigabit Link Module (GLM) 402603-001 2 Program card 402604-001 4 Maintenance port cable 402605-001 Add the following part numbers to Table A-1, The HSG80 Subsystem: Table A-1 The HSG80 Subsystem Item Description Compaq Part Number DIGITAL Part Number 2 Cooling fan, gray 402602-001 FC-BA35X-ML 14 Disk drive, 4 GB, 7200 Disk drive, 9 GB, 7200 Disk drive, 18 GB, 7200 Disk drive, 9 GB, 10K Disk driv
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Add the following part numbers to Table A-2, HSG80 Fibre Channel Array Controller: Table A-2 HSG80 Fibre Channel Array Controller 10.0 Item Description Compaq Part Number DIGITAL Part Number 1 Gigabit Link Module (GLM) 402603-001 70-GLMS1-02 2 Program card 402604-001 BG-RFNUA-BA 4 Maintenance port cable 402605-001 70-32873-02 STORAGEWORKS COMMAND CONSOLE (SWCC) V2.
Release Notes 10.2 Minimum System Configuration Client requires the minimum system configuration shown in Table 3 to operate: Table 3 Client Minimum System Configuration Requirements Feature Requirement Architecture Intel® 486, 66 MHz, 16 MB memory, 1 MB free disk space, CD-ROM drive OR Windows NT-compatible Digital Equipment Corporation Alpha® system, 1 MB free disk space, CD-ROM drive Windows NT version 4.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 10.3 Qualification Client has been qualified with the operating systems, platforms, and controllers shown in Table 4: Table 4 Client Operating System and Platform Qualification Operating System ® Platforms Tested On Microsoft Windows NT®, version 4.
Release Notes Stand-Alone Installations After doing a stand-alone install of a device-specific Client, exit Command Console before adding or accessing a system with that type of device. Command Console will then recognize the installation SWCC 1.1B Client Will Not Work if Version 2.x Client Was Already Installed SWCC 1.1b will malfunction if you already have SWCC 2.x on a Windows NT operating system. The Asynchronous Event Service that comes with SWCC 2.x uses the same port as SWCC 1.1b. SWCC 1.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 10.5 Uninstall Notes Command Console Client Uninstall Does Not Remove AsyncEventService Entries Before uninstalling the Command Console Client, first remove the AsyncEventService entries. This prevents the computer from sending you messages during boot time about a service failing to start. Under Windows 95 and Windows 98, go into Control Panel | Async Event Service and uncheck "Automatic startup on boot.
Release Notes Special Windows NT® Device Driver Required for Compatibility For local SCSI and network connections, the special HSG80 device driver, HSZDISK.SYS, must be installed and running properly to connect Client to a host running Windows NT®. The device driver makes HSG80 virtual disks visible to the host operating system and enables communication between Client, Agent and the host’s file system. Version 4.11 or later of the driver must be used.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Warning Message Windows The controller software responds to problems in parsing and executing commands from Client and Agent by returning a message window entitled “Warning”. The content of such messages may contain such indications as “Command Execution Error,” along with pertinent detailed information. These messages are simply passed through for display by Client and Agent and are normally associated with problems in the controller.
Release Notes Operating System Considerations Client provides a graphical interface that replaces your controller’s CLI interface. It cannot, however, perform all operating system configuration necessary to make your subsystem’s virtual disks visible to the user in the operating system. When you create or delete virtual disks using either the CLI or Client, you are adding or removing “disks” in the subsystem in a manner similar to plugging or unplugging physical disk drives on the host bus.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris 7. Make sure that the access device you’ve been using for your subsystem still exists. If you inadvertently deleted it, you must assign another device in its place. If no access device exists, Client cannot communicate with your subsystem unless the CCL is used. 8. Click the Next button until you can exit the configurator. 9. Select the Services option in the Windows Control Panel. 10. Scroll down to highlight the Steam entry. 11.
Release Notes 5. Stop and Restart the Agent—Using the Agent configuration script, you must stop and restart the Agent running on your UNIX host, using the configuration program. In the program, you must choose the option to create a new storage.ini file. This action updates the Agent to recognize any virtual disk changes you have made. Enabling Subsystems in NT Agent Configurator In the Step 3 dialogue box of the NT Agent Configurator, a check box entitled “Subsystem Enabled” has been added.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Case Sensitivity in Agent STORAGE.INI File If you choose to manually edit an Agent STORAGE.INI file, enter storage subsystem names only in lower-case form. If you use upper-case characters in a name, Client and Agent may not be able to communicate because of a name mismatch. Case Sensitivity in Agent CLIENT.INI File For Windows NT and UNIX-based Agents: If you choose to manually edit an Agent client.
Release Notes If you must use VGA resolution, consider the following suggestions: • If you are running under Windows 95, enable the Auto Hide feature for the Task Bar. This feature provides more screen space when the Task Bar is not being used. • You may not be able to see the scroll bars on the bottom of the display. You can use the Storage window’s menu settings to remove the toolbar from the display to make room for the bottom scroll bars.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Setting Up Pager Notification You may need to tune the pager notification feature for proper functioning with certain pager systems. The pager feature supports both alphanumeric and numeric pagers and allows for notification of multiple pagers. You can select multiple pagers to be notified for multiple storage subsystems within different blocks of time. You can also temporarily disable any pager.
Release Notes 10. To set the communications port and baud rate for the pager modem, select Options/Preferences to view the Event Notification Preferences menu. You can also set the subsystem polling interval on this menu. 11. You can establish paging on three separate levels: You can establish paging on all levels on any combination of levels.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Documentation for DIGITAL OpenVMS and Alpha® Systems If you have an Alpha computer, you can use Adobe Acrobat Reader by running the fx!32 emulator that came with the Alpha computer. You can also download the fx!32 emulator from the following website: www.compaq.com. 10.7 Operating Constraints This section describes the operating constraints for the software.
Release Notes Failover Mode Set in CLI Client is intended to be used to configure and monitor your storage only, and there are some functions available in the CLI that are not available in graphic form in the GUI. If you wish to use your controller’s multiple-bus failover mode, you must enable and control that function via the CLI. Also, if you wish to use virtual disk preferencing in multiple-bus failover mode, you must set your virtual disk preferences via the CLI when you set the failover mode.
RA8000/ESA12000 HSG80 Solution Software V8.
Release Notes Delayed Event Notification on RAS Connections Visual fault notification, paging, and NT Event Logging may be delayed significantly in situations where RAS connections are used for multiple Clients. An Agent with multiple Clients in its client.ini file must poll each Client whenever a fault occurs. Any Clients not currently network-connected significantly delay this process, because Agent must wait for their connections to time out before moving on to the other Clients.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris • • • • • JBOD virtual disks—maximum of one member. JBOD’s may now be expanded to two disks if concatenated sets are used.
Release Notes Mirrored Cache Mode Not Retained After Configuration Restore If you restore your controller configuration from a configuration file, the mirrored cache setting may not be properly enabled. You must restore the mirrored cache setting manually, using a CLI Window. Error Message on Exiting Storage Window Under certain conditions, when you exit a Storage Window, you may experience an “Illegal Operation Error” message. You may ignore this message.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Storage Window Corruption While Deleting a Virtual Disk In some circumstances, if you delete and confirm deletion of a RAID-based virtual disk, a “Subsystem Connection Status” window may be displayed, and the Storage Window goes blank. The Storage Window may remain blank for several seconds until the “Subsystem Connection Status” window disappears.
Release Notes Storage Window Won’t Open If you cannot open a Storage Window from the Storage Window Manager or in standalone mode, the client.ini ACCESS_ALLOWED parameter for your Client is probably set to “0”, disabling Storage Window access. Use the Agent configuration script or edit the client.ini file to enable access to the subsystem. Configuration File Deleted on Reinstallation or Upgrade Make sure to save a copy of the current swcc2.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris To select another pair for Client, open the file containing the sockets in an ASCII editor, after you have installed Client.
Release Notes Missing Tabs in Search Menu in Help When you select the Search button in Command Console Help, Windows Help may not display an Index or Find Tab. To prevent this problem, delete any hidden files with a .GID extension that are in the Command Console directory. The WinHelp engine uses .GID files to construct the Index and Find Tabs. If the files are corrupted, the engine may not display one or both of the tabs. Deleting the files causes the engine to reconstruct the .GID files.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Connecting Via the Host SCSI Port Client may indicate that it cannot find your subsystem if you attempt to connect via the host SCSI port by using Windows NT in either of the following situations: • A StorageWorks controller subsystem is connected to the host, but the subsystem has no virtual disks configured on it in SCSI-2 mode with CCL disabled. • A StorageWorks controller subsystem is not connected to the host.
Release Notes Lost Connections Cause Invalid or Missing Fault Displays and Event Logs Client receives notification for most types of changing subsystem fault conditions on the next monitor interval after they occur. You may experience invalid or lost notifications in situations in which Client’s connection with its subsystems is broken. Any Windows NT Event Logs that might have occurred while the connection was broken are also lost.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris No Agent Notification Causes Invalid or Missing Fault Displays For some types of faults, Agent does not send Client notification of changes in status as they occur. Client displays whatever fault information it last received. Following are three situations in which a fault can occur without immediate display in Client: • The OTHER controller fails or is shut down. • A cache battery on either controller fails or goes low.
Release Notes Reservation Error Message The Agent application, and other applications which access RAID storage through SCSI, will get a reservation error if a device is reserved by one host and another host attempts to access the same device. When this occurs, a generic I/O error will be logged. Reservation Conflict Agent will discard reserved LUNs from its list of devices to be statused. The reservation conflict will be recorded for each reserved LUN in the system error log.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Switching SCSI Modes When switching HSG80 controllers from SCSI-3 to SCSI-2 mode, the host system should be rebooted after the change is made. This will clear any unclaimed SCSI-3 CCL devices from the system. Failure to clear devices can cause erratic Agent behavior or crash the NT system (BSOD). It is also recommended that you reboot when changing from SCSI-2 to SCSI-3 mode.
Release Notes In SCSI-2, you will only get one CCL, which is presented as an offline device in disk administrator. This CCL will show as “PhysicalDrive#” in the storage.ini file. Host Non-descriptive Error Message If the host machine running the Storage Window is not in the client.ini file of an Agent and attempts to access that Agent, a non-descriptive error message is returned. For example, “Cannot establish communication with ‘77FORD’ ”. [Socket message is incorrect type.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Agent Failure using Multiple Storage Windows If the Agent fails while you have multiple Storage Windows connected to different subsystems, you may not be able to close the Storage Window. When this occurs, close the Storage Window by using Windows Task Manager. Windows 98 Message When using the Storage Window with Windows 98, you may see the following message: could not acquire SWCC.MGR.1 object.
Release Notes Windows 95 Memory Leak When you run SWCC on Windows 95, the operating system will gradually increase its use of memory, especially when SWCC opens and closes a large number of sockets. Microsoft has released an upgraded version of kernel32.dll that corrects this situation. This file is available from the following website: www.microsoft.com/windows95/downloads/contents/wuadmintools/s_wunetwor kingtools/w95kernel32/default.asp The following is the name of the file: kernel32.dll version 4.00.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris WINS Not Supported Windows Internet Name Service (WINS) is a name resolution service available for Windows NT, Windows 98, and Windows 95. SWCC does not support WINS. Each system, using SWCC, must have access to either a DNS server or a valid hosts file. Access Denied Problem This section covers some of the most common reasons for a Client to receive an "Access Denied" message when it attempts to add an agent system to the Storage Window Manager.
Release Notes If hosts files are not exactly the same on all systems, the h_name returned may vary on different Agent systems. For example, xxx.xxx.xxx.xxx client.somewhere.com client will return client.somewhere.com in the h_name field, but xxx.xxx.xxx.xxx client client.somewhere.com will return client in the h_name field. In some situations, you can configure the way a system uses DNS and its local hosts file. Please refer to your system documentation to find how your system is configured.
RA8000/ESA12000 HSG80 Solution Software V8.5 for Sun Solaris Running" Message When Adding System to the Storage Window Manager When trying to add a new system to the Storage Window Manager, you may receive a message, stating "No Agent running on specified system." This message can appear for several reasons. The error most likely occurred as a result of one of the following: • • • • Wrong system name was entered. Agents were not installed on the entered system.