IBM System Storage SAN Volume Controller ++++++++++++++++++++++++++++++++++++++++ ------------------------------------------------------------------------------- CONTENTS 1. Introduction 2. Available Education 3. Pre-Requisites 4. Code Levels 5. Problems Resolved and New Features in this Build 6. Installation Instructions for New Clusters 7. Further Documentation 8. Known Issues and Restrictions in this Level 9. Maximum Configurations ------------------------------------------------------------------------------- 1. Introduction This document describes how to install version 4.2.0.4 of the IBM System Storage SAN Volume Controller (2145) software. This release of software is a new release and adds features as detailed in in Section 5 Please refer to the Recommended Software List and Supported Hardware List on the support website: http://www.ibm.com/storage/support/2145. ------------------------------------------------------------------------------- 2. Available Education A course on SAN Volume Controller Planning and Implementation is available. For further information or enrolment, contact your local IBM representative. ------------------------------------------------------------------------------- 3. Pre-Requisites Before installing this code level please check the following pre-requisites are met. Also please note the concurrent upgrade (upgrade with I/O running) restrictions. Check there are no unfixed errors in the error log or on the front panel. Use normal service procedures to resolve these errors before proceeding. Before upgrading the SVC cluster, we recommend using the new SVC Software Upgrade test utility. See this page for more details: http://www-1.ibm.com/support/docview.wss?uid=ssg1S4000585 If you are upgrading from a code level below 4.2.0.0, it is important that you upgrade the SVC Console Code (GUI) before you install the SVC code. The latest level of the GUI (4.2.0.614 or later) is available from the same website as this code. SVCC 4.2.0.614 is not fully compatible with SVC versions earlier than 4.2.0.0. Therefore the new SVC Console should only be used with SVC clusters running previous versions of SVC code in order to upgrade to SVC V4.2.0.x. Please see the details in the download document for the SVC Console for more details. For existing clusters please check which level your cluster is currently running before proceeding. Refer to the Configuration Guide (v4.2.0) - Chapter 6 ("Using the SAN Volume Controller Console"), section "Viewing Cluster Properties" to determine how to identify the code level currently installed on your cluster (Look for "Code Version"). If your cluster is at 3.1.0.5 or higher then please follow the upgrade instructions given in the Configuration Guide (v4.2.0) - Chapter 9 ("Upgrading the SAN Volume Controller software"), section "Upgrading the SAN Volume Controller software using the SAN Volume Controller Console". If you are running a version of SVC software older than 3.1.0.5 then you will have to perform multiple upgrades to install SVC 4.2.0 concurrently on your cluster. Please see the following web page for the full upgrade compatibility matrix. http://www.ibm.com/storage/support/software/sanvc/code If you are installing a new SVC Cluster then you will need to follow the procedure in section 6. This will upgrade the SVC cluster to version 4.2.0.4 before the cluster is configured for use. Please note the warning at the beginning of the process and only proceed if you are sure there is no data on this cluster. ------------------------------------------------------------------------------- 4. Code Levels 2145 Software: 2145 Release Level 4.2.0.4 (6.20.0709100000) ------------------------------------------------------------------------------- 5. Problems Resolved and New Features in this Build New Features in SVC 4.2.0.3 Email inventory and call home directly from the SVC cluster New Features in SVC 4.2.0 Multiple Target Flash Copy 2145-8G4 Hardware Platform Fast Node Reset Increased FlashCopy & Remote Copy limits Role-based authentication APARs resolved in this release (4.2.0.4): Critical Fixes IC53521 Performing a detailed host listing during a small timing window when a node is offline causes Cluster Error 1001 or Node Error 90x IC53655 Cluster Error 1001 caused by connectivity changes to storage controllers with multiple WWNNs Suggested Fixes IC53515 SVC calls home erroneously with transient errors APARs resolved in previous 4.2.0.x releases 4.2.0.3 Critical Fixes IC53282 State change of a storage controller during image mode migration causes Node Error 900 High Importance Fixes IC51110 SVC sends large numbers of LOGO frames to storage controller after error inject IC52753 Improvements handling medium errors from storage controllers IC52869 Node assert using a two node and an eight node cluster in a Metro Mirror partnership IC53067 Low probability node assert caused by race condition Suggested Fixes IC52735 Timestamps in error log skewed during node failover IC53137 SVC V4.2 does not correctly handle timezones 4.2.0.2: Critical Fixes IC52988 Node Error 578 after site power failure 4.2.0.1: Critical Fixes IC49968 Deleting a vdisk whilst it is being formatted causes Node Error 900 IC51374 Lease Expiry during cache flush IC52232 Increase priority of lease renewal processing to avoid cluster lease expiry IC52295 Node assert caused by overlapping reads & writes to a vdisk during a node failover High Importance Fixes IC49691 Node assert when Kasha logs into SVC IC49950 Node assert caused by SAN or controller instability IC50330 Node assert during timing window when issuing SVC commands IC50646 Improve handling of Asymmetric LUN Access IC50713 Node assert due to inter-cluster link instability IC50768 Node assert caused by incorrectly formatted stats filenames IC51129 Node assert due to timing window for outstanding I/Os to offline vdisks IC51176 Improvements handling medium errors from storage controllers IC51394 Node assert caused by SAN or controller instability IC51637 Node assert caused by ethernet link negotiation on non configuration nodes IC51694 Node assert caused by lock contention IC51797 Node assert caused by illegally addressed SCSI Test Unit Ready from host IC52116 Node assert when deleting stats files IC52182 Repeated node asserts caused by failing 4 port FC Card IC52335 Node assert caused by lock contention IC52401 Node Error 900 caused by ethernet status change during software upgrade IC52414 Node assert during timing window when issuing SVC commands IC52469 Node assert caused by KCQ 02,04,03 from EMC controllers IC52534 Repeated node assert caused by Remote Copy recovery IC52559 Node assert caused by SAN or controller instability IC52597 Node assert handling aborted IO during RemoteCopy synchronization Suggested Fixes IC49298 Add mdisk ID field to Nm_stats file IC49526 Setting an SVC IP address to a value with leading 0s prevents ethernet access to the cluster IC50515 FlashCopy will now discard write cache data for the target vdisk when a FC map is stopped IC50751 Internal hard disk failure now reported as Cluster Error 1030 IC50805 SVC will no longer log 'LUN Discovery Failed' messages if a controller does not have a LUN 0 IC51605 SVC unable to detect DS8K controller after host ports changed from FICON to FCP IC51753 Firewall rule revised to allow 70 ICMP pings per minute IC51763 SVC may not correctly load balance mdisk access in large configurations IC51901 SVC may not slander ports during certain types of fabric disruption IC52292 Unprintable characters in storage controller serial number prevents successful configuration backups IC52507 Reduce the number of duplicate errors logged when communicating with storage controllers IC52508 SVC backend write performance degraded when under very high read workload ------------------------------------------------------------------------------- 6. Installation Instructions For New Clusters $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ NOTE: This procedure will destroy any existing data or configuration. If you wish to preserve the current SVC configuration and all data virtualized by the cluster then please follow the upgrade instructions given in Chapter 6 of the Configuration Guide. $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ * This procedure is for new installations only. Please read the introduction again to make sure you understand which procedure you wish to use. * Follow the instructions in chapter 5 ("Creating a SAN Volume Controller cluster) of the Configuration Guide, refer to sections "Creating a cluster from the front panel" and "Creating a cluster using the SAN Volume Controller Console" in order to create a cluster on ONLY the first node. Do not add the other nodes at this point. * Follow the instructions in the section entitled "Viewing Cluster Properties" in chapter 6 ("Using the SAN Volume Controller Console") of the Configuration Guide to display the "code version". If the code version of the cluster is 4.2.0.4 (6.20.0709100000) then you do not need to perform any further actions. Continue to add nodes and configure your cluster as described in the configuration guide. Otherwise, continue to follow this procedure. * Ensure that you have set a unique IP address for service mode on the existing single node cluster. * Put the node in the existing single node cluster into Service Mode (See "Setting Service Mode under "Recover cluster navigation" described in Chapter 6 ("Using the front panel of the SAN Volume Controller") of the Service Guide. 1. On the front panel, navigate to the 'Cluster' main field and then left to the 'Recover Cluster?' secondary field. 2. Press 'Select'. The screen should now say 'Service Access?'. 3. Press and hold the 'Down' button. 4. Press and release the 'Select' button. 5. Release the 'Down' button. The node will restart and display the Service IP address. The front panel buttons are disabled whilst in this state. * Apply the upgrade package. 1. Open a web browser and point it at https:// 2. Enter the admin or service user and password that was configured when you set up the one node Cluster. 3. Click "Upgrade Software" on the left side of the web page. 4. Click the "Upload" button and upload the IBM2145_INSTALL_4.2.0.4 file. 5. Once the upload completes, press the "Continue" button. This will take you to a page with a list of available upgrade packages. 6. Select the File you just uploaded from the list of available software upgrade files, and check the "Skip prerequisite checking" box. Click the "Apply" button. 7. Click the "Confirm" Button. 8. The node will now reboot and apply the new software. Note: If upgrading from 3.1.0.5 or 4.1.0.x to 4.2.0.x then an SVC dump may be generated during this upgrade. This is expected and can be ignored. * Once upgraded, create a new cluster on the recently upgraded node. Instructions for this are in Chapter 2 ("Creating a SAN Volume Controller cluster") of the Configuration Guide. At this point you will have a new one node cluster running 4.2.0.4 code. * After this process is complete, check that the software version number is 4.2.0.4 (6.20.0709100000). * You can now add the other nodes to the cluster and they will automatically be upgraded. ------------------------------------------------------------------------------- 7. Further Documentation All publications can be downloaded from the support website: http://www.ibm.com/storage/support/2145 ------------------------------------------------------------------------------- 8. Known Issues and Restrictions in this Level The current product limitations are detailed in the product restrictions document available here: http://www.ibm.com/storage/support/2145 Please read all the warnings in section 3 (pre-requisites). During upgrades to SVC 4.2.0.4, information about some objects which exist on the remote cluster will not be available. The affected commands are: svcinfo lsrcrelationship svcinfo lsrcrelationshipcandidate svcinfo lsrcconsistgrp svcinfo lsrcrelationshipprogress SVC V4.2.0 introduces a new FlashCopy (FC) behaviour. If a 'svctask stopfcmap' command is issued to a FC mapping which is in the idle_or_copied state then the mapping will stay in the idle_or_copied state, rather than changing into the stopped state. Please read the following flashes before upgrading to SVC V4.2.0 Potential Issue When Upgrading From SVC V4.1.1.0/1/2 http://www-1.ibm.com/support/docview.wss?uid=ssg1S1003069 Offline or Degraded Disks May Result in Loss of I/O Access During Code Upgrade http://www-1.ibm.com/support/docview.wss?rs=591&uid=ssg1S1002971 If an SVC Code Upgrade Stalls or Fails then Contact IBM Support for Further Assistance http://www-1.ibm.com/support/docview.wss?rs=591&uid=ssg1S1002894 ------------------------------------------------------------------------------- 9. Maximum Configurations. The Maximum Configurations of SVC are documented in the SVC V4.2.0 Configuration Requirements and Guidelines Document which is available from http://www-1.ibm.com/support/docview.wss?rs=591&uid=ssg1S1003093 -------------------------------------------------------------------------------