Mac OS X Server Upgrading and Migrating For Version 10.
K Apple Computer, Inc. © 2006 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. Every effort has been made to ensure that the information in this manual is accurate. Apple Computer, Inc.
1 Preface 5 5 6 6 7 8 8 Contents About This Guide What’s in This Guide Using This Guide Using Onscreen Help The Mac OS X Server Suite Getting Documentation Updates Getting Additional Information Chapter 1 9 9 9 10 11 11 11 11 Before You Begin Servers From Which You Can Upgrade or Migrate Upgrading to Version 10.4 Migrating From a Pre-Version 10.4 Server to Version 10.
47 48 49 Understanding What You Can Migrate Tools You Can Use Step-by-Step Instructions Chapter 6 61 61 61 62 63 Migrating From Mac OS X Server Version 10.1 Before You Begin Understanding What You Can Migrate Tools You Can Use Step-by-Step Instructions Chapter 7 75 75 75 76 77 Migrating From Mac OS X Server Version 1.
Preface About This Guide Use this guide when you want to move to Mac OS X Server version 10.4 from a previous version of the server. This guide contains instructions for reusing data and settings of previous server versions. There are two approaches: Â Perform an upgrade installation. This approach leaves all your data and settings in place and lets you reuse your existing server hardware for Mac OS X Server version 10.4. You can perform an upgrade installation of version 10.3 and version 10.2 servers.
Using This Guide Using this guide is easy. Simply read chapter 1 to make sure you understand all your options. Then turn to the chapter that addresses your upgrade or migration scenario. You’ll find step-by-step instructions for preserving and reusing server data by using various tools and manual techniques. You’ll also find references to instructions and supplemental information in other guides in the server suite; the next page tells you about the documents in the suite and where to find them.
The Mac OS X Server Suite The Mac OS X Server documentation includes a suite of guides that explain the services and provide instructions for configuring, managing, and troubleshooting the services. All of the guides are available in PDF format from: www.apple.com/server/documentation/ This guide ... tells you how to: Getting Started, Getting Started Install Mac OS X Server and set it up for the first time.
This guide ... tells you how to: Upgrading and Migrating Use data and service settings that are currently being used on earlier versions of the server software. User Management Create and manage user accounts, groups, and computer lists. Set up managed preferences for Mac OS X clients. Web Technologies Administration Set up and manage a web server, including WebDAV, WebMail, and web modules.
1 Before You Begin 1 Take a few moments to become familiar with upgrading and migrating options and requirements. If you’re using Mac OS X Server version 10.2 or 10.3, you may not need to migrate server data to a different computer. You might be able to upgrade your server, a process that installs and sets up Mac OS X Server version 10.4 on your existing server computer while automatically preserving data and service settings.
When you upgrade a server, you perform an upgrade installation from the server installation disc on your server computer. Data and settings are automatically preserved for you, and manual adjustments are minimal. If you’ve been using Macintosh Manager to manage Mac OS 9 client computers, you can continue to do so—an option not available when you migrate. See the documentation for your version 10.2 or 10.3 server for Macintosh Manager information.
Migrating From Windows NT Mac OS X Server can provide a variety of services to users of Microsoft Windows 95, 98, ME (Millennium Edition), XP, NT 4, and 2000 computers. By providing these services, Mac OS X Server can replace Windows NT servers in small workgroups. The Windows NT migration guide explains how to import users, groups, and computers from a Microsoft Windows NT server to a Mac OS X Server primary domain controller (PDC).
You can’t change the names or IDs of system accounts. So when you migrate users and groups, don’t try to do so. However, you can add users during migration to two system groups—admin and wheel: Â Wheel is a group that gives members almost as much control as root. If you’re a member of the wheel group, you can use the su (substitute user) command in the Terminal application to log in to a remote computer as the root user. Use ssh to log in, type su, then supply the root password when prompted.
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 tty 4 operator 5 mail 6 bin 7 staff 20 lp 26 postfix 27 postdrop 28 utmp 45 uucp 66 dialer 68 network 69 www 70 mysql 74 sshd 75 qtss 76 mailman 78 appserverusr 79 admin 80 appserveradm 81 clamav 82 amavisd 83 jabber 84 xgridcontroller 85 xgridagent 86 appowner 87 windowserver 88 accessibility 90 unknown 99 Chapter 1 B
Chapter 1 Before You Begin
2 Upgrading Mac OS X Server Version 10.3 2 Use the instructions in this chapter to upgrade a version 10.3.9 server to version 10.4. You can upgrade computers with Mac OS X Server version 10.3.9 that don’t require hard disk reformatting and that have: Â A PowerPC G4 or G5 processor. Â Built-in FireWire. Â At least 512 megabytes (MB) of random access memory (RAM). Â At least 10 gigabytes (GB) of disk space available. If you want to upgrade a version 10.3.9 server using a Mac OS X Server version 10.
Upgrading an Open Directory Master and Its Replicas When the server you want to upgrade is an Open Directory master or replica, upgrade the master then upgrade the replicas. To upgrade the master and its replicas: 1 Upgrade the master to version 10.4 following the instructions later in this chapter. While you’re upgrading the master, client computers won’t be able to connect to it for Open Directory services.
Step 1: Update your server to version 10.3.9 Use Software Update, if necessary, to update your server to version 10.3.9. Step 2: Perform an upgrade installation to version 10.4 You can use the version 10.4 installation disc to perform the upgrade installation locally on your server computer if it has a display, keyboard, and optical drive attached. After the upgrade installation is complete, the computer restarts and Server Assistant leads you through initial server setup.
7 After all setup data has been entered, Server Assistant displays a summary of the data. Review the setup data, optionally clicking Go Back to change it. 8 To initiate setup of the server, click Apply. When server setup is complete, click Restart Now. To upgrade to version 10.4 and perform initial server setup remotely: 1 Make sure that any DHCP or DNS servers your server depends on are running. 2 Start the computer from the installation disc.
8 During installation, progress information is displayed. If you’re using installation CDs (not available for version 10.4.7 or later), insert the next installation disc when prompted. 9 After installation is complete, the computer restarts automatically, and then Server Assistant opens and displays a Welcome pane. To initiate server setup, select “Set up a remote server” and click Continue.
Step 3: Make Adjustments as needed after initial server setup Now you can use Workgroup Manager, Server Admin, Terminal, and other applications to refine your server’s settings and take advantage of new version 10.4 features. See the administration guide for individual services for an explanation of new and changed features. Following are a few suggestions of particular interest. WebObjects Restore httpd.conf to the previous version (httpd.conf.AppleSaved), or include the following line in the new httpd.
Groups If you want groups to use new version 10.4 features such as nesting and stricter membership checking, upgrade group records using Workgroup Manager. To upgrade a group record: 1 Open Workgroup Manager. 2 Open the directory that contains the groups of interest. 3 Select one or more groups and click “Upgrade legacy group.” 4 Click Save. Directory Services After upgrading, you may want to convert a shared NetInfo directory to LDAP.
Print Service The upgrade process matches the old configuration with existing print queues and applies the settings to the new configuration, which is stored in /Library/Preferences/com.apple.printservice.plist. The upgrade results are logged in /Library/Logs/PrintService/PrintService.admin.log. If the server has a legacy (NetInfo-based) print service configuration that hasn’t been upgraded, the log file contains a report of the upgraded items.
3 Upgrading Mac OS X Server Version 10.2 3 Use the instructions in this chapter to upgrade a version 10.2.8 server to version 10.4. You can upgrade computers with Mac OS X Server version 10.2.8 that don’t require hard disk reformatting and that have: Â A PowerPC G4 or G5 processor. Â Built-in FireWire. Â At least 512 megabytes (MB) of random access memory (RAM). Â At least 10 gigabytes (GB) of disk space available. If you want to upgrade a version 10.2.8 server using a Mac OS X Server version 10.
Step-by-Step Instructions To upgrade a version 10.2.8 server to version 10.4, follow the instructions in this section. 1 Update your server to version 10.2.8. 2 Perform an upgrade installation to version 10.4. 3 Make adjustments as needed after initial server setup. Step 1: Update your server to version 10.2.8 Use Software Update if necessary to update your server to version 10.2.8. Step 2: Perform an upgrade installation to version 10.4 You can use the version 10.
5 During installation, progress information is displayed. If you’re using installation CDs (not available for version 10.4.7 or later), insert the next installation disc when prompted. 6 After installation is complete, the computer restarts automatically and Server Assistant opens so you can perform initial server setup. Move through the Assistant’s panes, following the onscreen instructions. Your existing settings are displayed in the panes, but you can change them if you like.
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 insert the installation disc into the optical drive on your administrator computer. You can also use an external FireWire optical drive. If the target server is an Xserve, you can move its drive module to another Xserve system that has an optical drive capable of reading your installation disc.
11 Move through the Assistant’s panes, following the onscreen instructions. Your existing settings are displayed in the panes, but you can change them if you like. Unless you have a site license, you’ll need to enter a unique server software serial number for each server you upgrade. You’ll find the number printed on the materials provided with the server software package. If you have a site license, a registered owner name and organization must be entered exactly as specified by your Apple representative.
To update a WebObjects project: 1 Open the project in Xcode. 2 In the Expert View for the main target’s settings, change the property value for “JAVA_VM” to “java”. Note: JavaMonitor and wotaskd (WebObjects Task Daemon) services are now managed by launchd and can be accessed through the Server Admin application. If the server you’re upgrading has the startup item /System/Library/StartupItems/WebObjects, you can ignore it.
Print Service The upgrade process matches the old configuration with existing print queues and applies the settings to the new configuration, which is stored in /Library/Preferences/ com.apple.printservice.plist. The upgrade results are logged in /Library/Logs/PrintService/PrintService.admin.log. If the server has a legacy (NetInfo-based) print service configuration that hasn’t been upgraded, the log file contains a report of the upgraded items.
Chapter 3 Upgrading Mac OS X Server Version 10.
4 Migrating From Mac OS X Server Version 10.3 4 Use the instructions in this chapter when you need to migrate data from a version 10.3.9 server to a different computer running version 10.4. You can migrate data from Mac OS X Server version 10.3.9 computers that can’t be upgraded to version 10.4.7 or later. Such computers may: Â Require hard disk reformatting or replacement with a newer computer. Â Be using server hardware that doesn’t have: Â A PowerPC G4 or G5 processor. Â Built-in FireWire.
To reestablish the master and its replicas: 1 Set up the version 10.4 master following the instructions later in this chapter. While you’re setting up the master, client computers won’t be able to connect to the version 10.3.9 master for Open Directory services. Clients may experience a delay while automatically finding the nearest Open Directory replica server.
 User data, including home directories  QuickTime Streaming Server files and directories  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.
