Apple Mac OS X manual

Mac OS X Ser v er Upgrading and Migrating For Version 10.4 or Later Second Edition[...]

K Apple Computer , Inc. © 2006 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 About This Guide 5 What’ s in T his Guide 6 Using This Guide 6 Using Onscreen Help 7 The Mac OS X Ser ver Suite 8 Getting Documentation Updates 8 Getting Additional Information Chapter 1 9 Before Y ou Begin 9 Ser vers F rom Which Y ou Can Upgrade or Migrate 9 Upgrading to V ersion 1 0.4 10 Migrating From a P re-V ersion[...]

4 Contents 47 Understanding What Y ou Can Migrate 48 T ools Y ou Can Use 49 Step-by-Step Instructions Chapter 6 6 1 Migrating F rom Mac OS X Server V ersion 1 0. 1 61 Before Y ou Begin 61 Understanding What Y ou Can Migrate 62 T ools Y ou Can Use 63 Step-by-Step Instructions Chapter 7 7 5 Migrating F rom Mac OS X Server V ersion 1 .2 75 Before Y ou[...]

5 Prefac e About This Guide Use this guide when you wan t to mo ve to Mac OS X Server version 1 0. 4 from a pr evious version of the server . This guide contains instructions for r eusing data and settings of previous server versions. There ar e two approaches: Â P erform an upgrade installation. This approach leaves all y our data and settings in[...]

6 Preface About This Guide Using This Guide Using this guide is easy . Simply read chapter 1 to make sure y ou understand all your options. T hen turn to the chapter that addre sses your upgrade or migration scenario . Y ou’ll find st ep-by-step instructions for preserving and reusing server data by using various tools and manual technique s. Y o[...]

Preface About This Guide 7 The Mac OS X Ser ver Suite The Mac OS X Ser ver documentation includes a suite of guide s that explain the ser vices and provide instructions for configuring , managing, and troubleshooting the ser vices. All of the guides are av ailable in PDF format fr om: www .apple.c om/ser ver/documentation/ This guide ... tells you [...]

8 Preface About This Guide Getting Documentation Updates P eriodically , Apple posts new onscreen help t opics, revised guides, and solution papers. The new help topics include updates t o the latest guides . Â T o view new onscreen help topics, make sure your ser ver or administrator comput er is connected to the Internet and click the Lat e-Brea[...]

1 9 1 Befor e Y ou Begin T ake a few moments to bec ome familiar with upgrading and migrating options and requir ements . If you’ re using Mac OS X Ser ver version 1 0.2 or 1 0.3, y ou may not need to migrate ser ver data to a diff erent computer . Y ou might be able to upgrade your server , a pr ocess that installs and sets up Mac OS X Ser ver v[...]

10 Chapter 1 Before You Begin When you upgrade a server , y ou per form an upgrade installation from the server installation disc on your server computer . Data and settings are automatically preserved for you , and manual adjustments ar e minimal. If you ’ve been using Macintosh Manager to manage Mac OS 9 client computers , you can continue to d[...]

Chapter 1 Before You Begin 11 Migrating F rom Windows NT Mac OS X Ser ver can provide a v ariety of ser vices to users of Microsoft Windo ws 95 , 98, ME (Millennium Edition), XP , NT 4, and 2 000 computers. By providing these services, Mac OS X Ser ver can replace Windows NT ser vers in small workgroups. The Windows NT migration guide explains how [...]

12 Chapter 1 Before You Begin Y ou can ’t change the names or IDs of syst em accounts. So when you migrate users and groups, don ’t try to do so. However , you can add users during migration t o two system groups—admin and wheel: Â Wheel is a group that gives members almost as much c ontrol as root. If you’ re a member of the wheel group ,[...]

Chapter 1 Before You Begin 13 Here is a list of the predefined group accoun ts: 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 lp 26 postfix 27 postdrop 28 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 appserveradm 8 1 clamav[...]

