Apple Mac OS X Server Migration For Version 10.3 or Later User Manual

Mac OS X ServerMigrationFor Version 10.3 or Later034-2344_Cvr 9/12/03 7:37 AM Page 1

10 Chapter 1 Before You Begin And here is a list of the predefined group accounts: Short name Group ID nobody -2nogroup -1wheel 0daemon 1kmem

100 Chapter 5 Migrating From AppleShare IP 6 If you’re migrating the mail database, locate the file AppleShare IP Mail 6.0 Data and click Choose.7

Chapter 5 Migrating From AppleShare IP 101 You can also use the dsimport tool to import users and groups. See the command-line administration guide

102 Chapter 5 Migrating From AppleShare IP Step 9: Set up share points and privilegesRe-create the share points and privileges as required. Rememb

Chapter 5 Migrating From AppleShare IP 103 4 Open Server Admin on the version 10.3 server and make sure that Macintosh Manager and AFP services are

104 Chapter 5 Migrating From AppleShare IP 10 The server and each client computer have script settings that designate the primary language for each

Chapter 5 Migrating From AppleShare IP 105 When the migration utility finds a managed client user already exists in a Mac OS X Server directory, th

Chapter 1 Before You Begin 11 Migrating Data for Managed Mac OS 8 and 9 Users On Mac OS X Server version 10.3, Macintosh Manager version 2.2 is

12 Chapter 1 Before You Begin After Migration When you’ve finished migrating, consider whether you want to take advantage of any of the newer f

2 13 2 Migrating From Mac OS X Server Version 10.2 Use the instructions in this chapter when you need to migrate data from a version 10.2 serv

14 Chapter 2 Migrating From Mac OS X Server Version 10.2 • Macintosh Manager data• User and group accountsIf you’re using any of the following, mak

Chapter 2 Migrating From Mac OS X Server Version 10.2 15 Migrating in Place From Version 10.2To install Mac OS X Server version 10.3 on a computer

16 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 1: Make a full backup of your current serverUse your current backup program to creat

Chapter 2 Migrating From Mac OS X Server Version 10.2 17 AFPSave the AFP configuration after running the following command from the Terminal applic

18 Chapter 2 Migrating From Mac OS X Server Version 10.2 Macintosh Manager DataIf you use Macintosh Manager and want to continue using it, copy the

Chapter 2 Migrating From Mac OS X Server Version 10.2 19 Step 5: Install Mac OS X Server version 10.3Follow the instructions in the getting starte

K Apple Computer, Inc.© 2003 Apple Computer, Inc. All rights reserved.The owner or authorized user of a valid copy of Mac OS X Server software may

20 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 7: Import previously exported users and groupsYou can use Workgroup Manager or the d

Chapter 2 Migrating From Mac OS X Server Version 10.2 21 Step 8: Restore saved dataCopy the files you want to reuse from their backup location.Web

22 Chapter 2 Migrating From Mac OS X Server Version 10.2 Mail DatabaseTo migrate the mail database:1 Make sure that mail service is not running.Ope

Chapter 2 Migrating From Mac OS X Server Version 10.2 23 NetBoot ImagesCopy the <name>.nbi folder for each image you want to migrate, optiona

24 Chapter 2 Migrating From Mac OS X Server Version 10.2 DHCP SettingsTo migrate the DHCP configuration:1 Restore the DHCPconfig file.2 Open Server

Chapter 2 Migrating From Mac OS X Server Version 10.2 25 Step 9: Set up share points and privilegesRe-create the share points and privileges as re

26 Chapter 2 Migrating From Mac OS X Server Version 10.2 Migrating to a New Server From Version 10.2To move data from a Mac OS X Server version 10.

Chapter 2 Migrating From Mac OS X Server Version 10.2 27 Step 1: Export users and groupsUse Workgroup Manager to export user and group accounts fr

