Detailed instructions for use are in the User's Guide.
Apple Remote Desktop Administrator's Guide
Version 3.1
K Apple Computer, Inc.
© 2006 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, iSight, Keychain, Mac, Macintosh, Mac OS, PowerBook, QuickTime, and Xserve are trademarks of Apple Computer, Inc., registered in the U.S. and other countries. Apple Remote Desktop, Bonjour, eMac, Finder, iCal, 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-0835/11-13-06
3
Contents
Preface
9 10 10 10 11 13 13 15 18 21 23 23 25 27 28 28 29 31 32 33 34 35 36 36 36 37 39 39 40 40 41
About This Book Using This Guide Remote Desktop Help Notation Conventions Where to Find More Information About Apple Remote Desktop Using Apple Remote Desktop Administering Computers Deploying Software Taking Inventory Housekeeping Supporting Users Providing Help Desk Support Interacting with Students Finding More Information Getting to Know Remote Desktop Remote Desktop Human Interface Guide Remote Desktop Main Window Task Dialogs Control and Observe Window Multiple-Client Observe Window Report Window Changing Report Layout Configuring Remote Desktop Customizing the Remote Desktop Toolbar Setting Preferences for the Remote Desktop Administrator Application Interface Tips and Shortcuts Installing Apple Remote Desktop System Requirements for Apple Remote Desktop Network Requirements Installing the Remote Desktop Administrator Software Setting Up an Apple Remote Desktop Client Computer for the First Time
Chapter 1
Chapter 2
Chapter 3
3
41 42 42 43 43 44 46 46 46 47 48 Chapter 4 49 49 50 51 51 52 53 53 54 54 55 55 55 56 56 57 57 58 58 Chapter 5 60 60 62 63 63 66 66 67
Upgrading the Remote Desktop Administrator Software Upgrading the Client Software Method #1--Remote Upgrade Installation Method #2--Manual Installation Upgrading Apple Remote Desktop Clients Using SSH Creating a Custom Client Installer Considerations for Managed Clients Removing or Disabling Apple Remote Desktop Uninstalling the Administrator Software Disabling the Client Software Uninstalling the Client Software from Client Computers Organizing Client Computers Into Computer Lists Finding and Adding Clients to Apple Remote Desktop Computer Lists Finding Clients by Using Bonjour Finding Clients by Searching the Local Network Finding Clients by Searching a Network Range Finding Clients by Network Address Finding Clients by File Import Making a New Scanner Making and Managing Lists About Apple Remote Desktop Computer Lists Creating an Apple Remote Desktop Computer List Deleting Apple Remote Desktop Lists Creating a Smart Computer List Editing a Smart Computer List Creating a List of Computers of from Existing Computer Lists Importing and Exporting Computer Lists Transferring Computer Lists from Apple Remote Desktop 3 to a New Administrator Computer Transferring Remote Desktop 2 Computer Lists to a New Remote Desktop 3 Administrator Computer Transferring Old v1.2 Computer Lists to a New Administrator Computer Understanding and Controlling Access Privileges Apple Remote Desktop Administrator Access Setting Apple Remote Desktop Administrator Access Authorization and Privileges Using Local Accounts Apple Remote Desktop Administrator Access Using Directory Services Creating Administrator Access Groups Enabling Directory Services Group Authorization Apple Remote Desktop Guest Access Apple Remote Desktop Nonadministrator Access
4
Contents
68 69 69 70 70 Chapter 6 72 72 73 74 74 76 76 77 78 79 79 80 81 81 81 82 82 82 83 83 84 85 86 86 88 89 89 89 91 91 92 92 93 93 93 94
Virtual Network Computing Access Command-Line SSH Access Managing Client Administration Settings and Privileges Getting an Administration Settings Report Changing Client Administrator Privileges Setting Up the Network and Maintaining Security Setting Up the Network Using Apple Remote Desktop with Computers in an AirPort Wireless Network Getting the Best Performance Maintaining Security Remote Desktop Authentication and Data Transport Encryption Encrypting Observe and Control Network Data Encrypting Network Data During Copy Items and Install Packages Tasks Interacting with Users Controlling Controlling Apple Remote Desktop Clients Control Window Options Switching the Control Window Between Full Size And Fit-To-Window Switching Between Control and Observe Modes Sharing Control with a User Hiding a User's Screen While Controlling Capturing the Control Window to a File Switching Control Session Between Full Screen and In a Window Sharing Clipboards for Copy and Paste Controlling VNC Servers Setting up a NonÂMac OS X VNC Server VNC Control Options Configuring an Apple Remote Desktop Client to be Controlled by a VNC Viewer Observing Changing Observe Settings While Observing Changing Screen Titles While Observing Viewing a User's Account Picture While Observing Viewing a Computer's System Status While at the Observe Window Shortcuts in the Multiple Screen Observe Window Observing a Single Computer Observing Multiple Computers Observing a Computer in Dashboard Sending Messages Sending One-Way Messages Interactive Chat Viewing Attention Requests
Chapter 7
Contents
5
94 94 95 95 95 96 96 Chapter 8 97 97 98 99 99 99 100 100 101 102 102 102 104 105 106 106 108 108 110 110 111 113 113 114 115 116 118 120 121 126 127 128 129 129 130
Sharing Screens Sharing a Screen with Client Computers Monitoring a Screen Sharing Tasks Interacting with Your Apple Remote Desktop Administrator Requesting Administrator Attention Canceling an Attention Request Changing Your Observed Client Icon Administering Client Computers Keeping Track of Task Progress and History Enabling a Task Notification Script Getting Active Task Status Using the Task Feedback Display Stopping a Currently Running Task Getting Completed Task History Saving a Task for Later Use Creating and Using Task Templates Editing a Saved Task Installing Software Using Apple Remote Desktop Installing by Package and Metapackage Installing Software on Offline Computers Installing by Using the Copy Items Command Using Installers from Other Companies Upgrading Software Copying Files Copy Options Copying from Administrator to Clients Copying Using Drag and Drop Restoring Items from a Master Copy Creating Reports Collecting Report Data Using a Task Server for Report Data Collection Report Database Recommendations and Bandwidth Usage Auditing Client Usage Information Finding Files, Folders, and Applications Comparing Software Auditing Hardware Testing Network Responsiveness Exporting Report Information Using Report Windows to Work with Computers Maintaining Systems Deleting Items Emptying the Trash
6
Contents
130 131 131 132 133 133 134 135 135 137 137 138 139 139 140 140 141 141 142 142 143 144 144 145 146 146 148 148 150 Chapter 9 156 156 157 157 158 159 159 160 161 161 161 162 162
Setting the Startup Disk Renaming Computers Synchronizing Computer Time Setting Computer Audio Volume Repairing File Permissions Adding Items to the Dock Changing Energy Saver Preferences Changing Sharing Preferences for Remote Login Setting Printer Preferences Managing Computers Opening Files and Folders Opening Applications Quitting Applications Without Logging Out the User Putting a Computer to Sleep Waking Up a Computer Locking a Computer Screen Displaying a Custom Picture on a Locked Screen Unlocking a Computer Screen Disabling a Computer Screen Logging In a User at the Login Window Logging Out the Current User Restarting a Computer Shutting Down a Computer Starting Up a Computer UNIX Shell Commands Send UNIX Command Templates Executing a Single UNIX Command Executing Scripts Using Send UNIX Command Built-in Command-Line Tools Automating Tasks Working with the Task Server Preliminary Planning for Using the Task Server Setting Up the Task Server Setting Up an Admin Console to Query the Task Server Setting Up Clients to Interface with the Task Server Using Automatic Data Reporting Setting the Client's Data Reporting Policy Creating a Template Data Reporting Policy Working with Scheduled Tasks Setting Scheduled Tasks Editing Scheduled Tasks Deleting Scheduled Tasks
Contents
7
162 163 166 Appendix A 167 167 167 168 168 169 169 170 171 171 174 175 175 175 176 176 178 178 179 179 180 180 187 189
Using Scripting and Automation Tools with Remote Desktop Using AppleScript with Remote Desktop Using Automator with Remote Desktop Icon and Port Reference Client Status Icons Apple Remote Desktop Status Icons List Menu Icons Task Status Icons System Status Icons (Basic) System Status Icons (Detailed) TCP and UDP Port Reference Report Field Definitions Reference System Overview Report Storage Report USB Devices Report FireWire Devices Report Memory Report Expansion Cards Report Network Interfaces Report Network Test Report Administration Settings Report Application Usage Report User History Report AppleScript Remote Desktop Suite Classes and Commands for the Remote Desktop Application. PostgreSQL Schema Sample
Appendix B
Appendix C
Appendix D Index
8
Contents
What Is Apple Remote Desktop?
Apple Remote Desktop 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 interactive 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, update, 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 any of several hardware or software reports  Control and manage multiple computer systems simultaneously, making shutdown, restart, and sending UNIX commands fast and easy  Provide help and remote assistance to 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 You can use Apple Remote Desktop to manage your client systems. IT administrators use Remote Desktop in education and business to simplify and empower the management of their organizations computer assets. For system administrators, Apple Remote Desktop can be used to administer large numbers of servers, like a virtual Keyboard-Video-Mouse (KVM) sharing unit. In computer administration environments, it's the ideal solution for managing remote systems, reducing administration costs, and increasing productivity. Apple Remote Desktop can also be used by educators to facilitate instruction in computer labs or one-on-one learning initiatives. Used in a classroom, Apple Remote Desktop enhances the learning experience and allows teachers to monitor and control students' computers.
Preface
9
About This Book
Using This Guide
The Apple Remote Desktop Administrator's Guide contains chapters to help you use Remote Desktop. It contains overviews and explanations about Apple Remote Desktop's features and commands. It also explains how to install and configure Apple Remote Desktop on clients, how to administer client computers, and how to use Remote Desktop to interact with computer users. This guide is provided on the Apple Remote Desktop 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.
Remote Desktop Help
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. Additionally, the Remote Desktop Help contains new information, corrections, and latebreaking information about Apple Remote Desktop. T ...
