Installing and maintaining the software for the SAN Volume Controller

The software for the SAN Volume Controller is pre-installed on all nodes. This software includes the following items:

Introduction

Because the software is pre-installed, it is not normally necessary to replace the software on a node. However, if the software is lost for some reason, for example if the hard disk drive in the node fails, it is possible to copy all the software from another node connected to the same fibre-channel fabric. This process is known as node rescue.

To allow nodes to operate as a cluster, you must run all nodes at the same version of software. This rule is enforced by the cluster software itself. When you attempt to add a node to a cluster its software version is examined, and if it is not running the same version of the software as the other nodes in the cluster, the software revisions are automatically copied from one of the other nodes in the cluster before the add operation is completed. If for some reason it is not possible to update the software on the node that you are adding, the operation fails and the cluster logs an error to explain the cause of the failure.

If the SAN Volume Controller detects software errors an error code is generated. The additional data logged with the error will indicate the source of the software error. The additional data might look like this:

Assert File /build/lodestone/030129_nd/src/user/vg/vgagentevt.c Line 1234

To view the additional data you will need to access the SAN Volume Controller web pages and select the Analyze error log option for the software error that you are investigating. Report the error code and the additional data to your IBM Product Support Center.

If this problem is known for your version of software, the customer will be advised to upgrade to the latest software level. If the problem is not known to the Support Center you might be asked to provide additional information for this error. In most cases a dump will automatically be taken when the software error is detected.

If requested to do so by your Support Center, you can use the SAN Volume Controller Console application on the master console to list and save dump data. If more than one dump file exists, select the dump file with a time stamp closest to the time stamp on the software error report and save this file for use by the Support Center.

Or, you can use the command-line interface to perform these tasks. You can list dumps using the following commands:

Secure copy can be used to copy a dump file to the master console.

Related topics

For information about related topics, see the following:

(C) Copyright International Business Machines Corporation 2003, 2004