28 Chapter 2 Migrating From Mac OS X Server Version 10.2 Web ContentCopy web content you want to reuse from:• /Library/Webserver/Documents/• /Libra

Chapter 2 Migrating From Mac OS X Server Version 10.2 29 WebObjects Applications and FrameworksSave WebObjects applications and frameworks located

3 1 Contents Preface 5 What’s in This Guide5 What’s Included in This Guide 5 Getting Additional Information Chapter 1 7 Before You Begin7 Upgr

30 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 3: Note current share points and privilegesIf your version 10.2 server has share poi

Chapter 2 Migrating From Mac OS X Server Version 10.2 31 5 If you’ll restore home directories in locations that won’t exactly match the locations i

32 Chapter 2 Migrating From Mac OS X Server Version 10.2 Web Configuration DataTo migrate the web configuration:1 Save the file /etc/httpd/servermg

Chapter 2 Migrating From Mac OS X Server Version 10.2 33 Mail DatabaseTo migrate the mail database:1 Make sure that mail service is not running.Ope

34 Chapter 2 Migrating From Mac OS X Server Version 10.2 NetBoot ImagesCopy the <name>.nbi folder for each image you want to migrate, optiona

Chapter 2 Migrating From Mac OS X Server Version 10.2 35 DHCP SettingsTo migrate the DHCP configuration:1 Restore the DHCPconfig file.2 Open Server

36 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 8: Set up share points and privilegesRe-create the share points and privileges as re

3 373 Migrating From Mac OS X Server Version 10.1Use the instructions in this chapter when you need to migrate data from a version10.1 server.Thi

38 Chapter 3 Migrating From Mac OS X Server Version 10.1 If you’re using any of the following, make a note of any settings you want to continue to

Chapter 3 Migrating From Mac OS X Server Version 10.1 39 Migrating in Place From Version 10.1To install Mac OS X Server version 10.3 on a computer

4 Contents Chapter 5 83 Migrating From AppleShare IP83 Understanding What You Can Migrate 84 Tools You Can Use 85 Migrating in Place From ASIP 96 Mig

40 Chapter 3 Migrating From Mac OS X Server Version 10.1 Step 2: Copy current data to another hard disk or partitionSave all the data files that y

Chapter 3 Migrating From Mac OS X Server Version 10.1 41 AFPSave the AFP configuration after running the following command from the Terminal applic

42 Chapter 3 Migrating From Mac OS X Server Version 10.1 QuickTime Streaming Server Files and FoldersSave files and folders in /Library/QuickTimeSt

Chapter 3 Migrating From Mac OS X Server Version 10.1 43 To prepare the server to store home directories:1 Create the folder you want to serve as t

44 Chapter 3 Migrating From Mac OS X Server Version 10.1 8 To create home directories for imported users, you have several options. Create home dir

Chapter 3 Migrating From Mac OS X Server Version 10.1 45 MySQL DataRestore saved MySQL databases in /var/mysql. There are a few commands you can us

46 Chapter 3 Migrating From Mac OS X Server Version 10.1 AFP ConfigurationTo migrate the AFP configuration:1 Restore the afpconfig file.2 Open Serv

Chapter 3 Migrating From Mac OS X Server Version 10.1 47 7 In the Terminal application, run the following command from the directory in which the f

48 Chapter 3 Migrating From Mac OS X Server Version 10.1 Step 9: Migrate Macintosh Manager InformationMove the Preferences folders in Mac OS 9 use

Chapter 3 Migrating From Mac OS X Server Version 10.1 49 Migrating to a New Server From Version 10.1To move data from a Mac OS X Server version 10.

5 Preface What’s in This Guide Use this guide when you want to migrate data to Mac OS X Server version 10.3 from previous versions of the serv

50 Chapter 3 Migrating From Mac OS X Server Version 10.1 To export users and groups:1 Open Server Admin and log in to the server that stores the us