14 Chapter 1 Before You Begin[...]

2 15 2 Upgrading Mac OS X Ser ver V ersion 1 0.3 Use the instructions in this chapter to upgrade a v ersion 1 0.3. 9 server to version 1 0. 4. Y ou can upgrade computers with Mac OS X Ser ver version 1 0.3. 9 that don’t r equire hard disk reformatting and that ha ve: Â A P owerPC G4 or G5 processor . Â Built-in Fir eWire. Â At least 5 1 2 mega[...]

16 Chapter 2 Upgrading Mac OS X Server Version 10.3 Upgrading an Open Director y Master and Its Replicas When the ser ver you wan t to upgrade is an Open Directory master or replica, upgrade the master then upgrade the replicas. T o upgrade the master and its replicas: 1 Upgrade the master to version 1 0. 4 following the instructions later in this [...]

Chapter 2 Upgrading Mac OS X Server Version 10.3 17 Step 1: Update your server to v ersion 1 0.3.9 Use Software Update, if necessary , to update your ser ver to version 1 0.3 .9 . Step 2: Perform an upgrade installation to v ersion 1 0.4 Y ou can use the version 1 0.4 installation disc to perform the upgrade installation locally on your server comp[...]

18 Chapter 2 Upgrading Mac OS X Server Version 10.3 7 After all setup data has been entered , Server Assistant displa ys a summar y of the data. Review the setup data, optionally clicking Go Back to change it. 8 T o initiate setup of the ser ver , click Apply . When ser ver setup is complete , click Restar t Now . T o upgrade to v ersion 1 0.4 and [...]

Chapter 2 Upgrading Mac OS X Server Version 10.3 19 8 During installation, progre ss information is displa yed . If you’ re using installation CDs (not av ailable for version 1 0. 4.7 or later), insert the next installation disc when prompted . 9 After installation is complete , the computer restar ts automatically , and then Server Assistant ope[...]

20 Chapter 2 Upgrading Mac OS X Server Version 10.3 Step 3: Make Adjustments as needed after initial server setup Now you can use Workgroup Manager , Server Admin, T erminal, and other applications to refine your server ’ s settings and take advantage of new version 1 0. 4 feature s. See the administration guide for individual services for an exp[...]

Chapter 2 Upgrading Mac OS X Server Version 10.3 21 Groups If you want groups to use new v ersion 1 0.4 featur es such as nesting and stricter membership checking, upgrade group records using W orkgroup Manager . T o upgrade a group rec ord: 1 Open W orkgroup M anager . 2 Open the director y that contains the groups of in terest. 3 Select one or mo[...]

22 Chapter 2 Upgrading Mac OS X Server Version 10.3 Prin t Ser vice The upgrade process mat ches the old configuration with existing print queue s and applies the settings to the new configuration, which is stored in /Librar y/Pr eference s/com.apple.printservice.plist. The upgrade results ar e logged in /Librar y/Logs/P rintService/PrintService.ad[...]

3 23 3 Upgrading Mac OS X Ser ver V ersion 1 0.2 Use the instructions in this chapter to upgrade a v ersion 1 0.2.8 ser ver to version 1 0. 4. Y ou can upgrade computers with Mac OS X Ser ver version 1 0.2.8 that don ’t r equire hard disk reformatting and that ha ve: Â A P owerPC G4 or G5 processor . Â Built-in Fir eWire. Â At least 5 1 2 mega[...]

24 Chapter 3 Upgrading Mac OS X Server Version 10.2 Step-by-St ep Instructions T o upgrade a version 1 0.2.8 ser ver to version 1 0.4, follow the instructions in this section. Step 1: Update your server to v ersion 1 0.2.8 Use Software Update if necessary to update your server to version 1 0.2.8. Step 2: Perform an upgrade installation to v ersion [...]

