Apple 034-2344 manual

Mac OS X Ser v er Migration For Version 10.3 or Later 034-2344_Cvr 9/12/03 7:37 AM Page 1[...]

K Apple Computer , Inc. © 2003 Apple C omputer , Inc. All rights reser ved. The owner or authoriz ed user of a valid copy of Mac OS X Ser ver software may reproduc e this publication for the purpose of learning to use such software. No part of this publication may be reproduced or transmitted for commercial purpose s, such as selling copies of thi[...]

3 1 C on ten ts Prefac e 5 What’ s in This Guide 5 What’ s Included in T his Guide 5 Getting Additional Information Chapter 1 7 Before Y ou Begin 7 Upgrading V ersus M igrating 8 Migration Scenarios 8 Migrating in Place 8 Migrating to a New Ser ver 8 Migrating Users and Groups 8 Saving and Reusing User and Group A ccounts 9 System Accoun ts 11 [...]

4 Contents Chapter 5 83 Migrating F rom AppleShare IP 83 Understanding What Y ou Can Migrate 84 T ools Y ou Can Use 85 Migrating in Place From ASIP 96 Migrating to a New Ser ver From ASIP LL2344.Book Page 4 Friday, August 22, 2003 3:44 PM[...]

5 Prefac e What’ s in This Guide Use this guide when you wan t to migrate data t o Mac OS X Ser ver version 1 0.3 from previous v ersions of the ser ver . The guide contains procedures for reusing data you’v e been using on older ser vers when you can’ t or don’ t want to upgrade. What ’ s Included in This Guide This guide is organized in[...]

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

1 7 1 Before Y ou Begin T ake a few moments to become familiar with upgrading and migrating . If you’ re using Mac OS X version 1 0. 1 or 1 0.2, you may not need to migrate. Y ou might be able to upgrade your ser ver , a process that installs and sets up Mac OS X Ser ver version 1 0.3 while automatically pre serving existing data and ser vice set[...]

8 Chapter 1 Before You Begin Even if your existing ser ver meets the minimum requirements for upgrading, you may want to migrate instead of upgrade. F or example, you may be updating some of your computers and decide that you want to reestablish your ser ver environmen t on one or more of the updated computers . The migration scenarios used in this[...]

Chapter 1 Before You Begin 9 The AppleShare IP Migration utility preserves existing user and group accounts (and , optionally , other data) without using expor t files. Each chapter provide s instructions for using these tools as appropriate . Syst em Accoun ts When you install the ser ver , several user and group accounts are created automatically[...]

10 Chapter 1 Before You Begin And here is a list of the predefined group acc ounts: Short name Group ID nobody -2 nogroup -1 wheel 0 daemon 1 kmem 2 sys 3 tty 4 operator 5 mail 6 bin 7 staff 20 smmsp 25 lp 26 postfix 27 postdrop 28 guest 3 1 utmp 45 uucp 66 dialer 68 network 6 9 www 70 mysql 7 4 sshd 7 5 qtss 76 mailman 78 appserverusr 79 admin 80 [...]

Chapter 1 Before You Begin 11 Migrating Data for Managed Mac OS 8 and 9 Users On Mac OS X Ser ver version 1 0.3, Macintosh Manager version 2.2 is used t o manage preference s of users of computers running software earlier than Mac OS X. On earlier ser ver versions , these applications were used to manage such clients: Procedur es for migrating data[...]

12 Chapter 1 Before You Begin After Migration When you’v e finished migrating, consider whether you want to take advantage of any of the newer features to update your ser ver data. F or example: • Y ou can conv er t a shared NetInfo directory to LDAP . See the Open Director y administration guide for details about the advan tages of using LDAP [...]

2 13 2 Migrating F rom Mac OS X Ser v er V ersion 1 0.2 Use the instructions in this chapter when you need to migrate data from a v ersion 1 0.2 ser ver . This chapter is f or Mac OS X Ser ver version 1 0.2 environmen ts that can ’t perform an upgrade installation of version 1 0.3. Such environmen ts might: • Require hard drive r eformatting ?[...]

