Page 3 - Contents; Preface
3 1 Contents Preface 5 What’s in This Guide 5 What’s Included in This Guide 5 Getting Additional Information Chapter 1 7 Before You Begin 7 Upgrading Versus Migrating 8 Migration Scenarios 8 Migrating in Place 8 Migrating to a New Server 8 Migrating Users and Groups 8 Saving and Reusing User and Gro...
Page 4 - Chapter; Understanding What You Can Migrate
4 Contents Chapter 5 83 Migrating From AppleShare IP 83 Understanding What You Can Migrate 84 Tools You Can Use 85 Migrating in Place From ASIP 96 Migrating to a New Server From ASIP LL2344.Book Page 4 Friday, August 22, 2003 3:44 PM
Page 5 - refac; What’s in This Guide; What’s Included in This Guide; This guide is organized into several chapters:; Migrating in place; is a scenario in which you reuse your existing server computer.; Migrating to a new server; is a scenario in which you move data to a different; Getting Additional Information
5 P refac e What’s in This Guide Use this guide when you want to migrate data to Mac OS X Server version 10.3 from previous versions of the 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...
Page 7 - Before You Begin; upgrade; Upgrading Versus Migrating
1 7 1 Before You Begin Take a few moments to become familiar with upgrading and migrating. If you’re using Mac OS X version 10.1 or 10.2, you 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 preser...
Page 8 - Migration Scenarios; Migrating in Place; Migrating Users and Groups; Saving and Reusing User and Group Accounts
8 Chapter 1 Before You Begin 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 co...
Page 9 - System Accounts; system accounts; Here are the predefined user accounts:
Chapter 1 Before You Begin 9 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...
Page 10 - And here is a list of the predefined group accounts:
10 Chapter 1 Before You Begin And here is a list of the predefined group accounts: Short name Group ID nobody-2 nogroup -1 wheel 0 daemon 1 kmem 2 sys 3 tty4 operator 5 mail 6 bin 7 staff 20 smmsp 25 lp 26 postfix 27 postdrop 28 guest 31 utmp 45 uucp 66 dialer 68 network 69 www 70 mysql 74 sshd 75 q...
Page 11 - Migrating Data for Managed Mac OS 8 and 9 Users
Chapter 1 Before You Begin 11 Migrating Data for Managed Mac OS 8 and 9 Users On Mac OS X Server version 10.3, Macintosh Manager version 2.2 is 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 ...
Page 12 - After Migration
12 Chapter 1 Before You Begin After Migration When you’ve finished migrating, consider whether you want to take advantage of any of the newer features to update your server data. For example: • You can convert a shared NetInfo directory to LDAP. See the Open Directory administration guide for detail...
Page 14 - Macintosh Manager data; Tools You Can Use; Several tools are available:
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 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 inst...
Page 15 - Migrating in Place From Version 10.2
Chapter 2 Migrating From Mac OS X Server Version 10.2 15 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. Macintosh HD user group 2017 Macintosh HD Engineering Read & Write Designs Documents ...
Page 16 - Copy web content you want to reuse from:; To migrate your FTP settings, save these configuration files:
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 10.2 server. Step 2: Copy current data to another hard disk or partition Save all the data files you want to reuse with M...
Page 17 - Save WebObjects applications and frameworks located in:
Chapter 2 Migrating From Mac OS X Server Version 10.2 17 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 ...
Page 18 - Macintosh Manager Data; Click the lock to authenticate as domain administrator.
18 Chapter 2 Migrating From Mac OS X Server Version 10.2 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 an...
Page 19 - Install Mac OS X Server version 10.3; Set up the destination for home directories you want to restore.; To prepare the server to store home directories:; Click Sharing to set up a share point for the home directories.
Chapter 2 Migrating From Mac OS X Server Version 10.2 19 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 cl...
Page 20 - Import previously exported users and groups; In Workgroup Manager, click the Accounts button.
20 Chapter 2 Migrating From Mac OS X Server Version 10.2 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....
Page 21 - Restore saved data
Chapter 2 Migrating From Mac OS X Server Version 10.2 21 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_dis...
Page 22 - Mail Database
22 Chapter 2 Migrating From Mac OS X Server Version 10.2 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 S...
Page 23 - NetBoot Images; Copy saved WebObjects applications and frameworks to:; Tomcat Data; Restore the firewallconfig file.; DNS Configuration
Chapter 2 Migrating From Mac OS X Server Version 10.2 23 NetBoot Images Copy the <name>.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 vers...
Page 24 - DHCP Settings; Restore the DHCPconfig file.; User Data; Restore saved user data files.; QuickTime Streaming Server Files and Folders
24 Chapter 2 Migrating From Mac OS X Server Version 10.2 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...
Page 25 - Set up share points and privileges; Re-create the share points and privileges as required.; To create a share point and set privileges:; Open Workgroup Manager and click Sharing.; Test the new server; Open Workgroup Manager and inspect user and group accounts.
Chapter 2 Migrating From Mac OS X Server Version 10.2 25 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 w...
Page 26 - Migrating to a New Server From Version 10.2
26 Chapter 2 Migrating From Mac OS X Server Version 10.2 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...
Page 27 - Export users and groups; Web Configuration Data
Chapter 2 Migrating From Mac OS X Server Version 10.2 27 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 expor...
Page 30 - Note current share points and privileges; Use Server Admin on the new server to start FTP service.; Set up the home directory infrastructure
30 Chapter 2 Migrating From Mac OS X Server Version 10.2 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 ...
Page 31 - Relocate saved data files
Chapter 2 Migrating From Mac OS X Server Version 10.2 31 5 If you’ll restore home directories in locations that won’t exactly match the locations 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 n...
Page 38 - Several utilities are available for use during migration:
38 Chapter 3 Migrating From Mac OS X Server Version 10.1 If you’re using any of the following, make a note of any settings you want to continue to use, then see the document indicated for instructions on re-creating the settings after using the instructions in this chapter. You can’t migrate NetBoot...
Page 39 - Migrating in Place From Version 10.1; Make a full backup of your current server
Chapter 3 Migrating From Mac OS X Server Version 10.1 39 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 42 - Select the users and groups you want to export, then click Export.
42 Chapter 3 Migrating From Mac OS X Server Version 10.1 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 priv...
Page 44 - Copy the files you want to reuse from their backup location.; Open Server Admin and make sure that web service isn’t running.; Web Content; Copy saved web content to:
44 Chapter 3 Migrating From Mac OS X Server Version 10.1 8 To create home directories for imported users, you have several options. Create home directories one at a time by selecting a user account in Workgroup Manager, clicking Advanced, then clicking Create Home Now. Create all the home directorie...
Page 45 - MySQL Data
Chapter 3 Migrating From Mac OS X Server Version 10.1 45 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 p...
Page 46 - AFP Configuration
46 Chapter 3 Migrating From Mac OS X Server Version 10.1 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 ...
Page 48 - Migrate Macintosh Manager Information
48 Chapter 3 Migrating From Mac OS X Server Version 10.1 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 Prefer...
Page 49 - Migrating to a New Server From Version 10.1
Chapter 3 Migrating From Mac OS X Server Version 10.1 49 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...
Page 50 - To export users and groups:
50 Chapter 3 Migrating From Mac OS X Server Version 10.1 To export users and groups: 1 Open Server Admin and log in to the server that stores the 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 expo...
Page 52 - To transfer tar files or disk images using FTP:
52 Chapter 3 Migrating From Mac OS X Server Version 10.1 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/IPFi...
Page 56 - Restore the afpconfig file.; WebObjects Applications and Frameworks
56 Chapter 3 Migrating From Mac OS X Server Version 10.1 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 ...
Page 57 - IP Firewall Configuration
Chapter 3 Migrating From Mac OS X Server Version 10.1 57 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 Authent...
Page 61 - Migrating in Place From Version 1.2
Chapter 4 Migrating From Mac OS X Server Version 1.2 61 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 C...
Page 63 - To prepare data for the migration utility:
Chapter 4 Migrating From Mac OS X Server Version 1.2 63 To prepare data for the migration utility: 1 Open the Macintosh Manager 1.x administration 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 ...
Page 64 - To export user and group information:; Insert the installation disc.
64 Chapter 4 Migrating From Mac OS X Server Version 1.2 To export user and group information: 1 Insert the installation disc. 2 Log in using the root account. 3 Open the Terminal application. 4 Navigate to the Migration Tools folder by entering cd "/<disc-name>/Welcome to Mac OS X Server/M...
Page 66 - FTP Configuration Files; Copy saved FTP configuration files to:
66 Chapter 4 Migrating From Mac OS X Server Version 1.2 8 To create home directories for imported users, you have several options. Create home 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...
Page 68 - Place any of the following folders in the following table into:
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 server. Place the Users folder just under the Macintosh Manager share point: /Library/Macintosh Manager/Users/ Place any of the following folders in...
Page 69 - Choose a password creation option.
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 create them. 11 On the remote Macintosh Manager 2.2 administrator computer, open the Macintosh Manager 2.2 administration application. Once the...
Page 70 - Use the log file to determine whether you need to:
70 Chapter 4 Migrating From Mac OS X Server Version 1.2 16 Check the log file after migration is complete. It’s called MM Migration Log.txt. The 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 • C...
Page 71 - Migrating to a New Server From Version 1.2
Chapter 4 Migrating From Mac OS X Server Version 1.2 71 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 ma...
Page 72 - Export user and group information
72 Chapter 4 Migrating From Mac OS X Server Version 1.2 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/M...
Page 73 - Create archive files
Chapter 4 Migrating From Mac OS X Server Version 1.2 73 Step 2: Create archive files Save all the data files that you want to reuse with Mac 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 larg...
Page 83 - Migrating From AppleShare IP
5 83 5 Migrating From AppleShare IP 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. Understandin...
Page 85 - Migrating in Place From ASIP
Chapter 5 Migrating From AppleShare IP 85 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. 2 Create Internet alia...
Page 86 - Click Users & Groups and choose Export Selected Items.
86 Chapter 5 Migrating From AppleShare IP If you have a primary ASIP server and one or more secondary ASIP servers and you want to migrate all of them to version 10.3, synchronize all secondary servers with the primary server before starting migration. Migrate the primary server, then migrate the se...
Page 87 - Prepare to migrate privileges; On Mac OS X Server, groups can’t own folders.
Chapter 5 Migrating From AppleShare IP 87 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 g...
Page 88 - Run the AppleShare IP Migration utility or use Workgroup Manager; Select migration options.
88 Chapter 5 Migrating From AppleShare IP To prepare the server to store home directories: 1 Create the folder you want to serve as the home 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 direc...
Page 89 - Don’t migrate the AppleShare user:
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 different computer. To determine what happens when a duplicate user name occurs, choose an option: • Don’t migrate the AppleShare user: Th...
Page 90 - To import users and groups using Workgroup Manager:; To create home directories for imported users:; You have several options:; Copy data to the new server; Set up the data you want to reuse.
90 Chapter 5 Migrating From AppleShare IP To import users and groups using Workgroup Manager: 1 Place the export file(s) you created in step 3 in a location accessible from your server. 2 If you want imported users to have passwords validated using Open Directory authentication, you can set that up ...
Page 91 - Instructions for restoring Macintosh Manager data are in step 10.
Chapter 5 Migrating From AppleShare IP 91 FTP Configuration Files To migrate your FTP settings, copy configuration files 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 necessary, y ou can use Workgro...
Page 93 - Open the Terminal application and execute the following command:
Chapter 5 Migrating From AppleShare IP 93 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/Mac...
Page 96 - Migrating to a New Server From ASIP
96 Chapter 5 Migrating From AppleShare IP 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 M...
Page 98 - Mount the ASIP server on Mac OS X Server
98 Chapter 5 Migrating From AppleShare IP 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 Ad...
Page 99 - Copy the Users & Groups Data File and the mail database; Make a copy of the Users & Groups Data File.; The ASIP data is reassigned to the administrator; Migrate the AppleShare user’s privileges and mail:; The ASIP data is assigned to the
Chapter 5 Migrating From AppleShare IP 99 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...