Chapter 3 Upgrading Mac OS X Server Version 10.2 25 5 During installation, progre ss information is displa yed . If you’ re using installation CDs (not av ailable for version 1 0. 4.7 or later), insert the next installation disc when prompted . 6 After installation is complete , the computer restar ts automatically and Server Assistant opens so y[...]

26 Chapter 3 Upgrading Mac OS X Server Version 10.2 If the target server lacks a built-in optical drive that can read your installation disc, you can start it in target disk mode and inser t the installation disc into the optical drive on your administrator comput er . Y ou can also use an external FireWir e optical drive. If the target server is a[...]

Chapter 3 Upgrading Mac OS X Server Version 10.2 27 11 Move through the A ssistant’ s panes, following the onscreen instructions. Y our existing settings are displa yed in the panes , but you can change them if y ou like. Unless you ha ve a site license , you’ll need to en ter a unique server software serial number for each server you upgrade. [...]

28 Chapter 3 Upgrading Mac OS X Server Version 10.2 T o update a WebObjects project: 1 Open the project in Xcode. 2 In the Expert View for the main target’ s settings, change the proper ty value for “ JA V A_VM” to “jav a ” . Note: JavaMonit or and wotaskd ( WebObjects T ask Daemon) services are now managed by launchd and can be acce ssed[...]

Chapter 3 Upgrading Mac OS X Server Version 10.2 29 Prin t Ser vice The upgrade process mat ches the old configuration with existing print queue s and applies the settings to the new configuration, which is stored in /Librar y/Pr eferences/ com.apple.printservice.plist. The upgrade results ar e logged in /Librar y/Logs/P rintService/PrintService.ad[...]

30 Chapter 3 Upgrading Mac OS X Server Version 10.2[...]

4 31 4 Migrating F rom Mac OS X Ser v er V ersion 1 0.3 Use the instructions in this chapter when you need to migrate da ta from a v ersion 1 0.3. 9 ser ver to a diff eren t computer running v ersion 1 0. 4. Y ou can migrate data from Mac OS X Ser ver version 1 0.3. 9 computers that can’ t be upgraded to version 1 0.4.7 or lat er . Such c omputer[...]

32 Chapter 4 Migrating From Mac OS X Server Version 10.3 T o reestablish the master and its r eplicas: 1 Set up the version 1 0.4 master f ollowing the instructions later in this chapter . While you ’ re setting up the master , clien t computers won ’t be able to connect to the version 1 0.3. 9 master f or Open Director y ser vices. Clients may[...]

Chapter 4 Migrating From Mac OS X Server Version 10.3 33  User data, including home direc tories  Quick Time Streaming Server files and directories  User and group accounts If you’ re using any of the f ollowing , make a note of any settings y ou want to continue to use, then see the document indicated for instructions on re-creating the se[...]

34 Chapter 4 Migrating From Mac OS X Server Version 10.3 Step-by-St ep Instructions T o move data from a Mac OS X Server version 1 0.3.9 c omputer to a computer with Mac OS X Ser ver version 1 0.4 installed , follow the instructions in this section. 1 Export user and group info . 2 Create archive files of data and user export file. 4 Copy archive f[...]

Chapter 4 Migrating From Mac OS X Server Version 10.3 35 Step 1: Expor t users and groups Use W orkgroup Manager to expor t user and group accounts from a NetInfo 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.4. T o export users and groups: 1 In W orkgroup Manager[...]

36 Chapter 4 Migrating From Mac OS X Server Version 10.3 W eb C onfiguration Data Save the f ollowing files and directory :  /etc/httpd/httpd.c onf  /etc/httpd/httpd_macosxserver .conf  /etc/httpd/httpd_squirrelmail.conf  /etc/httpd/magic  /etc/httpd/mime.types  /etc/httpd/mime_macosxserver .t ypes  /etc/httpd/ssl.crt  /etc/httpd/ss[...]