Step-by-Step Instructions To move data from a Mac OS X Server version 10.3.9 computer to a computer with Mac OS X Server version 10.4 installed, follow the instructions in this section. 2 Create archive files of data and user export file. 1 Export user and group info. 3 Note current share points and privileges. Shared Folders user Read & Write Engineering userdata.tar Read & Write Designs group 2017 Read Only Documents Workgroup Manager database.tar 4 Copy archive files to new server.
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.4. To export users and groups: 1 In Workgroup Manager, click Accounts, then click the globe icon below the toolbar and choose the directory from which you want to export accounts. 2 Click the lock to authenticate as domain administrator.
Web Configuration Data Save the following files and directory:  /etc/httpd/httpd.conf  /etc/httpd/httpd_macosxserver.conf  /etc/httpd/httpd_squirrelmail.conf  /etc/httpd/magic  /etc/httpd/mime.types  /etc/httpd/mime_macosxserver.types  /etc/httpd/ssl.crt  /etc/httpd/ssl.key  /etc/httpd/tomcat.conf  /etc/webperfcache/webperfcache.
Also, save a copy of the file /usr/bin/cyrus/bin/ctl_mboxlist so you can move it to the version 10.4 server in Step 4 on page 39. You will need this file to migrate the mail database successfully in Step 7 on page 41. Webmail Data If you’ve been using the SquirrelMail installed when you installed version 10.3 and want to continue using it after migration, make copies of the address books and preferences stored in /var/db/squirrelmail/data/.
IP Firewall Save these files:  /etc/ipfilter/ip_address_groups.plist  /etc/ipfilter/standard_services.plist  /etc/ipfilter/ipfw.conf NAT Save the contents of /etc/nat/natd.plist. VPN Copy:  /Library/Preferences/SystemConfiguration/com.apple.RemoteAccessServers.plist  /Library/Keychains/System.keychain  /etc/racoon/psk.text (if L2TP is set up and psk.text stores the IPsec shared secret; the shared secret may also be stored in com.apple.RemoteAccessServers.plist or System.
Step 4: Copy archive files to the new server Transfer the files you saved in Steps 1 and 2 to the version 10.4 server. To transfer tar files or disk images using FTP: 1 Use Server Admin on the new server to start FTP service. 2 Set up sharing for a folder into which you’ll place files you transfer from the 10.3 computer. 3 On the version 10.3 server, use FTP service to copy the tar files or disk images to the version 10.4 computer. 4 Double-click a tar file to extract its contents.
Step 6: Import users and groups and other data You can use Workgroup Manager or the dsimport tool to import users and groups and other data: Â See the user management guide for details about importing by using Workgroup Manager. Â See the Open Directory administration guide for information about passwords of users originally created with Mac OS X Server version 10.1.5 or earlier. Â See the command-line administration guide for dsimport instructions and a description of Workgroup Manager export format.
10 If you want to enable Kerberos for an Open Directory master on which it’s not enabled, you can use the following command, which maintains existing passwords and adds them to a new KDC. slapconfig -kerberize If you have user accounts with crypt passwords and you don’t Kerberize them using the command above, you can use Workgroup Manager or the NeST command to use an Open Directory password: To use Workgroup Manager, open the application and access the directory in which the user account resides.
Web Content Copy saved web content to: Â /Library/WebServer/Documents/ Â /Library/WebServer/CGI-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 If the MySQL 4.0.18 database you’re migrating originated as a MySQL 3.23.x database and it’s still using the deprecated ISAM table format from MySQL 3.23, you must update it. ISAM is no longer supported with MySQL 4.1.
4 In Server Admin, click Settings, click Advanced, and click Database to indicate where you restored the database and mail store. 5 Click Save. 6 Open the Terminal application and use the su command to assume the identity of the root user. 7 Run the mail database upgradedb script: sudo -u cyrusimap /System/Library/ServerSetup/SetupExtras/upgradedb 8 In Server Admin, start mail service by clicking Mail, then clicking Start Service.
Note: JavaMonitor and wotaskd (WebObjects Task Daemon) services are now managed by launchd and can be accessed through the Server Admin application. If the server you’re migrating from has the startup item /System/Library/StartupItems/WebObjects, you don’t need to copy it to the new server. It’s disabled by default and isn’t necessary for autostarting WebObjects services with Mac OS X Server v10.4. See the web technologies administration guide for more information.
Note: In version 10.4, the default setting of unregistered_only in /etc/nat/ natd.plist.default changed from false to true. VPN Restore:  /Library/Preferences/SystemConfiguration/com.apple.RemoteAccessServers.plist.  /Library/Keychains/System.keychain  /etc/racoon/psk.text (if L2TP is set up and psk.text stores the IPsec shared secret; the shared secret may also be stored in com.apple.RemoteAccessServers.plist or System.
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 button and select the volume or folder you want to share. 3 Click General and select “Share this item and its contents.” 4 Click Access to set up access privileges. 5 Click Save. New share points are automatically shared using AFP, SMB, and FTP, but not NFS.
5 Migrating From Mac OS X Server Version 10.2 5 Use the instructions in this chapter when you need to migrate data from a version 10.2.8 server to a different computer running version 10.4. You can migrate data from Mac OS X Server version 10.2.8 computers that can’t be upgraded to version 10.4.7 or later. Such computers may: Â Require hard disk reformatting or replacement with a newer computer. Â Be using server hardware that doesn’t have: Â A PowerPC G4 or G5 processor. Â Built-in FireWire.
             Mail database WebMail data FTP configuration files NetBoot images WebObjects applications and frameworks Tomcat data AFP settings IP firewall configuration DNS configuration DHCP settings User data, including home directories QuickTime Streaming Server files and directories 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 t
 You 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-Step Instructions To move data from a Mac OS X Server version 10.2.8 computer to a computer with Mac OS X Server version 10.4 installed, follow the instructions in this section. 2 Create archive files of data and user export file. 1 Export user and group info. 3 Note current share points and privileges.
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.4. To export users and groups: 1 In Workgroup Manager, click Accounts, then click the globe icon below the toolbar and choose the directory from which you want to export accounts. 2 Click the lock to authenticate as domain administrator.
Web Configuration Data Save the following files and directory:  /etc/httpd/httpd.conf  /etc/httpd/httpd_macosxserver.conf  /etc/httpd/httpd_squirrelmail.conf  /etc/httpd/magic  /etc/httpd/mime.types  /etc/httpd/mime_macosxserver.types  /etc/httpd/ssl.crt  /etc/httpd/ssl.key  /etc/httpd/tomcat.conf  /etc/webperfcache/webperfcache.
FTP Configuration Files To migrate your FTP settings, save these configuration files: In this directory Save these files /Library/FTPServer/ Configuration/ ftpaccess ftpconversions ftphosts ftpgroups ftpusers /Library/FTPServer/Messages/ banner.txt welcome.txt limit.txt 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 .
DHCP Save the DHCP settings after running the following command from the Terminal application. This command writes the DHCP configuration record stored in NetInfo to a file named DHCPconfig: nidump -r /config/dhcp . > DHCPconfig Although Server Admin DHCP didn’t manage static bindings between IP addresses and Ethernet addresses in version 10.3, it does in version 10.4. So if you’ve manually configured some DHCP static bindings on your version 10.
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. If the user accounts will reside in a shared Open Directory directory, create a dynamically automounted AFP or NFS share point for the home directories.
4 Click the globe icon in the toolbar to open the directory into which you want to import accounts. 5 Click the lock to authenticate as domain administrator. 6 Choose Server > Import, select the import file, and specify import options. If you’re using a preset, make sure you identify the preset. 7 Click Import. 8 If you want groups to use new version 10.4 features such as nesting and stricter membership checking, upgrade groups using Workgroup Manager.
A log of the changes made to the files is created in /Library/Logs/Migration/ webconfigmigrator.log. The version 10.2 files in /etc/httpd/ are renamed to httpd.conf.obsolete, httpd_macosxserver.conf.obsolete, and mime_macosxserver.types.obsolete. A new httpd.conf file is created and a sites directory is created. 5 If you’ve modified /etc/httpd/workers.properties, reapply your changes to the version of the file that’s installed with server version 10.4. The version 10.4 workers.
Otherwise, browse for the database to identify its location and list its accounts. 4 Make sure there is free space on the destination disk equal to the size of the mail database. 5 You can migrate a single user or all users. To migrate mail for only one user, select the user and click Migrate User. To migrate the entire database, click Migrate All. Webmail Data Place saved address books and preferences in /var/db/squirrelmail/data/.
WebObjects Applications and Frameworks To migrate WebObjects: 1 Copy saved applications and frameworks to: Â /Library/WebObjects/ Â /System/Library/WebObjects/ 2 Add the following line to the new httpd.conf file: Include /System/Library/WebObjects/Adaptors/Apache/apache.conf 3 WebObjects application projects need to be manually updated to use the version of the Java Virtual Machine (VM) included with version 10.4. Open the project in Xcode.
9 In Server Admin, start firewall service. DNS Configuration To migrate the DNS configuration: 1 Restore the file /etc/named.conf and the directory /var/named/ and all its contents. 2 In the Terminal application, go to the directory where the DNS migration script resides cd /System/Library/ServerSetup/MigrationExtras/ 3 Run the migration script: ./48_dnsconfigmigrator DHCP Settings To migrate the DHCP configuration: 1 Restore the DHCPconfig and Machinesconfig files.
Step 9: 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. 60 Chapter 5 Migrating From Mac OS X Server Version 10.
6 Migrating From Mac OS X Server Version 10.1 6 Use the instructions in this chapter when you need to migrate data from a version10.1.4 or 10.1.5 server to a different computer running version 10.4. This chapter tells you what you can migrate, then explains how. Before You Begin Before using the instructions in this chapter, perform initial setup of the version 10.4 server to which you’ll migrate data. See the getting started guide for instructions.
 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. To set up See the NFS file services File services administration guide Windows services Windows services administration guide Print service Print service administration guide In version 10.4, watchdog has been replaced by launchd.
Step-by-Step Instructions To move data from a Mac OS X Server version 10.1.4 or 10.1.5 computer to a computer with Mac OS X Server version 10.4 installed, follow the instructions in this section. 2 Create archive files of data and user export file. 1 Export user and group info. 3 Note current share points and privileges. Shared Folders user Read & Write Engineering userdata.tar Read & Write Designs group 2017 Read Only Documents Server Admin database.tar 4 Copy archive files to new server.
Step 1: Export users and groups Use Server Admin to export user and group accounts from a NetInfo directory into an XML file that you can import into a directory for use with Mac OS X Server version 10.4. 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.
MySQL Data Mac OS X Server version 10.1 preinstalled MySQL version 3.23. Server version 10.4 preinstalls MySQL version 4.0.20. To migrate your MySQL databases from one computer to another, you can use the mysqldump command from a Terminal window. To back up the data, type: mysqldump -p table > backup-file.sql or mysqldump --opt database > backup-file.sql Additional instructions for database backup and restore can be found in the MySQL documentation at www.mysql.com.
Tomcat Data Save any Tomcat servlets you want to reuse. They’re in /Library/Tomcat/webapps/. If you’ve installed Axis independent of the version supplied with your server, save any Simple Object Access Protocol (SOAP) services. 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 .
Step 4: Copy archive files to the new server Transfer the files you saved in Steps 1 and 2 to the version 10.4 server. To transfer tar files or disk images using FTP: 1 Use Server Admin on the new server to start FTP service. 2 Set up sharing for a folder into which you’ll place files you transfer from the 10.1 computer. 3 On the version 10.1 server, use FTP service to copy the tar files or disk images to the version 10.4 computer. 4 Double-click a tar file to extract its contents.
Step 6: Import exported users and groups and other data You can use Workgroup Manager or the dsimport tool to import users and groups and other data: Â See the user management guide for details about importing by using Workgroup Manager. Â See the Open Directory administration guide for information about passwords of users originally created with Mac OS X Server version 10.1.5 or earlier.
Step 7: Relocate saved data files Place the files you saved from your version 10.1 server in their final 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.4 server. 2 Replace the /etc/httpd/ directory and its files on the version 10.4 server with the /etc/ httpd/ directory and its contents that you saved on the former server.
If the MySQL database you’re migrating uses the deprecated ISAM table format from MySQL 3.23, now is a good time to update it. Refer to the documentation on the MySQL website for migration details: www.mysql.com/doc/en/Upgrading-from-3.23.html This site suggests: Â Running mysql_fix_privilege_tables to enable new security privilege features.
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.
Note: JavaMonitor and wotaskd (WebObjects Task Daemon) services are now managed by launchd and can be accessed through the Server Admin application. If the server you’re migrating from has the startup item /System/Library/StartupItems/WebObjects, you don’t need to copy it to the new server. It’s disabled by default and isn’t necessary for autostarting WebObjects services with Mac OS X Server v10.4. See the web technologies administration guide for more information.
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/.
Chapter 6 Migrating From Mac OS X Server Version 10.
7 Migrating From Mac OS X Server Version 1.2 7 Use the instructions in this chapter when you need to migrate data from a version 1.2 server to a different computer running version 10.4. This chapter tells you what you can migrate, and then explains how. Before You Begin Before using the instructions in this chapter, perform initial setup of the version 10.4 server to which you’ll migrate data. See the getting started guide for instructions.
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.4 to import users and groups from the file. Â Workgroup Manager’s import facility and the dsimport tool also let you import other kinds of data, such as computers and computer lists.
Step-by-Step Instructions To move data from a Mac OS X Server version 1.2 computer to a computer with Mac OS X Server version 10.4 installed, follow the instructions in this section. 2 Create archive files of data and user export file. 1 Export user and group info. 3 Note current share points and privileges. Shared Folders Read & Write Engineering userdata.tar ./Mac_OS_X_Server_1.2_Export_ Tool >/partition/exportfile.xml Read & Write Designs Read Only Documents database.
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.4 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. To export user and group information: 1 Insert the installation disc.
Step 2: Create archive files Save all the data files that you want to reuse with Mac OS X Server version 10.4. In Step 4 you’ll move the files described below, as well as the export file created in Step 1, to the version 10.4 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.4 server using FTP.
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 1.2 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.
Step 6: Import users and groups and other data You can use Workgroup Manager or the dsimport tool to import users and groups and other data: Â See the user management guide for details about importing by using Workgroup Manager. Â See the Open Directory administration guide for information about passwords of users originally created with Mac OS X Server version 10.1.5 or earlier. Â See the command-line administration guide for dsimport instructions and a description of Workgroup Manager export format.
Step 7: Relocate saved data files Place the files you saved from your version 1.2 server on the version 10.4 server. FTP Configuration Files Copy saved FTP configuration files to: Â /Library/FTPServer/Configuration/ Â /Library/FTPServer/Messages/ WebObjects Applications and Frameworks To migrate WebObjects: 1 Copy saved applications and frameworks to: Â /Library/WebObjects/ Â /System/Library/WebObjects/ 2 Add the following line to the new httpd.
QuickTime Streaming Server Files and Folders Follow instructions in the QuickTime Streaming Server administration guide to reuse files and folders saved from /Library/QuickTimeStreaming/. 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 button and select the volume or folder you want to share. 3 Click General and select “Share this item and its contents.
Chapter 7 Migrating From Mac OS X Server Version 1.
8 Migrating From AppleShare IP 8 Use this chapter when you need to migrate data from an AppleShare IP (ASIP) 6.3.3 server to a different computer running version 10.4. This chapter tells you what you can migrate, and then explains how. Before You Begin Before using the instructions in this chapter, perform initial setup of the version 10.4 server to which you’ll migrate data. See the getting started guide for instructions.
Tools You Can Use Several utilities are available for use during migration: Â The AppleShare IP Migration utility can import users and groups into the local server directory. Â If you want to import users into a shared directory, create an XML export file using Web & File Admin in ASIP 6.2 or Mac OS Server Admin in ASIP 6.3. Import the file using Workgroup Manager or the dsimport tool in version 10.4.
Step-by-Step Instructions To move data from an ASIP 6.2 or 6.3 computer to a computer with Mac OS X Server version 10.4 installed, follow the instructions in this section. 1 Create Internet aliases for users. 3 Export user and group info. 2 Note current share point and privileges. Macintosh HD Shared Folders (meichen,mei) user Read & Write Engineering Read & Write mei chen group 2017 Designs Read Only Documents Users 4 Mount ASIP server on Mac OS X Server. 11 Migrate mail.
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.4, 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.
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 using the root user account, and then 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. 5 Log in to the ASIP server as an administrator, then mount the startup volume for the ASIP server.
Step 6: Copy the Users & Groups Data File To copy this file: 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.4 server, move the copy of the Users & Groups Data File to a local partition on the version 10.4 server.
6 During migration, the utility displays a progress bar and status information. When migration is complete, click Quit. 7 Examine the log files, which are located in /Library/Logs/Migration/: Â UserGroupsActions.log: Steps taken during user and group migration. Â UserGroupsExceptions.log: Steps taken or not taken during user and group migration that may require additional administrative attention.
7 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 Home, 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.
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. Step 11: Migrate mail If you want to migrate mail, use one of these techniques: Â Have users copy mail they want to save from the ASIP server to Mac OS X Server. Â Migrate the mail database to Mac OS X version 10.2, then migrate it to the version 10.4 server.
11 During migration, the utility displays a progress bar and status information. When migration is complete, click Quit. 12 Examine the log files for mail migration, which are located in /Library/Logs/Migration/: Â MailActions.log: Steps taken during mail migration. Â MailExceptions.log: Steps taken or not taken during mail migration that may require additional administrative attention. 13 Move the mail database from the version 10.2 server to the version 10.4 server.
/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.log migrating from version 10.1 69 migrating from version 10.2 56 migrating from version 10.3 41 /Library/Logs/PrintService/PrintService.admin.log upgrading version 10.2.
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 frameworks 65 setting up the home directory infrastructure 67 step-by-step instructions 63 testing the new server 73 tools you can use 62 what you can migrate 61 migrating
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 version 10.3 22 R reasons for migrating 10 requirements for migrating to version 10.4 10 for upgrading to version 10.