Xsan Migration Guide Instructions for upgrading to Xsan 1.
K Apple Computer, Inc. © 2006 Apple Computer, Inc. All rights reserved. Under the copyright laws, this manual may not be copied, in whole or in part, without the written consent of Apple. The Apple logo is a trademark of Apple Computer, Inc., registered in the U.S. and other countries. Use of the “keyboard” Apple logo (Option-Shift-K) for commercial purposes without the prior written consent of Apple may constitute trademark infringement and unfair competition in violation of federal and state laws.
1 Preface 5 5 Contents About This Guide Notation Conventions Chapter 1 7 7 7 8 8 9 9 10 General Information About Upgrading Xsan About Macintosh Computers with Intel Processors Migrating Without Interruption About Primary and Standby Controllers If You Don’t Have a Standby Controller Where to Get the Updates Mac OS X or Mac OS X Server? Version Compatibility Chapter 2 11 Upgrading to Xsan 1.4 on Mac OS X version 10.4 Appendix 19 Upgrading to Xsan 1.1 on Mac OS X version 10.
Contents
Preface About This Guide This guide shows how to upgrade to Xsan 1.4 without interrupting volume availability. Follow the instructions in this guide to upgrade your Xsan SAN to Xsan 1.4 on Mac OS X or Mac OS X Server version 10.4. For general information about upgrading, read Chapter 1. For instructions that show how to upgrade from Xsan 1.1, 1.2, or 1.3 to Xsan 1.4 on Mac OS X or Mac OS X Server version 10.4, read Chapter 2. For instructions that show how to first upgrade from Xsan 1.
Preface About This Guide
1 General Information About Upgrading Xsan 1 Review the information in this chapter before you upgrade your Xsan storage area network. About Macintosh Computers with Intel Processors Macintosh computers with Intel processors run only Xsan 1.4 or later, so they don’t need to be upgraded. However, if you add a Macintosh computer with an Intel processor to your SAN as a metadata controller, you must upgrade all other controllers on the SAN to Xsan 1.
If Volume Availability During the Upgrade Is Not Important If your SAN volumes don’t need to be available during the upgrade, you can stop the volumes and then perform the upgrade as you would any software upgrade, without relying on controller failover. Stopping volumes lets you skip intermediate versions, so you can upgrade directly, for example, from Xsan 1.1 to Xsan 1.4 without installing Xsan 1.2 or 1.3 (which you would otherwise have to install to maintain volume availability during the upgrade).
Promoting a Client to Standby Controller You can temporarily change the role of a client computer so that it acts as a standby controller during the upgrade. This allows uninterrupted access to your SAN volumes during the upgrade. To promote a client to controller: 1 In Xsan Admin, select the SAN in the SAN Components list and click Setup. 2 Click Computers, select the client in the computer list, and click Edit. 3 Choose Controller from the Role pop-up menu.
Version Compatibility The following table shows which versions of Xsan and StorNext controllers and clients can be used on the same SAN. Controller Client Compatible? Xsan 1.4 Xsan 1.4 Yes Xsan 1.3 (Mac OS X v10.4) Yes Xsan 1.3 (Mac OS X v10.3) Yes, for LUNs < 2 TB Xsan 1.3 (Mac OS X v10.4) StorNext 2.8 StorNext 2.7 StorNext 2.6 or earlier 10 Xsan 1.2 or earlier No StorNext 2.8 No StorNext FX 1.3 or 1.4 Yes StorNext 2.6 or 2.7 Yes StorNext 2.5 or earlier No Xsan 1.4 No Xsan 1.
2 Upgrading to Xsan 1.4 on Mac OS X version 10.4 2 Follow the instructions in this chapter if you are currently using Xsan 1.1, 1.2, or 1.3 on Mac OS X version 10.3 or Mac OS X version 10.4. Note: If you are still running Xsan 1.0 or 1.0.1, you can follow the instructions in the appendix to move to Xsan 1.1 on Mac OS X v10.4, and then follow the steps in this chapter to complete the upgrade. The following steps summarize how to upgrade your SAN to Xsan 1.4 if your controllers are running Xsan 1.
Step 1: If needed, upgrade SAN controllers to Mac OS X v10.4.7 Xsan 1.4 requires Mac OS X (or Mac OS X Server) v10.4.7. If your SAN controllers are running an earlier version of Mac OS X, you must upgrade the controllers to v10.4.7 (or later) before you upgrade Xsan.
Step 2: If needed, migrate controllers to the equivalent Tiger version of Xsan If your controllers were already running Xsan on Mac OS X v10.4 before you started this upgrade, go on to Step 3 on the next page. If you upgraded your controllers from Mac OS X v10.3 Panther to v10.4 Tiger in Step 1 on the previous page, you need to migrate the old Panther version of Xsan to the same version for Tiger. So, for example, if you were running Xsan 1.1 for Panther on Mac OS X v10.
Step 3: If needed, upgrade Xsan on controllers and clients to Xsan 1.3 If you are already running Xsan 1.3 on your controllers and clients, you can go on to Step 4 on the next page. If your controllers and clients are not running Xsan 1.3 and you want to upgrade without interrupting volume availability, you must migrate your controllers and clients one version of Xsan at a time to permit failover until they are all running Xsan 1.3.
Step 4: Upgrade controllers to Xsan 1.4 When all controllers are running Xsan 1.3 on Mac OS X v10.4.7, you can upgrade the Xsan software to Xsan 1.4. Important: If you want your SAN volumes to be available to clients during the upgrade, upgrade the controllers one at a time so that there is always a standby controller to assume control of any volume currently hosted by the controller you are upgrading. To upgrade Xsan on the controllers: 1 Upgrade one controller to Xsan 1.4. If you have an Xsan 1.
Step 5: Upgrade the Xsan Admin application on administrator computers If you run Xsan Admin on other computers to make it easier to manage the SAN, upgrade the application on those computers to version 1.4. Note: You can run version 1.4 of the Xsan Admin application on any computer with Mac OS X or Mac OS X Server v10.4.7 or later installed. To upgrade the Xsan Admin application: m If you have an Xsan 1.
Step 6: Optionally, return control of volumes to a specific controller When you restart a controller during the upgrade process, control of the volumes the controller is hosting switches to a standby controller. After you finish upgrading, you can use the cvadmin command-line tool to return control of a volume to a specific controller.
Step 7: Optionally, upgrade client computers Clients running Xsan 1.3 on Mac OS X v10.3.9 or on any version of Mac OS X v10.4 can use volumes hosted by controllers running Xsan 1.4, so you don’t have to upgrade your clients to Xsan 1.4. However, upgrading the client computers on your SAN is highly recommended. Note: You won’t be able to change the role of a client computer to controller unless you upgrade the client to Xsan 1.4. To upgrade client computers to Xsan 1.4: 1 Run the Mac OS X v10.4.
Appendix Upgrading to Xsan 1.1 on Mac OS X version 10.4 If you’re still running Xsan 1.0 on Mac OS X v10.3 Panther, you need to follow the instructions in this chapter to migrate to Xsan 1.1 on Mac OS X v10.4 Tiger before you can perform the steps in Chapter 2. Why You Must First Upgrade to Xsan 1.1 on Mac OS X v10.3.9 Your Xsan volumes remain available to clients during the upgrade if you have at least one standby controller.
Why You Must Upgrade to Xsan 1.1 Twice Xsan 1.1 on Mac OS X v10.3 is not the same software as Xsan 1.1 on Mac OS X v10.4. So, you need to upgrade once when your controllers are running Mac OS X v10.3.9 and a second time after upgrading to Mac OS X v10.4.7 (or later) to get all the capabilities of Xsan on Mac OS X Tiger. The following steps summarize how to move from Xsan 1.0 on Mac OS X v10.3 to Xsan 1.1 on Mac OS X v10.4: 1 Unmount volumes from all controllers. 2 Upgrade all controllers to Mac OS X v10.3.
Step 1: Unmount volumes from all controllers To avoid difficulties mounting volumes on controllers after upgrading, unmount Xsan volumes from the controllers before you upgrade. Unmounting volumes from the controllers does not affect availability for clients. To unmount a volume: m In Xsan Admin, select the volume in the SAN Components list and click Clients. Then select a controller and click Unmount. Step 2: Upgrade all controllers to Mac OS X v10.3.9 Because Xsan 1.
Step 3: Upgrade all controllers to Xsan 1.1 on Mac OS X v10.3.9 Now that the controllers are running Mac OS X v10.3.9, you can upgrade the Xsan software to Xsan 1.1. Important: If you want your SAN volumes to be available to clients during the upgrade, upgrade the controllers one at a time so that there is always a standby controller to take control of any volume currently hosted by the controller you are upgrading. To upgrade Xsan on the controllers: 1 Upgrade one controller to Xsan 1.1.
Step 4: Upgrade standby controllers to Xsan 1.1 on Mac OS X v10.4.7 or later Now you can upgrade your controllers to Xsan 1.1 on Mac OS X (or Mac OS X Server) v10.4.7 or later. Important: If you want your SAN volumes to be available to clients during the upgrade, upgrade your standby controllers one at a time so there is always a standby controller ready to take control of any volume currently hosted by the controller you are upgrading. To upgrade your standby controllers to Xsan 1.1 on Mac OS X v10.4.
Step 5: Upgrade the primary controller to Xsan 1.1 on Mac OS X v10.4.7 or later Now that the standby controllers are running Xsan 1.1 on Mac OS X (or Mac OS X Server) v10.4.7 or later, you can upgrade the primary controller. To upgrade your primary controller to Xsan 1.1 on Mac OS X v10.4.7: 1 Insert the Mac OS X version 10.4 software installation disc in the primary controller computer and double-click the Install Mac OS X icon.