Chapter 4 Migrating From Mac OS X Server Version 10.3 37 Also , sav e a copy of the file /usr/bin/cyrus/bin/ctl_mboxlist so you can move it to the version 1 0.4 server in Step 4 on page 39. Y ou will need this file to migrate the mail database successfully in Step 7 on page 4 1. W ebmail Data If you ’ve been using the SquirrelMail installed when [...]

38 Chapter 4 Migrating From Mac OS X Server Version 10.3 IP Fir ewall Save the se files:  /etc/ipfilter/ip_address_gr oups.plist  /etc/ipfilter/standard_services.plist  /etc/ipfilter/ipfw .conf NA T Save the c ontents of /et c/nat/natd.plist. VPN Copy :  /Librar y/Pr eferences/S ystemConfiguration/c om.apple.RemoteA ccessServers.plist  /L[...]

Chapter 4 Migrating From Mac OS X Server Version 10.3 39 Step 4: Copy archiv e files to the new server T ransfer the files you sav ed in Steps 1 and 2 to the version 1 0. 4 ser ver . T o transfer tar files or disk image s using FTP: 1 Use Ser ver Admin on the new server to start FTP ser vice. 2 Set up sharing for a folder in to which you ’ll plac[...]

40 Chapter 4 Migrating From Mac OS X Server Version 10.3 Step 6: Impor t users and groups and other data Y ou can use W orkgroup Manager or the dsimport tool to import users and groups and other data: Â See the user management guide for details about importing by using W orkgroup Manager . Â See the Open Director y administration guide for inform[...]

Chapter 4 Migrating From Mac OS X Server Version 10.3 41 10 If you want to enable Kerberos f or an Open Directory master on which it ’ s not enabled, you can use the follo wing command , which maintains existing passw ords and adds them to a new KDC. slapconfig -kerberize If you have user acc ounts with crypt passwords and you don ’t Kerberiz e[...]

42 Chapter 4 Migrating From Mac OS X Server Version 10.3 W eb C onten t Copy sav ed web cont ent to: Â /Librar y/W ebSer ver/Documents/ Â /Librar y/W ebSer ver/C GI-Executables/ MySQL Data If you backed up your MySQL data using mysqldump , you can restore the data using: mysql -p table < backup-file.sql or mysql database < backup-file.sql I[...]

Chapter 4 Migrating From Mac OS X Server Version 10.3 43 4 In Ser ver Admin, click Settings, click Adv anced , and click Database to indicat e where you rest ored the database and mail store . 5 Click Save . 6 Open the T erminal application and use the su command to assume the identity of the root user . 7 Run the mail database upgradedb script: su[...]

44 Chapter 4 Migrating From Mac OS X Server Version 10.3 Note: JavaMonit or and wotaskd ( WebObjects T ask Daemon) services are now managed by launchd and can be acce ssed through the Ser ver Admin application. If the ser ver you ’ re migrating from has the startup item /System/Library/Star tupI tems/W ebObjects, you don ’t need t o copy it to [...]

