Xsan 1.2: How to use the Xsan 1.2 Updates

This article outlines the basic steps required to update Xsan 1.1 to version 1.2. If you are still using Xsan 1.0, you must first update to Xsan 1.1. Please note that the Xsan Migration guide, available here, contains additional scenarios and details.

The steps vary according to whether your starting point is Mac OS X 10.3.9 or Mac OS X 10.4.3 or later, and there are two versions of the Xsan 1.2 Update to accommodate that.

Before you begin

• All metadata controllers (MDCs) should have the same version of Mac OS X.
• Do not make any changes to Xsan settings using Xsan Admin or the command-line tools during the installation.
• Be sure that all MDCs are updated before you make any configuration changes.
• If any system in your Xsan network is running Xsan 1.2 on Mac OS X 10.4.3 or later, then your MDCs must also be updated to Xsan 1.2 on Mac OS X 10.4.3 or later. The same is true for Xsan 1.2 on Mac OS X 10.3.9. The rule of thumb is that your MDCs must be running an Xsan version and operating system version that is as current as the most current of your clients.

Important: Preventing an inconsistent volume state

Xsan versions prior to 1.2 may have left bitmap artifacts on Xsan volumes, which could result in an inconsistent volume state. After all MDCs have been updated to Xsan 1.2, you should run the cvfsck command (as described below) to ensure a consistent volume state and to prevent data corruption or stability issues over the long term.

Updating Xsan 1.1 on Mac OS X 10.3.9 to Xsan 1.2

Follow these steps to update Mac OS X 10.3.9 from Xsan 1.1 to Xsan 1.2:

1. Unmount volumes on the controllers.
2. Update Xsan on one MDC at a time, using the Xsan 1.2 Update for 10.3.9.
3. Update any admin computers using the Xsan Admin 1.2 Update.
4. Stop the volume using Xsan Admin.
5. In Terminal on the MDC, run this command as root:
   

   # cvfsck volumeName

   Note: Replace "volumeName" with the actual name of an Xsan volume.
   
   
6. Restart the volume using Xsan Admin.
7. Repeat steps 4 to 6 until you have run cvfsck for each Xsan volume.
8. Update client Mac OS X 10.3.9 client computers using the Xsan 1.2 Update for 10.3.9.

Updating Xsan 1.1 on Mac OS X 10.4.3 or later to Xsan 1.2

1. Update Xsan on one MDC at a time, using the Xsan 1.2 Update for 10.4.3.
2. Update any admin computers using the Xsan Admin 1.2 Update.
3. Stop the volume using Xsan Admin.
4. In Terminal on the MDC, run this command as root:
   

   # cvfsck volumeName

   Note: Replace "volumeName" with the actual name of an Xsan volume.
   
   
5. Restart the volume using Xsan Admin.
6. Repeat steps 3 to 5 until you have run cvfsck for each Xsan volume.
7. Update Mac OS X 10.4.3 (or later) client computers using the Xsan 1.2 Update for 10.4.3.

Related articles

About the Xsan 1.2 Updates
"Invalid" Serial Numbers fixed with Xsan 1.2