Chapter 3 Migrating From Mac OS X Server Version 10.1 51 Mail DatabaseSave the mail database, if you want to reuse it. Its default location is /Lib

52 Chapter 3 Migrating From Mac OS X Server Version 10.1 IP FirewallSave the IP firewall configuration after running the following command from the

Chapter 3 Migrating From Mac OS X Server Version 10.1 53 Step 5: Set up the home directory infrastructureSet up the destination for home directori

54 Chapter 3 Migrating From Mac OS X Server Version 10.1 5 Click the lock to authenticate as domain administrator.6 Choose Server > Import, sele

Chapter 3 Migrating From Mac OS X Server Version 10.1 55 MySQL DataRestore saved MySQL databases in /var/mysql. There are a few commands you can us

56 Chapter 3 Migrating From Mac OS X Server Version 10.1 AFP ConfigurationTo migrate the AFP configuration:1 Restore the afpconfig file.2 Open Serv

Chapter 3 Migrating From Mac OS X Server Version 10.1 57 IP Firewall ConfigurationTo migrate the IP firewall configuration:1 Restore the firewallco

58 Chapter 3 Migrating From Mac OS X Server Version 10.1 User DataRestore saved user data files. Place home directories in locations that match the

4 594 Migrating From Mac OS X Server Version 1.2Use the instructions in this chapter when you need to migrate data from a version 1.2 server.This

LL2344.Book Page 6 Friday, August 22, 2003 3:44 PM

60 Chapter 4 Migrating From Mac OS X Server Version 1.2 You can’t migrate NetBoot images created prior to Mac OS X Server version 10.2. Re-create y

Chapter 4 Migrating From Mac OS X Server Version 1.2 61 Migrating in Place From Version 1.2To install Mac OS X Server version 10.3 on a computer ru

62 Chapter 4 Migrating From Mac OS X Server Version 1.2 Step 1: Make a full backup of your current serverUse your current backup program to create

Chapter 4 Migrating From Mac OS X Server Version 1.2 63 To prepare data for the migration utility:1 Open the Macintosh Manager 1.x administration a

64 Chapter 4 Migrating From Mac OS X Server Version 1.2 To export user and group information:1 Insert the installation disc.2 Log in using the root

Chapter 4 Migrating From Mac OS X Server Version 1.2 65 Step 6: Set up the home directory infrastructureSet up the destination for home directorie

66 Chapter 4 Migrating From Mac OS X Server Version 1.2 8 To create home directories for imported users, you have several options. Create home dire

Chapter 4 Migrating From Mac OS X Server Version 1.2 67 Step 9: Set up share points and privilegesRe-create the share points and privileges as req

68 Chapter 4 Migrating From Mac OS X Server Version 1.2 5 Restore the contents of the Macintosh Manager share point you backed up earlier from the

Chapter 4 Migrating From Mac OS X Server Version 1.2 69 10 Make sure all the user home directories exist. Use Workgroup Manager or the createhomedi

1 7 1 Before You Begin Take a few moments to become familiar with upgrading and migrating. If you’re using Mac OS X version 10.1 or 10.2, you

70 Chapter 4 Migrating From Mac OS X Server Version 1.2 16 Check the log file after migration is complete. It’s called MM Migration Log.txt. The fi

Chapter 4 Migrating From Mac OS X Server Version 1.2 71 Migrating to a New Server From Version 1.2To move data from a Mac OS X Server version 1.2 c

72 Chapter 4 Migrating From Mac OS X Server Version 1.2 Step 1: Export user and group informationYou use a command-line tool called Mac_OS_X_Serve

Chapter 4 Migrating From Mac OS X Server Version 1.2 73 Step 2: Create archive files Save all the data files that you want to reuse with Mac O

74 Chapter 4 Migrating From Mac OS X Server Version 1.2 Macintosh Manager DataIf you use Macintosh Manager and want to continue using it, make a co

Chapter 4 Migrating From Mac OS X Server Version 1.2 75 Step 5: Set up the home directory infrastructureSet up the destination for home directorie

