Apple Mac OS X manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Apple Mac OS X, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Apple Mac OS X one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Apple Mac OS X. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Apple Mac OS X should contain:
- informations concerning technical data of Apple Mac OS X
- name of the manufacturer and a year of construction of the Apple Mac OS X item
- rules of operation, control and maintenance of the Apple Mac OS X item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Apple Mac OS X alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Apple Mac OS X, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Apple service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Apple Mac OS X.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Apple Mac OS X item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

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

  • Page 2

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

  • Page 3

    3 1 C on ten ts Prefac e 5 About This Guide 5 What’ s in T his Guide 6 Using This Guide 6 Using Onscreen Help 7 The Mac OS X Ser ver Suite 8 Getting Documentation Updates 8 Getting Additional Information Chapter 1 9 Before Y ou Begin 9 Ser vers F rom Which Y ou Can Upgrade or Migrate 9 Upgrading to V ersion 1 0.4 10 Migrating From a P re-V ersion[...]

  • Page 4

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

  • Page 5

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

  • Page 6

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

  • Page 7

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

  • Page 8

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

  • Page 9

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

  • Page 10

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

  • Page 11

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

  • Page 12

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

  • Page 13

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

  • Page 14

    14 Chapter 1 Before You Begin[...]

  • Page 15

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

  • Page 16

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

  • Page 17

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

  • Page 18

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

  • Page 19

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

  • Page 20

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

  • Page 21

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

  • Page 22

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

  • Page 23

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

  • Page 24

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

  • Page 25

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

  • Page 26

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

  • Page 27

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

  • Page 28

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

  • Page 29

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

  • Page 30

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

  • Page 31

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

  • Page 32

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

  • Page 33

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

  • Page 34

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

  • Page 35

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

  • Page 36

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

  • Page 37

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

  • Page 38

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

  • Page 39

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

  • Page 40

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

  • Page 41

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

  • Page 42

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

  • Page 43

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

  • Page 44

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

  • Page 45

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

  • Page 46

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

  • Page 47

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

  • Page 48

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

  • Page 49

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

  • Page 50

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

  • Page 51

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

  • Page 52

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

  • Page 53

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

  • Page 54

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

  • Page 55

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

  • Page 56

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

  • Page 57

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

  • Page 58

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

  • Page 59

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

  • Page 60

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

  • Page 61

    6 61 6 Migrating F rom Mac OS X Ser v er V ersion 1 0. 1 Use the instructions in this chapter when you need to migrate da ta from a v ersion1 0. 1 . 4 or 1 0. 1 .5 ser ver to a diff erent computer running v ersion 1 0. 4. This chapter tells y ou what you can migrate , then explains how . Befor e Y ou Begin Before using the instructions in this chap[...]

  • Page 62

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

  • Page 63

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

  • Page 64

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

  • Page 65

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

  • Page 66

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

  • Page 67

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

  • Page 68

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

  • Page 69

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

  • Page 70

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

  • Page 71

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

  • Page 72

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

  • Page 73

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

  • Page 74

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

  • Page 75

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

  • Page 76

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

  • Page 77

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

  • Page 78

    78 Chapter 7 Migrating From Mac OS X Server Version 1.2 Step 1: Expor t user and group information Y ou use a command-line tool called Mac_OS_X_Server_1.2_Export_Tool to export user and group information. The tool is located on the v ersion 1 0.4 server installation disc in /W elcome to Mac OS X Server/M igration T ools/. When you run the tool, you[...]

  • Page 79

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

  • Page 80

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

  • Page 81

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

  • Page 82

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

  • Page 83

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

  • Page 84

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

  • Page 85

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

  • Page 86

    86 Chapter 8 Migrating From AppleShare IP T ools Y ou Can Use Several utilities are a vailable for use during migration: Â The AppleShare IP Migration utility can impor t users and groups into the local server director y . Â If you want to import users into a shared directory , create an XML expor t file using W eb & F ile Admin in ASIP 6.2 o[...]

  • Page 87

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

  • Page 88

    88 Chapter 8 Migrating From AppleShare IP If you have a primary ASIP ser ver and one or more secondary ASIP ser vers and you want to migrate all of them t o version 1 0.4, synchronize all secondary ser vers with the primar y ser ver befor e star ting migration. Migrate the primary ser ver , then migrate the secondary ser vers. When migrating second[...]

  • Page 89

    Chapter 8 Migrating From AppleShare IP 89 Step 4: Mount the ASIP ser ver on Mac OS X Server T o mount the ASIP server: 1 On the ASIP ser ver , disconnect all users and administrators and shut down the mail ser ver . 2 On Mac OS X Ser ver , log in using the root user account , and then turn off all services using Ser ver Admin. 3 Choose Go > Conn[...]

  • Page 90

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

  • Page 91

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

  • Page 92

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

  • Page 93

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

  • Page 94

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

  • Page 95

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

  • Page 96

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

  • Page 97

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