Apple M9547Z/A Administration Guide
Apple M9547Z/A - Remote Desktop - Mac Manual
 |
UPC - 718908688908
View all Apple M9547Z/A manuals
Add to My Manuals
Save this manual to your list of manuals |
Apple M9547Z/A manual content summary:
- Apple M9547Z/A | Administration Guide - Page 1
Apple Remote Desktop Administrator's Guide Version 3.2 - Apple M9547Z/A | Administration Guide - Page 2
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, Inc., registered in the U.S. and other countries. Use of the "keyboard" Apple logo (Option-Shift - Apple M9547Z/A | Administration Guide - Page 3
Guide 10 Remote Desktop Help 10 Notation Conventions 11 Where to Find More Information About Apple Remote Desktop 13 Using Apple Remote Desktop 13 Administering Computers 15 Deploying Software 18 Taking Inventory 22 Housekeeping 24 Supporting Remote Desktop Administrator Application 38 Interface Tips - Apple M9547Z/A | Administration Guide - Page 4
Upgrading the Client Software 44 Method #1-Remote Upgrade Installation 45 Method #2-Manual Installation 46 Upgrading Apple Remote Desktop Clients Using SSH 46 Creating 69 Apple Remote Desktop Administrator Access Using Directory Services 69 Creating Administrator Access Groups 72 Enabling Directory - Apple M9547Z/A | Administration Guide - Page 5
Chapter 6 Chapter 7 72 Apple Remote Desktop Guest Access 73 Apple Remote Desktop Nonadministrator Access 73 Limiting Features in the Administrator Application 74 Virtual Network Computing Access 75 Command-Line SSH Access 75 Managing Client Administration Settings and Privileges 76 Getting an - Apple M9547Z/A | Administration Guide - Page 6
Data Collection 123 Report Database Recommendations and Bandwidth Usage 124 Auditing Client Usage Information 126 Finding Files, Folders, and Applications 128 Comparing Software 130 Auditing Hardware 135 Testing Network Responsiveness 136 Exporting Report Information 137 Using Report Windows to Work - Apple M9547Z/A | Administration Guide - Page 7
Sharing Preferences for Remote Login 144 Setting Printer Preferences 146 Managing Computers 146 Opening Files and Folders 147 Opening Applications 148 Quitting Applications Without Logging Out the User 148 Putting a Computer to Sleep 149 Waking Up a Computer 149 Locking a Computer Screen 150 - Apple M9547Z/A | Administration Guide - Page 8
Devices Report 185 Memory Report 186 Expansion Cards Report 186 Network Interfaces Report 188 Network Test Report 188 Administration Settings Report 189 Application Usage Report 189 User History Report Appendix C 191 AppleScript Remote Desktop Suite 191 Classes and Commands for the Remote Desktop - Apple M9547Z/A | Administration Guide - Page 9
easy  Provide help and remote assistance to users when they encounter problems  Interact with users by sending text messages, observing and controlling users Apple Remote Desktop can also be used by educators to facilitate instruction in computer labs or one-on-one learning initiatives. Used in - Apple M9547Z/A | Administration Guide - Page 10
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 use Remote Desktop's commands effectively. In many tasks shown in this manual and in Remote Desktop Help, you need to choose menu commands - Apple M9547Z/A | Administration Guide - Page 11
on the Apple Remote Desktop website: www.apple.com/remotedesktop/ You can find the most recent edition of the Apple Remote Desktop Administrator's Guide at: Â the Apple Server Division Documentation page www.apple.com/server/documentation/ Â the Remote Desktop section of Apple.com, and www.apple.com - Apple M9547Z/A | Administration Guide - Page 12
website provides a database of technical articles about product issues, use, and implementation: www.apple.com/support/remotedesktop/ To provide feedback about Apple Remote Desktop, visit the feedback page: www.apple.com/feedback/remotedesktop.html For details about how to join the - Apple M9547Z/A | Administration Guide - Page 13
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 Apple Remote Desktop's administration and user - Apple M9547Z/A | Administration Guide - Page 14
Remote Desktop 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 - Apple M9547Z/A | Administration Guide - Page 15
from your Apple Remote Desktop administrator computer or from a computer running Mac OS X Server. Administrator computer Deploy drag-and-drop application folders Deploy configuration files Deploy install packages (.pkg or .mpkg) Deploy UNIX shell scripts Set startup disk Mac OS X Server - Apple M9547Z/A | Administration Guide - Page 16
want to:  Distribute school project materials or business forms and templates  Automate the installation of multiple installer packages  Deploy custom applications Before performing remote installations, you can send an Apple Remote Desktop text message to notify users, perhaps letting them know - Apple M9547Z/A | Administration Guide - Page 17
manually restart and configure each computer individually. Distributing Preference Files Managed computers often require a standard set of preferences for each instance of an application automate PDF workflows, or job instructions for computational clusters. Chapter 1 Using Apple Remote Desktop 17 - Apple M9547Z/A | Administration Guide - Page 18
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. Taking Inventory Apple Remote Desktop lets you capture data describing the attributes of client computers, then generate reports based on the - Apple M9547Z/A | Administration Guide - Page 19
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. Spotlight File Search Use the Spotlight Search report - Apple M9547Z/A | Administration Guide - Page 20
. You can also learn whether a user has installed an application that shouldn't be installed. System Overview Report The System Overview There are numerous uses for this report, such as identifying problems or verifying system configurations before installing new software, or determining - Apple M9547Z/A | Administration Guide - Page 21
Application Usage Report Use the Application Usage report to find out which applications have been running on your client computers and who ran those applications. Network Test Report A Network Test report helps you measure and troubleshoot can help you isolate the problem to a particular cable or - Apple M9547Z/A | Administration Guide - Page 22
Housekeeping Apple Remote Desktop provides several ways to remotely control client computers for housekeeping activities, which you can conduct using one or more Apple Remote Desktop windows. Administrator computer Restart, shut down, sleep, and start up Empty Trash Remote screen control Execute - Apple M9547Z/A | Administration Guide - Page 23
activities on the desktop of Xserve computers, or use graphical applications on them. Apple Remote Desktop replaces the need for KVM performance or other problems. Changing Startup Disks Change the startup disk of a client computer to perform diagnostic or troubleshooting activities. For example - Apple M9547Z/A | Administration Guide - Page 24
in order to perform a demonstration. Providing Help Desk Support When a user is having trouble, Apple Remote Desktop provides several ways to interact with the user and his or her computer to diagnose and fix the problem. Administrator computer Distribute items electronically Control, observe, and - Apple M9547Z/A | Administration Guide - Page 25
notification on the administrator computer alerts you to the message, and you can use several techniques to obtain more information and troubleshoot the problem. Chatting with the User Conduct two-way Apple Remote Desktop text communication with the user to obtain more information. Screen Monitoring - Apple M9547Z/A | Administration Guide - Page 26
text messages Observe and share one or multiple screens Control screen Lock screens Open applications or files Log out students Distribute items electronically One-to-one help desk support Classroom Using Text Messages Send Apple Remote Desktop text messages to communicate with students - Apple M9547Z/A | Administration Guide - Page 27
, 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. Chapter - Apple M9547Z/A | Administration Guide - Page 28
instructions for performing the tasks highlighted in this chapter- and more-throughout this manual. report data User login accounting Application usage Deleting items Emptying the imaging administration guide at: www.apple.com/server/documentation/ Â You can find the Software Delivery Guide on the - Apple M9547Z/A | Administration Guide - Page 29
screenshots and short descriptions of Remote Desktop's interface, as well as detailed instructions for customizing the appearance and preferences of the application. You will learn about: Â "Remote Desktop Human Interface Guide" on page 29 Â "Configuring Remote Desktop" on page 37 Â "Interface Tips - Apple M9547Z/A | Administration Guide - Page 30
Remote Desktop Main Window The main window of Remote Desktop has a customizable toolbar, groups of lists, tasks, and scanners on the left, and the main window area to the right. "List Menu Icons" on page 178 contains icons seen in the list menu of the main window. K L A B C D E F G H I J A All - Apple M9547Z/A | Administration Guide - Page 31
G Task server list: This lists tasks delegated to the Task Server, rather than run those run directly from the application. When all the target computers have come online and participated in the task, the task is labeled as complete. H Active tasks list: This list shows - Apple M9547Z/A | Administration Guide - Page 32
C Task configuration area: This area is different for every task. It's where you set operating parameters for the task to be performed. D Participating computers: This area shows you the computers that will be affected by the task. You can add or remove computers in this area without changing - Apple M9547Z/A | Administration Guide - Page 33
Control and Observe Window This window is the same for both controlling and observing a single client. The only difference is the state of the Observe or Control toggle button. When it's selected, you have control over the remote client. A BCDE F G H I J A Observe or control toggle: When this - Apple M9547Z/A | Administration Guide - Page 34
). F Account picture: Shows the login icon of the currently logged in user. G Computer status: Shows basic computer status beneath each client screen. H Cycle through pages: Manually advances to the next page of screens. 34 Chapter 2 Getting to Know Remote Desktop - Apple M9547Z/A | Administration Guide - Page 35
I View Options: Reveals the view option controls. J Observed computers: Contains the scaled desktops of the observed client computers. Report Window Reports serve as valuable shortcuts when you're copying files and organizing computer lists. CB A CB D E F A Report category: Most reports have - Apple M9547Z/A | Administration Guide - Page 36
item is in The full file path The file extension indicating the file type (.app, .zip, .jpg) The last date and time the file was changed and indicating whether it is visible in the Finder If an application, the version reported If an application, the version reported The item owner's short name The - Apple M9547Z/A | Administration Guide - Page 37
, Text Chat)  Whether to show the client idle time  Whether to accept messages from client users  What warnings may appear when quitting the application  A new serial number In the Control & Observe pane, you can set:  Whether a remote screen is shown in a window or a full screen  Whether - Apple M9547Z/A | Administration Guide - Page 38
is being used as a Task Server  Whether other Apple Remote Desktop administrators can access your local Task Server  Whether clients collect user and application tracking data  A saved template for scheduling client reporting policies In the Labels pane, you can set:  Label colors and text for - Apple M9547Z/A | Administration Guide - Page 39
Drag and drop works on configuration dialogs Configuration dialogs accept dragged items. Computer lists in the dialogs accept dragged computers. The Copy Items dialog accepts dragged files to copy, without having to browse the file system for them. Save yourself time and effort by dragging available - Apple M9547Z/A | Administration Guide - Page 40
40 Chapter 2 Getting to Know Remote Desktop - Apple M9547Z/A | Administration Guide - Page 41
ll need your install disc, the serial number, and either the printed Welcome instructions, or these instructions. This chapter describes how to install Apple Remote Desktop for system administration and (optional) Â Mac OS X Server version 10.3 or later with NetBoot and NetInstall services enabled 41 - Apple M9547Z/A | Administration Guide - Page 42
disc. 2 Double-click the Remote Desktop installer package and follow the onscreen instructions. The Remote Desktop application will be installed in the Applications folder. 3 Launch Remote Desktop (in the Applications folder). The Remote Desktop Setup Assistant appears. 4 Enter the serial number - Apple M9547Z/A | Administration Guide - Page 43
. See "Method #2-Manual Installation" on page 45 for more information. If you're setting up Mac OS X Server for the first time using Server Setup Assistant, you can enable Apple Remote Desktop as one of the initial services. This allows you to administer a server immediately after server software - Apple M9547Z/A | Administration Guide - Page 44
Software" on page 42, for detailed instructions. If you are upgrading from version " on page 41). Please note that there is no supported "downgrade" to any previous version, and if you upgrade Update, or they must be updated manually. See "Method #2-Manual Installation" on page 45 for more information - Apple M9547Z/A | Administration Guide - Page 45
to add or edit user names and passwords for Apple Remote Desktop authentication. To manually upgrade the client software: 1 Use Remote Desktop to create a client software installer package. For detailed instructions, see "Creating a Custom Client Installer" on page 46. 2 Copy and install the package - Apple M9547Z/A | Administration Guide - Page 46
client software using SSH: 1 Create the custom client installer package. For detailed instructions, see "Creating a Custom Client Installer" on page 46. 2 Open the Terminal application (located in /Applications/Utilities/). 3 Copy the installer package to the client computer by typing: $ scp - Apple M9547Z/A | Administration Guide - Page 47
user, and click Continue when you're ready to go on. 10 Choose whether to assign Apple Remote Desktop administrator access privileges to Directory Services groups. If you choose to do so, select "Enable directory-based administration." See "Apple Remote Desktop Administrator Access Using Directory - Apple M9547Z/A | Administration Guide - Page 48
enabled in Workgroup Manager's legacy application preference settings: Â "Allow approved applications to launch non-approved applications" Â "Allow UNIX tools to run" For more information about Workgroup Manager, see the Mac OS X Server user management guide. 48 Chapter 3 Installing Apple Remote - Apple M9547Z/A | Administration Guide - Page 49
/RemoteDesktop 6 Delete the Apple Remote Desktop support files from /Library/Application Support/ using the following commands in the Terminal application: $ rm -rf ~/Library/Application\ Support/Remote\ Desktop/ $ sudo rm -rf /Library/Application\ Support/Apple\ Remote\ Desktop/ 7 Delete the Apple - Apple M9547Z/A | Administration Guide - Page 50
Disabling the Client Software You may want to temporarily disable Apple Remote Desktop on a client without removing the software. WARNING: Because Apple Remote Desktop is part of the default Mac OS X v10.3, v10.4, and v10.5 installation, do not remove the Apple Remote Desktop client components. To - Apple M9547Z/A | Administration Guide - Page 51
sufficient to stop Apple Remote Desktop system activity. See "Disabling the Client Software" on page 50 for instructions. To uninstall client software: 1 Open Terminal (located in /Applications/Utilities). 2 Delete the client pieces from /System/Library/ using the following commands in the Terminal - Apple M9547Z/A | Administration Guide - Page 52
52 Chapter 3 Installing Apple Remote Desktop - Apple M9547Z/A | Administration Guide - Page 53
4 Organizing Client Computers Into 4 Computer Lists Apple Remote Desktop uses lists of client computers to logically organize the client computers under your control. Connecting to client computers on the network and adding them to your list is necessary to administer them. This chapter describes - Apple M9547Z/A | Administration Guide - Page 54
Once you have found a potential client, you see the following default information: Search column (none) (none) Name IP Address DNS Name ARD Version Network Interface Description Displays a small icon indicating whether the computer is already in the All Computers List. Displays a small icon - Apple M9547Z/A | Administration Guide - Page 55
Finding Clients by Searching the Local Network When you choose a local network scanner, Remote Desktop sends a subnet broadcast to computers on the same subnets as the administrator computer. All possible clients on the local subnets appear in a list on the right side of the Remote Desktop window. - Apple M9547Z/A | Administration Guide - Page 56
Finding Clients by Network Address If you know the exact IP address or fully qualified domain name of a computer, you can use that IP address or domain name to add the computer to your All Computers list. To add a specific address immediately to the All Computers list: 1 Choose File > Add by Address - Apple M9547Z/A | Administration Guide - Page 57
Finding Clients by File Import You can import a list of computers into Apple Remote Desktop by importing a file listing the computers' IP addresses. The list can be in any file format (text, spreadsheet, word processor) and must contain either IP addresses or fully qualified domain names (such as - Apple M9547Z/A | Administration Guide - Page 58
5 Customize the search by entering the specific parameters for the search (such as an IP address range, or file location). You can find out how to customize the search in the following sections: Â "Finding Clients by Using Bonjour" on page 54 Â "Finding Clients by Searching the Local Network" on - Apple M9547Z/A | Administration Guide - Page 59
Creating an Apple Remote Desktop Computer List You can make more specific, targeted lists of computers from your All Computers list. The easiest way to make a new list is to use computers already in the All Computers list. You can also create blank lists and add computers to them later. To create an - Apple M9547Z/A | Administration Guide - Page 60
To create a smart computer list: 1 Choose File > New Smart List. 2 Name the smart computer list. 3 Choose "any" or "all" criteria to match. 4 Select the attribute to select by, using the pop-up windows and text entry field. 5 Add any other criteria with the Add (+) button. 6 Click OK. The new smart - Apple M9547Z/A | Administration Guide - Page 61
Desktop 3. Lists transferred in this way retain their client computers as well as the original name of the list. You can only use these instructions to move computer lists between administrator computers which run Apple Remote Desktop 3. When you import or export a computer list, the user name and - Apple M9547Z/A | Administration Guide - Page 62
computer, launch Remote Desktop. 7 Using the Scanner, add the clients by File Import. See "Finding Clients by File Import" on page 57, for detailed instructions. The list now appears in Remote Desktop's main window. 8 Select the computers in the list. 9 Choose File > New List From Selection. The new - Apple M9547Z/A | Administration Guide - Page 63
To transfer the computer lists: 1 Open Keychain Access (located 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 - Apple M9547Z/A | Administration Guide - Page 64
64 Chapter 4 Organizing Client Computers Into Computer Lists - Apple M9547Z/A | Administration Guide - Page 65
their uses. You can learn about: Â "Apple Remote Desktop Administrator Access" on page 65 Â "Apple Remote Desktop Administrator Access Using Directory Services" on page 69 Â "Apple Remote Desktop Guest Access" on page 72 Â "Apple Remote Desktop Nonadministrator Access" on page 73 Â "Virtual Network - Apple M9547Z/A | Administration Guide - Page 66
177. Create hardware and software reports using the Report menu; use Set Reporting Policy and Spotlight Search. Use these Manage menu commands: Open Application, Open Items, Send UNIX Command and Log Out Current User. Use these Manage menu commands: Rename Computer, Send UNIX Command and Set Startup - Apple M9547Z/A | Administration Guide - Page 67
If you allow access to the computer using Apple Remote Desktop, the administrator can see the client computer in the Computer Status window and include it in Network Test reports, even if no other options are selected. Setting Apple Remote Desktop Administrator Access Authorization and Privileges - Apple M9547Z/A | Administration Guide - Page 68
enter the user name and password of a user with administrator privileges on that computer. 2 Select Apple Remote Desktop in the Sharing service pane. 3 Click Access Privileges. 4 Select each user that you want enabled for Apple Remote Desktop administration authentication. 5 Select a listed user - Apple M9547Z/A | Administration Guide - Page 69
master domain, you don't have to add users and passwords to the client computers for Apple Remote Desktop access and privileges. When Directory Services authorization is enabled on a client, the user name and password you supply when you authenticate to the computer are checked in the directory - Apple M9547Z/A | Administration Guide - Page 70
Management Privilege Generate reports Open and quit applications Change settings Copy items Delete and replace items Send messages Restart and shut down Control Observe Show being observed ard_admin X X X X X X X X X X ard_reports X ard_manage ard_interact X X X X X X X X X X X In the - Apple M9547Z/A | Administration Guide - Page 71
The following is the sample XML format you need to use to assign management privileges via MCX keys. It assigns the above "ard_interact" privileges to the groups named "some_group" and "staff." It also assigns the "ard_manage" privileges to the group named "staff," the "ard_admin" privileges to the - Apple M9547Z/A | Administration Guide - Page 72
work as expected with Apple Remote Desktop 3. Enabling Directory Services Group Authorization In order to enable group-based authorization for directory-based administration on the clients using Directory Utility (in /Applications/Utilities/). Apple Remote Desktop Guest Access You can configure an - Apple M9547Z/A | Administration Guide - Page 73
the computer with Remote Desktop installed can choose which features and tasks are available to nonadministrator users. Limiting Features in the Administrator Application User mode is a great way to delegate administrative tasks, or give users only the features of Remote Desktop that they really use - Apple M9547Z/A | Administration Guide - Page 74
 Send UNIX commands Each of these features can be enabled or disabled independently of each other, or you can enable all of Remote Desktop's features for nonadministrator users. To enable User Mode: 1 Make sure you are logged in as an administrator user. 2 Open Remote Desktop. 3 Choose Remote - Apple M9547Z/A | Administration Guide - Page 75
specialized logins for certain tasks, limiting potentially disruptive power of certain sub-administrators. The following section gives detailed instructions for checking the administrator privilege settings of client computers, and changing those settings. Chapter 5 Understanding and Controlling - Apple M9547Z/A | Administration Guide - Page 76
, you can change the administrator access privileges for multiple computers simultaneously, using the Change Client Settings command. If you are using Directory Services to designate administrator privileges, you don't need to change the settings on the clients. To make changes on a client, you must - Apple M9547Z/A | Administration Guide - Page 77
administration." See "Apple Remote Desktop Administrator Access Using Directory Services" on page 69 for more information on using this the clients' settings. 17 Choose whether to execute the change using the application or a dedicated task server. For more detailed information about setting up and - Apple M9547Z/A | Administration Guide - Page 78
78 Chapter 5 Understanding and Controlling Access Privileges - Apple M9547Z/A | Administration Guide - Page 79
administration, as well as best-practice tips for your network. Additionally, it contains information about Apple Remote Desktop security features, and detailed instructions for enabling them. You can learn about: Â "Setting Up the Network" on page 79 Â "Using Apple Remote Desktop with Computers in - Apple M9547Z/A | Administration Guide - Page 80
 Organize computers you're administering using Apple Remote Desktop into small groups, and close the Remote Desktop administrator application when not in use. This helps reduce the number of status queries, thus reducing network traffic.  If a client has a slow network type, consider running it - Apple M9547Z/A | Administration Guide - Page 81
password used to access Remote Desktop can be stored in a keychain or can be required to be typed each time you open the application. However, the administrator name and password for each client computer are stored in the administrator's preferences and are strongly encrypted. Chapter 6 Setting Up - Apple M9547Z/A | Administration Guide - Page 82
Administrator Application Security  Make use of user mode to limit what nonadministrator users can do with Remote Desktop. See "Apple Remote Desktop Nonadministrator Access" on page 73.  - Apple M9547Z/A | Administration Guide - Page 83
may choose to encrypt these as well by changing your application preferences). This information is encrypted using the Advanced Encryption trying to control a VNC server which is not Remote Desktop, it will not support Remote Desktop keystroke encryption. If you try to control that VNC server, you - Apple M9547Z/A | Administration Guide - Page 84
To enable Observe and Control transport encryption: 1 Choose Remote Desktop > Preferences. 2 Click the Security button. 3 In the "Controlling computers" section, select "Encrypt all network data." Encrypting Network Data During Copy Items and Install Packages Tasks Remote Desktop can send files for - Apple M9547Z/A | Administration Guide - Page 85
messaging with remote users, or sharing your screen with others. This chapter describes Remote Desktop's user interaction capabilities and gives complete instructions for using them. You can learn about: Â "Controlling" on page 86 Â "Observing" on page 93 Â "Sending Messages" on page 100 Â "Sharing - Apple M9547Z/A | Administration Guide - Page 86
, some keyboard shortcut commands are not sent to the remote computer, but they affect the administrator computer. These include: Â Change Active Application (Command-Tab and Command-Shift-Tab) Â Show or Hide Dock (Command-Option-D) Â Log Out User (Command-Shift-Q) Â Take Screen Shot (Command - Apple M9547Z/A | Administration Guide - Page 87
These instructions assume that the observed computer has Apple Remote Desktop installed and configured properly (see "Setting Up an Apple Remote Desktop Client Computer for the First - Apple M9547Z/A | Administration Guide - Page 88
Switching the Control Window Between Full Size And Fit-To-Window When controlling a client, you can see the client window at full size, or scaled to fit the control window. Viewing the client window at full size will show the client screen at its real pixel resolution. If the controlled computer's - Apple M9547Z/A | Administration Guide - Page 89
Hiding a User's Screen While Controlling Sometimes you may want to control a client computer with a user at the client computer, but you don't want the user to see what you're doing. In such a case, you can disable the client computer's screen while preserving your own view of the client computer. - Apple M9547Z/A | Administration Guide - Page 90
to control a VNC server which is not Remote Desktop, it will not support Remote Desktop keystroke encryption. If you try to control that VNC server, you "Encrypting Observe and Control Network Data" on page 83. These instructions assume the observed computer has been added to an Apple Remote Desktop - Apple M9547Z/A | Administration Guide - Page 91
very basic, high-level steps for setting up a non-Mac OS X client to be viewed with Remote Desktop. This section cannot give detailed instructions, since the client operating system, VNC software, and firewall will be different. The basic steps are: 1 Install VNC Server software on the client - Apple M9547Z/A | Administration Guide - Page 92
VNC Control Options After you have added a VNC server to a computer list (or when you are first adding it), you can set a custom port for VNC communication, and you can designate a display to control. To set a custom port on an existing computer list member: 1 Select a computer list in the Remote - Apple M9547Z/A | Administration Guide - Page 93
If you want to control the third display, you would enter: vncserver.example.com:5902 Configuring an Apple Remote Desktop Client to be Controlled by a VNC Viewer When configured to do so, an Apple Remote Desktop client can be controlled with a non-Apple VNC viewer. Allowing a non-Apple VNC viewer - Apple M9547Z/A | Administration Guide - Page 94
chosen to fit on one screen, you can cycle through multiple pages by clicking the Previous or Next button. Cycle Pages: Use these buttons to manually switch to the previous or next page of screens. 94 Chapter 7 Interacting with Users - Apple M9547Z/A | Administration Guide - Page 95
Getting More Information on Observed Clients There is a computer information area beneath each of the observed desktops. It's automatically disabled when the administrator is viewing more computers than the computer information area is able to show effectively (a threshhold of about 220 pixels - Apple M9547Z/A | Administration Guide - Page 96
Setting Account picture Computer status Use shapes for status Effect Select this to display the currently logged-in user's account picture under each observed desktop. See "Viewing a User's Account Picture While Observing" on page 96 for more information. Select this to add a colored status - Apple M9547Z/A | Administration Guide - Page 97
. This information gives you a basic assessment of the following service statistics:  CPU Usage  Disk Usage  Free Memory There can click the "i" to get more information. Clicking the icon exposes per-service status icons: Service CPU Usage Icon Status Usage is at 60% or less Usage is between - Apple M9547Z/A | Administration Guide - Page 98
Service Free Memory Icon Status No status information is available Less than the observe window toolbar. Regardless of your toolbar customizations, you'll be able to advance through pages manually, change the titling of the observed screens, change the number of client screens per page, change - Apple M9547Z/A | Administration Guide - Page 99
the same time. You can set the number of client screens that appear at any one time. See "Setting Preferences for the Remote Desktop Administrator Application" on page 37 for more information. If a client has a screen saver running when you start observing, the screen saver remains in effect. The - Apple M9547Z/A | Administration Guide - Page 100
You can use text messages to give instructions or announcements, to collaborate remotely, or troubleshoot with users. There are two types of or information to users client computers. The announcements appear in front of open application windows and can be dismissed by the user. To send a one-way - Apple M9547Z/A | Administration Guide - Page 101
5 Press the Return key to complete and send each line. Viewing Attention Requests After a client user sends an attention request, the Apple Remote Desktop administrator can read the attention request text. To view attention requests: 1 Choose Window > Messages From Users. 2 Select the message you - Apple M9547Z/A | Administration Guide - Page 102
Monitoring a Screen Sharing Tasks You may want to keep track of the screen sharing tasks you have begun. You can get information on all active screen sharing tasks, and can sort the tasks by time started, source screen, or target computers. To view current active screen sharing tasks: m Choose - Apple M9547Z/A | Administration Guide - Page 103
you want to use. You could use a graphic file, or take a picture using an iSight camera. 2 Open System Preferences. The System Preferences application launches. 3 Select the Accounts pane. 4 Select your account, and choose the Picture button. 5 Replace your current account picture with the new - Apple M9547Z/A | Administration Guide - Page 104
104 Chapter 7 Interacting with Users - Apple M9547Z/A | Administration Guide - Page 105
powerful administrative control. You can manually or automatically get detailed information about every computer, install software, and maintain systems from a single administrator computer. This chapter describes Remote Desktop's capabilities and gives complete instructions for using them. You can - Apple M9547Z/A | Administration Guide - Page 106
. 4 Click the Tasks button. 5 Select "Enable task notification script." 6 Choose the location of the script. The default notification script is located at /Library/Application Support/Apple/Remote Desktop/Notify. 7 Close the Preferences window. 106 Chapter 8 Administering Client Computers - Apple M9547Z/A | Administration Guide - Page 107
Getting Active Task Status When you get a task's current status, you see the progress of the task, the computers involved, and their feedback to the administrator computer. To get status on a currently running task: 1 Select the Active Tasks list. 2 Select the desired task in the Remote Desktop - Apple M9547Z/A | Administration Guide - Page 108
Stopping a Currently Running Task If a task is in progress and Remote Desktop is still waiting for feedback from the client computers, you can stop the task. You use the Active Tasks list to stop the command in progress. To stop a currently running task: 1 Select the Active Tasks list. 2 Select the - Apple M9547Z/A | Administration Guide - Page 109
Creating and Using Task Templates In each task configuration dialog, you can save a task's settings to a template to reuse for future tasks of that same type. For example, if you always use certain copy options for a Copy Items task, you can save those settings as a template, and have them apply to - Apple M9547Z/A | Administration Guide - Page 110
Editing a Saved Task You may want to change a previously saved task, changing whether what the task does or changing the target computers. To edit a saved task: 1 Double-click the saved task you want to edit. Alternatively, you could use Control-click or right-click and choose Edit Task from - Apple M9547Z/A | Administration Guide - Page 111
the Task Server" on page 166. For detailed instructions about installing via the Task Server, see " restart the computers upon completion, or restart the computers manually later. It is not possible to stop the administrator can use the PackageMaker application (available on the Apple Remote - Apple M9547Z/A | Administration Guide - Page 112
of 10) instead of the multicast traffic used when the Remote Desktop application performs the installation. Remote Desktop first copies the installation package to the Task Server, and gives the Task Server the necessary instructions to install the package to all the selected computers, even if some - Apple M9547Z/A | Administration Guide - Page 113
7 Click Install. Installing by Using the Copy Items Command Many applications can be installed simply by copying the application or its folder to the client computer. Consult the application's documentation to verify that you can simply copy the application to the hard disk to install it. To install - Apple M9547Z/A | Administration Guide - Page 114
want to copy is in the list. 5 Select a destination. There are several preset locations available in the "Place items in" pop-up menu, including the Applications folder. If you do not see the location you want, you can specify a full pathname. 6 Select your copy options. See "Copy Options" on page - Apple M9547Z/A | Administration Guide - Page 115
, you may need to use an uninstaller before installing the new version. Consult the software's manual for instructions on removing its software. If an uninstaller application is necessary, you can copy it to each of the client computers and run it remotely. 3 Use the appropriate installation - Apple M9547Z/A | Administration Guide - Page 116
copying a single file archive (like a .zip or .sit file) to remote computers for faster copying. Remember that Mac OS X applications are bundles of many smaller files. Although the application you want to copy looks like a single file in the Finder, it may contain hundreds, or even thousands of - Apple M9547Z/A | Administration Guide - Page 117
Copy Destination Locations There are several preset destinations available in the "Place Items In" destination popup menu, including the Applications folder. If you do not see the destination you want, you can specify a full pathname. Owner and Group for Copied File By default, the copied - Apple M9547Z/A | Administration Guide - Page 118
You can choose to open a copied item immediately after it's copied. If you select this option, the file will open with the parent application that created it. Copying from Administrator to Clients Using Apple Remote Desktop, you can copy items to any number of client computers simultaneously. To - Apple M9547Z/A | Administration Guide - Page 119
window. 2 Select one or more computers in the selected computer list. 3 Choose a file search report to find the item. See "Finding Files, Folders, and Applications" on page 126 for more information. 4 Select the item you want to copy in the report window. 5 Drag the item you want to copy from - Apple M9547Z/A | Administration Guide - Page 120
has the same software. You can automate the software restoration process by using the instructions in "Setting Scheduled Tasks" on page 170. You may want to start by creating a disk image that contains the Mac OS X applications and items you want to copy. Alternatively, you can copy files from any - Apple M9547Z/A | Administration Guide - Page 121
Remote Desktop uses when searching for report information: new data, cached data, and Spotlight data. With a new data search, the Remote Desktop application queries a client directly, and waits for the client computer to respond with the desired information. A new data search gets the most recent - Apple M9547Z/A | Administration Guide - Page 122
be done on client computers running Mac OS X 10.4 or later. Spotlight searches a comprehensive, constantly updated index that sees all the metadata inside supported files-the "what, when and who" of every piece of information saved on your Mac-including the kind of content, the author, edit history - Apple M9547Z/A | Administration Guide - Page 123
case, you will probably give yourself your own denial-of-service attack. Increasing the number of Task Server computers can divide clients will always try to use all available bandwidth (most IP-based client/server applications work this way). Therefore, on a 10Mbit/sec. network, the report data - Apple M9547Z/A | Administration Guide - Page 124
you audit information about how the clients are being used:  the User History report  the Application Usage report Generating a User History Report The User History report is used to track who has Data Reporting Policy" on page 169 for instructions. 124 Chapter 8 Administering Client Computers - Apple M9547Z/A | Administration Guide - Page 125
to enable its collection explicitly in the clients' reporting policy. See "Setting the Client's Data Reporting Policy" on page 169 for instructions. To generate an Application Usage report: 1 Select a computer list in the Remote Desktop window. 2 Select one or more computers in the selected computer - Apple M9547Z/A | Administration Guide - Page 126
the administrator computer. These searches can compare software versions, fonts, applications, or installed packages. Using Spotlight to Find Items You can found locally on a computer with Mac OS X v10.4 or later. It supports many of the same features and queries as Spotlight on a local computer. - Apple M9547Z/A | Administration Guide - Page 127
File Search report allows you to find up to a total of 32,000 items on selected computers. The items can be files, folders, or applications, but they can only be items accessible (or visible) in the Finder. The search parameters include:  Name  Parent path  Full path  Extension  Date created - Apple M9547Z/A | Administration Guide - Page 128
one or more computers in the selected computer list. 3 Choose Report > Software Version. 4 Select the software you want to compare, from the application list. You can select up to 10 applications. If the application you want doesn't appear in the list, click the Add (+) button to browse for the - Apple M9547Z/A | Administration Guide - Page 129
in /Library/Receipts/. You can use this report to find out if your clients have the applications or fonts they need. Comparing differences in installed packages can help you troubleshoot software conflicts, and keep your client computers up to date. To generate a Software Difference report: 1 Select - Apple M9547Z/A | Administration Guide - Page 130
Auditing Hardware You can get a report about the hardware of any client computer. Hardware information can be accessed using a number of different reports. Although some basic hardware information can be found in the System Overview report, several more focused hardware reports provide more detailed - Apple M9547Z/A | Administration Guide - Page 131
Getting Serial Numbers Although there is no specific serial number report for Apple Remote Desktop, the serial number of any client is in the Computer section of the System Overview Report. In addition to using Apple Remote Desktop to retrieve a computer's serial number, you could use the command- - Apple M9547Z/A | Administration Guide - Page 132
Getting FireWire Device Information The FireWire Devices report gets information about FireWire devices connected to the client computer. It can get the following information from a device:  Manufacturer  Model  Device speed  Software version  Firmware revision For more information about - Apple M9547Z/A | Administration Guide - Page 133
, and Ethernet statistics from client computers. The Network Interfaces report can be used to find network errors or faulty network equipment, troubleshoot network performance, and query the network settings of the client computers. All detailed statistics are refreshed when the client restarts, and - Apple M9547Z/A | Administration Guide - Page 134
identifier  Size, type, and speed Memory reports can be used for managing computer resources, hardware troubleshooting, or deciding which client computer can handle a memory-intensive application or task. For more information about the Memory report options, see "Report Field Definitions Reference - Apple M9547Z/A | Administration Guide - Page 135
To generate an Expansion Cards report: 1 Select a computer list in the Remote Desktop window. 2 Select one or more computers in the selected computer list. 3 Choose Report > Expansion Cards. 4 Select the desired expansion card information. 5 To search using new data, select Rebuild Data For Report. - Apple M9547Z/A | Administration Guide - Page 136
large number of lost packets, there may be a network connection problem or a problem with an intervening router or bridge. Exporting Report Information You can export 's SQL database directly with your own SQL query tools or applications. Using standard SQL database queries you can get any or all - Apple M9547Z/A | Administration Guide - Page 137
): Best choice if the report information uses the Roman alphabet, and the exported document will be opened in an application or on an operating system that does not support Unicode text encoding (for example, some installations of Mac OS 9). Â Unicode (UTF-8): Best choice if the exported file will - Apple M9547Z/A | Administration Guide - Page 138
3 Choose Report > File Search. 4 Find the software you want to delete, using the File Search report. For more information, see "Finding Files, Folders, and Applications" on page 126. 5 Select the item or items you want to delete in the File Search report window. 6 Click Delete Selected in the report - Apple M9547Z/A | Administration Guide - Page 139
Emptying the Trash Apple Remote Desktop allows you to empty the Trash on clients to free up disk space. To find out how much free disk space is on a computer, create a System Overview or Storage report using the Report menu. As a part of routine maintenance for client computers, you can free disk - Apple M9547Z/A | Administration Guide - Page 140
times allow for more precise audits and allow you to accurately correlate events between clients on the network. In addition, many internet services rely on, or benefit from, clock times that are synchronized to a Network Time Protocol (NTP) server. Any scheduled event benefits from synchronized - Apple M9547Z/A | Administration Guide - Page 141
Template pop-up menu. Change the time server from time.apple.com to whichever time server you want, if desired. 5 Alternatively, manually enter the UNIX command. a Type or paste the following UNIX command: systemsetup -setusingnetworktime on -setnetworktimeserver b Set the user - Apple M9547Z/A | Administration Guide - Page 142
values. In such a case, it may be necessary to manually repair the permissions on the client. Repairing permissions returns system and dragging and dropping, the file, folder, or application isn't immediately added to the user's Dock. The instructions provided here are a workaround for clients that - Apple M9547Z/A | Administration Guide - Page 143
Type or paste the following UNIX command (replace /Path_To_Application with your own path to the desired application, and be sure to include the application file extension, .app): defaults write com.apple.dock persistent-apps -array-add 'tiledatafile-data - Apple M9547Z/A | Administration Guide - Page 144
more information). a Select System Setup > Remote Login (SSH) from the Template pop-up menu. b Set the login for on or off. 5 Alternatively, manually enter the UNIX command. a Type or paste the following UNIX command: systemsetup -setremotelogin (on | off) b Set the permissions for this command to - Apple M9547Z/A | Administration Guide - Page 145
To set up printer preferences using Copy Items: 1 Set up a client computer's print preference using the Print & Fax System Preferences. 2 Use the Copy Items task to copy the following file and folder to all the target computers: /private/etc/cups/printers.conf /private/etc/cups/ppd/ Because these - Apple M9547Z/A | Administration Guide - Page 146
Out, Sleep, Restart, etc.), as well as other commands. Opening Files and Folders Apple Remote Desktop can open existing items (files, folders, and applications) on client computers. The item to open must be on the administrator computer, in addition to being on the client computers, and must have - Apple M9547Z/A | Administration Guide - Page 147
the item is selected. The Open Items dialog shows the icon and name of the item to open. 6 Click Open. Opening Applications Apple Remote Desktop can open applications on client computers. The application to open must be on the administrator computer, in addition to being on client computers. If the - Apple M9547Z/A | Administration Guide - Page 148
"Send UNIX Command Templates" on page 155 for more information). a Select Miscellaneous > Quit Application from the Template pop-up menu. b Fill in the desired Application Name. 5 Alternatively, manually enter the UNIX command. a Type or paste the following UNIX command: killall "application_name - Apple M9547Z/A | Administration Guide - Page 149
computer using Remote Desktop, the computer's networking hardware must support waking via network packet (wakeonlan), and the computer must copy of Remote Desktop. That way you can control the "sentry" computer and instruct it to wake client computers on its local subnet. To wake a computer: 1 - Apple M9547Z/A | Administration Guide - Page 150
To lock a computer screen: 1 Select a computer list in the Remote Desktop window. 2 Select one or more computers in the selected computer list. 3 Choose Interact > Lock Screen. 4 Enter a message to be displayed on the locked screen, if desired. 5 Click Lock Screen. The client screen goes black, - Apple M9547Z/A | Administration Guide - Page 151
Disabling a Computer Screen Sometimes you may want to control a client computer with a user at the client computer, but you don't want the user to see what you're doing. In such a case, you can disable the client computers screen while preserving your own view of the client computer. This is a - Apple M9547Z/A | Administration Guide - Page 152
4 Type the following AppleScript in the UNIX Command window, adding the user name and password: osascript - Apple M9547Z/A | Administration Guide - Page 153
the same result as choosing the Shut Down command from the client computer's Apple menu. Unless you're trying to shut down an client that supports lights-out management, you cannot shut down a computer that has a status other than "Available." Remote Desktop also uses lights-out management when you - Apple M9547Z/A | Administration Guide - Page 154
, and if they're configured to allow LOM administration. The LOM status can be: LOM Status Available Not Configured Access Denied Offline -- Description The client supports LOM and is configured for administration. You can only start up clients with a LOM status of "Available." The client - Apple M9547Z/A | Administration Guide - Page 155
you have to do is customize the script to your situation. For example, if you want to set a manual IP address for a client computer, in the Template pop-up menu choose Network Setup > Manual IP, replace the placeholder indicated in the pasted UNIX command with the real IP address, and send the - Apple M9547Z/A | Administration Guide - Page 156
Network Setup System Setup Miscellaneous Template name  List All Services  Manual IP  DHCP  BOOTP  Manual with DHCP Router  DNS Servers  Search Domains  Failure  Wake On Modem Activity  Wake On Network Access  Quit Application  Volume Off  Volume On  List Required Software Updates  - Apple M9547Z/A | Administration Guide - Page 157
, is an AppleScript. AppleScripts are files that contain English-like commands, using the AppleScript programming language and they are created using the Script Editor application. Running a UNIX command as the current user will fail if the target computer is at the login window, since there is no - Apple M9547Z/A | Administration Guide - Page 158
Click Send. Executing AppleScripts with Remote Desktop AppleScripts can be executed on client computers in two ways. They can be saved and executed as an application, or sent at once using the command line. To learn more about AppleScript, see AppleScript Help in Help Viewer or go to: www.apple.com - Apple M9547Z/A | Administration Guide - Page 159
would be entered as: osascript - Apple M9547Z/A | Administration Guide - Page 160
10.3 clients use the following: /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/ Support/networksetup -help  For clients with Mac OS X v.10 network service to use BOOTP. networksetup -setbootp "Built-in Ethernet" -setmanualwithdhcprouter Use this command to specify a manual IP - Apple M9547Z/A | Administration Guide - Page 161
a network service with domain and port number. Turns proxy on. Optionally, specify on or off to enable and disable authenticated proxy support. Specify line in the Terminal: /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Support/ systemsetup -help A few of the capabilities of - Apple M9547Z/A | Administration Guide - Page 162
Flag -setremotelogin ( on | off ) -setrestartfreeze ( on | off ) -setrestartpowerfailure ( on | off ) -setsleep minutes -settime hh:mm:ss -settimezone timezone -setusingnetworktime ( on | off ) -setWaitForStartupAfterPowerFailure seconds -setwakeonmodem ( on | off ) -setwakeonnetworkaccess ( on | - Apple M9547Z/A | Administration Guide - Page 163
command in the Mac OS X Server command-line guide that uses systemsetup can be used in Remote Desktop Xserves. The kickstart utility is located at: /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/ Resources/kickstart. The syntax and list of actions possible with kickstart are - Apple M9547Z/A | Administration Guide - Page 164
 Deactivate Remote Desktop access for a computer: $ sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/ Contents/Resources/kickstart -deactivate -configure -access -off 164 Chapter 8 Administering Client Computers - Apple M9547Z/A | Administration Guide - Page 165
UNIX scripts. This chapter describes Remote Desktop's automation capabilities and gives instructions for using them. You can learn about: Â "Working with the acts as a central repository for cached report data. The Remote Desktop application console doesn't need to be open and active, and you can - Apple M9547Z/A | Administration Guide - Page 166
Preliminary Planning for Using the Task Server Before you use Task Server to automate administration, you should first make sure that the network settings and infrastructure are configured properly. To prepare for the Task Server: 1 Check the network settings on the server. The server should have a - Apple M9547Z/A | Administration Guide - Page 167
kickstart tool through SSH to enable the Remote Desktop Sharing and other command-line file copy tools to install the Remote Desktop application. For more information, see "Using kickstart" on page 163. 3 After the installer finishes, launch Remote Desktop and configure it using Setup Assistant - Apple M9547Z/A | Administration Guide - Page 168
client performance needs. The collection policy includes four kinds of information: system data, file data, user accounting data, and application usage data. System data includes information for the following reports:  System Overview  Storage  USB Devices  FireWire Devices  Memory  Expansion - Apple M9547Z/A | Administration Guide - Page 169
Data Reporting Policy" on page 170. 7 Select which data types to upload: System data, File Search data, Application Usage data, User Accounting data, or any combination. 8 In order to upload Application Usage data and User Accounting data, you need to specify collection of that data. Select "Collect - Apple M9547Z/A | Administration Guide - Page 170
should occur. 7 Set the time at which the collection should occur. 8 Select which data types to upload: System data, File Search data, Application Usage data, User Accounting data, or any combination. 9 Click OK. Working with Scheduled Tasks You can use Apple Remote Desktop to automate and - Apple M9547Z/A | Administration Guide - Page 171
5 Before executing the task, click the Schedule button. The scheduling information is revealed. 6 Choose when and how often you want the task to execute. 7 If you want the task to repeat, click Repeating Every then set the repeat interval. 8 Click OK. 9 Save the task and choose where the task will - Apple M9547Z/A | Administration Guide - Page 172
versatile scripting language that is built into Mac OS X. You can use AppleScript to create shortcuts, automate repetitive tasks, or even make custom applications that save you a great amount of time. AppleScript is an Englishlike language you can use to write scripts that contain commands. Scripts - Apple M9547Z/A | Administration Guide - Page 173
list" are being acted upon by "add." To access the full AppleScript dictionary for Remote Desktop: 1 Launch Script Editor in the /Applications/AppleScript/ folder. 2 Select File > Open Dictionary. 3 Choose Remote Desktop. 4 Click OK. The AppleScript Dictionary for Remote Desktop is also available in - Apple M9547Z/A | Administration Guide - Page 174
to "Please wait" as Unicode text -- make a UNIX script which executes an AppleScript on the remote computers set the UNIX_script to "osascript -e 'tell application \"Finder\" to delete every item of the desktop whose class is not disk'" -- set the lock task parameters set lock_task to make new lock - Apple M9547Z/A | Administration Guide - Page 175
Desktop Accomplish all of your time-consuming, repetitive manual tasks quickly, efficiently, and effortlessly with Automator workflows Packages, then repeat those tasks again and again. Simple and easy-to-understand application actions are the building blocks, so you don't have to write any code. - Apple M9547Z/A | Administration Guide - Page 176
You can create an Automator workflow, application, Finder plug-in, or iCal alarm similar to the AppleScript mentioned above. By stringing together Remote Desktop actions in Automator, you accomplish the same work as an AppleScript, but without having to write code. 176 Chapter 9 Automating Tasks - Apple M9547Z/A | Administration Guide - Page 177
Appendix Icon and Port Reference A A The following tables illustrate some of the icons found in the main window of Remote Desktop. The final table shows which network port numbers are in use by Apple Remote Desktop. Client Status Icons The following icons appear next to the names of computers in - Apple M9547Z/A | Administration Guide - Page 178
List Menu Icons The following icons are used in the Apple Remote Desktop list area of Remote Desktop's main window. Icon What it means All Computers list Apple Remote Desktop list Smart list Scanner Active Task list Task History list Task Server queue Task Status Icons The following icons - Apple M9547Z/A | Administration Guide - Page 179
informaiton available. System Status Icons (Detailed) The following icons are shown after further inspection of observed client computer status indicators. Service CPU Usage Icon Status Usage is at 60% or less Usage is between 60% to 85% Usage is at 85% or higher No status information - Apple M9547Z/A | Administration Guide - Page 180
Service Icon Status Over 95% used No status information is available TCP and UDP Port Reference Apple Remote Desktop uses the following TCP and UDP ports - Apple M9547Z/A | Administration Guide - Page 181
Appendix B Report Field Definitions Reference B The following sections describe the available fields in some of the Apple Remote Desktop reports. For information on generating reports, see "Creating Reports" on page 121. The file search reports (File Search, Software Version, and Software - Apple M9547Z/A | Administration Guide - Page 182
List category Devices Display Lights-Out Management Modem Field name CPU Speed Serial Number Vector Processor L2 Cache Size L3 Cache Size Machine Model Memory Empty RAM Slots PCI Slots Used Processor Count CPU Type Sales Order Number VM Size Total RAM Slots ATA Device Count Firewire Device Count - Apple M9547Z/A | Administration Guide - Page 183
List category Network Preferences Printing Remote Desktop Sharing Field name Notes or example Modem Driver Modem Firmware Version Modem Installed Yes/No Modem Interface Modem Model First Ethernet Address en0 MAC address NetBooted Yes/No Primary IP Address Primary Network Collisions - Apple M9547Z/A | Administration Guide - Page 184
List category Software Storage Storage Report List category Hardware Volume File System Backup Field name Windows Sharing Kernel Version System Version Free Disk Space Total Disk Space Trash Size Field name Drive Manufacturer Drive Model Drive Revision Drive Protocol Removable Serial Number Logical - Apple M9547Z/A | Administration Guide - Page 185
List category Field name Journaled Last Backup Date Last Check Date Notes or example Yes/No UNIX GMT format UNIX GMT format USB Devices Report Field name Product Name Product ID Vendor ID Vendor Name Device Speed Bus Power Date collected Notes or example 1.5Mb, 12Mb In mA FireWire Devices - Apple M9547Z/A | Administration Guide - Page 186
Expansion Cards Report Field name Card Name Slot Name Card Type Vendor ID Device ID ROM Revision Card Revision Card Memory Date collected Notes or example Slot4 Display Displays only Displays only Network Interfaces Report List category Network Overview Active Interface Network Statistics Field - Apple M9547Z/A | Administration Guide - Page 187
List category Output Statistics Ethernet Statistics Field name Notes or example Output Queue Capacity Output Queue Size Output Queue Peak Size Output Queue Drop Count Output Queue Output Count Output Queue Retry Count Output Queue Stall Count Ethernet Alignment Errors Ethernet FCS Errors - Apple M9547Z/A | Administration Guide - Page 188
& Shutdown Change Settings Copy Items Delete Items Control Observe Show Observe LOM Authentication Collect Application Usage Data Notes or example Computer sharing name On or off On or off On Invalid, Not Configured, or Not Supported On or off 188 Appendix B Report Field Definitions Reference - Apple M9547Z/A | Administration Guide - Page 189
days to upload information On or off On or off On or off On or off Apple Remote Desktop version and build number Relative date Application Usage Report Field name Computer name Name Launch date Total run time Frontmost User name State Notes or example File sharing computer name - Apple M9547Z/A | Administration Guide - Page 190
190 Appendix B Report Field Definitions Reference - Apple M9547Z/A | Administration Guide - Page 191
has the most recent information about scriptable objects and events in Remote Desktop, and better usability. Classes and Commands for the Remote Desktop Application add v: Add a computer to a task. add computer: The computer. to computer list: The computer list (or task) to add the computer to - Apple M9547Z/A | Administration Guide - Page 192
, computer lists, copy items tasks, copy to me tasks, documents, empty trash tasks, install package tasks, lock screen tasks, logout tasks, open application tasks, open item tasks, rename computer tasks, restart tasks, send message tasks, send unix command tasks, set local startup disk tasks, set - Apple M9547Z/A | Administration Guide - Page 193
copying copy to me task n [inh. task > item]: Copy items from the target computers to the administrator computer. ELEMENTS contained by application. PROPERTIES bandwidth limit (integer): Network usage limit in kilobytes per second (0 = unlimited). conflict resolution (ask what to do/rename the - Apple M9547Z/A | Administration Guide - Page 194
terminate if an error occurs during copying lock screen task n [inh. task > item]: Lock the screen(s) on the target computers. ELEMENTS contained by application. PROPERTIES message (Unicode text): Message to display on the screen(s). logout task n [inh. task > item]: Log out the current user on the - Apple M9547Z/A | Administration Guide - Page 195
name target name (Unicode text): The new name for the computer. restart task n [inh. task > item]: Restart the target computers. ELEMENTS contained by application. PROPERTIES user can save changes or cancel (boolean): Is the user allowed to save changes or cancel the restart send message task n [inh - Apple M9547Z/A | Administration Guide - Page 196
): The computer (other than the admin) whose screen to share. shutdown task n [inh. task > item]: Shutdown the target computers. ELEMENTS contained by application. PROPERTIES user can save changes or cancel (boolean): Is the user allowed to save changes or cancel the shutdown sleep task n [inh. task - Apple M9547Z/A | Administration Guide - Page 197
upgrade client task n [inh. task > item]: Upgrade the Remote Desktop client on the target computers. ELEMENTS contained by application. wake up task n [inh. task > item]: Wake up the target computers. ELEMENTS contained by application. Appendix C AppleScript Remote Desktop Suite 197 - Apple M9547Z/A | Administration Guide - Page 198
198 Appendix C AppleScript Remote Desktop Suite - Apple M9547Z/A | Administration Guide - Page 199
database schema used in Apple Remote Desktop's report database. You can use this knowledge about the schema to create your own applications that access Apple Remote Desktop report information. Sample list of main database schema Command: /System/Library/CoreServices/RemoteManagement/rmdb.bundle/bin - Apple M9547Z/A | Administration Guide - Page 200
lastupdated | timestamp with time zone | Sample list of property names Command: /System/Library/CoreServices/RemoteManagement/rmdb.bundle/bin/psql -U ard -c "select * from propertynamemap" ard Output: objectname | propertyname | propertymapid Mac_SystemInfoElement | WirelessCardIsActive | - Apple M9547Z/A | Administration Guide - Page 201
Apple Remote Desktop menu icon 102, 103 application use report 125 asset tracking application use 125 expansion cards 134 FireWire devices 132 99 deleting files 139 demonstration mode 101 designated data collector 122 directory services 69 drag and drop copies 118 installation 113 E enabling SSH on - Apple M9547Z/A | Administration Guide - Page 202
Remote Desktop 49 renaming copied items 117 multiple computers 140 repairing UNIX permissions 142 replacing copied items 117 report access privileges 76 Application Usage 125 File Search 127, 169 Software Difference 129, 169 Software Version 128, 169 System Overview 130, 168 User History 124, 169 - Apple M9547Z/A | Administration Guide - Page 203
scripting Remote Desktop AppleScript 172-174 Automator 175 Secure Screen Blanking. See curtain mode. security best practices 81 preferences 37 sending scripts via UNIX command 157-159 serial number 42 setting boot disk 139 setting encryption defaults 83 setting Energy Saver preferences 143 setting
-
1 -
2 -
3 -
4 -
5 -
6 -
7 -
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
-
155
-
156
-
157
-
158
-
159
-
160
-
161
-
162
-
163
-
164
-
165
-
166
-
167
-
168
-
169
-
170
-
171
-
172
-
173
-
174
-
175
-
176
-
177
-
178
-
179
-
180
-
181
-
182
-
183
-
184
-
185
-
186
-
187
-
188
-
189
-
190
-
191
-
192
-
193
-
194
-
195
-
196
-
197
-
198
-
199
-
200
-
201
-
202
-
203
 |
 |
Apple Remote Desktop
Administrator’s Guide
Version 3.2