Chapter 4 Migrating From Mac OS X Server Version 10.3 45 Note: In version 1 0.4, the default setting of unregistered_only in /etc/nat/ natd.plist.defa ult changed from false to true . VPN Restore:  /Librar y/Pr eferences/S ystemConfiguration/c om.apple.RemoteA ccessServers.plist.  /Librar y/Keychains/System.keychain  /etc/racoon/psk.text (if [...]

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

5 47 5 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 da ta from a v ersion 1 0.2.8 ser v er to a diff erent computer running v ersion 1 0. 4. Y ou can migrate data from Mac OS X Ser ver version 1 0.2.8 computers that can ’t be upgraded to version 1 0.4.7 or lat er . Such c omputers [...]

48 Chapter 5 Migrating From Mac OS X Server Version 10.2  Mail database  W ebMail data  FTP configuration files  NetBoot images  W ebObjects applications and frameworks  T omcat data  AFP settings  IP firewall configuration  DNS configuration  DHCP settings  User data, including home direc tories  Quick Time Streaming Server[...]

Chapter 5 Migrating From Mac OS X Server Version 10.2 49 Â Y ou use the nidump and niload tools and the NetInfo Manager application to migrate your DHCP configuration. Instructions in the following sections explain when and how to use these utilities . Step-by-St ep Instructions T o move data from a Mac OS X Server version 1 0.2.8 computer to a co[...]

50 Chapter 5 Migrating From Mac OS X Server Version 10.2 Step 1: Expor t users and groups Use W orkgroup Manager to expor t user and group accounts from a NetInfo 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.4. T o export users and groups: 1 In W orkgroup Manager[...]

Chapter 5 Migrating From Mac OS X Server Version 10.2 51 W eb C onfiguration Data Save the f ollowing files and directory :  /etc/httpd/httpd.c onf  /etc/httpd/httpd_macosxserver .conf  /etc/httpd/httpd_squirrelmail.conf  /etc/httpd/magic  /etc/httpd/mime.types  /etc/httpd/mime_macosxserver .t ypes  /etc/httpd/ssl.crt  /etc/httpd/ss[...]

52 Chapter 5 Migrating From Mac OS X Server Version 10.2 FTP Configur ation F iles T o migrate your FTP settings, save these configuration file s: AFP Save the AFP c onfiguration after running the following command from the T erminal application. This command writes the AFP configuration rec ord stored in NetInf o to a file named afpconfig: nidump [...]

Chapter 5 Migrating From Mac OS X Server Version 10.2 53 DHCP Save the DHCP settings after running the f ollowing command from the T erminal application. This command writes the DHCP configuration rec ord stored in NetInf o to a file named DHCPconfig: nidump -r /config/dhcp . > DHCPconfig Although Ser ver Admin DHCP didn ’t manage static bindi[...]

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

Chapter 5 Migrating From Mac OS X Server Version 10.2 55 4 Click the globe icon in the toolbar to open the directory into which you want to import accounts. 5 Click the lock to authenticat e as domain administrator . 6 Choose Ser ver > Import, select the impor t file, and specify impor t options. If you ’ re using a preset , make sure you iden[...]

56 Chapter 5 Migrating From Mac OS X Server Version 10.2 A log of the changes made to the files is creat ed in /Librar y/Logs/Migration/ webconfigmigrator .log. The v ersion 1 0.2 files in /etc/httpd/ are renamed to httpd.conf .obsolete, httpd_macosxser ver .conf .obsolete, and mime_macosxserver .t ypes.obsolete. A new httpd.conf file is creat ed a[...]

Chapter 5 Migrating From Mac OS X Server Version 10.2 57 Other wise, brow se for the database to identify its location and list its acc ounts. 4 Make sure there is free space on the destination disk equal t o the size of the mail database. 5 Y ou can migrate a single user or all users. T o migrate mail for only one user , select the user and click [...]

58 Chapter 5 Migrating From Mac OS X Server Version 10.2 W ebObjects Applications and F ramew orks T o migrate W ebObjects: 1 Copy sav ed applications and frameworks to: Â /Librar y/W ebObjects/ Â /System/Library/WebObjects/ 2 Add the follo wing line to the new httpd .conf file: Include /System/Library/WebObjects/Adaptors/Apache/apache.conf 3 W e[...]

Chapter 5 Migrating From Mac OS X Server Version 10.2 59 9 In Ser ver Admin, star t firewall ser vice. DNS Configur ation T o migrate the DNS c onfiguration: 1 Restore the file /etc/named .conf and the director y /var/named/ and all its contents . 2 In the T erminal application, go to the dir ector y where the DNS migration script resides cd /Syste[...]

60 Chapter 5 Migrating From Mac OS X Server Version 10.2 Step 9: T est the new server T o test the new server: 1 Open W orkgroup Manager and inspect user and group accoun ts. 2 Open Ser ver Admin and inspect settings for services whose configuration data you migrated.[...]

6 61 6 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 da ta from a v ersion1 0. 1 . 4 or 1 0. 1 .5 ser ver to a diff erent computer running v ersion 1 0. 4. This chapter tells y ou what you can migrate , then explains how . Befor e Y ou Begin Before using the instructions in this chap[...]

62 Chapter 6 Migrating From Mac OS X Server Version 10.1 Â User and group accounts If you’ re using any of the f ollowing , make a note of any settings y ou want to continue to use, then see the document indicated for instructions on re-creating the settings after using the instructions in this chapter . In version 1 0.4, watchdog has been repla[...]

Chapter 6 Migrating From Mac OS X Server Version 10.1 63 Step-by-St ep Instructions T o move data from a Mac OS X Server version 1 0. 1 .4 or 1 0. 1 .5 comput er to a computer with Mac OS X Ser ver version 1 0.4 installed , follow the instructions in this section. user group 20 1 7 1 Export user and group info . 2 Create archive files of data and u[...]

64 Chapter 6 Migrating From Mac OS X Server Version 10.1 Step 1: Expor t users and groups Use Ser ver Admin t o expor t user and group accounts fr om a NetInfo directory into an XML file that you can import into a director y for use with Mac OS X Ser ver version 1 0. 4. T o export users and groups: 1 Open Ser ver Admin and log in to the server that[...]

Chapter 6 Migrating From Mac OS X Server Version 10.1 65 MySQL Data Mac OS X Ser ver version 1 0. 1 preinstalled MySQL version 3 .2 3. Ser ver version 1 0.4 preinstalls MySQL version 4.0.20. T o migrate your MySQL databases from one computer t o another , you can use the mysqldump command from a T erminal window. T o back up the data, type: mysqldu[...]

66 Chapter 6 Migrating From Mac OS X Server Version 10.1 T omcat Data Save an y T omcat servlets you want to reuse. They’ re in /Library/T omcat/webapps/. If you ’ve installed Axis independent of the v ersion supplied with your server , sa ve an y Simple Object Access P rotocol (SO AP) services. IP Fir ewall Save the IP fir ewall configuration [...]

Chapter 6 Migrating From Mac OS X Server Version 10.1 67 Step 4: Copy archiv e files to the new server T ransfer the files you sav ed in Steps 1 and 2 to the version 1 0. 4 ser ver . T o transfer tar files or disk image s using FTP: 1 Use Ser ver Admin on the new server to start FTP ser vice. 2 Set up sharing for a folder in to which you ’ll plac[...]

68 Chapter 6 Migrating From Mac OS X Server Version 10.1 Step 6: Impor t exported users and groups and other data Y ou can use W orkgroup Manager or the dsimport tool to import users and groups and other data: Â See the user management guide for details about importing by using W orkgroup Manager . Â See the Open Director y administration guide f[...]

Chapter 6 Migrating From Mac OS X Server Version 10.1 69 Step 7: Relocate sav ed data files Place the files y ou saved from y our version 1 0. 1 server in their final location. W eb C onfiguration Data T o migrate the w eb configuration: 1 Save the file /et c/httpd/ser vermgr_web_httpd_config .plist and the directory /etc/ httpd/sites_disabled/ and[...]

70 Chapter 6 Migrating From Mac OS X Server Version 10.1 If the MySQL database you’ re migrating uses the deprecated ISAM table format fr om MySQL 3.2 3, now is a good time to updat e it. Refer to the documentation on the MySQL website for migration details: www .mysql.c om/doc/en/Upgrading-from-3.2 3.html This site suggests: Â Running mysql_fix[...]

Chapter 6 Migrating From Mac OS X Server Version 10.1 71 AFP Configur ation T o migrate the AFP c onfiguration: 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 SubDirectory to cr[...]

72 Chapter 6 Migrating From Mac OS X Server Version 10.1 Note: JavaMonit or and wotaskd ( WebObjects T ask Daemon) services are now managed by launchd and can be acce ssed through the Ser ver Admin application. If the ser ver you ’ re migrating from has the startup item /System/Library/Star tupI tems/W ebObjects, you don ’t need t o copy it to [...]

Chapter 6 Migrating From Mac OS X Server Version 10.1 73 User Data Restore sa ved user data files. Place home directories in locations that match the locations in the imported user records . If necessary , y ou can use W orkgroup Manager to edit user accoun ts so the locations in the account and on disk are the same . QuickTime Str eaming Ser ver F[...]

74 Chapter 6 Migrating From Mac OS X Server Version 10.1[...]

7 75 7 Migrating F rom Mac OS X Ser v er V ersion 1 .2 Use the instructions in this chapter when you need to migrate da ta from a v ersion 1 .2 ser ver to a diff erent c omputer running version 1 0. 4. This chapter tells y ou what you can migrate , and then explains how . Befor e Y ou Begin Before using the instructions in this chapter , per f orm [...]

76 Chapter 7 Migrating From Mac OS X Server Version 1.2 T ools Y ou Can Use Several utilities are a vailable for use during migration: Â Y ou use a command-line tool called Mac_OS_X_Server_1.2_Export_Tool to export version 1 .2 users and groups to an XML expor t file. Â Y ou use W orkgroup Manager in version 1 0. 4 to import users and groups from[...]

Chapter 7 Migrating From Mac OS X Server Version 1.2 77 Step-by-St ep Instructions T o move data from a Mac OS X Server version 1 .2 computer t o a computer with Mac OS X Ser ver version 1 0.4 installed , follow the instructions in this section. 1 Export user and group info . 2 Create archive files of data and user export file. 4 Copy archive files[...]

78 Chapter 7 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_Server_1.2_Export_Tool to export user and group information. The tool is located on the v ersion 1 0.4 server installation disc in /W elcome to Mac OS X Server/M igration T ools/. When you run the tool, you[...]

Chapter 7 Migrating From Mac OS X Server Version 1.2 79 Step 2: Create archive file s Save all the data file s that you want to r euse with Mac OS X Ser ver version 1 0.4. 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.4 c omputer . F or large amounts of data, you may want to c[...]

80 Chapter 7 Migrating From Mac OS X Server Version 1.2 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 privilege s If your version 1 .2 ser ver has [...]

Chapter 7 Migrating From Mac OS X Server Version 1.2 81 Step 6: Impor t users and groups and other data Y ou can use W orkgroup Manager or the dsimport tool to import users and groups and other data: Â See the user management guide for details about importing by using W orkgroup Manager . Â See the Open Director y administration guide for informa[...]

82 Chapter 7 Migrating From Mac OS X Server Version 1.2 Step 7: Relocate sav ed data files Place the files y ou saved from y our version 1 .2 ser ver on the version 1 0.4 server . FTP Configur ation F iles Copy sav ed FTP configuration files to: Â /Librar y/FTPSer ver/Configuration/ Â /Librar y/FTPSer ver/Messages/ W ebObjects Applications and F [...]

Chapter 7 Migrating From Mac OS X Server Version 1.2 83 QuickTime Str eaming Ser ver F iles and F olders F ollow instructions in the Quick Time Streaming Server administration guide to reuse files and folders sa ved from /Library/Quick TimeStreaming/. Step 8: Set up share points and privileges Re-create the share poin ts and privileges as required [...]

84 Chapter 7 Migrating From Mac OS X Server Version 1.2[...]

8 85 8 Migrating F rom AppleShar e IP Use this chapter when y ou need to migra te data from an AppleShare IP (ASIP) 6.3 .3 ser ver to a diff eren t computer running version 1 0. 4. This chapter tells y ou what you can migrate , and then explains how . Befor e Y ou Begin Before using the instructions in this chapter , per f orm initial setup of the [...]

86 Chapter 8 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 impor t users and groups into the local server director y . Â If you want to import users into a shared directory , create an XML expor t file using W eb & F ile Admin in ASIP 6.2 o[...]

Chapter 8 Migrating From AppleShare IP 87 Step-by-St ep Instructions T o move data from an ASIP 6.2 or 6.3 comput er to a computer with Mac OS X Server version 1 0.4 installed , follow the instructions in this section. 1 Create Internet aliases for users. 4 Mount ASIP server on Mac OS X Ser ver . 6 Copy Users & Groups . (meichen,mei) mei chen 1[...]

88 Chapter 8 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.4, synchronize all secondary ser vers with the primar y ser ver befor e star ting migration. Migrate the primary ser ver , then migrate the secondary ser vers. When migrating second[...]

Chapter 8 Migrating From AppleShare IP 89 Step 4: Mount the ASIP ser ver on Mac OS X Server T o mount the ASIP server: 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 using the root user account , and then turn off all services using Ser ver Admin. 3 Choose Go > Conn[...]

90 Chapter 8 Migrating From AppleShare IP Step 6: Copy the Users & Gr oups Data F ile T o copy this file: 1 Navigate to the U sers & Groups Data F ile on the remote ASIP server . Its default location is the Pr eference s folder in the Syst em F older . 2 Make a copy of the Users & Groups Data File . 3 F rom the version 1 0.4 server , mo[...]

Chapter 8 Migrating From AppleShare IP 91 6 During migration, the utility displays a progr ess bar and status information. When migration is complete , click Quit. 7 Examine the log files, which are located in /Library/Logs/Migration/: Â UserGroupsA ctions.log: Steps taken during user and group migration. Â UserGroupsEx ceptions.log: Steps taken [...]

92 Chapter 8 Migrating From AppleShare IP 7 T o create home directories for imported users, you have sev eral options: Create home directories one at a time b y selecting a user account in W orkgroup Manager , clicking Home , then clicking Create Home Now . Create all the home directories by using the -a ar gument of the createhomedir command. F or[...]

Chapter 8 Migrating From AppleShare IP 93 Step 1 0: T est the new ser ver T o test the new server: 1 Open W orkgroup Manager and inspect user and group accoun ts. 2 Open Ser ver Admin and inspect settings for services whose configuration data you migrated. Step 1 1: Migrate mail If you want to migrate mail, use one of these techniques: Â Have user[...]

94 Chapter 8 Migrating From AppleShare IP 11 During migration, the utility displays a progr ess bar and status information. When migration is complete , click Quit. 12 Examine the log files for mail migration, which are located in /Librar y/Logs/Migration/: Â MailActions.log: Steps taken during mail migration. Â MailExceptions .log: Steps taken o[...]

95 Index Index /Library/Logs/Migration/MailActions.log 94 /Library/Logs/Migration/MailExceptions.log 94 /Library/Logs/Migration/PrivilegesActions.log 91 /Library/Logs/Migration/PrivilegesExceptions.log 91 /Library/Logs/Migration/UserGroupsActions.log 91 /Library/Logs/Migration/ UserGroupsExceptions.log 91 /Library/Logs/Migration/webconfigmigrator.l[...]

96 Index saving DNS settings 66 saving FTP configuration files 65 saving IP firewall settings 66 saving MySQL data 65 saving QTSS files 66 saving share points 66 saving the AFP configuration 65 saving Tomcat data 66 saving user data 66 saving web configuration data 64 saving web content 64 saving webmail data 65 saving WebObjects applications and f[...]

Index 97 setting up home directory infrastructure 39 step-by-step instructions 34 testing the new server 46 tools you can use 33 what you can migrate 32 migrating from Windows NT 11 migrating versus upgrading 5 P predefined accounts definition of 11 group accounts 13 user accounts 12 PrintService.admin.log upgrading version 10.2.8 29 upgrading vers[...]