76 Chapter 4 Migrating From Mac OS X Server Version 1.2 8 To create home directories for imported users, you have several options. Create home dire

Chapter 4 Migrating From Mac OS X Server Version 1.2 77 Step 8: Set up share points and privilegesRe-create the share points and privileges as req

78 Chapter 4 Migrating From Mac OS X Server Version 1.2 5 In the Macintosh Manager share point (/Library/Macintosh Manager/), create a new folder c

Chapter 4 Migrating From Mac OS X Server Version 1.2 79 10 The server and each client computer have script settings that designate the primary lang

8 Chapter 1 Before You Begin Even if your existing server meets the minimum requirements for upgrading, you may want to migrate instead of upgra

80 Chapter 4 Migrating From Mac OS X Server Version 1.2 15 Click Update. The migration utility starts migrating data, displaying a progress bar dur

Chapter 4 Migrating From Mac OS X Server Version 1.2 81 Step 10: Test the new serverTo test the new server:1 Open Workgroup Manager and inspect us

LL2344.Book Page 82 Friday, August 22, 2003 3:44 PM

5 835 Migrating From AppleShare IPUse this chapter when you need to migrate data from an AppleShare IP (ASIP) 6.2 or 6.3 server.This chapter tell

84 Chapter 5 Migrating From AppleShare IP Tools You Can UseSeveral utilities are available for use during migration:• The AppleShare IP Migration u

Chapter 5 Migrating From AppleShare IP 85 Migrating in Place From ASIPTo install Mac OS X Server version 10.3 on a computer running ASIP, follow th

86 Chapter 5 Migrating From AppleShare IP If you have a primary ASIP server and one or more secondary ASIP servers and you want to migrate all of t

Chapter 5 Migrating From AppleShare IP 87 Step 4: Prepare to migrate privilegesOn Mac OS X Server, groups can’t own folders. Before you migrate fr

88 Chapter 5 Migrating From AppleShare IP To prepare the server to store home directories:1 Create the folder you want to serve as the home directo

Chapter 5 Migrating From AppleShare IP 89 When migrating users and groups, the migration utility checks to see if a duplicate user exists in a p

Chapter 1 Before You Begin 9 The AppleShare IP Migration utility preserves existing user and group accounts (and, optionally, other data) withou

90 Chapter 5 Migrating From AppleShare IP To import users and groups using Workgroup Manager:1 Place the export file(s) you created in step 3 in a

Chapter 5 Migrating From AppleShare IP 91 FTP Configuration FilesTo migrate your FTP settings, copy configuration files to the Mac OS X Server dire

92 Chapter 5 Migrating From AppleShare IP Step 10: Migrate Macintosh Manager InformationTo migrate Macintosh Manager data:1 Set up a remote Macint

Chapter 5 Migrating From AppleShare IP 93 6 Open the Terminal application and execute the following command: sudo chown -R mmuser:admin /Library/Ma

94 Chapter 5 Migrating From AppleShare IP 10 Make sure all the user home directories exist. Use Workgroup Manager or the createhomedir tool to crea

Chapter 5 Migrating From AppleShare IP 95 15 Quit the Macintosh Manager administration application after migration is complete so that information

96 Chapter 5 Migrating From AppleShare IP Migrating to a New Server From ASIPTo move data from an ASIP 6.2 or 6.3 computer to a computer with Mac O

Chapter 5 Migrating From AppleShare IP 97 If you have a primary ASIP server and one or more secondary ASIP servers and you want to migrate all of t

98 Chapter 5 Migrating From AppleShare IP Step 4: Mount the ASIP server on Mac OS X ServerTo mount the ASIP server:1 On the ASIP server, disconnec

Chapter 5 Migrating From AppleShare IP 99 Step 6: Copy the Users & Groups Data File and the mail databaseTo copy these items:1 Navigate to the