Mac OS X Server Upgrading and Migrating For Version 10.5 Leopard Apple Inc. © 2007 Apple Inc. All rights reserved. The owner or authorized user of a valid copy of Mac OS X Server software may reproduce this publication for the purpose of learning to use such software. No part of this publication may be reproduced or transmitted for commercial purposes, such as selling copies of this publication or for providing paid-for support services. Every effort has been made to make sure that the information in this manual is correct. Apple Inc. is not responsible for printing or clerical errors. Apple 1 Infinite Loop Cupertino CA 95014-2084 www.apple.com The Apple logo is a trademark of Apple 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. Apple, the Apple logo, iChat, Mac, Macintosh, QuickTime, Xgrid, Xserve, and WebObjects are trademarks of Apple Inc., registered in the U.S. and other countries. Finder is a trademark of Apple Inc. Adobe and PostScript are trademarks of Adobe Systems Incorporated. Intel, Intel Core, and Xeon are trademarks of Intel Corp. in the U.S. and other countries. JavaTM and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. PowerPCTM and the PowerPC logoTM are trademarks of International Business Machines Corporation, used under license therefrom. UNIX is a registered trademark of The Open Group. Other company and product names mentioned herein are trademarks of their respective companies. Mention of third-party products is for informational purposes only and constitutes neither an endorsement nor a recommendation. Apple assumes no responsibility with regard to the performance or use of these products. 019-0937/2007-09-01 1 Contents Preface 5 5 6 6 6 8 8 8 9 11 11 11 12 12 12 12 13 15 17 17 18 18 25 27 27 28 29 30 47 47 About This Guide What's in This Guide Using This Guide Using Onscreen Help Mac OS X Server Administration Guides Viewing PDF Guides on Screen Printing PDF Guides Getting Documentation Updates Getting Additional Information Before You Begin Servers from Which You Can Upgrade or Migrate Upgrading to v10.5 Migrating from a Pre-10.5 Version Server to v10.5 Migrating from Windows NT Migrating Users and Groups Saving and Reusing User and Group Accounts System Accounts Applying a New Serial Number Upgrading Mac OS X Server v10.4 Understanding What Can Be Reused Upgrading an Open Directory Master and Its Replicas Step-by-Step Instructions Upgrading Apache Web Server to v2.2 from v1.3 Migrating from Mac OS X Server v10.4 Before You Begin Understanding What You Can Migrate Tools You Can Use Step-by-Step Instructions Upgrading Mac OS X Server v10.3 Understanding What Can Be Reused Chapter 1 Chapter 2 Chapter 3 Chapter 4 3 48 48 55 Chapter 5 57 57 58 59 60 75 75 75 76 77 89 89 90 90 91 96 96 96 97 97 97 108 111 115 Upgrading an Open Directory Master and Its Replicas Step-by-Step Instructions Upgrading Apache Web Server to v2.2 from v1.3 Migrating from Mac OS X Server v10.3 Before You Begin Understanding What You Can Migrate Tools You Can Use Step-by-Step Instructions Migrating from Mac OS X Server v10.2 Before You Begin Understanding What You Can Migrate Tools You Can Use Step-by-Step Instructions Migrating to Mac OS X Server from Windows NT Before You Begin Understanding What You Can Migrate What Migrated Users Can Do Planning Your Migration Tools You Can Use Tools for Migrating Users, Groups, and Computers Tools for Migrating the File Service Tools for Providing Windows Access to Print Service Step-by-Step Instructions Migrating Users, Groups, and Computers Migrating Windows File Service Providing Windows Access to Print Service Chapter 6 Chapter 7 Index 4 Contents Use this guide when you want to move to Mac OS X Server v10.5 from a previous version of the server or to migrate Windows NT data to Mac OS X Server v10.5. Upgrading and Migrating contains instructions for reusing data and settings of previous server versions. There are two approaches: Â Perform an upgrade installation. This approach leaves all your data and settings in place and lets you reuse your existing server hardware for Mac OS X Server v10.5. You can perform an upgrade installation of v10.4 and v10.3 servers. Â Manually migrate data and settings. This approach transfers data and settings to a different computer--one running Mac OS X Server v10.5. You can migrate data and settings from server versions 10.4, 10.3, and 10.2. What's in This Guide This guide includes the following chapters: Â Chapter 1, "Before You Begin," summarizes upgrade and migration options and requirements. Â Chapter 2, "Upgrading Mac OS X Server v10.4," describes how to upgrade a v10.4.10 or later server to v10.5. Â Chapter 3, "Migrating from Mac OS X Server v10.4," describes how to migrate data from a v10.4.10 or later server to a different computer running v10.5. Â Chapter 4, "Upgrading Mac OS X Server v10.3," describes how to upgrade a v10.3.9 server to v10.5. Â Chapter 5, "Migrating from Mac OS X Server v10.3," describes how to migrate data from a v10.3.9 server to a different computer running v10.5. Â Chapter 6, "Migrating from Mac OS X Server v10.2," describes how to migrate data from a v10.2.8 server to a different computer running v10.5. Â Chapter 7, "Migrating to Mac OS X Server from Windows NT," describes how to migrate data from a Windows NT server to a computer running Mac OS X Server v10.5. Preface 5 About This Guide Using This Guide Using this guide is easy. Read Chapter 1 to make sure you understand your options. Then turn to the chapter that addresses your upgrade or migration scenario. You'll find step-by-step instructions for preserving and reusing server data by using various tools and manual techniques. You'll also find references to instructions and supplemental information in other guides in the server suite. The next page tells you about the documents in the suite and where to find them. Using Onscreen Help You can get task instructions onscreen in the Help Viewer application while you're managing Leopard Server. You can view help on a server or an administrator computer. (An administrator computer is a Mac OS X computer with Leopard Server administration software installed on it.) To get help for an advanced configuration of Leopard Server: m Open Server Admin or Workgroup Manager and then: Â Use the Help menu to search for a task you want to perform. Â Choose Help > Server Admin Help or Help > Workgroup Manager Help to browse and search the help topics. The onscreen help contains instructions taken from Server Administration and other advanced administration guides described in "Mac OS X Server Administration Guides," next. To see the most recent server help topics: m Make sure the server or administrator computer is connected to the Internet while you're getting help. Help Viewer automatically retrieves and caches the most recent server help topics from the Internet. When not connected to the Internet, Help Viewer displays cached help topics. Mac OS X Server Administration Guides Getting Started covers basic installation and initial setup methods for an advanced configuration of Leopard Server as well as for a standard or workgroup configuration. An advanced guide, Server Administration, covers advanced planning, installation, setup, and more. A suite of additional guides, listed below, covers advanced planning, setup, and management of individual services. You can get these guides in PDF format from the Mac OS X Server documentation website: 6 Preface About This Guide www.apple.com/server/documentation This guide ... Getting Started and Mac OS X Server Worksheet Command-Line Administration File Services Administration iCal Service Administration iChat Service Administration Mac OS X Security Configuration Mac OS X Server Security Configuration Mail Service Administration Network Services Administration Open Directory Administration Podcast Producer Administration Print Service Administration QuickTime Streaming and Broadcasting Administration Server Administration tells you how to: Install Mac OS X Server and set it up for the first time. Install, set up, and manage Mac OS X Server using UNIX commandline tools and configuration files. Share selected server volumes or folders among server clients using the AFP, NFS, FTP, and SMB protocols. Set up and manage iCal shared calendar service. Set up and manage iChat instant messaging service. Make Mac OS X computers (clients) more secure, as required by enterprise and government customers. Make Mac OS X Server and the computer it's installed on more secure, as required by enterprise and government customers. Set up and manage IMAP, POP, and SMTP mail services on the server. Set up, configure, and administer DHCP, DNS, VPN, NTP, IP firewall, NAT, and RADIUS services on the server. Set up and manage directory and authentication services, and configure clients to access directory services. Set up and manage Podcast Producer service to record, process, and distribute podcasts. Host shared printers and manage their associated queues and print jobs. Capture and encode QuickTime content. Set up and manage QuickTime streaming service to deliver media streams live or on demand. Perform advanced installation and setup of server software, and manage options that apply to multiple services or to the server as a whole. Use NetBoot, NetInstall, and Software Update to automate the management of operating system and other software used by client computers. Use data and service settings from an earlier version of Mac OS X Server or Windows NT. Create and manage user accounts, groups, and computers. Set up managed preferences for Mac OS X clients. Set up and manage web technologies, including web, blog, webmail, wiki, MySQL, PHP, Ruby on Rails, and WebDAV. Set up and manage computational clusters of Xserve systems and Mac computers. Learn about terms used for server and storage products. System Imaging and Software Update Administration Upgrading and Migrating User Management Web Technologies Administration Xgrid Administration and High Performance Computing Mac OS X Server Glossary Preface About This Guide 7 Viewing PDF Guides on Screen While reading the PDF version of a guide onscreen: Â Show bookmarks to see the guide's outline, and click a bookmark to jump to the corresponding section. Â Search for a word or phrase to see a list of places where it appears in the document. Click a listed place to see the page where it occurs. Â Click a cross-reference to jump to the referenced section. Click a web link to visit the website in your browser. Printing PDF Guides If you want to print a guide, you can take these steps to save paper and ink: Â Save ink or toner by not printing the cover page. Â Save color ink on a color printer by looking in the panes of the Print dialog for an option to print in grays or black and white. Â Reduce the bulk of the printed document and save paper by printing more than one page per sheet of paper. In the Print dialog, change Scale to 115% (155% for Getting Started). Then choose Layout from the untitled pop-up menu. If your printer supports two-sided (duplex) printing, select one of the Two-Sided options. Otherwise, choose 2 from the Pages per Sheet pop-up menu, and optionally choose Single Hairline from the Border menu. (If you're using Mac OS X v10.4 or earlier, the Scale setting is in the Page Setup dialog and the Layout settings are in the Print dialog.) You may want to enlarge the printed pages even if you don't print double sided, because the PDF page size is smaller than standard printer paper. In the Print dialog or Page Setup dialog, try changing Scale to 115% (155% for Getting Started, which has CDsize pages). Getting Documentation Updates Periodically, Apple posts revised help pages and new editions of guides. Some revised help pages update the latest editions of the guides. Â To view new onscreen help topics for a server application, make sure your server or administrator computer is connected to the Internet and click "Latest help topics" or "Staying current" in the main help page for the application. Â To download the latest guides in PDF format, go to the Mac OS X Server documentation website: www.apple.com/server/documentation 8 Preface About This Guide Getting Additional Information For more information, consult these resources: Â Read Me documents--important updates and special information. Look for them on the server discs. Â Mac OS X Server website (www.apple.com/server/macosx)--gateway to extensive product and technology information. Â Mac OS X Server Support website (www.apple.com/support/macosxserver)--access to hundreds of article ...