034-2344_Cvr 9/12/03 7:37 AM Page 1 Mac OS X Server Migration For Version 10.
LL2344.Book Page 2 Friday, August 22, 2003 3:49 PM 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 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.
LL2344.
LL2344.
What’s in This Guide Preface LL2344.Book Page 5 Friday, August 22, 2003 3:44 PM Use this guide when you want to migrate data to Mac OS X Server version 10.3 from previous versions of the server. The guide contains procedures for reusing data you’ve been using on older servers when you can’t or don’t want to upgrade. What’s Included in This Guide This guide is organized into several chapters: • Chapter 1 contrasts upgrading and migrating and summarizes topics of interest for migration.
LL2344.
LL2344.Book Page 7 Friday, August 22, 2003 3:44 PM 1 Before You Begin 1 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 may not need to migrate. You might be able to upgrade your server, a process that installs and sets up Mac OS X Server version 10.3 while automatically preserving existing data and service settings. Upgrading Versus Migrating You can upgrade your version 10.1 or 10.2 server to version 10.
LL2344.Book Page 8 Friday, August 22, 2003 3:44 PM Even if your existing server meets the minimum requirements for upgrading, you may want to migrate instead of upgrade. For example, you may be updating some of your computers and decide that you want to reestablish your server environment on one or more of the updated computers. The migration scenarios used in this guide address how to migrate data when you can’t upgrade or when you want to move existing server data to a different computer.
LL2344.Book Page 9 Friday, August 22, 2003 3:44 PM The AppleShare IP Migration utility preserves existing user and group accounts (and, optionally, other data) without using export files. Each chapter provides instructions for using these tools as appropriate. System Accounts When you install the server, several user and group accounts are created automatically. These predefined accounts are sometimes called system accounts, because they’re used by the server system software.
LL2344.
LL2344.Book Page 11 Friday, August 22, 2003 3:44 PM Migrating Data for Managed Mac OS 8 and 9 Users On Mac OS X Server version 10.3, Macintosh Manager version 2.2 is used to manage preferences of users of computers running software earlier than Mac OS X. On earlier server versions, these applications were used to manage such clients: On this server This application managed pre-Mac OS X users Mac OS X Server version 10.2 Macintosh Manager version 2.2 Mac OS X Server version 10.
LL2344.Book Page 12 Friday, August 22, 2003 3:44 PM After Migration When you’ve finished migrating, consider whether you want to take advantage of any of the newer features to update your server data. For example: • You can convert a shared NetInfo directory to LDAP. See the Open Directory administration guide for details about the advantages of using LDAP and how to use Server Admin to conduct the conversion. • You can convert to Open Directory password validation from a different strategy.
LL2344.Book Page 13 Friday, August 22, 2003 3:44 PM 2 Migrating From Mac OS X Server Version 10.2 2 Use the instructions in this chapter when you need to migrate data from a version 10.2 server. This chapter is for Mac OS X Server version 10.2 environments that can’t perform an upgrade installation of version 10.3.
LL2344.Book Page 14 Friday, August 22, 2003 3:44 PM • Macintosh Manager data • User and group accounts If you’re using any of the following, make a note of any settings you want to continue to use, then see the document indicated for instructions on re-creating the settings after using the instructions in this chapter.
LL2344.Book Page 15 Friday, August 22, 2003 3:44 PM Migrating in Place From Version 10.2 To install Mac OS X Server version 10.3 on a computer running version 10.2, follow the instructions in this section. 2 Copy current data to another hard disk or partition. 1 Make a full backup of current server. 3 Note current share points and privileges. Macintosh HD Shared Folders Read & Write Engineering Read & Write Designs Read Only Documents 10 Test the new server.
LL2344.Book Page 16 Friday, August 22, 2003 3:44 PM Step 1: Make a full backup of your current server Use your current backup program to create a backup copy of your version 10.2 server. Step 2: Copy current data to another hard disk or partition Save all the data files you want to reuse with Mac OS X Server version 10.3. You can keep them on the same computer, but make sure you place them on a disk or partition that won’t be overwritten when you do the clean 10.3 installation.
LL2344.Book Page 17 Friday, August 22, 2003 3:44 PM AFP Save the AFP configuration after running the following command from the Terminal application. This command writes the AFP configuration record stored in NetInfo to a file named afpconfig: nidump -r /config/AppleFileServer . > afpconfig NetBoot Images You can migrate NetBoot images created using Mac OS X Server version 10.2. Save the .
LL2344.Book Page 18 Friday, August 22, 2003 3:44 PM Macintosh Manager Data If you use Macintosh Manager and want to continue using it, copy the following folders: • /Library/Macintosh Manager/Multi-User Items/ • /Library/Macintosh Manager/Managed Preferences/ QuickTime Streaming Server Files and Folders Save files and folders in /Library/QuickTimeStreaming/. For more information about migrating QTSS, see the QuickTime Streaming Server administration guide.
LL2344.Book Page 19 Friday, August 22, 2003 3:44 PM Step 5: Install Mac OS X Server version 10.3 Follow the instructions in the getting started guide for performing a clean installation of Mac OS X Server version 10.3. If you’ve been using Macintosh Manager to manage preferences for Mac OS 9 clients and want to continue doing so, also install Macintosh Manager 2.2. Step 6: Set up the home directory infrastructure Set up the destination for home directories you want to restore.
LL2344.Book Page 20 Friday, August 22, 2003 3:44 PM Step 7: Import previously exported users and groups You can use Workgroup Manager or the dsimport tool to import users and groups. See the command-line administration guide for dsimport instructions and a description of the export file format. To import users and groups using Workgroup Manager: 1 Place the export file(s) you created in step 4 in a location accessible from your server.
LL2344.Book Page 21 Friday, August 22, 2003 3:44 PM Step 8: Restore saved data Copy the files you want to reuse from their backup location. Web Configuration Data To migrate the web configuration: 1 Save the file /etc/httpd/servermgr_web_httpd_config.plist and the directory /etc/ httpd/sites_disabled/ and all its contents from the version 10.3 server. 2 Replace the /etc/httpd/ directory and its files on the version 10.
LL2344.Book Page 22 Friday, August 22, 2003 3:44 PM Mail Database To migrate the mail database: 1 Make sure that mail service is not running. Open Server Admin, then click Mail. If it is not grayed out, click Stop Service. 2 Place the saved database in the default location: /Library/AppleMail Server/. Make sure that no extra files are in that location. 3 Make sure that there is free space on the destination disk equal to the size of the mail database. 4 Open the Terminal application.
LL2344.Book Page 23 Friday, August 22, 2003 3:44 PM NetBoot Images Copy the .nbi folder for each image you want to migrate, optionally placing it into the location where it previously resided. WebObjects Applications and Frameworks Make manual modifications to the new installed version of apache.conf if you want to reuse the previous server’s web configuration.
LL2344.Book Page 24 Friday, August 22, 2003 3:44 PM DHCP Settings To migrate the DHCP configuration: 1 Restore the DHCPconfig file. 2 Open Server Admin and make sure that DHCP service isn’t running. 3 Open NetInfo Manager, located in /Applications/Utilities/. 4 Authenticate and go to /config. 5 Choose Directory > New SubDirectory to create a record in /config. 6 Change the name of the new record from newdirectory to dhcp by selecting the name property’s value and editing it.
LL2344.Book Page 25 Friday, August 22, 2003 3:44 PM Step 9: Set up share points and privileges Re-create the share points and privileges as required. To create a share point and set privileges: 1 Open Workgroup Manager and click Sharing. 2 Click the All tab and select the volume or folder you want to share. 3 Click the General tab and select “Share this item and its contents.
LL2344.Book Page 26 Friday, August 22, 2003 3:44 PM Migrating to a New Server From Version 10.2 To move data from a Mac OS X Server version 10.2 computer to a computer with Mac OS X Server version 10.3 installed, follow the instructions in this section. If you’ve been using Macintosh Manager to manage preferences for Mac OS 9 clients and want to continue doing so, also install Macintosh Manager 2.2 on the version 10.3 computer. 2 Create archive files of data and user export file.
LL2344.Book Page 27 Friday, August 22, 2003 3:44 PM Step 1: Export users and groups Use Workgroup Manager to export user and group accounts from a NetInfo or LDAPv3 directory into a character-delimited file that you can import into a directory for use with Mac OS X Server version 10.3. To export users and groups: 1 In Workgroup Manager, click the Accounts button, then use the At pop-up menu to open the directory from which you want to export accounts.
LL2344.Book Page 28 Friday, August 22, 2003 3:44 PM Web Content Copy web content you want to reuse from: • /Library/Webserver/Documents/ • /Library/Webserver/CGI-Executables • Any other location in which it resides MySQL Data Mac OS X Server version 10.2 preinstalled version 3.23 of MySQL. Version 10.3 preinstalls a newer version—version 4.0. Make copies of your MySQL 3.23 databases, stored in /var/mysql/, if you want to migrate to version 4.0. Mail Database Save the mail database, if you want to reuse it.
LL2344.Book Page 29 Friday, August 22, 2003 3:44 PM WebObjects Applications and Frameworks Save WebObjects applications and frameworks located in: • /Local/Library/WebServer • /Library/WebServer Save a copy of webobjects.conf for reference if you want to modify the new version of apache.conf to reproduce your current settings. For more information on migrating WebObjects data, see the Java Converter documentation on the WebObjects 5 Developer disc. Tomcat Data Save any Tomcat servlets you want to reuse.
LL2344.Book Page 30 Friday, August 22, 2003 3:44 PM Step 3: Note current share points and privileges If your version 10.2 server has share points and privileges you want to re-create on the version 10.3 server, make a note of them. Note which share points are for home directories. Step 4: Copy archive files to the new server Transfer the files you saved in steps 1 and 2 to the version 10.3 server. To transfer tar files or disk images using FTP: 1 Use Server Admin on the new server to start FTP service.
LL2344.Book Page 31 Friday, August 22, 2003 3:44 PM 5 If you’ll restore home directories in locations that won’t exactly match the locations identified in exported user records, you can define a preset that identifies the restore location. If you identify the preset when you import users, the new location will replace the existing location in user records.
LL2344.Book Page 32 Friday, August 22, 2003 3:44 PM Web Configuration Data To migrate the web configuration: 1 Save the file /etc/httpd/servermgr_web_httpd_config.plist and the directory /etc/ httpd/sites_disabled/ and all its contents from the version 10.3 server. 2 Replace the /etc/httpd/ directory and its files on the version 10.3 server with the /etc/ httpd/ directory and its contents that you saved on the former server. Also restore the saved /etc/webperfcache/webperfcache.conf.
LL2344.Book Page 33 Friday, August 22, 2003 3:44 PM Mail Database To migrate the mail database: 1 Make sure that mail service is not running. Open Server Admin, then click Mail. If it is not grayed out, click Stop Service. 2 Place the saved database in the default location: /Library/AppleMail Server/. Make sure that no extra files are in that location. 3 Make sure that there is free space on the destination disk equal to the size of the mail database. 4 Open the Terminal application.
LL2344.Book Page 34 Friday, August 22, 2003 3:44 PM NetBoot Images Copy the .nbi folder for each image you want to migrate, optionally placing it into the location where it previously resided. WebObjects Applications and Frameworks Make manual modifications to the new installed version of apache.conf if you want to reuse the previous server’s web configuration.
LL2344.Book Page 35 Friday, August 22, 2003 3:44 PM DHCP Settings To migrate the DHCP configuration: 1 Restore the DHCPconfig file. 2 Open Server Admin and make sure that DHCP service isn’t running. 3 Open NetInfo Manager, located in /Applications/Utilities/. 4 Authenticate and go to /config. 5 Choose Directory > New SubDirectory to create a record in /config. 6 Change the name of the new record from newdirectory to dhcp by selecting the name property’s value and editing it.
LL2344.Book Page 36 Friday, August 22, 2003 3:44 PM Step 8: Set up share points and privileges Re-create the share points and privileges as required. To create a share point and set privileges: 1 Open Workgroup Manager and click Sharing. 2 Click the All tab and select the volume or folder you want to share. 3 Click the General tab and select “Share this item and its contents.
LL2344.Book Page 37 Friday, August 22, 2003 3:44 PM 3 Migrating From Mac OS X Server Version 10.1 3 Use the instructions in this chapter when you need to migrate data from a version10.1 server. This chapter is for Mac OS X Server version 10.1 environments that can’t perform an upgrade installation of version 10.
LL2344.Book Page 38 Friday, August 22, 2003 3:44 PM If you’re using any of the following, make a note of any settings you want to continue to use, then see the document indicated for instructions on re-creating the settings after using the instructions in this chapter.
LL2344.Book Page 39 Friday, August 22, 2003 3:44 PM Migrating in Place From Version 10.1 To install Mac OS X Server version 10.3 on a computer running version 10.1, follow the instructions in this section. Make sure that the computer meets the minimum requirements for version 10.3, described on page 7. 3 Note current share points and privileges. 2 Copy current data to another hard disk or partition. 1 Make a full backup of current server.
LL2344.Book Page 40 Friday, August 22, 2003 3:44 PM Step 2: Copy current data to another hard disk or partition Save all the data files that you want to reuse with Mac OS X Server version 10.3. You can keep them on the same computer, but make sure you place them on a disk or partition that won’t be overwritten when you do the clean 10.3 installation. Web Configuration Data Save the directory /etc/httpd/ and all its contents. Also save the file /etc/webperfcache/ webperfcache.conf.
LL2344.Book Page 41 Friday, August 22, 2003 3:44 PM AFP Save the AFP configuration after running the following command from the Terminal application. This command writes the AFP configuration record stored in NetInfo to a file named afpconfig: nidump -r /config/AppleFileServer . > afpconfig WebObjects Applications and Frameworks Save WebObjects applications and frameworks located in: • /Local/Library/WebServer • /Library/WebServer Save a copy of webobjects.
LL2344.Book Page 42 Friday, August 22, 2003 3:44 PM QuickTime Streaming Server Files and Folders Save files and folders in /Library/QuickTimeStreaming/. For more information about migrating QTSS, see the QuickTime Streaming Server administration guide. Step 3: Note current share points and privileges If your version 10.1 server has share points and privileges you want to re-create on the new server, make a note of them. Note which share points are for home directories.
LL2344.Book Page 43 Friday, August 22, 2003 3:44 PM To prepare the server to store home directories: 1 Create the folder you want to serve as the home directory share point, if required. You can use the predefined /Users folder, if you like. 2 Open Workgroup Manager on the server where you want the home directories to reside. 3 Click Sharing to set up a share point for the home directories.
LL2344.Book Page 44 Friday, August 22, 2003 3:44 PM 8 To create home directories for imported users, you have several options. Create home directories one at a time by selecting a user account in Workgroup Manager, clicking Advanced, then clicking Create Home Now. Create all the home directories by using the -a argument of the createhomedir command. For details, see the command-line administration guide or the man page for createhomedir.
LL2344.Book Page 45 Friday, August 22, 2003 3:44 PM MySQL Data Restore saved MySQL databases in /var/mysql. 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_convert_table_format (if all existing tables are ISAM or MyISAM) or ALTER TABLE table_name TYPE=MyISAM on all ISAM tables to avoid the deprecated ISAM table format.
LL2344.Book Page 46 Friday, August 22, 2003 3:44 PM AFP Configuration To migrate the AFP configuration: 1 Restore the afpconfig file. 2 Open Server Admin and make sure that AFP isn’t running. 3 Open NetInfo Manager, located in /Applications/Utilities. 4 Authenticate and go to /config. 5 Choose Directory > New SubDirectory to create a record in /config. 6 Change the name of the new record from newdirectory to AppleFileServer by selecting the name property’s value and editing it.
LL2344.Book Page 47 Friday, August 22, 2003 3:44 PM 7 In the Terminal application, run the following command from the directory in which the firewallconfig file resides: sudo niload -r /config/IPFilters . < firewallconfig 8 Type the 50_ipfwconfigmigrator command: sudo /System/Library/ServerSetup/MigrationExtras/ 50_ipfwconfigmigrator 9 In Server Admin, start firewall service. DNS Configuration Restore the file /etc/named.conf and the directory /var/named/ and all its contents.
LL2344.Book Page 48 Friday, August 22, 2003 3:44 PM Step 9: Migrate Macintosh Manager Information Move the Preferences folders in Mac OS 9 user home directories from ~/Library/ Preferences to ~/Library/Classic/Preferences if you want to preserve existing preferences. If you don’t move the Preferences folder, users can log in, but all application preferences are new, not reused.
LL2344.Book Page 49 Friday, August 22, 2003 3:44 PM Migrating to a New Server From Version 10.1 To move data from a Mac OS X Server version 10.1 computer to a computer with Mac OS X Server version 10.3 installed, follow the instructions in this section. If you’ve been using Macintosh Manager to manage preferences for Mac OS 9 clients and want to continue doing so, also install Macintosh Manager 2.2 on the version 10.3 computer. 2 Create archive files of data and user export file.
LL2344.Book Page 50 Friday, August 22, 2003 3:44 PM To export users and groups: 1 Open Server Admin and log in to the server that stores the user and group accounts you want to migrate. 2 Click Users & Groups and choose Show Users & Groups. 3 Select the users and groups you want to export, then click Export. When you export users using Server Admin, encrypted passwords are exported. If you want to reset passwords, you can do so using Workgroup Manager, as described in step 6.
LL2344.Book Page 51 Friday, August 22, 2003 3:44 PM Mail Database Save the mail database, if you want to reuse it. Its default location is /Library/ AppleMailServer/. Webmail Data Mac OS X Server version 10.3 installs a version of SquirrelMail configured to use the mail server running on the local computer. Address books and preferences are stored in /var/db/squirrelmail/data/. You may want to migrate your users’ address books and preferences to that location.
LL2344.Book Page 52 Friday, August 22, 2003 3:44 PM IP Firewall Save the IP firewall configuration after running the following command from the Terminal application. This command writes the IP firewall configuration record stored in NetInfo to a file named firewallconfig: nidump -r /config/IPFilters . > firewallconfig DNS Save the file /etc/named.conf and the directory /var/named/ and all its contents. DHCP Save the DHCP settings after running the following command from the Terminal application.
LL2344.Book Page 53 Friday, August 22, 2003 3:44 PM Step 5: Set up the home directory infrastructure Set up the destination for home directories you want to restore. The home directory location identified in imported user accounts must match the physical location of the restored home directories, including the share point location. For detailed instructions on how to perform individual steps in the following procedure, see the user management guide.
LL2344.Book Page 54 Friday, August 22, 2003 3:44 PM 5 Click the lock to authenticate as domain administrator. 6 Choose Server > Import, select the import file, and specify import options. If you’re importing user accounts and using a preset, make sure you identify the preset. 7 Click Import. 8 To create home directories for imported users, you have several options. Create home directories one at a time by selecting a user account in Workgroup Manager, clicking Advanced, then clicking Create Home Now.
LL2344.Book Page 55 Friday, August 22, 2003 3:44 PM MySQL Data Restore saved MySQL databases in /var/mysql. 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_convert_table_format (if all existing tables are ISAM or MyISAM) or ALTER TABLE table_name TYPE=MyISAM on all ISAM tables to avoid the deprecated ISAM table format.
LL2344.Book Page 56 Friday, August 22, 2003 3:44 PM AFP Configuration To migrate the AFP configuration: 1 Restore the afpconfig file. 2 Open Server Admin and make sure that AFP isn’t running. 3 Open NetInfo Manager, located in /Applications/Utilities. 4 Authenticate and go to /config. 5 Choose Directory > New SubDirectory to create a record in /config. 6 Change the name of the new record from newdirectory to AppleFileServer by selecting the name property’s value and editing it.
LL2344.Book Page 57 Friday, August 22, 2003 3:44 PM IP Firewall Configuration To migrate the IP firewall configuration: 1 Restore the firewallconfig file. 2 Open Server Admin and make sure that firewall service isn’t running. 3 Open NetInfo Manager, located in /Applications/Utilities. 4 Authenticate and go to /config. 5 Choose Directory > New SubDirectory to create a record in /config. 6 Change the name of the new record from newdirectory to IPFilters by selecting the name property’s value and editing it.
LL2344.Book Page 58 Friday, August 22, 2003 3:44 PM User Data Restore saved user data files. Place home directories in locations that match the locations in the imported user records. If necessary, you can use Workgroup Manager to edit user accounts so the locations in the account and on disk are the same. QuickTime Streaming Server Files and Folders Follow instructions in the QuickTime Streaming Server administration guide to reuse files and folders saved from /Library/QuickTimeStreaming/.
LL2344.Book Page 59 Friday, August 22, 2003 3:44 PM 4 Migrating From Mac OS X Server Version 1.2 4 Use the instructions in this chapter when you need to migrate data from a version 1.2 server. This chapter tells you what you can migrate, and then explains how to migrate by reusing your existing server hardware or by moving to a different computer. Understanding What You Can Migrate “Migrating in Place From Version 1.2” on page 61 and “Migrating to a New Server From Version 1.
LL2344.Book Page 60 Friday, August 22, 2003 3:44 PM You can’t migrate NetBoot images created prior to Mac OS X Server version 10.2. Recreate your old images using the default startup images provided with Mac OS X Server version 10.3. Tools You Can Use Several utilities are available for use during migration: • You 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 export file. • You use Workgroup Manager in version 10.
LL2344.Book Page 61 Friday, August 22, 2003 3:44 PM Migrating in Place From Version 1.2 To install Mac OS X Server version 10.3 on a computer running version 1.2, follow the instructions in this section. Make sure that the computer meets the minimum requirements for version 10.3; see page 7. 2 Copy current data to another hard disk or partition. 1 Make a full backup of current server. 3 Note current share points and privileges.
LL2344.Book Page 62 Friday, August 22, 2003 3:44 PM 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 server. Step 2: Copy current data to another hard disk or partition Save all the data files that you want to reuse with Mac OS X Server version 10.3. You can keep them on the same computer, but make sure you place them on a disk or partition that won’t be overwritten when you do the clean 10.3 installation.
LL2344.Book Page 63 Friday, August 22, 2003 3:44 PM To prepare data for the migration utility: 1 Open the Macintosh Manager 1.x administration application and log in to the version 1.2 server using an administrator account. 2 After connecting, verify the users and workgroups using the option in the File menu. After the consistency check is complete, quit the application. Note: User accounts that exist only in Macintosh Manager and not in the version 1.2 user database won’t be migrated.
LL2344.Book Page 64 Friday, August 22, 2003 3:44 PM To export user and group information: 1 Insert the installation disc. 2 Log in using the root account. 3 Open the Terminal application. 4 Navigate to the Migration Tools folder by entering cd "//Welcome to Mac OS X Server/Migration Tools/" 5 Run the tool and save the results in an XML file on a partition other than the server partition. For example: ./Mac_OS_X_Server_1.2_Export_Tool > /MyPartition/MyExportFile.
LL2344.Book Page 65 Friday, August 22, 2003 3:44 PM Step 6: Set up the home directory infrastructure Set up the destination for home directories you want to restore. For detailed instructions on how to perform individual steps in the following procedure, see the user management guide. To prepare the server to store home directories: 1 Create the folder you want to serve as the home directory share point, if required. You can use the predefined /Users folder, if you like.
LL2344.Book Page 66 Friday, August 22, 2003 3:44 PM 8 To create home directories for imported users, you have several options. Create home directories one at a time by selecting a user account in Workgroup Manager, clicking Advanced, then clicking Create Home Now. Create all the home directories by using the -a argument of the createhomedir command. For details, see the command-line administration guide or the man page for createhomedir.
LL2344.Book Page 67 Friday, August 22, 2003 3:44 PM Step 9: Set up share points and privileges Re-create the share points and privileges as required. To create a share point and set privileges: 1 Open Workgroup Manager and click Sharing. 2 Click the All tab and select the volume or folder you want to share. 3 Click the General tab and select “Share this item and its contents.
LL2344.Book Page 68 Friday, August 22, 2003 3:44 PM 5 Restore the contents of the Macintosh Manager share point you backed up earlier from the ASIP server. Place the Users folder just under the Macintosh Manager share point: /Library/Macintosh Manager/Users/ Place any of the following folders in the following table into: /Library/Macintosh Manager/Old MM Items/ For Move this folder to Old MM Items Macintosh Manager 1.0-1.0.x Macintosh Manager Items Macintosh Manager 1.1-1.
LL2344.Book Page 69 Friday, August 22, 2003 3:44 PM 10 Make sure all the user home directories exist. Use Workgroup Manager or the createhomedir tool to create them. 11 On the remote Macintosh Manager 2.2 administrator computer, open the Macintosh Manager 2.2 administration application. Once the correct server is found by Macintosh Manager, log in as an administrator. Note: Allow the application to locate the server on its own.
LL2344.Book Page 70 Friday, August 22, 2003 3:44 PM 16 Check the log file after migration is complete. It’s called MM Migration Log.txt. The file resides at the root of the startup volume on the Mac OS 9 computer.
LL2344.Book Page 71 Friday, August 22, 2003 3:44 PM Migrating to a New Server From Version 1.2 To move data from a Mac OS X Server version 1.2 computer to a computer with Mac OS X Server version 10.3 installed, follow the instructions in this section. If you’ve been using Macintosh Manager to manage Mac OS 9 users and want to continue doing so, also install Macintosh Manager 2.2 on the version 10.3 computer. 1 Export user and group info. 2 Create archive files of data and user export file.
LL2344.Book Page 72 Friday, August 22, 2003 3:44 PM Step 1: Export user and group information You 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 version 10.3 server installation disc in /Welcome to Mac OS X Server/Migration Tools/ When you run the tool, you must save the exported information in a file with the extension “.xml” on a partition or disk other than the server partition.
LL2344.Book Page 73 Friday, August 22, 2003 4:11 PM Step 2: Create archive files Save all the data files that you want to reuse with Mac OS X Server version 10.3. In step 4 you’ll move the files described below, as well as the export file created in step 1, to the version 10.3 computer. For large amounts of data, you may want to create one or more tar archives, using the tar command in the Terminal application; tar archives can be transferred to the version 10.3 server using FTP.
LL2344.Book Page 74 Friday, August 22, 2003 3:44 PM Macintosh Manager Data If you use Macintosh Manager and want to continue using it, make a copy of the following folders, which reside in the share point named Macintosh Manager on an HFS Plus volume: For Copy the folder named Macintosh Manager 1.0-1.0.x Macintosh Manager Macintosh Manager 1.1-1.x Multi-User Items All Macintosh Manager versions Users To help you migrate data for individual managed users, Macintosh Manager version 2.
LL2344.Book Page 75 Friday, August 22, 2003 3:44 PM Step 5: Set up the home directory infrastructure Set up the destination for home directories you want to restore. For detailed instructions on how to perform individual steps in the following procedure, see the user management guide. To prepare the server to store home directories: 1 Create the folder you want to serve as the home directory share point, if required. You can use the predefined /Users folder, if you like.
LL2344.Book Page 76 Friday, August 22, 2003 3:44 PM 8 To create home directories for imported users, you have several options. Create home directories one at a time by selecting a user account in Workgroup Manager, clicking Advanced, then clicking Create Home Now. Create all the home directories by using the -a argument of the createhomedir command. For details, see the command-line administration guide or the man page for createhomedir.
LL2344.Book Page 77 Friday, August 22, 2003 3:44 PM Step 8: Set up share points and privileges Re-create the share points and privileges as required. To create a share point and set privileges: 1 Open Workgroup Manager and click Sharing. 2 Click the All tab and select the volume or folder you want to share. 3 Click the General tab and select “Share this item and its contents.
LL2344.Book Page 78 Friday, August 22, 2003 3:44 PM 5 In the Macintosh Manager share point (/Library/Macintosh Manager/), create a new folder called Old MM Items: /Library/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 Macintosh Manager share point.
LL2344.Book Page 79 Friday, August 22, 2003 3:44 PM 10 The server and each client computer have script settings that designate the primary language for each computer. Make sure that these three language script settings match: • The default script for logging in and using the Macintosh Manager 2.2 administration program. For Mac OS X Server, use the International pane of System Preferences to change this setting. On Mac OS 9, the script setting is determined by the localization of the current system.
LL2344.Book Page 80 Friday, August 22, 2003 3:44 PM 15 Click Update. The migration utility starts migrating data, displaying a progress bar during the process. If two user documents with identical file names are found on separate volumes, both documents are copied to the home directory and the name of one of the documents is modified. If two sets of user settings are stored on separate volumes, the settings with the most recent data are copied to the home directory.
LL2344.Book Page 81 Friday, August 22, 2003 3:44 PM Step 10: Test the new server To test the new server: 1 Open Workgroup Manager and inspect user and group accounts. 2 Open Server Admin and inspect settings for services whose configuration data you migrated. 3 Check Macintosh Manager and Workgroup Manager settings for managed Mac OS 9 clients you migrated. Log in to managed client computers to make sure that settings work as expected. Chapter 4 Migrating From Mac OS X Server Version 1.
LL2344.
LL2344.Book Page 83 Friday, August 22, 2003 3:44 PM 5 Migrating From AppleShare IP 5 Use this chapter when you need to migrate data from an AppleShare IP (ASIP) 6.2 or 6.3 server. This chapter tells you what you can migrate, and then explains how to migrate by reusing your existing server hardware or by moving to a different computer.
LL2344.Book Page 84 Friday, August 22, 2003 3:44 PM Tools You Can Use Several utilities are available 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. You can use this tool to migrate all these items or only users and groups. If you’re migrating only users and groups, the recommended approach is to use the user and group export facilities.
LL2344.Book Page 85 Friday, August 22, 2003 3:44 PM Migrating in Place From ASIP To install Mac OS X Server version 10.3 on a computer running ASIP, follow the instructions in this section. Make sure that the computer meets the minimum requirements for version 10.3, described on page 7. 1 Make a full backup of current server. 2 Create Internet aliases for users. 3 Export user and group info. (tsmith,smitty) user Tom Smith group 2017 Users 4 Prepare to migrate privileges.
LL2344.Book Page 86 Friday, August 22, 2003 3:44 PM If you have a primary ASIP server and one or more secondary ASIP servers and you want to migrate all of them to version 10.3, synchronize all secondary servers with the primary server before starting migration. Migrate the primary server, then migrate the secondary servers. When migrating secondary servers, you can’t use the AppleShare IP Migration utility.
LL2344.Book Page 87 Friday, August 22, 2003 3:44 PM Step 4: Prepare to migrate privileges On Mac OS X Server, groups can’t own folders. Before you migrate from ASIP, you can use Mac OS Server Admin (in ASIP 6.3), or Web & File Admin (in ASIP 6.2), to assign a new owner to any folders that are owned by a group. If you use the AppleShare IP Migration utility to migrate share points and privileges, the ownership of any folders owned by a group is assigned to the administrator.
LL2344.Book Page 88 Friday, August 22, 2003 3:44 PM To prepare the server to store home directories: 1 Create the folder you want to serve as the home directory share point, if required. You can use the predefined /Users folder, if you like. 2 Open Workgroup Manager on the server where you want the home directories to reside. 3 Click Sharing to set up a share point for the home directories.
LL2344.Book Page 89 Friday, August 22, 2003 4:11 PM When migrating users and groups, the migration utility checks to see if a duplicate user exists in a parent domain on a different computer. To determine what happens when a duplicate user name occurs, choose an option: • Don’t migrate the AppleShare user: The ASIP data is reassigned to the administrator and the mail inbox is converted to a text file. (Choose this option if you’re migrating a primary server.
LL2344.Book Page 90 Friday, August 22, 2003 3:44 PM To import users and groups using Workgroup Manager: 1 Place the export file(s) you created in step 3 in a location accessible from your server. 2 If you want imported users to have passwords validated using Open Directory authentication, you can set that up in the preset you defined in step 6. Enable the password option that forces users to change their passwords the next time they log in.
LL2344.Book Page 91 Friday, August 22, 2003 3:44 PM FTP Configuration Files To migrate your FTP settings, copy configuration files to the Mac OS X Server directory indicated: In this directory Place these files /Library/FTPServer/ Configuration ftpaccess ftpconversions ftphosts ftpgroups ftpusers /Library/FTPServer/Messages banner.txt welcome.txt limit.txt User Data Place home directories in locations that match the locations in the imported user records.
LL2344.Book Page 92 Friday, August 22, 2003 3:44 PM Step 10: Migrate Macintosh Manager Information To migrate Macintosh Manager data: 1 Set up a remote Macintosh Manager administrator computer by installing Macintosh Manager administrator and client software from the Administration Tools disc onto a Mac OS 9.2 computer.
LL2344.Book Page 93 Friday, August 22, 2003 3:44 PM 6 Open the Terminal application and execute the following command: sudo chown -R mmuser:admin /Library/Macintosh\ Manager /Old\ MM\ Items/ You can also use quotation marks to handle the spaces in the folder names: sudo chown -R mmuser:admin "/Library/Macintosh Manager/Old MM Items/" 7 In Server Admin, start AFP and enable Macintosh Manager. To start AFP, select it in the Computers & Services list and click Start Service.
LL2344.Book Page 94 Friday, August 22, 2003 3:44 PM 10 Make sure all the user home directories exist. Use Workgroup Manager or the createhomedir tool to create them. 11 On the remote Macintosh Manager 2.2 administrator computer, open the Macintosh Manager 2.2 administration application. Once the correct server is found by Macintosh Manager, log in as an administrator. Note: Allow the application to locate the server on its own.
LL2344.Book Page 95 Friday, August 22, 2003 3:44 PM 15 Quit the Macintosh Manager administration application after migration is complete so that information is written to the Macintosh Manager database. 16 Check the log file after migration is complete. It’s called MM Migration Log.txt. The file resides at the root of the startup volume on the Mac OS 9 computer.
LL2344.Book Page 96 Friday, August 22, 2003 3:44 PM Migrating to a New Server From ASIP To move data from an ASIP 6.2 or 6.3 computer to a computer with Mac OS X Server version 10.3 installed, follow the instructions in this section. If you’ve been using Macintosh Manager or At Ease for Workgroups to manage Mac OS 9 users and want to continue doing so, also install Macintosh Manager 2.2 on the version 10.3 computer. 2 Note current share point and privileges. 1 Create Internet aliases for users.
LL2344.Book Page 97 Friday, August 22, 2003 3:44 PM If you have a primary ASIP server and one or more secondary ASIP servers and you want to migrate all of them to version 10.3, synchronize all secondary servers with the primary server before starting migration. Migrate the primary server, then migrate the secondary servers. When migrating secondary servers, you can’t use the AppleShare IP Migration utility.
LL2344.Book Page 98 Friday, August 22, 2003 3:44 PM Step 4: Mount the ASIP server on Mac OS X Server To mount the ASIP server: 1 On the ASIP server, disconnect all users and administrators and shut down the mail server. 2 On Mac OS X Server, log in as an administrator and turn off all services using Server Admin. 3 Choose Go > Connect to Server. 4 Enter the IP address or DNS name of the ASIP server, then click Connect.
LL2344.Book Page 99 Friday, August 22, 2003 3:44 PM Step 6: Copy the Users & Groups Data File and the mail database To copy these items: 1 Navigate to the Users & Groups Data File on the remote ASIP server. Its default location is the Preferences folder in the System Folder. 2 Make a copy of the Users & Groups Data File. 3 From the version 10.3 server, move the copy of the Users & Groups Data File to a local partition on the version 10.3 server. 4 Navigate to the AppleShare IP Mail 6.
LL2344.Book Page 100 Friday, August 22, 2003 3:44 PM 6 If you’re migrating the mail database, locate the file AppleShare IP Mail 6.0 Data and click Choose. 7 During migration, the utility displays a progress bar and status information. When migration is complete, click Quit. 8 Examine the log files, which are located in /Library/Logs/Migration/: • UserGroupsActions.log: Steps taken during user and group migration. • UserGroupsExceptions.
LL2344.Book Page 101 Friday, August 22, 2003 3:44 PM You can also use the dsimport tool to import users and groups. See the command-line administration guide for dsimport instructions. To create home directories for imported users: You have several options: • Create home directories one at a time by selecting a user account in Workgroup Manager, clicking Advanced, then clicking Create Home Now. • Create all the home directories by using the -a argument of the createhomedir command.
LL2344.Book Page 102 Friday, August 22, 2003 3:44 PM Step 9: Set up share points and privileges Re-create the share points and privileges as required. Remember that a group can’t own a folder in Mac OS X Server. To create a share point and set privileges: 1 Open Workgroup Manager and click Sharing. 2 Click the All tab and select the volume or folder you want to share. 3 Click the General tab and select “Share this item and its contents.
LL2344.Book Page 103 Friday, August 22, 2003 3:44 PM 4 Open Server Admin on the version 10.3 server and make sure that Macintosh Manager and AFP services are not running. This step is very important to the success of user document migration.
LL2344.Book Page 104 Friday, August 22, 2003 3:44 PM 10 The server and each client computer have script settings that designate the primary language for each computer. Make sure that these three language script settings match: • The default script for logging in and using the Macintosh Manager 2.2 administration program. For Mac OS X Server, use the International pane of System Preferences to change this setting. On Mac OS 9, the script setting is determined by the localization of the current system.
LL2344.Book Page 105 Friday, August 22, 2003 3:44 PM When the migration utility finds a managed client user already exists in a Mac OS X Server directory, the action it takes depends on the user login setting and whether the user has a home directory: If login is The migration utility Enabled Assumes it is the same user and copies the user documents to the home directory.