14 Chapter 2 Migrating From Mac OS X Server Version 10.2 • Macintosh Manager data • User and group accounts If you’ re using any of the f ollowing , make a note of any settings y ou want to con tinue to use, then see the document indicated for instructions on re-creating the settings after using the instructions in this chapter . T ools Y ou [...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 15 Migrating in Place F rom V ersion 1 0.2 T o install Mac OS X Ser ver version 1 0.3 on a computer running version 1 0.2, f ollow the instructions in this section. Macintosh HD user group 20 1 7 Macintosh HD Engineering Read & Write Designs Documents Read Only Read & Write Engineering R[...]

16 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 1: Make a full backup of your current server Use your current backup program to create a backup copy of your version 1 0.2 ser ver . Step 2: Copy current da ta to another hard disk or partition Save all the data files you want to reuse with Mac OS X Ser ver version 1 0.3. Y ou can keep t[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 17 AFP Save the AFP configuration after running the f ollowing command from the T erminal application. This command writes the AFP configuration record stor ed in NetInfo to a file named afpconfig: nidump -r /config/AppleFileServer . > afpconfig NetBoot Images Y ou can migrate NetBoot images [...]

18 Chapter 2 Migrating From Mac OS X Server Version 10.2 Macintosh Manager Data If you use M acintosh Manager and want to continue using it, copy the following folders: • /Librar y/Macintosh Manager/Multi-User Items/ • /Librar y/Macintosh Manager/Managed Pref erences/ QuickTime Str eaming Ser ver F iles and F olders Save file s and folders in /[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 19 Step 5: Install Mac OS X Ser ver version 1 0.3 F ollow the instructions in the getting star ted guide for performing a clean installation of Mac OS X Ser ver version 1 0.3. If you’ve been using Macintosh Manager to manage preferences f or Mac OS 9 clients and want to continue doing so , als[...]

20 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 7: Impor t previously exported users and groups Y ou can use W orkgroup Manager or the dsimpor t tool to impor t users and groups. S ee the command-line administration guide for dsimport instruc tions and a description of the export file format. T o impor t users and groups using W orkgr[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 21 Step 8: Restore sav ed data Copy the files y ou want to reuse fr om their backup location. W eb C onfiguration Da ta T o migrate the web configura tion: 1 Save the file /et c/httpd/ser vermgr_web_httpd_config .plist and the directory /etc/ httpd/sites_disabled/ and all its cont ents from the [...]

22 Chapter 2 Migrating From Mac OS X Server Version 10.2 Mail Database T o migrate the mail database: 1 Make sure that mail ser vice is not running. Open Ser ver Admin, then click Mail. If it is not grayed out, click Stop Ser vice. 2 Place the saved database in the defa ult location: /Librar y/AppleMail Ser ver/. Make sure that no extra files are i[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 23 NetBoot Images Copy the <name>.nbi folder f or each image you wan t to migrate , optionally placing it into the location where it pr eviously resided . W ebObjects Applications and F rameworks Make manual modifications to the new installed version of apache.conf if you want to reuse the[...]

24 Chapter 2 Migrating From Mac OS X Server Version 10.2 DHCP Settings T o migrate the DHCP configuration: 1 Restore the DHCPconfig file . 2 Open Ser ver Admin and make sure that DHCP service isn’ t running. 3 Open NetInfo Manager , located in /Applications/Utilitie s/. 4 Authenticate and go t o /config. 5 Choose Director y > New SubDirector y[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 25 Step 9: Set up share points and privileges Re-create the share poin ts and privileges as required . T o create a share point and set privileges: 1 Open W orkgroup Manager and click Sharing. 2 Click the All tab and selec t the volume or folder you want to share. 3 Click the General tab and sel[...]

26 Chapter 2 Migrating From Mac OS X Server Version 10.2 Migrating to a New Ser ver F rom V ersion 1 0.2 T o move data from a Mac OS X Server version 1 0.2 computer to a computer with Mac OS X Ser ver version 1 0.3 installed, follow the instruc tions in this section. If you ’ve been using Macintosh Manager to manage pref erences for Mac OS 9 clie[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 27 Step 1: Expor t users and groups Use W orkgroup Manager to export user and group accounts from a NetInf o or LDAPv3 director y into a character-delimited file that you can import into a directory for use with Mac OS X Ser ver version 1 0.3. T o expor t users and groups: 1 In W orkgroup Manage[...]

28 Chapter 2 Migrating From Mac OS X Server Version 10.2 W eb C ontent Copy web con tent you wan t to reuse from: • /Librar y/W ebserver/Documents/ • /Librar y/W ebserver/CGI-Executable s • Any other location in which it reside s MySQL Data Mac OS X Ser ver version 1 0.2 preinstalled v ersion 3 .2 3 of MySQL. V ersion 1 0.3 preinstalls a newe[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 29 W ebObjects Applications and F rameworks Save WebObjects applications and frameworks located in: • /Local/Library/WebServer • /Librar y/W ebSer ver Save a copy of w ebobjects.conf for ref erence if you want to modify the new version of apache.conf to reproduce your current settings. F or [...]

30 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 3: Note current share points and privileges If your version 1 0.2 ser ver has share points and privileges you want to re-create on the version 1 0.3 server , make a note of them. Note which share points are f or home directories. Step 4: Copy archiv e files to the new server T ransfer th[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 31 5 If you’ll restor e home directories in locations that won’ t exactly match the locations identified in expor ted user records, you can define a preset that identifies the restore location. If you identify the preset when you impor t users, the new location will replace the existing loca[...]

32 Chapter 2 Migrating From Mac OS X Server Version 10.2 W eb C onfiguration Da ta T o migrate the web configura tion: 1 Save the file /et c/httpd/ser vermgr_web_httpd_config .plist and the directory /etc/ httpd/sites_disabled/ and all its cont ents from the version 1 0.3 ser ver . 2 Replace the /etc/httpd/ directory and its files on the version 1 [...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 33 Mail Database T o migrate the mail database: 1 Make sure that mail ser vice is not running. Open Ser ver Admin, then click Mail. If it is not grayed out, click Stop Ser vice. 2 Place the saved database in the defa ult location: /Librar y/AppleMail Ser ver/. Make sure that no extra files are i[...]

34 Chapter 2 Migrating From Mac OS X Server Version 10.2 NetBoot Images Copy the <name>.nbi folder f or each image you wan t to migrate , optionally placing it into the location where it pr eviously resided . W ebObjects Applications and F rameworks Make manual modifications to the new installed version of apache.conf if you want to reuse the[...]

Chapter 2 Migrating From Mac OS X Server Version 10.2 35 DHCP Settings T o migrate the DHCP configuration: 1 Restore the DHCPconfig file . 2 Open Ser ver Admin and make sure that DHCP service isn’ t running. 3 Open NetInfo Manager , located in /Applications/Utilitie s/. 4 Authenticate and go t o /config. 5 Choose Director y > New SubDirector y[...]

36 Chapter 2 Migrating From Mac OS X Server Version 10.2 Step 8: Set up share points and privileges Re-create the share poin ts and privileges as required . T o create a share point and set privileges: 1 Open W orkgroup Manager and click Sharing. 2 Click the All tab and selec t the volume or folder you want to share. 3 Click the General tab and sel[...]

3 37 3 Migrating F rom Mac OS X Ser v er V ersion 1 0. 1 Use the instructions in this chapter when you need to migrate data from a v ersion1 0. 1 ser ver . This chapter is f or Mac OS X Ser ver version 1 0. 1 environments that can ’t per form an upgrade installation of version 1 0.3 because they might: • Require hard drive r eformatting in orde[...]

38 Chapter 3 Migrating From Mac OS X Server Version 10.1 If you’ re using any of the f ollowing , make a note of any settings y ou want to con tinue to use, then see the document indicated for instructions on re-creating the settings after using the instructions in this chapter . Y ou can ’t migrate NetBoot image s created prior to Mac OS X Ser[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 39 Migrating in Place Fr om V ersion 1 0. 1 T o install Mac OS X Ser ver version 1 0.3 on a computer running version 1 0. 1, follow the instructions in this section. Make sure that the computer meets the minimum requirements f or version 1 0.3, de scribed on page 7. Step 1: Make a full backup of[...]

40 Chapter 3 Migrating From Mac OS X Server Version 10.1 Step 2: Copy current da ta to another hard disk or partition Save all the data files that you wan t to reuse with Mac OS X S er ver version 1 0.3. Y ou can keep them on the same computer , but make sure you place them on a disk or par tition that won ’t be overwritten when you do the clean [...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 41 AFP Save the AFP configuration after running the f ollowing command from the T erminal application. This command writes the AFP configuration record stor ed in NetInfo to a file named afpconfig: nidump -r /config/AppleFileServer . > afpconfig W ebObjects Applications and F rameworks Save W[...]

42 Chapter 3 Migrating From Mac OS X Server Version 10.1 QuickTime Str eaming Ser ver F iles and F olders Save file s and folders in /Library/QuickTimeStr eaming/. F or more information about migrating Q TSS, see the Quick Time Streaming Ser ver administration guide. Step 3: Note current share points and privileges If your version 1 0. 1 ser ver ha[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 43 T o prepare the ser ver to store home dir ectories: 1 Create the folder you want to ser ve as the home director y share point, if required. Y ou can use the predefined /Users folder , if you like. 2 Open W orkgroup Manager on the ser ver where you want the home directories to reside. 3 Click [...]

44 Chapter 3 Migrating From Mac OS X Server Version 10.1 8 T o create home direc tories for imported users, you have several options. Create home directories one at a time b y selecting a user account in W orkgroup Manager , clicking Adv anced , then clicking Create Home Now . Create all the home directories b y using the -a argument of the creat e[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 45 MySQL Data Restore sa ved MySQL databases in /var/m ysql. There are a few commands you can use on an old database to remove dependency on the ISAM table format, which has been deprecated: • Run mysql_fix_privilege_tables to enable new security privilege features. • Run either mysql_conver[...]

46 Chapter 3 Migrating From Mac OS X Server Version 10.1 AFP Configur ation T o migrate the AFP configuration: 1 Restore the afpconfig file . 2 Open Ser ver Admin and make sure that AFP isn ’t running. 3 Open NetInfo Manager , located in /Applications/Utilitie s. 4 Authenticate and go t o /config. 5 Choose Director y > New SubDirector y to cre[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 47 7 In the T erminal application, run the f ollowing command from the dir ector y in which the firewallconfig file resides: sudo niload -r /config/IPFilters . < firewallconfig 8 T ype the 50_ipfwconfigmigrat or command: sudo /System/Library/ServerSetup/MigrationExtras/ 50_ipfwconfigmigrator [...]

48 Chapter 3 Migrating From Mac OS X Server Version 10.1 Step 9: M igrate Macin tosh Manager Information Move the P ref erences f olders in Mac OS 9 user home directories from ~/Library/ Pref erences t o ~/Librar y/Classic/Pref erences if y ou want to pre serve existing preference s. I f you don’ t move the Pref erences folder , users can log in,[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 49 Migrating to a New Ser ver F rom V ersion 1 0. 1 T o move data from a Mac OS X Server version 1 0. 1 computer to a computer with Mac OS X Ser ver version 1 0.3 installed, follow the instruc tions in this section. If you ’ve been using Macintosh Manager to manage pref erences for Mac OS 9 cl[...]

50 Chapter 3 Migrating From Mac OS X Server Version 10.1 T o expor t users and groups: 1 Open Ser ver Admin and log in to the server that stores the user and gr oup accounts you want to migrate. 2 Click Users & Groups and choose Show Users & Groups . 3 Select the users and groups you want to expor t, then click Expor t. When you expor t use[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 51 Mail Database Save the mail database, if you want to reuse it. I ts default location is /Librar y/ AppleMailSer ver/. W ebmail Data Mac OS X Ser ver version 1 0.3 installs a version of SquirrelMail configured to use the mail server running on the local computer . A ddress books and preference[...]

52 Chapter 3 Migrating From Mac OS X Server Version 10.1 IP Fir ewall Save the IP fir ewall configuration after running the following command from the T erminal application. This command writ es the IP firewall configuration record st ored in NetInfo to a file named firewallconfig: nidump -r /config/IPFilters . > firewallconfig DNS Save the file[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 53 Step 5: Set up the home direc tor y infrastructure Set up the destination for home directories you want to restore. The home directory location identified in impor ted user accounts must match the physical location of the restor ed home directories, including the share point location. F or de[...]

54 Chapter 3 Migrating From Mac OS X Server Version 10.1 5 Click the lock to authenticat e as domain administrator . 6 Choose Ser ver > Import, select the import file, and specify impor t options. If you’ re impor ting user accounts and using a preset, make sure you identify the preset. 7 Click Import. 8 T o create home direc tories for import[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 55 MySQL Data Restore sa ved MySQL databases in /var/m ysql. There are a few commands you can use on an old database to remove dependency on the ISAM table format, which has been deprecated: • Run mysql_fix_privilege_tables to enable new security privilege features. • Run either mysql_conver[...]

56 Chapter 3 Migrating From Mac OS X Server Version 10.1 AFP Configur ation T o migrate the AFP configuration: 1 Restore the afpconfig file . 2 Open Ser ver Admin and make sure that AFP isn ’t running. 3 Open NetInfo Manager , located in /Applications/Utilitie s. 4 Authenticate and go t o /config. 5 Choose Director y > New SubDirector y to cre[...]

Chapter 3 Migrating From Mac OS X Server Version 10.1 57 IP Fir ewall Configur ation T o migrate the IP firewall configuration: 1 Restore the firewallconfig file . 2 Open Ser ver Admin and make sure that firewall service isn’ t running . 3 Open NetInfo Manager , located in /Applications/Utilitie s. 4 Authenticate and go t o /config. 5 Choose Dire[...]

58 Chapter 3 Migrating From Mac OS X Server Version 10.1 User Data Restore sa ved user data files . Place home directories in locations that match the locations in the imported user records. If necessar y , you can use Workgroup Manager to edit user accounts so the locations in the account and on disk are the same. QuickTime Str eaming Ser ver F il[...]

4 59 4 Migrating F rom Mac OS X Ser v er V ersion 1 .2 Use the instructions in this chapter when you need to migrate data from a v ersion 1 .2 ser ver . This chapter tells you what you can migrate, and then explains how to migrate by reusing your existing ser ver hardware or by moving to a different computer . Understanding What Y ou Can M igrate ?[...]

60 Chapter 4 Migrating From Mac OS X Server Version 1.2 Y ou can ’t migrate NetBoot image s created prior to Mac OS X Server version 1 0.2. Re- create y our old image s using the default startup images pro vided with Mac OS X Server version 1 0.3. T ools Y ou Can Use Several utilities are a vailable for use during migration: • Y ou use a comman[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 61 Migrating in Place Fr om V ersion 1 .2 T o install Mac OS X Ser ver version 1 0.3 on a computer running version 1 .2, f ollow the instructions in this section. Make sure that the computer meets the minimum requirements f or version 1 0.3; see page 7. 2 Copy current data to another hard disk or[...]

62 Chapter 4 Migrating From Mac OS X Server Version 1.2 Step 1: Make a full backup of your current server Use your current backup program to create a backup copy of your version 1 .2 ser ver . Step 2: Copy current da ta to another hard disk or partition Save all the data files that you wan t to reuse with Mac OS X S er ver version 1 0.3. Y ou can k[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 63 T o prepare data for the migration utility: 1 Open the Macintosh Manager 1 .x administration application and log in to the version 1 .2 ser ver using an administrator account. 2 After connecting, verify the users and workgroups using the option in the F ile menu. After the consistency check is[...]

64 Chapter 4 Migrating From Mac OS X Server Version 1.2 T o expor t user and group information: 1 Inser t the installation disc. 2 Log in using the root accoun t. 3 Open the T erminal application. 4 Navigate to the Migration T ools folder by entering cd "/<disc-name>/Welcome to Mac OS X Server/Migration Tools/" 5 Run the tool and sa[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 65 Step 6: Set up the home direc tor y infrastructure Set up the destination for home directories you want to restore. F or detailed instructions on how to per form individual steps in the f ollowing procedure , see the user management guide. T o prepare the ser ver to store home dir ectories: 1 [...]

66 Chapter 4 Migrating From Mac OS X Server Version 1.2 8 T o create home direc tories for imported users, you have several options. Create home directories one at a time b y selecting a user account in W orkgroup Manager , clicking Adv anced , then clicking Create Home Now . Create all the home directories b y using the -a argument of the creat eh[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 67 Step 9: Set up share points and privileges Re-create the share poin ts and privileges as required . T o create a share point and set privileges: 1 Open W orkgroup Manager and click Sharing. 2 Click the All tab and selec t the volume or folder you want to share. 3 Click the General tab and sele[...]

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 ASIP ser ver . Place the Users folder just under the Macintosh Manager share poin t: /Librar y/Macintosh Manager/Users/ Place any of the follo wing folders in the f ollowing table into: /Librar y/Macinto[...]

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 createhomedir tool to cr eate them. 11 On the remote Macintosh Manager 2.2 administrator comput er , open the Macintosh Manager 2.2 administration application. Once the correct server is found by Macintosh Manager ,[...]

70 Chapter 4 Migrating From Mac OS X Server Version 1.2 16 Check the log file after migration is complete. I t ’ s called MM Migration Log.txt. T he file resides at the root of the startup volume on the Mac OS 9 computer . Use the log file to determine whether you need to: • Set a password for a user • Create a home directory for a user • C[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 71 Migrating to a New Ser ver F rom V ersion 1 .2 T o move data from a Mac OS X Server version 1 .2 computer to a computer with Mac OS X Ser ver version 1 0.3 installed, follow the instruc tions in this section. If you ’ve been using Macintosh Manager to manage Mac OS 9 users and wan t to conti[...]

72 Chapter 4 Migrating From Mac OS X Server Version 1.2 Step 1: Expor t user and group information Y ou use a command-line tool called Mac_OS_X_Ser ver_1 .2_Expor t_T ool to expor t user and group information. The tool is located on the v ersion 1 0.3 ser ver installation disc in /W elcome to Mac OS X Ser ver/Migration T ools/ When you run the tool[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 73 Step 2: Create archive files Save all the data file s that you want to r euse with Mac OS X Ser ver version 1 0.3. In step 4 you ’ll move the file s described below , as well as the export file created in step 1, to the version 1 0.3 computer . F or large amounts of data, you may want to cr [...]

74 Chapter 4 Migrating From Mac OS X Server Version 1.2 Macintosh Manager Data If you use M acintosh Manager and want to continue using it, make a copy of the following folders , which reside in the share poin t named Macintosh Manager on an HFS Plus volume: T o help you migrate data for individual managed users, Macintosh Manager version 2.2 has a[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 75 Step 5: Set up the home direc tor y infrastructure Set up the destination for home directories you want to restore. F or detailed instructions on how to per form individual steps in the f ollowing procedure , see the user management guide. T o prepare the ser ver to store home dir ectories: 1 [...]

76 Chapter 4 Migrating From Mac OS X Server Version 1.2 8 T o create home direc tories for imported users, you have several options. Create home directories one at a time b y selecting a user account in W orkgroup Manager , clicking Adv anced , then clicking Create Home Now . Create all the home directories b y using the -a argument of the creat eh[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 77 Step 8: Set up share points and privileges Re-create the share poin ts and privileges as required . T o create a share point and set privileges: 1 Open W orkgroup Manager and click Sharing. 2 Click the All tab and selec t the volume or folder you want to share. 3 Click the General tab and sele[...]

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 called Old MM Items: /Librar y/Macintosh Manager/Old MM Items 6 Place the folders you backed up earlier from the version 1 .2 Macintosh Manager share point into the new Macint osh Manager share point. Pla[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 79 10 The server and each client computer have script settings that de signate the primary language for each computer . Make sure that these three language script settings match: • The defa ult script f or logging in and using the Macintosh Manager 2.2 administration program. For Mac OS X Ser v[...]

80 Chapter 4 Migrating From Mac OS X Server Version 1.2 15 Click Update. The migration utility star ts migrating data, displa ying a progress bar during the process. If two user documents with identical file names ar e found on separate v olumes , both documents are copied to the home dir ector y and the name of one of the documents is modified. If[...]

Chapter 4 Migrating From Mac OS X Server Version 1.2 81 Step 1 0: T est the new server T o test the new ser ver: 1 Open W orkgroup Manager and inspec t user and group accounts. 2 Open Ser ver Admin and inspect settings for ser vices whose configuration data you migrated. 3 Check Macintosh Manager and W orkgroup Manager settings for managed Mac OS 9[...]

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

5 83 5 Migrating F rom AppleShare IP Use this chapter when y ou need to migrate data fr om an AppleShare IP (ASIP) 6.2 or 6.3 ser ver . This chapter tells you what you can migrate, and then explains how to migrate by reusing your existing ser ver hardware or by moving to a different computer . Understanding What Y ou Can M igrate “Migrating in Pl[...]

84 Chapter 5 Migrating From AppleShare IP T ools Y ou Can Use Several utilities are a vailable for use during migration: • The AppleShare IP Migration utility can migrate users and groups, share points and privileges (when migrating in place only), and the mail database. Y ou can use this tool to migrate all these it ems or only users and groups.[...]

Chapter 5 Migrating From AppleShare IP 85 Migrating in Place Fr om ASIP T o install Mac OS X Ser ver version 1 0.3 on a computer running ASIP , follo w the instructions in this section. Make sure that the computer meets the minimum requirements f or version 1 0.3, de scribed on page 7. 2 Create Internet aliases for users. (tsmith,smitty) Users 1 Ma[...]

86 Chapter 5 Migrating From AppleShare IP If you have a primary ASIP ser ver and one or more secondary ASIP ser vers and you want to migrate all of them t o version 1 0.3, synchroniz e all secondary ser vers with the primar y ser ver before starting migration. Migrate the primary ser ver , then migrat e the secondar y ser vers. When migrating secon[...]

Chapter 5 Migrating From AppleShare IP 87 Step 4: Prepare to migr ate privileges On Mac OS X Ser ver , groups can ’t o wn folders. Before you migrate from ASIP , you can use Mac OS Ser ver Admin (in ASIP 6.3), or W eb & File A dmin (in ASIP 6.2), to assign a new owner to any folders that ar e owned by a group . If you use the AppleShar e IP M[...]

88 Chapter 5 Migrating From AppleShare IP T o prepare the ser ver to store home dir ectories: 1 Create the folder you want to ser ve as the home director y share point, if required. Y ou can use the predefined /Users folder , if you like. 2 Open W orkgroup Manager on the ser ver where you want the home directories to reside. 3 Click Sharing to set [...]

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 parent domain on a diff erent computer . T o determine what happens when a duplicate user name occurs, choose an option: • Don’ t migr ate the AppleShare user: T he ASIP data is reassigned to the adminis[...]

90 Chapter 5 Migrating From AppleShare IP T o impor t users and groups using W orkgroup Manager: 1 Place the expor t file(s) you created in step 3 in a location accessible from your ser ver . 2 If you want impor ted users to have passwords validat ed using Open Direc tory authentication, you can set that up in the preset you defined in step 6. Enab[...]

Chapter 5 Migrating From AppleShare IP 91 FTP Configur ation F iles T o migrate your FTP settings, copy configuration file s to the Mac OS X Server directory indicated: User Data Place home directories in locations that match the locations in the imported user records. If necessar y , you can use Workgroup Manager to edit user accounts so the locat[...]

92 Chapter 5 Migrating From AppleShare IP Step 1 0: Migrat e Macintosh Manager Informa tion T o migrate Macintosh Manager da ta: 1 Set up a remote Macintosh Manager administrator computer b y installing Macintosh Manager administrator and client software from the Administration T ools disc onto a Mac OS 9 .2 computer . The computer should have acce[...]

Chapter 5 Migrating From AppleShare IP 93 6 Open the T erminal application and execute the following command: sudo chown -R mmuser:admin /Library/Macintosh Manager /Old MM Items/ Y ou can also use quotation marks to handle the spaces in the f older names: sudo chown -R mmuser:admin "/Library/Macintosh Manager/Old MM Items/" 7 In Ser ve[...]

94 Chapter 5 Migrating From AppleShare IP 10 Make sure all the user home directories exist. Use Workgroup Manager or the createhomedir tool to cr eate them. 11 On the remote Macintosh Manager 2.2 administrator comput er , open the Macintosh Manager 2.2 administration application. Once the correct server is found by Macintosh Manager , log in as an [...]

Chapter 5 Migrating From AppleShare IP 95 15 Quit the Macintosh Manager administration application after migration is complete so that information is written to the Macin tosh Manager database. 16 Check the log file after migration is complete. I t ’ s called MM Migration Log.txt. T he file resides at the root of the startup volume on the Mac OS [...]

96 Chapter 5 Migrating From AppleShare IP Migrating to a New Ser ver F rom ASIP T o move data from an ASIP 6.2 or 6.3 computer t o a computer with Mac OS X Ser ver version 1 0.3 installed, follow the instructions in this sec tion. If you’v e been using Macintosh Manager or At Ease for Workgr oups to manage Mac OS 9 users and want to continue doin[...]

Chapter 5 Migrating From AppleShare IP 97 If you have a primary ASIP ser ver and one or more secondary ASIP ser vers and you want to migrate all of them t o version 1 0.3, synchroniz e all secondary ser vers with the primar y ser ver before starting migration. Migrate the primary ser ver , then migrat e the secondar y ser vers. When migrating secon[...]

98 Chapter 5 Migrating From AppleShare IP Step 4: Mount the ASIP ser ver on Mac OS X Server T o mount the ASIP ser ver: 1 On the ASIP ser ver , disconnect all users and administrators and shut down the mail ser ver . 2 On Mac OS X Ser ver , log in as an administrator and turn off all services using Ser ver Admin. 3 Choose Go > Connect to Server [...]

Chapter 5 Migrating From AppleShare IP 99 Step 6: Copy the Users & Gr oups Data F ile and the mail database T o copy these items: 1 Navigate to the Users & Gr oups Data File on the r emote ASIP server . Its default location is the Pref erences f older in the System F older . 2 Make a copy of the Users & Groups Data File . 3 Fr om the ve[...]

100 Chapter 5 Migrating From AppleShare IP 6 If you’ re migrating the mail database, locate the file AppleShare IP M ail 6.0 Data and click Choose. 7 During migration, the utility displays a progre ss bar and status information. When migration is complete, click Quit. 8 Examine the log files, which are located in /Library/Logs/Migration/: • Use[...]

Chapter 5 Migrating From AppleShare IP 101 Y ou can also use the dsimpor t tool to import users and groups. S ee the command-line administration guide for dsimport instruc tions. T o create home directories for imported users: Y ou have sev eral options: • Create home directories one at a time b y selecting a user account in W orkgroup Manager , [...]

102 Chapter 5 Migrating From AppleShare IP Step 9: Set up share points and privileges Re-create the share poin ts and privileges as required . Remember that a group can ’t own a folder in Mac OS X Server . T o create a share point and set privileges: 1 Open W orkgroup Manager and click Sharing. 2 Click the All tab and selec t the volume or folder[...]

Chapter 5 Migrating From AppleShare IP 103 4 Open Ser ver Admin on the version 1 0.3 ser ver and make sure that Macintosh Manager and AFP ser vices are not running . T his step is very impor tant to the success of user document migration. 5 In the Macintosh Manager share point (/Library/Macintosh Manager/), create a new folder called Old MM Items: [...]

104 Chapter 5 Migrating From AppleShare IP 10 The server and each client computer have script settings that de signate the primary language for each computer . Make sure that these three language script settings match: • The defa ult script f or logging in and using the Macintosh Manager 2.2 administration program. For Mac OS X Ser ver , use the [...]

Chapter 5 Migrating From AppleShare IP 105 When the migration utility finds a managed client user already exists in a Mac OS X Ser ver directory , the ac tion it takes depends on the user login setting and whether the user has a home directory : 16 Quit the Macintosh Manager administration application after migration is complete so that information[...]