System Imaging and SW Update Admin v10.6
System Imaging and SW Update Admin v10.6
Every effort has been made to ensure that the PowerPC™ and the PowerPC logo™ are trademarks
information in this manual is accurate. Apple Inc., is not of International Business Machines Corporation, used
responsible for printing or clerical errors. under license therefrom.
3
26 Chapter 2: Creating NetBoot and NetInstall Images
26 Using System Image Utility
26 Creating Images
27 Creating NetBoot Images
28 Creating NetInstall Images
29 Creating NetRestore Images
30 Creating an Image from a Configured Computer
32 Updating an Image
33 Understanding Workflows
33 Workflow Components
33 Configuring the Customize Package Selection Action
34 Configuring the Define Image Source Action
34 Configuring the Add Packages and Post-Install Scripts Action
35 Configuring the Add User Account Action
35 Configuring the Apply System Configuration Settings Action
36 Configuring the Create Image Action
37 Configuring the Enable Automated Installation Action
37 Configuring the Filter Clients by MAC Address Action
38 Configuring the Filter Computer Models Action
38 Configuring the Partition Disk Action
39 Assembling Workflows
39 Adding Existing Workflows
39 Removing Workflows
40 Assembling an Image Workflow
41 Adding Software to NetBoot and NetInstall Images
41 About Packages
42 Creating Packages
42 Viewing the Contents of a Package
4 Contents
50 Configuring NetBoot Logging Settings
50 Enabling NetBoot 1.0 for Older NetBoot Clients
51 Starting NetBoot and Related Services
52 Managing Images
52 Enabling Images
52 Choosing Where Images Are Stored
54 Choosing Where Shadow Files Are Stored
56 Using Images Stored on Remote Servers
56 Specifying the Default Image
57 Setting an Image for Diskless Booting
58 Restricting NetBoot Clients by Filtering Addresses
59 Setting Up NetBoot Service Across Subnets
Contents 5
Part II: Software Update Administration
76 Chapter 7: Understanding Software Update Administration
77 Inside the Software Update Process
77 Overview
77 Catalogs
77 Installation Packages
78 Staying Up-To-Date with the Apple Server
78 Limiting User Bandwidth
78 Revoked Files
79 Software Update Package Format
79 Log Files
79 Information That Is Collected
79 Tools for Managing Software Update
80 Server Admin
80 Workgroup Manager
80 Command-Line Tools
6 Contents
92 Automatically Copying and Enabling Updates from Apple
92 Copying and Enabling Selected Updates from Apple
93 Removing Obsolete Software Updates
94 Identifying Individual Software Update Files
96 Appendix: Command-Line Parameters
96 NetBoot Service Settings
97 The Storage Record Array
97 The Filters Record Array
98 The Image Record Array
99 The Port Record Array
100 Index
Contents 7
8
About This Guide
Preface
This guide describes how to configure and use NetBoot and
NetInstall images within Mac OS X Server. It also describes
Software Update service, which you can set up using
Mac OS X Server.
Mac OS X Server version 10.6 includes NetBoot service supporting NetBoot and
NetInstall images and the improved System Image Utility—a stand-alone utility used
to create Install and Boot images used with NetBoot service.
Mac OS X Server v10.6 also includes Apple’s Software Update service. It is designed as a
source for Apple Software Updates managed on your network. With Software Update,
you can directly manage which Apple software updates users on your network can
access and apply to their computers.
9
What’s in This Guide
This guide includes the following sections:
ÂÂ Part I: System Imaging Administration. The chapters in this part of the guide
introduce you to system imaging and the applications and tools available for
administering System Image Utility.
ÂÂ Part II: Software Update Administration. The chapters in this part of the guide
introduce you to Software Update and the applications and tools available for
administering it.
Note: Because Apple periodically releases new versions and updates to its software,
images shown in this book may be different from what you see on your screen.
File Server
Administration
Explains how to share
server volumes or folders
among server clients
using the AFP, NFS, FTP,
and SMB protocols.
You may want to enlarge the printed pages even if you don’t print double sided,
because the PDF page size is smaller than standard printer paper. In the Print dialog
or Page Setup dialog, try changing Scale to 115% (155% for Getting Started, which has
CD-size pages).
You can also choose to not install software and have client computers start (or boot)
from an image stored on the server. (In some cases, clients don’t even need their own
hard disk.)
Using NetBoot and NetInstall, your client computers can start from a standardized
Mac OS configuration suited to specific tasks. Because the client computers start from
the same image, you can quickly update the operating system for users by updating a
single boot image.
A boot image is a file that looks and acts like a mountable disk or volume. NetBoot
images contain the system software needed to act as a startup disk for client
computers over the network.
An installation image is an image that starts up the client computer long enough to
install software from the image. The client can then start up from its own hard disk.
Boot images (used with NetBoot) and installation images (used with NetInstall) are
different kinds of disk images. The main difference is that a .dmg file is a proper disk
image and a .nbi folder is a bootable network volume (which contains a .dmg disk
image file). Disk images are files that behave like disk volumes.
16
You can set up multiple NetBoot or NetInstall images to suit the needs of different
groups of clients or you can provide copies of the same image on multiple NetBoot
servers to distribute the client startup load. You can also use a NetRestore image to
quickly restore a volume.
NetBoot service can be used with NetBoot and NetInstall images along with Mac OS X
client management services to provide a personalized work environment for each user.
For information about client management services, see User Management.
You can use the following Mac OS X Server applications to set up and manage
NetBoot, NetInstall, and NetRestore:
ÂÂ System Image Utility to create Mac OS X NetBoot, NetInstall, and NetRestore disk
images. This utility is installed with Mac OS X Server software in the /Applications/
Server/ folder.
ÂÂ Server Admin to enable and configure NetBoot service and supporting services. This
utility is installed with Mac OS X Server software in the /Applications/Server/ folder.
ÂÂ PackageMaker to create package files that you use to add software to disk images.
This utility is provided on the Mac OS X Server Administration Tools CD.
ÂÂ Property List Editor to edit property lists such as NBImageInfo.plist. This utility is
included on the Mac OS X Server Administration Tools CD.
Note: To create an image, you must have valid Mac OS X v10.6 image sources
(either volumes or install DVDs). You cannot create an image of the startup disk
you are running on.
Disk Images
The disk images contain the system software and applications used over the network
by client computers. These tools can be installed on a client computer with the
Mac OS X Server Administration Tools CD. The name of a disk image file typically ends in
.img or .dmg. Disk Utility—part of Mac OS X—can mount disk image files as volumes
on the desktop.
You use System Image Utility to create Mac OS X NetBoot or NetInstall images, using
a Mac OS X installation disc or an existing system volume as the source. See “Creating
Images” on page 26.
NetBoot service creates share points for storing NetBoot and NetInstall images in
/Library/NetBoot/ on each volume you enable and names them NetBootSPn, where
n is 0 for the first share point and increases by 1 for each extra share point.
For example, if you decide to store images on three server disks, NetBoot service sets
up three share points named NetBootSP0, NetBootSP1, and NetBootSP2.
The share points for client shadow files are also created in /Library/NetBoot/ and are
named NetBootClientsn, where n is the share point number.
You can create and enable NetBootSPn and NetBootClientsn share points on other
server volumes using the NetBoot Service General settings in Server Admin.
WARNING: Don’t rename a NetBoot share point or the volume it resides on. Don’t
stop sharing a NetBoot share point unless you first deselect the share point for
images and shadow files in Server Admin.
Shadow Files
Many clients can read from the same NetBoot image, but when a client must write
back to its startup volume (such as print jobs and other temporary files), NetBoot
service redirects the written data to the client’s shadow files, which are separate from
regular system and application software.
Shadow files preserve the unique identity of each client while it is running from a
NetBoot image. NetBoot service transparently maintains changed user data in shadow
files while reading unchanged data from the shared system image. Shadow files are
recreated at startup, so changes made to a user’s startup volume are lost at restart.
File Description
booter Startup file that the firmware uses to begin the
startup process
mach.macosx UNIX kernel
mach.macosx.mkext Drivers
System.dmg Startup image file (can include application
software)
NBImageInfo.plist Property list file
System Image Utility stores the folder whose name ends with .nbi on the NetBoot
server in /Library/NetBoot/NetBootSPn/image.nbi (where n is the volume number and
image is the name of the image). You can save directly to this folder or you can create
the image elsewhere (even on another computer) and copy it to the /Library/NetBoot/
NetBootSPn folder later.
You use System Image Utility to set up NetBoot image folders. The utility lets you:
ÂÂ Name the image
ÂÂ Choose the image type (NetBoot or NetInstall)
ÂÂ Provide an image ID
ÂÂ Choose the default language
ÂÂ Choose the computer models the image supports
ÂÂ Create unique sharing names
ÂÂ Specify a default user name and password
ÂÂ Enable automatic installation for installation images
ÂÂ Add package or preinstalled applications
Initial values in NBImageInfo.plist are set by System Image Utility and you usually don’t
need to change the property list file directly. Some values are set by Server Admin. If
you must edit a property list file, you can use TextEdit or Property List Editor, found in
the Utilities folder on the Mac OS X Server Administration Tools CD.
NetBoot clients obtain their IP information from a DHCP server and their NetBoot
information from BSDP. BSDP offers built-in support for load balancing. See
“Performance and Load Balancing” on page 67.
If BootP clients on your network request an IP address from the NetBoot BootP server,
this request fails because the NetBoot BootP server doesn’t have addresses to offer. To
prevent the NetBoot BootP server from responding to requests for IP addresses, use
the dscl command-line tool to open the local folder on the NetBoot server and add a
key named bootp_enabled with no value to the /config/dhcp/ folder.
Boot Files
When you create a Mac OS X NetBoot image with System Image Utility, the utility
generates the following boot files and stores them on the NetBoot server in /Library/
NetBoot/NetBootSPn/image.nbi (where n is the volume number and image is the
name of the image):
ÂÂ booter
ÂÂ mach.macosx
ÂÂ mach.macosx.mkext
Note: If you turn on NetBoot service when installing Mac OS X Server, the installer
creates the NetBootSP0 share point on the server boot volume. Otherwise, you can set
up NetBootSPn share points by choosing where to store NetBoot images from the list
of volumes in the General pane of NetBoot Service settings in Server Admin.
Client computers access the startup software on the NetBoot server from the location
where the image was saved.
The hardware address of a client computer is added to the NetBoot Filtering list
when the client starts up using NetBoot and is, by default, enabled to use NetBoot
service. You can specify other services. See “Restricting NetBoot Clients by Filtering
Addresses” on page 58.
NetInstall Images
A NetInstall image is an image that starts up the client computer long enough to
install software from the image. The client can then start up from its own hard disk.
In the same way that a NetBoot image replaces the role of a hard disk, a NetInstall
image is a replacement for an installation DVD.
Like a bootable CD, NetInstall is a convenient way to reinstall the operating system,
applications, or other software onto the local hard disk. For system administrators
deploying large numbers of computers with the same version of Mac OS X, NetInstall
can be very useful. NetInstall does not require the insertion of a CD into each NetBoot
client because startup and installation information is delivered over the network.
When you create a NetInstall image with System Image Utility, you can automate the
installation process by limiting interaction at the client computer.
For more information about preparing NetInstall images to install software over the
network, see “Creating NetInstall Images” on page 28.
These applications are included with Mac OS X Server and can be installed on another
computer with Mac OS X v10.6 or later, making that computer an administrator
computer. For more information about setting up an administrator computer, see the
server administration chapter of Getting Started.
Server Admin
Server Admin provides access to tools you use to set up, manage, and monitor
NetBoot service and other services. You use Server Admin to:
ÂÂ Set up Mac OS X Server as a DHCP server and configure NetBoot service to use
NetBoot and NetInstall images. For instructions, see Chapter 3, “Setting Up NetBoot
Service.”
ÂÂ Manage and monitor NetBoot service. For instructions, see Chapter 5, “Managing
NetBoot Service.”
For more information about using Server Admin, see Advanced Server Administration.
This guide includes information about:
ÂÂ Opening and authenticating in Server Admin
ÂÂ Working with specific servers
ÂÂ Administering services
ÂÂ Using SSL for remote server administration
ÂÂ Customizing the Server Admin environment
Workgroup Manager
The Workgroup Manager application provides comprehensive management of clients
of Mac OS X Server. For basic information about using Workgroup Manager, see User
Management. This includes:
ÂÂ Opening and authenticating in Workgroup Manager
ÂÂ Administering accounts
ÂÂ Customizing the Workgroup Manager environment
For instructions on using System Image Utility, see Chapter 2, “Creating NetBoot and
NetInstall Images.”
Command-Line Tools
A full range of command-line tools is available for administrators who prefer to
use command-driven server administration. For remote server management,
submit commands in a secure shell (SSH) session. You can enter commands on
Mac OS X servers and computers using the Terminal application, located in the
/Applications/Utilities/ folder.
You can set up multiple NetBoot or NetInstall images to suit the needs of different
groups of users or to provide copies of the same image on multiple servers to
distribute the client startup load. You can also set up NetRestore images to restore
Mac OS X volumes. Using NetBoot service, you can provide a personalized work
environment for each user.
Creating Images
To create system and software images to use with NetBoot service or the asr tool,
use System Image Utility.
Note: To create an image, you must have valid Mac OS X v10.6 image sources (volumes
or installation DVDs). You cannot create an image of the startup disk you are running on.
26
Creating NetBoot Images
You can create NetBoot images of Mac OS X that are then used to start client
computers over the network.
You can also assemble a workflow to create a NetBoot image that permits
advanced customization of your images. For more information, see “Understanding
Workflows” on page 33.
Note: You must purchase a Mac OS X user license for each client that starts from a
NetBoot or NetInstall disk image.
Important: Do not attempt to edit content in the image destination folder while the
image is being created.
You can also use the asr tool to restore a system image onto a volume or to clone
volumes.
You must start up from a volume other than the one you’re using as the image source.
For example, you could start up from an external FireWire hard disk or a second
partition on the client computer hard disk. You can’t create the image on a volume
over the network.
You can also assemble a workflow to create a NetRestore image that permits
advanced customization of your images. For more information, see “Understanding
Workflows” on page 33.
You must start up from a volume other than the one you’re using as the image source.
For example, you could start up from an external FireWire hard disk or a second
partition on the client computer hard disk. You can’t create the image on a volume
over the network.
For information about how to manipulate disk images, see the hdiutil man page.
For the basics of command-line tool usage, see Introduction to Command-Line
Administration.
Updating an Image
To update a Mac OS X disk image, you must recreate the image. New images can easily
be recreated by running a saved image creation workflow. For more information, see
“Creating Images” on page 26.
For information about installer, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
Each action performs a single task, such as customizing a software package or adding
a user account.
Workflow Components
System Image Utility comes preloaded with a library of actions. You can use these
actions to customize settings when creating an image. You access and organize this
Automator Library of actions within the workflow panes of System Image Utility.
The following sections describe the workflow actions available in the Automator
Library and provide steps on how to configure their options. By themselves, these
actions cannot create an image and must be assembled into a workflow to function.
For more information, see “Assembling Workflows” on page 39.
This action is valid when creating NetBoot, NetInstall, and NetRestore images.
This action is valid when creating NetBoot, NetInstall, and NetRestore images.
WARNING: Using the Erase option removes all data from the target volume. Back up
all data before using this option.
4 From the Primary Language pop-up menu, choose the image language.
WARNING: Partitioning a disk removes all data. Back up all data before using this action.
5 In the Name field enter a name for the new volume (partition).
6 From the Format pop-up menu, select the volume format.
7 Set the size of the volume by choosing one of the following.
ÂÂ Choose “Percentage of available disk” from the Size pop-up menu and enter a
percentage. Select Minimum and enter the smallest size in GB for the volume
(minimum size is only available if using percentage).
ÂÂ Choose “Absolute size” from the Size pop-up menu and enter the size in GB.
8 To prevent the information from being updated when the disk is partitioned,
select “Locked for editing.”
Each action has options and settings you can configure. System Image Utility connects
these action components with the types of data that are flowing from one action
to another.
Removing Workflows
You can remove workflows from System Image Utility.
An image workflow must start with the Define Image Source action and end with
the Create Image action. Also, all actions in a workflow must be connected. If not, the
workflow is invalid and the actions are not processed.
To create or edit a workflow, use System Image Utility. For more information, see the
automator man pages and the following sections:
About Packages
To add application software or other files at image creation (instead of installing
applications or files on the image source volume before you create the image),
you must group the applications or files in a special file known as a package.
For more information about creating packages, open PackageMaker and choose
PackageMaker Help, PackageMaker Release Notes, or Package Format Notes from the
Help menu.
After creating packages, add them to your NetBoot or NetInstall image using System
Image Utility workflows.
You use PackageMaker (included on the Mac OS X Server Administration Tools CD) to
create application software packages to use with NetInstall images.
For information about ls, see its man page. For the basics of command-line tool usage,
see Introduction to Command-Line Administration.
Use Server Admin to configure the NetBoot service in conjunction with System Image
Utility to create and edit images.
Setup Overview
Here is an overview of the basic steps for setting up NetBoot service.
Step 1: Evaluate and update your network, servers, and client computers as
necessary.
The number of client computers you can support using NetBoot is determined by
the number of servers you have, how they’re configured, hard disk storage capacity,
and other factors. See “Capacity Planning” on page 46.
Depending on the results of this evaluation, you might want to add servers or hard
disks, add Ethernet ports to your server, or make other changes to your servers. You
might also want to set up more subnets for BootP clients, depending on the number
of clients you support.
You might also want to implement subnets on this server (or other servers) to take
advantage of NetBoot filtering.
43
You might also want to restrict access to NetBoot images by using Model Filtering.
See “Creating NetBoot Images” on page 27.
To create application packages that you can add to an image, use PackageMaker.
Application software packages can be installed by themselves or with Mac OS X
system software. See “Creating Packages” on page 42.
If your NetBoot server also supplies DHCP service, you might get better performance
if you configure your server as a gateway. That is, configure your subnets to use the
server’s IP address as the router IP address.
You turn on NetBoot service using Server Admin. See “Starting NetBoot and Related
Services” on page 51 and “Enabling Images” on page 52.
You can use the client computer’s Startup Disk System Preference pane to select a
startup disk image from the server and then restart the computer. See “Selecting a
NetBoot Boot Image” on page 60.
You can also restart the client computer and hold down the N key until the NetBoot
icon starts flashing on the screen. The client starts from the default image on the
NetBoot server. See “Starting Up Using the N Key” on page 62.
You might need to work with your networking staff to change network topologies,
switches, routers, and other network settings.
You must install the latest firmware updates on all client computers. Firmware updates
are available from the Apple support website: www.apple.com/support/.
To update a Mac OS X disk image, you must recreate the image. New images can easily
be recreated by running a saved image creation workflow. For more information, see
“Creating Images” on page 26.
These are estimates for the number of clients supported. For more details of the
optimal system and network configurations to support the number of clients you have,
see “Capacity Planning” on page 46.
Capacity Planning
The number of NetBoot client computers your server can support depends on how
your server is configured, when your clients routinely start, the server’s hard disk space,
and a number of other factors. When planning for your server and network needs,
consider these factors:
ÂÂ Ethernet speed: 100Base-T or faster connections are required for client computers
and the server. As you add clients, you might need to increase the speed of your
server’s Ethernet connections.
Ideally you want to take advantage of the Gigabit Ethernet capacity built in to your
Mac OS X server hardware to connect to a Gigabit switch. From the switch, connect
Gigabit Ethernet or 100-Mbit Ethernet to each NetBoot client.
If you plan on serving Network Install images for installing Mac OS X and Mac OS X
Server, also make sure that you have a site license.
If you plan on serving Network Install images for installing Mac OS X Server, you can
use the Mac OS X Server Assistant to generate a setup file that you can add to the
Network Install image so the server knows how to configure itself automatically.
If you use a generic file, you’ll need to enter the serial number manually using
Server Admin.
The following sections describe the tasks for configuring these settings and how to
start NetBoot service after you configure it.
You can enter a MAC address as canonical or noncanonical in the filter list. The
canonical form of a MAC address contains leading zeros and lowercase hex digits
separated by a “:”. For example, 01:a1:0c:32:00:b0 is the canonical form of a MAC address
and 1:a1:c:32:0:b0 is the noncanonical form of the same MAC address.
Parameter Description
logging_level Default = Medium
Possible values are Low, Medium, or High.
Note: NetBoot 1.0 and 2.0 can run on the same network simultaneously.
Parameter Description
port_list List of ports you want to enable for NetBoot 1.0,
formatted like en0 en1 en2.
If you get the following response, you have not yet enabled NetBoot on a network port:
$ netboot:state = "STOPPED"
$ netboot:status = 5000
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
Enabling Images
You must enable disk images on your server to make the images available to client
computers for NetBoot startups.
Parameter Description
netBootImagesRecordsArray:_array_ Default = no
index:<n>:IsEnabled Sets whether the image is available to NetBoot.
WARNING: Don’t rename a NetBoot share point or the volume it resides on. Don’t
use Server Admin to stop sharing for a NetBoot share point unless you first deselect
the share point for images and shadow files.
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
WARNING: Don’t rename a NetBoot share point or the volume it resides on. Don’t
use Server Admin to stop sharing for a NetBoot share point unless you first deselect
the share point for images and shadow files.
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
If you’ve created more than one startup disk image, you can use NetBoot service
settings in Server Admin to select the default startup image.
Important: If you have diskless clients, set their boot image as the default image.
If you have more than one NetBoot server on the network, a client uses the default
image from the first server that responds. There is no way to control which default
image is used when more than one is available.
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
To provide NetBoot service across subnets, you must configure the router to pass on
BSDP traffic to the NetBoot server. To see if your router is capable of passing BSDP
traffic, check with your router manufacturer. Sometimes this is also referred to as using
a DHCP helper or a DHCP relay agent.
After NetBoot service and images are configured on the server, you must set up the
client computers to access and use the images.
After the client computer starts, you can use Startup Disk preferences to select the
NetBoot disk image as the startup disk for the client. That way you no longer need to
use the N key method to start the client from the server.
Removing the system software from client computers gives you more control over
user environments. By forcing the client to start up from the server and using client
management to deny access to the client computer local hard disk, you can prevent
users from saving files to the local hard disk.
60
From the command line:
mm To select a NetBoot startup image:
> setenv boot-file enet:YourServerIPAddress,NetBoot\NetBootsSP*\<name of
.nbi folder>\mach.macosx
> setenv boot-args rp=nfs: YourServerIPAddress:/private/tftpboot/NetBoot/
NetBootSP*:<name of .nbi folder>/<Name of image>.dmg
> setenv boot-device enet: YourServerIPAddress,NetBoot\NetBootSP*\<name
of .nbi folder>\booter
> mac-boot
mm To choose a boot device:
$ sudo systemsetup -setstartupdisk /volume/Disk\ 2/System/Library/
CoreServices
Parameter Description
volume The path to the boot device.
For information about systemsetup, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
Each client can receive the restore image at any time during a multicast of the image,
and the client continues receiving the first part of the next multicast until the client
receives the complete restore image.
The server multicasts only one copy of the restore image at a time, and all clients
receive this copy.
If the server finishes multicasting the restore image and a client is still requesting the
image, the server multicasts the image again. Thus, using multicast asr to stream
images to multiple clients doesn’t congest the network nearly as much as Network
Install with multiple clients.
To enable the image server, use the asr tool with the -server flag and a correctly
built image and plist file.
The image does not start multicasting on the network until a client attempts to start a
restore. The server continues to multicast the image until the process is terminated.
The client receives the multicast stream from <hostname> and saves it to the client.
To overwrite an existing image, add -erase. Using -erase with -target indicates an
image should be overwritten when doing a multicast.
Note: For more information about using the N key when starting the system, see the
manual that was provided with the computer. Some computers have extra capabilities.
The N key also provides a way to start up client computers that don’t have system
software installed. See “Setting Up Diskless Clients” on page 60.
For Mac OS X v10.3 and later images set for diskless booting, you can change this
behavior by using a text editor to specify a value for the NETBOOT_SHADOW variable in
the image /etc/hostconfig file.
Note: This value is set in the /etc/hostconfig file in the image .dmg file, not in the
server hostconfig file.
You can manage NetBoot service using Server Admin. Server Admin enables you to
verify the overall status of the connection, to review logs, to control clients, and to
manage boot and installation images. You can use System Image Utility to distribute
boot images across servers for load balancing.
To stop NetBoot:
1 Open Server Admin and connect to the server.
2 Click the triangle at the left of the server.
The list of services appears.
3 From the expanded Servers list, select NetBoot.
4 Click the Stop NetBoot button (below the Servers list) and perform one of the
following tasks:
ÂÂ To stop service on a specific Ethernet port, click Settings, click General, and deselect
the Enable checkbox for the port.
ÂÂ To stop serving a specific image, click Settings, click Images, and deselect the Enable
checkbox for the image.
ÂÂ To stop service to a client, click Settings, click Filters, select Enable NetBoot Filtering,
choose “Deny only clients listed below,” and add the client’s hardware address to the list.
64
From the command line:
mm To stop NetBoot service or disable images:
$ sudo serveradmin stop netboot
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
For information about serveradmin, see its man page. For the basics of command-line
tool usage, see Introduction to Command-Line Administration.
For information about tail and serveradmin, see their man pages. For the basics of
command-line tool usage, see Introduction to Command-Line Administration.
Many sites using NetBoot service achieve acceptable responsiveness by staggering the
boot times of client computers to reduce network load. Generally, it isn’t necessary to
boot client computers at the same time; rather, client computers are booted early in
the morning and remain booted throughout the work day.
You can program staggered startup times using the Energy Saver preferences pane.
Note: You must customize the image by creating a workflow with the Create Image
action to assign the image an index ID.
Clients still see the image listed only once in Startup Disk preferences, but the server
that delivers its copy of the image is selected based on server activity.
Important: Don’t distribute images across different partitions of the same physical disk
drive. Doing so does not improve, and can even reduce, performance.
where [admin_name] is an admin login and [ip_address] is the correct IP address for
that server.
You are prompted for the password of the admin login you supply.
You can also force redistribution of the load by deleting the /var/db/bsdpd_clients file
from the existing NetBoot server.
Note: After deleting the bsdpd_clients file, the server does not remember which
clients selected which NetBoot or NetInstall volumes via Startup Disk. Unless the
clients reselect their intended NetBoot or NetInstall volumes, the clients will boot into
the default image on the server.
Similarly, if you’re recovering from a server or infrastructure failure and your clients
have been starting up from a reduced number of NetBoot servers, delete the
bsdpd_clients file from the running servers so clients can again start from among the
entire set of servers.
The bsdpd_clients file holds the Ethernet MAC addresses of the computers that have
selected the server as their NetBoot server.
Note: If a client is registered on more than one server because an unavailable server
comes back on line, the client starts up from the server with the fewest number of
clients that started from it.
By default, NetBoot for Mac OS X clients creates a share point for client shadow files on
the server boot volume. (You can change this behavior. See “Choosing Where Shadow
Files Are Stored” on page 54.)
You can use Server Admin to see this share point and to add others. The share points
are named NetBootClientsn where n is the share point number.
Share points are numbered starting with zero. For example, if your server has two disk
volumes, the default shadow-file folder is NetBootClients0 on the boot volume. If you
use Server Admin to specify that client data will also be stored on the second volume,
the folder is named NetBootClients1. NetBoot stores the first client’s shadow files on
NetBootClients0, the second client’s shadow files on NetBootClients1, the third client’s
shadow files on NetBootSP0, and so on.
Likewise, with three volumes and eight clients, the first, fourth, and seventh clients
use the first volume; the second, fifth, and eighth clients use the second volume; and
the third and sixth clients use the third volume. This load balancing is automatic and
usually provides optimal performance.
To prevent shadow files from being placed on a specific volume, use the NetBoot
Service General settings in Server Admin. Deselect the client data checkbox for any
volume you don’t want shadow files placed in.
You can also prevent shadow files from being placed on a specific volume or partition
by deleting the hidden file /Library/NetBoot/.clients, which is a symbolic link, and then
stopping and restarting NetBoot service.
General Tips
ÂÂ Make sure a DHCP service is available on your network. It can be provided by the
Mac OS X Server DHCP service or another server.
ÂÂ Make sure required services are started on the server. See “Network Service
Requirements” on page 46. Open Server Admin and verify the following:
ÂÂ If you’re booting Mac OS X diskless clients, AFP is started
ÂÂ If you’re using HTTP instead of NFS to deliver images, Web service is started
71
If You Want to Change the Image Name
You can’t edit the name of an image with System Image Utility after you create it.
However, there are other ways to change the name, as shown in the following sections.
Replace image with the name of the image you want to rename and new_name with
the new name of the image.
3 When prompted, enter your administrator password.
The name of the image changes.
4 Unmount the image.
5 Remount the image to verify that it has been renamed.
Replace image with the name of the image you want to rename and new_name with
the new name of the image.
11 When prompted, enter your administrator password.
The name of the image changes.
12 Unmount the image.
13 Remount the image to verify that the image has been renamed.
14 Unmount the image.
15 Remove the original image from the .nbi folder and store it somewhere else.
16 In Disk Utility, select the new image and click Convert.
17 Give the image the same name as the one it had inside the .nbi folder.
18 In the Where field, select the .nbi folder.
19 From the Format menu, choose Compressed.
20 Click Save.
21 Test the new image to make sure it mounts properly.
22 Discard the old image.
Using local Software Update servers, your client computers access only the software
updates you permit from software lists that you control, improving your ability to
manage computer software updates. For example you can:
ÂÂ Download software updates from the Apple Software Update servers to a local
server for sharing with local network clients and reduce the amount of bandwidth
used outside your enterprise network.
ÂÂ Direct users, groups, and computers to specific local Software Update servers using
managed preferences.
ÂÂ Manage the software update packages users can access by enabling and disabling
packages at the local server.
ÂÂ Mirror updates between Apple Software Update servers and your server to make
sure you have the most current updates.
Note: Software Update does not update software on the server. For information about
keeping your server software current, see Advanced Server Administration.
76
Inside the Software Update Process
This section describes how Software Update servers are implemented on Mac OS X,
including information about the protocols, files, folder structures, and configuration
details.
Overview
The process that starts Software Update is swupd_syncd. When you start Software
Update, it contacts Apple’s Software Update server and requests a list of available
software to download locally.
You can copy (store packages locally) and enable (make the packages available to
users) any files in the list. You can also limit user bandwidth for updates and choose to
automatically copy and enable newer updates from the Apple server.
Catalogs
When Software Update starts, your Software Update server receives a list of available
software updates from the Apple Software Update service. Your server synchronizes
the contents of the software catalog with Apple’s Software Update server when you
restart your server or when you enter the following command:
$ sudo /usr/sbin/swupd_syncd -sync
To manually update the catalog, select the Refresh button in the Updates pane of
Software Update settings.
Changes in the Apple published catalog are immediately reflected on your local
server. Deprecated software packages are automatically disabled when a replacement
package for that update is enabled. An administrator can disable the new software
package and continue offering the deprecated package.
Installation Packages
Software Update supports pkm.en and .tar file types, recognized only by Mac OS X
v10.4 and later. As you copy updates on your server, your server downloads and stores
update packages in the /var/db/swupd/html/ folder.
The Apple Software Update server executes the swupd_syncd synchronization daemon
to make sure the latest update packages are available. The scheduled execution of
swupd_syncd is controlled by launchd by means of the StartCalendarInterval setting at
/System/Library/LaunchDaemons/com.apple.swupdate.sync.plist.
Setting a limit on the bandwidth enables you to control traffic on your network and
prevents Software Update clients from slowing the network. For example, if you limit
the bandwidth to 56 Kbps, each software update client can download updates at 56
Kbps. If five clients connect simultaneously to the server, the total bandwidth used by
the clients will be 280 Kbps (56 Kbps x 5).
Revoked Files
On a rare occasion Apple might provide a software update and want to revoke or
deprecate a package from circulation.
If Apple revokes the update package, the package is removed from your catalog and
stored packages, making it unavailable to clients
If Apple deprecates a software package and provides a replacement package, the older
software package is disabled, making it unavailable to clients. The package remains in
your catalog and stored packages until you remove it.
An administrator can disable the new software package and continue offering the
deprecated package.
In addition, Software Update works only with the new package format supported in
Mac OS X Server v10.4 or later.
Log Files
The log files for Software Update are located in the /var/log/swupd/ folder. The log
files record Software Update events as they occur.
The logs can be viewed in Server Admin in the Software Update Logs panel or using
the Console application located in the /Applications/Utilities/ folder.
These applications are included with Mac OS X Server and can be installed on another
computer with Mac OS X v10.6 or later, making that computer an administrator
computer. For more information on setting up an administrator computer, see the
server administration chapter of Getting Started.
For more information about using Server Admin, see Advanced Server Administration.
This includes information about:
ÂÂ Opening and authenticating in Server Admin
ÂÂ Working with specific servers
ÂÂ Administering services
ÂÂ Using SSL for remote server administration
ÂÂ Customizing the Server Admin environment
Workgroup Manager
Workgroup Manager provides comprehensive management of clients of Mac OS X
Server. You use Workgroup Manager to set preferences by user, group, or computer
to access your Software Update server. For more information about how to configure
managed preferences for the Software Update server, see User Management.
For basic information about using Workgroup Manager, see User Management. This
includes:
ÂÂ Opening and authenticating in Workgroup Manager
ÂÂ Administering accounts
ÂÂ Customizing the Workgroup Manager environment
Command-Line Tools
A full range of command-line tools is available for administrators who prefer to
use command-driven server administration. For remote server management,
submit commands in a secure shell (SSH) session. You can enter commands on
Mac OS X servers and computers using the Terminal application, located in the
/Applications/Utilities/ folder.
You use Software Update in Server Admin to provide local software updates to client
computers.
Setup Overview
Here is an overview of the basic steps for configuring your Software Update server.
This includes setting up Software Update service, configuring client computer access
to the server, and testing.
Step 1: Evaluate and update your network, servers, and client computers as
necessary.
The number of client computers you can support using Software Update is
determined by the number of servers you have, how they’re configured, hard disk
storage capacity, and other factors. See “Capacity Planning” on page 83.
Depending on the results of this evaluation, you might want to add servers or hard
disks, add Ethernet ports, or make other changes to your servers.
For your client computers to use the local Software Update service, you must update
them to Mac OS X v10.4 or later.
You might have groups who need unlimited access while others might need a more
limited choice of software updates. Such a plan requires more than one Software
Update server with client computers bound using directory services to manage user
preferences.
81
Step 3: Configure the Software Update server.
Decide how you want to copy and enable software updates from Apple: automatically
or manually. Set the maximum bandwidth you want a single computer to use when
downloading update packages from your server. See “Setting Up Software Update”
on page 85.
Step 6: Set up client computers to use the correct Software Update server.
Set preferences in Workgroup Manager by user, group, or computer to access your
Software Update server. For more information about how to configure managed
preferences for the Software Update server, see User Management.
You might also need to work with your networking staff to change network topologies,
switches, routers, and other network settings.
These are estimates for the number of clients supported. For more details about the
optimal system and network configurations to support the number of clients you have,
see “Capacity Planning” on page 83.
Note: In Mac OS X Server, Software Update operates across all network interfaces that
TCP/IP is configured for.
Capacity Planning
The number of client computers your server can support when accessing Software
Update depends on how your server is configured, when and how often your clients
check for updates, the size of the updates, and a number of other factors.
When planning for your server and network needs, consider these main factors:
ÂÂ Ethernet speed: 100Base-T or faster connections are required for client computers
and the server. As you add clients, you might need to increase the speed of the
Ethernet connections of your server.
Ideally you want to take advantage of the Gigabit Ethernet capacity built in to your
Mac OS X server hardware to connect to a Gigabit switch. From the switch, connect
Gigabit Ethernet or 100-Mbit Ethernet to each Macintosh client.
ÂÂ Hard disk capacity and number of packages: Software Update packages can
occupy considerable hard disk space on server volumes, depending on the size and
configuration of the package and the number of packages being stored.
ÂÂ Number of Ethernet ports on the switch: Distributing Macintosh clients over
multiple Ethernet ports on your switch offers a performance advantage. Each port
must serve a distinct segment.
ÂÂ Number of Software Update servers on the network: You might want to provide
different software updates to various groups of users. By configuring directory
services you can offer different update services by network or hardware type, each
targeting a different Software Update server on the network.
Note: You can’t configure Software Update servers to talk to one another.
You can configure your Software Update server to serve only Software Update
packages you approve. Restricting access to update packages might help prevent
maintenance and compatibility problems with your computers.
You can restrict client access in a Software Update server by disabling automatic
mirror-and-enable functions in the General Settings pane. You manage specific
updates in the Updates pane of the Software Update server.
By default, software updates are stored in the /var/db/swupd/ folder. To store software
updates in another location, choose a different partition or volume in the Software
Update General settings pane.
To provide varied access to software update packages, you must set up multiple
Software Update servers. Use managed preferences to configure these computers to
access a specific Software Update server.
For more information about how to configure managed preferences for the Software
Update server, see User Management.
The following sections describe the tasks for configuring these settings and how to
start Software Update after you configure it.
By redirecting your Software Update server, you can have multiple Software Update
servers on your private network. However, only one Software Update server needs
access outside your private Intranet to obtain software updates from the Apple
Software Update server. Then each additional server can access the internal server to
obtain the software updates.
If you are not using Client Management, use the defaults command in Terminal
to point unmanaged client computers to a Software Update server. You must be an
administrator to use the defaults command.
To point the unmanaged client computer back to the Apple Software Update server,
use the following command:
$ defaults delete /Library/Preferences/com.apple.SoftwareUpdate
CatalogURL
The following sections show how to manually refresh the updates catalog from the
Apple server, check the status of Software Update, stop the service, and control the
software updates cataloged and distributed by the service.
90
Checking the Status of Software Update
Use Server Admin to check the status of Software Update.
Enabling this feature retrieves all Apple published catalog updates and automatically
disables deprecated software packages that have a replacement package available.
An administrator can disable the new software package and continue offering the
deprecated package.
If this feature is not selected and an administrator manually enables updates, disabling
of deprecated software packages is performed as individual replacement packages are
enabled.
Enabling this feature does not remove obsolete or deprecated software updates from
the local Software Update catalog.
To make sure that you are selecting the correct software update file, correlate the
file name (product ID) with the software update product ID in Server Admin. Each
software update lists their product ID below the description field in the Updates
Settings pane of Server Admin.
General Tips
ÂÂ Make sure required services are installed.
ÂÂ Make sure the Software Update packages you enable are meant for the client
accessing them.
ÂÂ If you detect poor response from the Software Update server, check the network
load. For more information, see “Capacity Planning” on page 83.
ÂÂ Delete old updates to make space for new ones.
95
Command-Line Parameters
Appendix
NetBoot Service Settings
To configure general NetBoot service setting from Terminal, use the following
parameters with the serveradmin tool.
96
The Storage Record Array
An array of the following values appears in NetBoot service settings for each volume
on the server used to store boot or installation images.
Appendix Command-Line Parameters 97
The Image Record Array
An array of the following values appears in NetBoot service settings for each image
stored on the server.
netBootImagesRecordsArray:_array_ yes
index:<n>:IsDefault Specifies this image file as the default boot image
on the subnet.
netBootImagesRecordsArray:_array_ yes
index:<n>:SupportsDiskless Directs the NetBoot server to allocate space for
shadow files needed by diskless clients.
netBootImagesRecordsArray:_array_ 1–4095
index:<n>:Index Indicates a local image unique to the server.
4096–65535 is a duplicate, identical image
stored on multiple servers for load balancing.
netBootImagesRecordsArray:_array_ yes
index:<n>:IsInstall Specifies a network installation image.
no
Specifies a NetBoot image.
98 Appendix Command-Line Parameters
The Port Record Array
An array of the following items is included in the NetBoot service settings for each
network port on the server set to deliver images.
Appendix Command-Line Parameters 99
Index
Index
A NetBoot 30
access network requirements 46
client management 60, 81, 83 setup 60, 62
load balancing 69 shadow files 54, 63, 70
path for client 22 troubleshooting NetBoot startup 71
restricting NetBoot 37, 38, 49, 58 See also Automator actions, Software Update
restricting Software Update 76, 84, 85 service
Add Packages and Post-Install Scripts action 34 clients
Add User Account action 35 capacity planning 46
AFP (Apple Filing Protocol) service 46 diskless startup 71
AirPort wireless network 46 groups 17, 81, 83, 85
Apple Filing Protocol service. See AFP imaging multiple 61
Apply System Configuration Settings action 35 NetBoot 18, 19, 22
Architectures property 20 viewing lists of 65, 66
ASR (Apple Software Restore) 29 command-line tools
asr tool 29, 30, 61 assmbling workflows 41
Automator actions creating images 32
Add Packages and Post-Install Scripts 34 disabling images 65
Add User Account 35 enabling images 52, 59
Apply System Configuration Settings 35 logs 67
Create Image 36 NetBoot settings 25, 96, 97, 98, 99
Customize Package Selection 33 package-making 42
Define Image Source 34 restoring images 30
Enable Automated Installation 37 service settings 50
Filter Clients by MAC Address 37 Software Update service 80
Filter Computer Model 38 starting NetBoot 51
overview 33 startup image selection 61
Partition Disk 38 status checking 66
stopping service 65
B storing image files 53, 55
bandwidth limitations for Software Update 78, 91 computer name 36
boot image, definition 16 configuration, client settings 35
See also NetBoot service Create Image action 36
Boot Server Discovery Protocol. See BSDP Customize Package Selection action 33
BootFile property 20
BootP (Bootstrap Protocol) 22, 62 D
Bootstrap Protocol. See BootP Define Image Source action 34
BSDP (Boot Server Discovery Protocol) 21, 59 Description property 21
DHCP (Dynamic Host Configuration Protocol)
C service 21, 44, 46, 51, 71
client computers disk images. See NetBoot service, NetInstall
diskless startup 54, 56, 57, 60 diskless startup 54, 56, 57, 60, 71
hardware requirements 45 disks
100
capacity planning 38, 47, 83 Name property 21
distribution of images across 68 naming conventions 52, 72
partitions 38 NetBoot service
documentation 11, 12, 13 adding packages to images 41, 42
drives. See disks boot file management 22
Dynamic Host Configuration Protocol. See DHCP capacity planning 46
client setup 45, 46, 60
E creating images 26, 27, 29, 30
Enable Automated Installation Action 37 default settings 56
Ethernet 45, 46, 83 disabling images 65
enabling images 52
F filters 49, 58
file services 46 image folder 19
See also share points management tools 24, 25, 52
files monitoring of 64, 65, 66, 67, 68, 69, 70
boot 22 NetBoot 1.0 support 50
Software Update storage 84 network service requirements 46
Filter Clients by MAC Address action 37 overview 9, 16, 17, 18, 19
Filter Computer Model action 38 prerequisites 45
filters record array, NetBoot 97 property list file 20
filters, NetBoot 49, 58 security 23
folders, NetBoot image 19 selecting boot image 60
server discovery 21, 59
G settings 48, 96, 97, 98, 99
groups, setup 17, 81, 83, 85 setup 35, 43, 48
starting 47, 51
status checking 66
H
stopping 64
hardware requirements 45, 46, 82, 83
storage for images 22, 52, 54, 56
hdiutil tool 32
testing 44
help, using 10
troubleshooting 71, 72
host name, local 36
updating images 32
HTTP (Hypertext Transfer Protocol) 46
viewing client lists 65, 66
workflows 33, 34, 35, 36, 37, 38, 39, 40
I See also Automator actions
image record array, NetBoot 98
NetBootClientsn share points 19, 63, 70
images. See NetBoot service, NetInstall
NetBootSPn 18, 22
Index property, NetBoot image 20
NetInstall
installation image, definition 16
adding software to images 41, 42
See also NetInstall
creating images 26, 28, 30
IsDefault property 21
overview 9, 16, 18, 23
IsEnabled property 21
selecting install image 62
IsInstall property 21
using stored images 22
workflows 33, 34, 35, 36, 37, 38, 39, 40
L See also Automator actions
Language property 21
NetRestore 29
load balancing 19, 67, 68, 69, 70
Network File System. See NFS
logs 50, 67, 79
network requirements 46, 83
network services 21, 44, 46, 51, 71
M NFS (Network File System) 46
MAC address 37, 49, 58
memory, requirements for 45 P
multicast 61 package install images 33, 34, 41, 42
PackageMaker 17, 42
N packages, Software Update 77, 78, 79, 83, 84, 94
N key startup procedure 62 Partition Disk action 38
Index 101
port record array, NetBoot 99 storage record array, NetBoot 97
post-install scripts 34 streaming media, multicast 61
problems. See troubleshooting subnets 59
Property List Editor 17 SupportsDiskless property 21
property list files 20 System Image Utility
protocols creating images 26
AFP 46 overview 9, 17, 20, 25
BootP 22, 62 system imaging. See NetBoot service, NetInstall
BSDP 21, 59 systemsetup tool 61
DHCP 21, 44, 46, 71
HTTP 46 T
TFTP 22, 46 TFTP (Trivial File Transfer Protocol) 22, 46
troubleshooting
R NetBoot service 71, 72
RAM (random-access memory) 45 Software Update service 95
remote servers, images stored on 56 Type property 21
RootPath property 21
U
S updating disk images 45
security 23 See also Software Update service
See also access user accounts, adding 35
serial number, server 47 See also client computers
Server Admin 17, 24, 80 users. See clients
servers
discovery of 21, 59 V
images on remote 56 volumes, cloning 29
load balancing 67, 68, 69
NetBoot 18 W
Software Update 83, 89, 95 workflows 33
setup procedures. See configuration, installation adding 39
shadow files 18, 19, 54, 63, 70 assembling 39, 40
share points Automator actions 33, 34, 35, 36, 37, 38
NetBootClientsn 19, 63, 70 removing 39
NetBootSPn 18, 22 Workgroup Manager 24, 80
shadow files 18, 19, 70 workgroups 43
software requirements 45, 81
Software Update service
automatic settings 92
capacity planning 83
catalog management 77, 90, 93
clients 76, 78, 82, 85, 89
file packages 77, 78, 79, 83, 84, 94
file storage 84
identifying files 94
limitations on bandwidth 78, 91
management tools 79, 80, 90
monitoring of 78, 79
overview 9, 76, 77
prerequisites 82, 83
settings 84, 85, 86, 87
setup overview 81
starting 85, 87
status checking 91
stopping 91
troubleshooting 95
startup. See NetBoot service
102 Index