Apple Remote Desktop 2.2 User Manual
Apple Remote Desktop
Administrator’s Guide
Version 2.2
Apple Computer, Inc.
© 2005 Apple Computer, Inc. All rights reserved.
The owner or authorized user of a valid copy of Apple
Remote Desktop software may reproduce this
publication for the purpose of learning to use such
software. No part of this publication may be reproduced
or transmitted for commercial purposes, such as selling
copies of this publication or for providing paid for
support services.
The Apple logo is a trademark of Apple Computer, Inc.,
registered in the U.S. and other countries. Use of the
“keyboard” Apple logo (Option-Shift-K) for commercial
purposes without the prior written consent of Apple
may constitute trademark infringement and unfair
competition in violation of federal and state laws.
Apple, the Apple logo, AirPort, AppleScript, AppleTalk,
AppleWorks, FireWire, iBook, iMac, Keychain, Mac,
Macintosh, Mac OS, PowerBook, QuickTime, and Xserve
are trademarks of Apple Computer, Inc., registered in the
U.S. and other countries. eMac, Finder, iCal, Bonjour, and
Safari are trademarks of Apple Computer, Inc.
Adobe and Acrobat are trademarks of Adobe Systems
Incorporated.
Java and all Java-based trademarks and logos are
trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.
UNIX is a registered trademark in the United States and
other countries, licensed exclusively through
X/Open Company, Ltd.
019-0359
3/4/05
Contents
3
Preface 5 About This Book
5
What Is Apple Remote Desktop?
5
Using This Guide
7
Where to Find More Information About Apple Remote Desktop
Chapter 1 9 Using Apple Remote Desktop
9
Administering Computers
18
Supporting Users
23
Finding More Information
Chapter 2 25 Setting Up
25
System Requirements for Apple Remote Desktop
26
Setting Up an Apple Remote Desktop Administrator Computer
28
Setting Up Client Computers With Mac OS X 10.2 Installed
32
Setting Up Client Computers With Mac OS X 10.3 Installed
36
Creating a Custom Client Installer
38
Understanding Access Types
44
Considerations for Managed Clients
44
Configuring the Administrator Software
48
Setting Up the Network
49
Getting the Best Performance
50
Maintaining Security
Chapter 3 53 Administering Computers
54
Finding and Adding Clients to ARD Computer Lists
57
Making and Managing Lists
58
Installing Software Using ARD
62
Upgrading Software
63
Copying Files
66
Creating Reports
77
Maintaining Systems
79
Managing Computers
84
Automating Functions
3
Chapter 4 93 Interacting With Users
94
Controlling
97
Observing
10 0
Sending Messages
10 2
Sharing Screens
Appendix A 105 Reference
10 5
Computer Scanner Icons
10 6
ARD Status Icons
10 6
TCP and UDP Port Reference
10 7
Report Field Definitions Reference
11 4
PostgreSQL Schema Sample
4
Contents
About This Book
What Is Apple Remote Desktop?
Apple Remote Desktop (ARD) is easy-to-use, powerful, open standards-based, desktop
management software for all your networked Macs. IT professionals can remotely
control and configure systems, install software, offer live online help to end users, and
assemble detailed software and hardware reports for an entire Mac network.
You can use Apple Remote Desktop to:
Manage client computers and maintain, upgrade, and distribute software
•
•
Collect more than 200 system-information attributes for any Mac on your network.
Store the results in an SQL database and view the information using one of several
hardware or software reports.
Provide help and remote assistance for users when they encounter problems
•
•
Interact with users by sending text messages, observing and controlling users’
screens, and sharing their screens with other client users
Preface
With Apple Remote Desktop software, you can access your office computer,
documents, and applications while you’re away from the office. Used in a classroom,
Apple Remote Desktop enhances the learning experience and allows teachers to
monitor and control students’ computers. In corporate environments, it’s the ideal
solution for managing remote systems, reducing administration costs, and increasing
productivity.
Using This Guide
The ARD Administrator’s Guide contains chapters to help you use Remote Desktop. It
contains overviews and explanations about ARD’s features and commands. It also
explains how to install and configure ARD on clients, how to administer client
computers, and how to use Remote Desktop to interact with computer users.
In addition, this guide is provided on the ARD installation disc and on the Apple
Remote Desktop support website as a fully searchable, bookmarked PDF file. You can
use Apple’s Preview application or Adobe (Acrobat) Reader to browse the contents of
this guide as well as search for specific terms, features, or tasks.
5
Remote Desktop Help is available using Help Viewer. To open Remote Desktop Help,
choose Help > Remote Desktop Help. The help files contain the same information
found in this guide, and are useful when trying to accomplish a task when this guide is
unavailable.
Notation Conventions
This guide and Remote Desktop Help contain step-by-step procedures to help you use
ARD’s commands effectively. In many tasks shown in this manual and in Remote
Desktop Help, you need to choose menu commands, which look like this:
m
Choose Edit > Clear.
The first term after Choose is the name of a menu in the Remote Desktop menu bar.
The next term (or terms) are the items you choose from that menu.
Terminal Command Conventions
Notation Indicates
monospaced
$
<anglebrackets>
Commands or command parameters that you might type, along with other text that
normally appears in a Terminal window, are shown in
font A command or other Terminal text
A shell prompt
A displayed value that depends on your configuration or settings
this
font. For example:
You can use the
doit
command to get things done.
When a command is shown on a line by itself as you might type it in a Terminal
window, it follows a dollar sign that represents the shell prompt. For example:
$ doit
To use this command, type “doit” without the dollar sign at the command prompt in a
Terminal window, then press the Return key.
6 Preface
About This Book
Where to Find More Information About Apple Remote Desktop
For additional information related to Apple Remote Desktop, try these resources.
•
You’ll find more information in the ARD Read Me file and on the Apple Remote
Desktop website:
http://www.apple.com/remotedesktop
•
You can find the most recent edition of the Administrator’s Guide at:
http://www.apple.com/server/documentation
The Apple Remote Desktop Support website provides a database of technical articles
•
about product issues, usage, and implementation:
http://www.apple.com/support/remotedesktop
•
To provide feedback about ARD, visit the feedback page:
http://www.apple.com/feedback/remotedesktop.html
For details about how to join the ARD Mailing list, visit:
•
http://lists.apple.com/mailman/listinfo/remote-desktop
To share information and learn from others in online discussions, visit the ARD
•
Discussions Forum:
http://discussions.info.apple.com/appleremotedesktop
For more information about WBEM/CIM, go to:
•
http://www.dmtf.org
•
For more information about PostgreSQL go to:
http://www.postgresql.org
Preface
About This Book
7
Using Apple Remote Desktop
1
Apple Remote Desktop helps you keep Macintosh
computers and the software running on them up to date
and trouble free. And it lets you interact directly with
Macintosh users to provide instructional and
troubleshooting support.
This chapter describes the main aspects of ARD’s administration and user interaction
capabilities and tells you where to find complete instructions for using them.
Administering Computers
ARD lets you perform a wide range of client hardware and software administration
activities remotely, from an administrator computer (the computer on which
administrator software resides):
Keep users’ software up to date by using ARD to
•
client computers.
Create reports that
•
hardware.
•
Use ARD’s remote administration capabilities to perform
computers.
inventory
the characteristics of client computer software and
deploy software and related files to
housekeeping
tasks for client
1
9
You can administer client computers individually, but most ARD features can be used to
manage
multiple
computers at the same time. For example, you may want to install or
update the same applications on all the computers in a particular department. Or you
may want to share your computer screen to demonstrate a task to a group of users,
such as students in a training room.
Marketing department Engineering department
To manage multiple computers with a single action, you define ARD
computer lists
. A
computer list is a group of computers that you want to administer similarly. Setting up
computer lists is easy; you simply import the identity of computers from files, or
network scans.
A particular computer can belong to more than one list, giving you a lot of flexibility
for multicomputer management. A computer can be categorized by its type (laptop,
desktop), its physical location (building 3, 4th floor), its usage (marketing, engineering,
computing), and so forth.
Once you’ve set up computer lists, you can conduct most of the computer
administration activities described next for groups of client computers.
10 Chapter 1
Using Apple Remote Desktop
Deploying Software
ARD lets you distribute software and related files to client computers from your ARD
administrator computer or from a computer running Mac OS X Server.
Administrator
computer
configuration files
Deploy
Deploy
drag-and-drop
application folders
Deploy
install packages
(.pkg or .mpkg)
Deploy UNIX
shell scripts
Set startup
partition
Mac OS X
Server
Network
install images
NetBoot
images
Xserve cluster node Marketing department Engineering department
Distributing Install Packages
You can distribute and automatically install packages in .pkg and .mpkg formats. ARD
lets you install software and software updates on one or more client computers
without user interaction or interruption, or even if no user is logged in. After
installation, ARD erases the installer files. If the computers need to be restarted, as they
do following an operating system update, you can restart them from ARD.
Chapter 1
Using Apple Remote Desktop
11
For example, you can use Apple Software Update to download an iCal update or an
operating system update to a test computer. If the update works as expected and
introduces no compatibility issues, copy the install package to the administrator
computer to distribute to computers that need upgrading. Note that this approach
conserves Internet bandwidth, because only one copy of the package needs to be
downloaded.
You can also use ARD to deploy new versions of computational software to Xserve
computers in a cluster node.
You can use the PackageMaker tool from Apple’s Developer Tools to create your own
install packages, such as when you want to:
Distribute school project materials or business forms and templates
•
•
Automate the installation of multiple install packages
•
Deploy custom applications
Before performing remote installations, you can send an ARD text message to notify
users, perhaps letting them know that you’ll be using ARD to lock their screens at a
particular time before you start the installation.
Using Network Install Images
You can also distribute and install software, including the Mac OS X operating system,
by using Network Install images.
On Mac OS X Server, use the Network Image Utility to create a Network Install image.
You can create the image by cloning a system that’s already installed and set up or by
using an install disc or image downloaded using Apple Software Update. If you choose
to auto-install, you won’t have to interact with each computer. On the ARD
administrator computer, set the startup disk of remote client systems to point to the
Network Install image, and then remotely reboot the clients to initiate installation.
Before initiating installations that require computers to be restarted afterwards, send
an ARD text message to client users to notify them of a pending installation. For
example, tell users you’ll log them off at 5:00 P.M. to install an operating system update.
Using NetBoot Images
Another kind of system image you can create using Mac OS X Server is a NetBoot
image. Like a Network Install image, a client computer uses NetBoot images to start up.
Unlike a Network Install image, the boot software is not installed on the client system.
Instead, it resides on a remote server. It is recommended you use a NetBoot image that
has ARD installed and configured. Otherwise, administering the computer using ARD
after NetBooting is impossible.
12 Chapter 1
Using Apple Remote Desktop
Client computers that boot from a NetBoot image get fresh system environments every
time they start up. For this reason, using NetBoot images is useful when a particular
computer is shared by several users who require different work environments or
refreshed work environments, or when you want to start a new experiment or use a
different computing environment in a cluster node.
You use ARD to set the startup disks of client systems to point to the NetBoot image,
and then restart the systems remotely using ARD. Users can also choose a NetBoot
image for startup by using the Startup Disk pane of System Preferences. With just a few
clicks you can reconfigure all the computers in a lab or cluster without having to
manually restart and configure each computer individually.
Distributing Configuration Files
Many of the core Mac OS services rely on the settings in configuration files. Use ARD to
distribute configuration files when you need to reconfigure services.
For example, if you add a new network printer, you can update the printer list of all
computers in the area by using ARD to copy an updated CUPS configuration file and
the PPD (printer definition) files to the computers.
You can also use ARD to distribute AppleScript files that automate PDF workflows, or
job instructions for computational clusters.
Using UNIX Shell Scripts
You can use ARD to distribute and run UNIX shell scripts on client computers.
For example, a script can mount an AFP server volume, from which it downloads a disk
image to client computers. The script might also download an install package and then
perform a command-line install.
On an Xserve in a cluster node, you could also run a script that mounts an Xserve RAID
disk designed for high throughput and then downloads large data sets for processing.
Distributing Drag-and-Drop Applications
You can distribute and install self-contained (drag-and-drop) applications by copying
them to one or more client computers. Use this approach, for example, to distribute
Safari application updates.
Verifying Installations
To check whether an installation has been completed successfully, use ARD’s remote
control capabilities.
For example, you can start an application remotely, or search for particular files. You can
also use the File Search report to verify that all files for an application are installed
correctly.
Chapter 1
Using Apple Remote Desktop
13
Taking Inventory
ARD lets you capture data describing the attributes of client computers, then generate
reports based on the data.
You specify how often you want to capture data, the data you want to capture, and the
computers you want to profile. You can collect data just before generating a report if
you need up-to-the-minute information. Or you can schedule data to be collected by
ARD at regular intervals and stored in its built-in SQL (Structured Query Language)
database for use on an as-needed basis.
You can also specify where you want the database to reside—on the local
administrator computer, or on a server where the ARD administration software is
installed and always running, so data can be captured on an ongoing basis.
Mac OS X
Server
Administrator
computer
ARD SQL
database
SQL tools
Xserve cluster node Marketing department Engineering department
ARD SQL
database
Using the collected data, ARD generates reports tailored to your specifications.
14 Chapter 1
Using Apple Remote Desktop
File Search Report
Use the File Search report to search client systems for specific files and folders and to
audit installed applications.
This report can help you find out how many copies of a particular application are in use
so you don’t violate license agreements.
Software Version Report
Use the Software Version report to make sure that all users have the latest application
versions appropriate for their systems.
Software Difference Report
Use the Software Difference report to detect application versions that are out of date,
nonstandard, or unacceptable for some other reason. Or you can learn whether a user
has installed an application that shouldn’t be installed.
System Overview Report
The System Overview report makes visible a wide variety of client computer
characteristics. Using this report you can review information about a client’s AirPort
setup, computer and display characteristics, devices, network settings, system
preferences, printer lists, and key software attributes.
There are numerous uses for this report, such as identifying problems or verifying
system configurations before installing new software, or determining how many
devices of a particular type (such as scanners) reside in a particular lab.
Hardware Reports
Several reports focus on details about particular hardware used by client computers—
hard disks, FireWire devices, USB devices, network interfaces, memory, and PCI cards.
Use these reports to determine, for example, which computers need more memory,
which computer has the fastest processor speed, and how much free space is left on a
particular disk.
Administration Settings Report
Use the Administration Settings report to determine which ARD administration
privileges are enabled or disabled for you in the Sharing or Remote Desktop pane of
System Preferences on individual client computers.
Network Test Report
A network test report helps you measure and troubleshoot the communication
between your administrator computer and your client computers.
Chapter 1
Using Apple Remote Desktop
15
Use this report to help identify reasons for network communication problems that
could affect ARD. For example, if you’re unable to copy items to particular client
computers from the administrator computer, you may find you have a bad connection
to the computers. Using this information can help you isolate the problem to a
particular cable or hub.
Generating Your Own Reports
Because the ARD database is in standard SQL format, you can also use your favorite
SQL scripts to query, sort, and analyze the collected data. In addition, you can export
data from the database into a file so you can import it for viewing in a different
program, such as a spreadsheet application.
16 Chapter 1
Using Apple Remote Desktop
Housekeeping
ARD provides several ways to remotely control client computers for housekeeping
activities, which you can conduct using one or more ARD windows.
Administrator
computer
Restart/
shutdown/sleep
Empty
Trash
Mac OS X
Server
Remote screen
control
Execute UNIX
shell script
Send text
notification
Xserve cluster node Marketing department Engineering department
Set startup
partition
Managing Power Settings
Use ARD to manage the power settings of client computers.
NetBoot
images
For example, you may need to have all computers turned off during maintenance of a
power generation unit or during a holiday shutdown. You could send an ARD text
message reminding users to shut down their computers at a particular time. Any
computers still running when you need to start maintenance can be detected and shut
down remotely with ARD.
Chapter 1
Using Apple Remote Desktop
17
Locking Computer Screens
You can lock the screens of client computers for specified durations when you don’t
want the computers to be used. For example, you may need to perform network
maintenance and want to make sure that computers don’t use the network for a few
hours.
You can display a custom picture and/or text messages on screens while they’re locked
to let users know when they’re available again.
Reclaiming Disk Space
Periodically empty the Trash on client computers to conserve disk space.
Automating Periodic Maintenance
Use UNIX shell scripts to automate periodic maintenance, such as checking permissions
or deleting log files.
Controlling Screens
Use ARD’s remote screen control to conduct activities on the desktop of Xserve
computers, or use graphical applications on them. ARD replaces the need for KVM
(keyboard/video/mouse) switches for accessing Xserve computers without a monitor
attached.
You can also remotely control a user’s computer to help determine reasons for slow
performance or other problems the user is experiencing.
Changing Startup Disks
Change the startup disk of a client computer to perform diagnostic or troubleshooting
activities.
For example, start up a computer using a server-based NetBoot image that’s been set
up for troubleshooting. When you’re finished, reset the startup disk to the original boot
volume.
Managing Shared Computers
On computers that are shared among users, check for files that need to be deleted
between user logins, close applications, log users off, or perform other activities
needed to prepare computers for the next users.
Supporting Users
ARD lets you interact with users from your administrator computer in these ways:
• Provide help: respond to users who need help by using ARD to receive user requests
and to remotely diagnose and fix problems.
• Interact: conduct instructional interactions with students in a school or corporate
training environment—from controlling or observing student screens to sharing your
screen with all your students to perform a demonstration.
18 Chapter 1 Using Apple Remote Desktop
Providing Help Desk Support
When a user is having trouble, ARD provides several ways to interact with the user and
his or her computer to diagnose and fix the problem.
Administrator
computer
Use
text chat
Copy
items
Control, observe, and
share screens
Marketing department Engineering department
Requesting Help
A user can discreetly notify you of the problem by sending a request for help using an
ARD text message.
Users initiate requests using the commands in the menu that appears when they click
the ARD icon in the menu bar. A notification on the administrator computer alerts you
to the message, and you can use several techniques to obtain more information or
troubleshoot the problem.
Chatting With the User
Conduct two-way ARD text communication with the user to obtain more information.
Screen Monitoring
Use ARD to observe the user’s screen if you need more details to understand the
problem.
Chapter 1 Using Apple Remote Desktop 19
Screen Controlling
Use ARD to control the user’s screen in order to diagnose and hopefully fix the
problem. You may have unlimited control, or a user can grant you temporary guest
access so you can control his or her computer only during troubleshooting.
There are several levels of control available. You can take complete control of the user’s
computer, or you can share control of the keyboard and mouse with the user.
Screen Sharing
If the problem is caused by incorrect actions by the user, share your screen with the
user as you demonstrate the correct way to perform the action.
Using Reports
Use hardware and software reports as diagnostic tools to determine whether the client
computer setup is part of the problem. For example, if a user can’t save his or her work,
the storage report can help you determine whether it’s a disk space issue.
Deploying New Software or Files
If software or configuration settings are part of the problem, use ARD to copy new
configuration files, install packages, or copy other items to client computers.
20 Chapter 1 Using Apple Remote Desktop
Interacting With Students
ARD helps instructors teach more efficiently by letting them interact with student
computers individually or as a group.
Administrator
computer
Broadcast
text messages
Observe and
share one or
multiple screens
Control
screen
Lock
screens
Log out
students
Distribute
items electronically
Open applications
help desk support
or files
One-to-one
Classroom
Using Text Messages
Send ARD text messages to communicate with students. For example, notify them that
a classroom activity will start soon or that they have 10 minutes to finish an
examination.
Monitoring Student Computers
View student computer screens on your computer, so you can monitor student
activities or assess how well they’re able to perform a particular task. You can also
monitor the applications running on any student’s computer.
Sharing Screens
Display your screen or a student’s screen on other student computers for training and
demonstration purposes.
Controlling Screens
Show students how to perform tasks by controlling their screens from your computer,
opening applications and using files as required.
Chapter 1 Using Apple Remote Desktop 21
Locking Screens
Lock student screens to prevent students from using their computers when you want
them to focus on other activities.
Terminating Computer Use
Remotely log students out or shut down their computers at the end of a class or school
day.
Distributing and Collecting Files
Distribute handouts electronically, at a time that won’t disrupt class activities or when
they’re needed for the next class activity, and collect homework files.
Automating Website Access
Open a webpage on all student computers. Drag a URL from Safari to your desktop,
then copy it to student computers and open it in Safari. You can also copy files and
open them in the appropriate applications on student computers.
Providing One-to-One Assistance
Provide help when a student needs it, conducting private and discreet computer-tocomputer interactions as required.
22 Chapter 1 Using Apple Remote Desktop
Finding More Information
You’ll find detailed instructions for performing the tasks highlighted in this chapter—
and more—throughout this manual.
To learn more about See information for Starting on page
ARD administration Administration privileges
Administrator computers
Security
Computer lists Creating computer lists page 57
Deploying software Installing software
Upgrading software
Distributing files Copying files page 63
Taking inventory Data collection options
Auditing software
Auditing hardware
Network responsiveness
Customizing reports
Exporting report data
Housekeeping tasks Deleting items
Emptying the Trash
Setting startup volumes
Renaming computers
Sleeping and waking
Locking screens
Logging users out
Restart and shutdown
Automating tasks Configuring data gathering
Scheduling tasks
Using UNIX shell scripts
Using ARD text messages Text messages page 100
Controlling screens Controlling page 94
Observing screens Observing page 97
Sharing screens Share screens page 102
page 38
page 58
page 66
page 77
page 77
Additional information can be obtained at several Apple websites:
• For information about NetBoot and Network Install, go to www.apple.com/server/
documentation/ and download the system imaging administration guide.
• For information about PackageMaker, go to www.developer.apple.com and search for
PackageMaker.
Chapter 1 Using Apple Remote Desktop 23
2 Setting Up
2
To use Apple Remote Desktop, install the administration
software on the administrator computer first, and then
install and enable the client software on the computers
you want to manage.
This chapter describes the main aspects of setting up and configuring ARD for system
administration and user interaction and gives complete instructions for setting up. You
can learn about:
• “System Requirements for Apple Remote Desktop” on page 25
• “Setting Up an Apple Remote Desktop Administrator Computer” on page 26
• “Setting Up Client Computers With Mac OS X 10.2 Installed” on page 28
• “Setting Up Client Computers With Mac OS X 10.3 Installed” on page 32
• “Creating a Custom Client Installer” on page 36
• “Understanding Access Types” on page 38
• “Considerations for Managed Clients” on page 44
• “Configuring the Administrator Software” on page 44
• “Setting Up the Network” on page 48
• “Getting the Best Performance” on page 49
• “Maintaining Security” on page 50
System Requirements for Apple Remote Desktop
Administrator and client computers:
• eMac, iMac, iBook G3 or G4, PowerBook G3 or G4, Power Mac G3, G4 or G5,
Xserve G4 or G5
• Mac OS X versions 10.2.8 and 10.3 or later
• Mac OS Extended (HFS+) formatted hard disk
• For observing and controlling other platforms: a system running VNC-compatible
server software.
NetBoot and Network Install
• Mac OS X Server 10.3 with NetBoot and Network Install services enabled
25
Network Requirements
• Ethernet (recommended), AirPort, FireWire, or other network connection
See “Setting Up the Network” on page 48 for more information.
Setting Up an Apple Remote Desktop Administrator Computer
If you already have Apple Remote Desktop version 1.2 and existing ARD computer lists
on a different computer from the one on which you’ll install ARD 2, you first need to
transfer the existing ARD computer lists to the new computer.
Otherwise, go to “Installing the Administrator Software” on page 27.
Transferring Old Computer Lists to a New Administrator Computer
If you are installing ARD 2 on a computer different from the current administrator
computer, you need to move your existing computer lists to the new administrator
computer before installing version 2.
These instructions only apply when moving ARD 1.2 administrator computer lists to a
new computer.
Throughout these instructions, the computer with the original lists is the “source
computer.” The computer that will have ARD 2 installed is the “target computer.”
To transfer the computer lists:
1 Open Keychain Access (in /Applications/Utilities) on the source computer.
2 Choose File > New Keychain.
3 Name the new keychain, and click Create.
4 Enter a password for the new keychain.
This is a temporary password that you will use to retrieve the information in the
keychain. Do not use your login or other sensitive password.
5 If necessary, click Show Keychains to show the administrator keychain.
6 Select the source computer’s main keychain.
If the keychain is locked, unlock it and authenticate.
7 Select only the ARD entries in the Keychain.
8 Drag the ARD entries to the newly created keychain.
9 Provide the source computer keychain password for each entry.
10 Quit Keychain Access on the source computer.
26 Chapter 2 Setting Up
11 Copy the newly created keychain from the source computer (~/Library/Keychains/
<keychain name>) to the same location on the target computer.
You can copy the keychain over a network, or use a removable storage drive.
12 On the target computer, open Keychain Access in the Finder.
13 Choose File > Add Keychain.
14 Select the keychain that was copied from the source computer, and click Open.
15 If necessary, click Show Keychains to show the keychains.
16 Unlock the newly imported keychain, using the password designated for that keychain.
17 Select the ARD entries.
18 Drag the ARD entries to the main keychain on the target computer.
Provide the temporary keychain password for each entry.
19 Quit Keychain Access on the source computer.
When you open ARD on the new computer, you will notice the computer lists from the
old computer are available.
Installing the Administrator Software
To set up ARD on administrator computers, you install the software on the computer
you plan to use to administer remote computers. Then, you open the application and
create a main list of computers.
To install Apple Remote Desktop on an administrator computer:
1 Insert the Apple Remote Desktop disc.
2 Double click the ARD install package and follow the onscreen instructions.
The application Remote Desktop will be installed in the Applications folder.
3 Open Remote Desktop (in the Applications folder).
The Remote Desktop Setup Assistant appears.
4 Enter the ARD serial number.
The serial number can be found on the Apple Remote Desktop Welcome document
that came with your software.
5 Click Continue.
If ARD 2 client software is not already present, the assistant asks if you want to install it.
Click OK to continue.
Chapter 2 Setting Up 27
6 Enter a Remote Desktop password and verify it.
The Remote Desktop password is used to encrypt names and passwords of client
computers for ARD. You can store this password in your keychain for convenience, or
you can require that the password be entered each time you open Remote Desktop.
7 Click Done.
The main application window appears.
If ARD 1.2 was previously installed (or if you transferred computer lists from another
administrator computer), all the existing computer lists are available in the new
window. Update and configure your clients using the instructions in “Upgrading
Existing Client Software On Mac OS X 10.2” on page 29 or “Upgrading Existing Client
Software on Mac OS X 10.3 Using ARD” on page 33.
If no version of ARD was previously installed, you must enable and configure the client
computers before Remote Desktop can administer them.
Uninstalling the Administrator Software
To remove the administrator software completely, you must remove the application,
the encrypted list of computer login names and passwords, and the client information
database.
To remove the administrator software:
1 Drag the Remote Desktop application to the Trash.
2 Empty the Trash.
3 Delete the ARD database from /var/db/RemoteManagement/ using the following
command in the Terminal application:
$ sudo rm -rf /var/db/RemoteManagement
$ sudo rm /Library/Preferences/com.apple.RemoteDesktop.plist
$ rm ~/Library/Preferences/com.apple.RemoteDesktop.plist
Setting Up Client Computers With Mac OS X 10.2 Installed
The following section contains information on installing Apple Remote Desktop 2 on
computers running Mac OS X 10.2 Jaguar. See the appropriate instructions, depending
on whether you’re setting up clients for the first time or upgrading existing ARD clients.
Installing the Client Software on Mac OS X 10.2 for the First Time
To install the client software on the computers you plan to use with Apple Remote
Desktop, use the ARD administration software to create a client software installer. You
need the name and password of a user with administrator privileges on the client
computer to install the package.
28 Chapter 2 Setting Up
To install the client software for the first time:
1 Create the custom client install package.
For detailed instructions, see “Creating a Custom Client Installer” on page 36.
2 Copy and install the package on the client computers.
There are several ways to do this. For example, you can:
• Distribute the package by removable media, such as a CD
• Copy the installer to the clients over the network using file sharing
• Copy the installer to the clients using command-line tools like scp (if ssh is enabled),
and use Apple’s command-line installation tool, “installer,” to install the package
remotely. This process is described in detail in “Upgrading Existing Mac OS X 10.2
Client Software Using ssh” on page 29.
Warning: Custom installer packages that create login names contain sensitive
password data. Take care to store such custom installers securely.
Upgrading Existing Client Software On Mac OS X 10.2
For Mac OS X 10.2 Jaguar computers using Apple Remote Desktop client software
version 1.2 or later, you can use the Upgrade Client Software feature to update client
software with Remote Desktop’s built-in features. If you choose not to use Remote
Desktop’s Upgrade Client feature, you can use the process described in “Installing the
Client Software on Mac OS X 10.2 for the First Time,” above, to upgrade Jaguar clients
manually.
Upgrading Existing Mac OS X 10.2 Client Software Using ARD
To upgrade ARD clients, find them in your ARD computer lists, or with a network scan.
To upgrade existing computers:
1 Open Remote Desktop.
2 Select a computer list.
3 Select one or more computers in the Remote Desktop window.
4 Choose Manage > Upgrade Client Software.
Upgrading Existing Mac OS X 10.2 Client Software Using ssh
You may not be able to use Apple Remote Desktop’s administration software to
upgrade existing Jaguar clients to ARD 2. The clients may have software older than
version 1.2, for example. If the clients have ssh enabled (called Remote Login in System
Preferences), and are available on the network, you can still upgrade the client
computers.
You still need to use the ARD administration software to create a custom installer
package. You also need the login name and password of a user with administrator
privileges on the client computer.
Chapter 2 Setting Up 29
To upgrade existing client software via ssh:
1 Create the custom client install package.
For detailed instructions, see “Creating a Custom Client Installer” on page 36.
2 Make sure Remote Login is selected in the Sharing pane of System Preferences on the
client computer.
3 Open Terminal.
4 Copy the installer package to the client computer by typing:
$ scp -r <path to installer package> <user>@<host>:<path to package
destination>
For other scp options, see its man page.
5 Log in to the client computer using the ssh command-line tool.
$ ssh <user>@<host>
For other ssh options, see its man page.
6 On the client computer, install the package by typing:
$ sudo installer -pkg <path to package> -target /
For other installer options, see its man page.
Preparing Mac OS X 10.2 Clients for Administration
To prepare a client for administration, after installing or updating the Apple Remote
Desktop client software on the computer, you activate ARD and grant access privileges
to the computer by using the ARD pane of the computer’s System Preferences. If you
chose to have the privileges set and ARD enabled when you created the custom
installer package, your computers are already prepared.
Note: You can skip this step if you create a custom installer that automatically enables
your desired client settings.
If you did not create an ARD user login or define ARD administrator access privileges
when you created the custom installer package, you need to configure your clients. You
set access privileges separately for each user account on the computer for which you
want the ARD administrator to be able to log in and take command of the computer.
Follow the steps in this section to set access privileges on each client computer that
uses Mac OS X 10.2 Jaguar.
To make changes on a Mac OS X client, you must have the name and password of a
user with administrator privileges on that computer.
30 Chapter 2 Setting Up
Loading...