Apple 3 manual

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

Go to page of

A good user manual

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

What is an instruction?

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

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

What should a perfect user manual contain?

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

Why don't we read the manuals?

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

Why one should read the manuals?

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

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

Table of contents for the manual

  • Page 1

    Ap ple Remote Deskt op A dministra tor ’ s Guide V ersion 3[...]

  • Page 2

    K Apple Computer , Inc. © 2006 Apple C omputer , Inc. All rights reserved. The owner or authoriz ed user of a valid copy of Apple Remote Desktop software may repr oduce this publication for the purpose of learning to use such software. No part of this publication ma y be reproduced or transmitted for commer cial purposes, such as selling copies of[...]

  • Page 3

    3 3 C on ten ts Prefac e 9 About This Book 1 0 Using This Guide 1 0 Remote Desktop Help 1 0 Notation Con ventions 1 1 Where to F ind More Inf ormation About Apple Remote Desktop Chapter 1 1 3 Using Apple Remot e Desktop 1 3 Administering C omputers 1 5 Deploying Software 1 8 T aking Inventory 2 1 Housekeeping 22 Suppor ting Users 23 Pr oviding Help[...]

  • Page 4

    4 Contents 4 1 Upgrading the Remote Desktop A dministrator Software 42 Upgrading the Client Software 42 Method #1—Remote Upgrade Installation 43 Method #2—Manual Installation 43 Upgrading Apple Remote Desktop Clien ts Using SSH 44 Creating a Cust om Client Installer 46 Considerations f or Managed Clients 46 Removing or Disabling Apple Remote De[...]

  • Page 5

    Contents 5 68 Command-Line SSH Acc ess 68 Managing Client Administration Settings and P rivileges 69 Getting an Administration Settings Repor t 69 Changing Client A dministrator P rivileges Chapter 6 7 1 Setting Up the Network and Maintaining Security 7 1 Setting Up the Network 72 Using Apple Remote Desktop with C omputers in an AirP or t Wireless [...]

  • Page 6

    6 Contents 93 Sharing a Screen with Client C omputers 94 Monitoring a Screen Sharing T asks 94 Interacting with Y our Apple Remote Desktop Administrat or 94 Requesting Administrat or Atten tion 95 Canceling an Att ention Request 95 Changing Y our Obser ved Client Icon Chapter 8 96 Administering Clien t Comput ers 96 Keeping T rack of T ask Pr ogres[...]

  • Page 7

    Contents 7 1 29 Renaming Computers 1 29 Synchronizing Comput er Time 1 30 Setting Computer Audio V olume 1 3 1 Repairing File P ermissions 1 3 1 Adding Items to the Dock 1 3 2 Changing Energy Saver P references 1 3 3 Changing Sharing Pr eference s for Remote L ogin 1 3 3 Setting Print er Pr eference s 1 35 Managing C omputers 1 35 Opening F iles an[...]

  • Page 8

    8 Contents Appendix B 1 65 Repor t F ield Definitions Reference 1 65 S ystem Overview Repor t 1 6 7 Storage Repor t 1 6 9 USB Devices Report 1 6 9 Fir eWire Devices Report 1 6 9 Memor y Report 1 6 9 PCI Cards Report 1 70 Network Interfaces Repor t 1 72 Network T est Repor t 1 72 A dministration Settings Repor t 1 73 A pplication Usage Report 1 73 U[...]

  • Page 9

    9 Prefac e About T his Book What Is Apple Remote De sktop? Apple Remote Desktop is easy-to-use , pow er ful, open standards-based, desktop management software for all your netw orked Macs. IT prof essionals can remotely control and configur e systems , install software , off er interactive online help to end users, and assemble detailed software an[...]

  • Page 10

    10 Preface About This Book Using This Guide The Apple Remote Desktop Administr ator’ s Guide contains chapters to help you use Remote Desktop . I t contains o verviews and explanations about Apple Remote Desktop ’ s f eatures and commands . It also explains how to install and configure A pple Remote Desktop on clients , how to administer client[...]

  • Page 11

    Preface About This Book 11 T erminal Command C on ven tions Commands or command paramet ers that you might type, along with other text that normally appears in a T erminal window , are shown in this fon t. F or example: Y ou can use the doit command to get things done. When a command is shown on a line by itself as y ou might type it in a T erminal[...]

  • Page 12

    12 Preface About This Book The Apple Remote Deskt op Support website provides a database of technical articles about product issues, use, and implementation: www .apple.c om/support/remotedesktop/ T o provide feedback about A pple Remote Desktop , visit the feedback page: www .apple.c om/feedback/remot edesktop .html F or details about how to join [...]

  • Page 13

    1 13 1 Using A pple Remot e Desktop Apple Remote Desktop helps y ou keep Macintosh c omputers and the software running on them up to date and tr ouble free . And it lets you inter act direc tly with Macin tosh users to provide instructional and troubleshooting support. This chapter describe s the main aspects of Apple Remote Desktop ’ s administr[...]

  • Page 14

    14 Chapter 1 Using Apple Remote Desktop Y ou can administer client comput ers individually , but most Apple Remote Desktop feature s can be used to manage multiple comput ers at the same time . F or example, you may wan t t o install or updat e the same applications on all the computers in a particular department. Or you may wan t to share your c o[...]

  • Page 15

    Chapter 1 Using Apple Remote Desktop 15 Deploying Software Apple Remote Deskt op lets you distribute software and related files to client computers from your Apple Remot e Desktop administrator c omputer or from a comput er running Mac OS X Ser ver . Distributing Installer Packages Y ou can distribute and automatically install packages in .pkg and [...]

  • Page 16

    16 Chapter 1 Using Apple Remote Desktop F or example, you can use Apple Software Update to do wnload an iCal update or an operating system update to a t est computer . I f the update w orks as expected and introduce s no compatibility issues, copy the installer package to the administrator computer to distribute t o computers that need upgrading . [...]

  • Page 17

    Chapter 1 Using Apple Remote Desktop 17 Client computers that boot fr om a NetBoot image get a fresh system en vironmen t every time they star t up. F or this reason, using NetBoot images is useful when a particular computer is shared b y sev eral users who r equire diff erent work envir onments or refreshed w ork environmen ts, or when you want to[...]

  • Page 18

    18 Chapter 1 Using Apple Remote Desktop T aking Inv entory Apple Remote Desktop lets y ou capture data describing the attribute s of client computers , then generate r eports based on the data. Y ou specify how often you wan t to capture data, the data you want to capture , and the computers you wan t to profile . Y ou can c ollect data just before[...]

  • Page 19

    Chapter 1 Using Apple Remote Desktop 19 File Search Report Use the F ile Search report to search client systems for s pecific files and folders and t o audit installed applications. This report can help you find out ho w man y copies of a particular application are in use so you don ’t violate license agreements. Spotlight F ile Search Use the Sp[...]

  • Page 20

    20 Chapter 1 Using Apple Remote Desktop Application Usage Report Use the Application Usage r epor t to find out which applications ha ve been running on your client comput ers and who ran those applications. Network T est Repor t A Network T est repor t helps you measure and tr oubleshoot the communication between your administrator c omputer and y[...]

  • Page 21

    Chapter 1 Using Apple Remote Desktop 21 Housekeeping Apple Remote Desktop pr ovides sev eral ways to remot ely control clien t computers f or housekeeping activities, which you can c onduct using one or more Apple Remote Desktop windows. Managing P ow er State Use Apple Remote Deskt op to control the po wer state of clien t computers. F or example,[...]

  • Page 22

    22 Chapter 1 Using Apple Remote Desktop Locking Computer Scr eens Y ou can lock the screens of client comput ers for specified durations when y ou don ’t want the computers to be used . F or example, you ma y need to perform network maintenance and wan t to make sure computers don ’t use the network for a few hours . Y ou can display cust om pi[...]

  • Page 23

    Chapter 1 Using Apple Remote Desktop 23 Pro viding Help Desk Support When a user is having tr ouble, Apple Remote Desktop pro vides several ways to in teract with the user and his or her computer to diagnose and fix the problem. Requesting Help A user can discreetly notify you of a problem b y sending a request f or help using an Apple Remote Deskt[...]

  • Page 24

    24 Chapter 1 Using Apple Remote Desktop Screen C ontrolling Use Apple Remot e Desktop to con trol the user’ s screen in order to diagnose and fix the problem. Y ou may hav e unlimited contr ol, or a user can grant you temporary guest access so you can con trol the computer only during tr oubleshooting. There are tw o levels of contr ol av ailable[...]

  • Page 25

    Chapter 1 Using Apple Remote Desktop 25 Inter acting with Students Apple Remote Desktop helps instructors teach mor e efficiently by letting them int eract with student computers individually or as a gr oup. Using T ext Messages Send Apple Remote Desktop text messages t o communicate with students . For example, notify them that a classroom activit[...]

  • Page 26

    26 Chapter 1 Using Apple Remote Desktop Locking Screens Lock student scr eens to preven t students from using their c omputer when you wan t them to focus on other activities. T erminating C omputer Use Remotely log students out or shut down their c omputers at the end of a class or school day . Distributing and Collecting File s Distribute handout[...]

  • Page 27

    Chapter 1 Using Apple Remote Desktop 27 Additional inf ormation can be obtained at several Apple w ebsites:  F or information about NetBoot and Network Install, download the system imaging administration guide at: www .apple.c om/server/documentation  Y ou can find P ackageMaker ’ s documentation at Apple ’ s Developer C onnection: http://d[...]

  • Page 28

    2 28 2 Getting to Know Remote Desktop Remote Desktop is the administr ator application f or Apple Remote Desktop . I ts attractive int er face is pow er ful, yet simple to use. Remote Deskt op ’ s in ter face is cust omizable , allowing you t o get the informa tion you wan t quickly , the way y ou want it. This chapt er con tains screenshots and [...]

  • Page 29

    Chapter 2 Getting to Know Remote Desktop 29 Remote Desktop Main Window The main window of Remote Deskt op has a customizable toolbar , groups of lists , tasks, and scanners on the left, and the main window area t o the right. “List M enu Icons ” on page 1 62 con tains icons seen in the list menu of the main window . A All Computers list: The Al[...]

  • Page 30

    30 Chapter 2 Getting to Know Remote Desktop F Scanner: Scanners find clients to add to the All Computers list. Y ou can make new scanners and customize them for y our needs. See “Making a New Scanner ” on page 52. G T ask ser ver list: This lists tasks delegated to the T ask Ser ver , rather than run those run directly from the application. Whe[...]

  • Page 31

    Chapter 2 Getting to Know Remote Desktop 31 T ask Dialogs When you click a task, a dialog appears to let you set task parameters or confirm the task. A T ask type header : This header area shows y ou the kind of task represented . B Saved task name: When you save a task, you name it for y our own use. C T ask configuration area: T his area is diffe[...]

  • Page 32

    32 Chapter 2 Getting to Know Remote Desktop Con trol and Observe Window This window is the same f or both controlling and observing a single client. The only difference is the stat e of the Observe or Control toggle butt on. When it’ s selected, you have c ontrol ov er the remote client. A Observe or control toggle : When this button is selected [...]

  • Page 33

    Chapter 2 Getting to Know Remote Desktop 33 Multiple-Client Observe Window When you observe many clients at the same time , they all appear in the same window . If you have mor e computers than will fit in the window , they are divided acr oss several pages. H Send clipboard to the client : When clicked, the remote client Clipboard receiv es the co[...]

  • Page 34

    34 Chapter 2 Getting to Know Remote Desktop Repor t Window Reports ser ve as valuable shortcuts when y ou’ re copying file s and or ganizing computer lists. G Computer status: Shows basic computer status beneath each clien t screen. H Cy cle through pages : Manually advances to the next page of screens. I View Options : Reveals the view option co[...]

  • Page 35

    Chapter 2 Getting to Know Remote Desktop 35 Changing Report Layout Y ou can customize report layouts for y our own purposes . By default , repor ts include a column for each inf ormation type you selected before running the report, in the order present ed in the report dialog. The columns in the report are initially sor ted by computer name. Y ou c[...]

  • Page 36

    36 Chapter 2 Getting to Know Remote Desktop Configuring Remote De sktop Y ou can configure the Remote Deskt op administrator application to meet your w ork needs. Remote Desktop has an interface that is both flexible and func tional. Customizing the Remot e Desktop T oolbar The Remote Desktop application has a fully cust omizable toolbar , which pr[...]

  • Page 37

    Chapter 2 Getting to Know Remote Desktop 37  Whether other Apple Remote Deskt op administrators can access y our local T ask Ser ver  Whether clients collect user and application tracking data  A saved t emplate for scheduling clien t reporting policies In the Labels pane, you can set:  Label colors and text for labeling computers In the T [...]

  • Page 38

    38 Chapter 2 Getting to Know Remote Desktop Drag and drop works on c onfiguration dialogs Configuration dialogs accept dragged it ems. Computer lists in the dialogs accept dragged computers. The C opy Items dialog accepts dragged files to c opy , without having to bro wse the file system for them. Save y ourself time and effort by dragging availabl[...]

  • Page 39

    3 39 3 Installing Apple Remot e Desktop T o use Apple Remot e Desktop , install the administration software on the administrator c omputer first, and then install and enable the clien t software on the computers y ou wan t to manage. Y ou’ll need y our install disc, the serial number , and either the printed W elcome instruc tions , or these inst[...]

  • Page 40

    40 Chapter 3 Installing Apple Remote Desktop Network Requiremen ts  Ethernet (recommended), AirPort, FireWire , or other network c onnection See “Setting Up the Network ” on page 7 1 f or more information. Installing the Remote Desktop A dministrat or Software T o set up Apple Remote Desktop on administrator c omputers, you install the softwa[...]

  • Page 41

    Chapter 3 Installing Apple Remote Desktop 41 1 0 Configure some client computers f or administration, find them in a scanner , and add them to a computer list. See: Â “Setting Up an Apple Remote Desktop Client C omputer f or the First Time” on page 4 1 Â “Finding and A dding Clients to A pple Remote Desktop C omputer Lists ” on page 49 Se[...]

  • Page 42

    42 Chapter 3 Installing Apple Remote Desktop Upgrading the Client Software This section contains information on installing A pple Remote Desktop 3 on client computers. Since Apple Remot e Desktop client software was automatically included on the clients running Mac OS X v1 0.3 and v1 0.4, all Apple Remote Desktop 3 installations are upgrade install[...]

  • Page 43

    Chapter 3 Installing Apple Remote Desktop 43 Method #2—Manual Installation This method works best if y ou have nev er enabled Apple Remote Desktop on y our clients and hav e an existing software distribution infrastructure. T his method also allows for the gr eatest pow er and configuration flexibility . Also , if y ou don ’t wan t Apple Remote[...]

  • Page 44

    44 Chapter 3 Installing Apple Remote Desktop T o upgrade existing clien t software using SSH: 1 Create the custom clien t installer package. F or detailed instructions, see “Creating a Custom Client Installer” on page 4 4. 2 Open the T erminal application (located in /Applications/Utilitie s/). 3 Copy the installer package to the client compute[...]

  • Page 45

    Chapter 3 Installing Apple Remote Desktop 45 4 Click Continue t o begin creating a custom installer . 5 Choose whether to start Remote Desktop sharing at system star tup . This changes the setting f ound in the Sharing pane of System P refer ences. 6 Choose whether to hide or show the Apple Remot e Desktop menu bar icon. 7 Click Continue . 8 Choose[...]

  • Page 46

    46 Chapter 3 Installing Apple Remote Desktop 1 7 Click Continue . 1 8 Select a location for the installer . 1 9 Click Continue to creat e the installer . An installer metapackage (.mpkg file) is created in the designated location. 20 Click Done. Consider ations for Managed Clien ts If you plan on restricting what applications can open on a managed [...]

  • Page 47

    Chapter 3 Installing Apple Remote Desktop 47 5 Delete the Remote Desktop documentation using the f ollowing commands in the T erminal application. sudo rm -r /Library/Documentation/Applications/RemoteDesktop 6 Delete the Apple Remote Desktop support files from /Library/Application Suppor t/ using the following commands in the T erminal application:[...]

  • Page 48

    48 Chapter 3 Installing Apple Remote Desktop Uninstalling the Client Software fr om Client C omputers T o remove A pple Remote Desktop client software from Mac OS X clients , you need to remove a number of software componen ts from each client syst em. T o uninstall client software: 1 Open T erminal (located in /Applications/Utilitie s). 2 Delete t[...]

  • Page 49

    4 49 4 Organizing Clien t Computers In to C omputer Lists Apple Remote Desktop use s lists of client comput ers to logically organize the clien t comput ers under your con trol. Connecting to client c omputers on the network and adding them to your list is nec essary to administer them. This chapter describes finding clien ts and organizing them in[...]

  • Page 50

    50 Chapter 4 Organizing Client Computers Into Computer Lists If you want to change the defa ult display list f or the scanner , you can select Edit > View Options and choose any of the other available options (which include C omputer Info F ields, Ethernet ID , Label, or others). T o add a computer to a computer list , you first authenticate to [...]

  • Page 51

    Chapter 4 Organizing Client Computers Into Computer Lists 51 T o search a range of netw ork addresses: 1 Select a scanner at the lef t of the Remote Deskt op window . 2 Select Network R ange. 3 Enter the beginning and ending IP addre ss. 4 Click the Refresh button. All responding clien ts are listed in the Remote Deskt op window . 5 Select the desi[...]

  • Page 52

    52 Chapter 4 Organizing Client Computers Into Computer Lists F inding Clients b y F ile Impor t Y ou can impor t a list of comput ers into Apple Remot e Desktop by importing a file listing the computers ’ IP addr esses. The list can be in an y file format (text, spreadsheet, word proc essor) and must contain either IP addr esses or fully qualifie[...]

  • Page 53

    Chapter 4 Organizing Client Computers Into Computer Lists 53 5 Customiz e the search by ent ering the specific parameters f or the search (such as an IP address range , or file location). Y ou can find out how to customiz e the search in the following sections: Â “Finding Clien ts by Searching the Local Netw ork” on page 50 Â “Finding Clien[...]

  • Page 54

    54 Chapter 4 Organizing Client Computers Into Computer Lists Creating an Ap ple Remote Desktop C omputer List Y ou can make more specific, targeted lists of computers fr om your All Comput ers list. The easiest way to make a new list is to use computers already in the All C omputers list. Y ou can also create blank lists and add comput ers to them [...]

  • Page 55

    Chapter 4 Organizing Client Computers Into Computer Lists 55 T o create a smart computer list: 1 Choose File > New Smart List. 2 Name the smart computer list. 3 Choose “an y ” or “all” criteria to match. 4 Select the attribute to select by , using the pop-up windows and t ext entry field. 5 Add any other crit eria with the Add (+) button[...]

  • Page 56

    56 Chapter 4 Organizing Client Computers Into Computer Lists 8 Add other conditions and criteria as desir ed. 9 Create the final Smart List by clicking OK. The new Smart List appears in Remote Desktop’ s main window. Impor ting and Expor ting C omputer Lists When setting up Apple Remote Desktop 3, you may not necessarily use the same computer you[...]

  • Page 57

    Chapter 4 Organizing Client Computers Into Computer Lists 57 8 Select the expor ted list, and click Open. The list now appears in Remote Desktop ’ s main window . T ransferring Remote Desktop 2 C omputer Lists to a New Remote Desktop 3 Administr ator C omputer If you are installing Apple Remote Deskt op 3 on a computer diff erent from the v ersio[...]

  • Page 58

    58 Chapter 4 Organizing Client Computers Into Computer Lists T o transfer the comput er lists: 1 Open Keychain Acc ess (located in /Applications/Utilitie s) on the source computer . 2 Choose File > New Key chain. 3 Name the new keychain, and click Create. 4 Enter a passwor d for the new keychain. This is a temporary password that you will use to[...]

  • Page 59

    5 59 5 Understanding and C on trolling Acc ess P rivileges There are sev eral diff eren t wa ys to acce ss and authen ticate to Apple Remote Desktop clien ts. Some depend on Apple Remote Desktop settings , and others depend on other client settings, or third-part y administra tion tools. This chapter explains the various access t ypes , their confi[...]

  • Page 60

    60 Chapter 5 Understanding and Controlling Access Privileges The follo wing table shows the settings in the Apple Remote Deskt op settings in the Sharing Pr eference pane and the f eatures of Remot e Desktop that they corres pond to . F or example, if you want a certain administrator to be rename comput er file sharing names, you will need to grant[...]

  • Page 61

    Chapter 5 Understanding and Controlling Access Privileges 61 Setting Apple Remote Desktop A dministrat or Acc ess Authoriza tion and Privileges U sing Local A ccoun ts T o prepare a client f or administration, you activate the existing version of Apple Remote Desktop on the client c omputer and set Apple Remote Deskt op administrator access privile[...]

  • Page 62

    62 Chapter 5 Understanding and Controlling Access Privileges Apple Remote Desktop A dministrat or Acc ess U sing Director y Ser vices Y ou can also grant Apple Remot e Desktop administrator acce ss without enabling any local users at all by enabling group-based authorization if the clien t computers are bound to a directory ser vice. When you use s[...]

  • Page 63

    Chapter 5 Understanding and Controlling Access Privileges 63 In the XML, you name a privilege key and make the value the name of the gr oup or groups you want t o possess the privilege. Use the sample XML below to make your managemen t/key designation XML. 4 When you hav e created the snippet of XML, you enter this whole snippet int o a computer re[...]

  • Page 64

    64 Chapter 5 Understanding and Controlling Access Privileges F or more information on using Workgr oup Manager , and Open Dir ector y , see their documentation at: www .apple.c om/server/documentation The follo wing is the sample XML format you need t o use to assign management privileges via MCX keys. I t assigns the above “ ard_in teract” pri[...]

  • Page 65

    Chapter 5 Understanding and Controlling Access Privileges 65 Method #2 Y ou can create groups with s pecial names that corres pond to the privilege keys above: ard_admin, ard_repor ts, ard_manage, and ard_interact. The corresponding privileges are a utomatically assigned to these s pecially named groups. If you hav e already created these groups fo[...]

  • Page 66

    66 Chapter 5 Understanding and Controlling Access Privileges T o allow guest acce ss: 1 On the client computer , open System Pref erence s and click Sharing. If prompted , enter the user name and password of a user with administrator privileges on that computer . 2 Select Apple Remote Desktop in the Sharing pane. 3 Click Access P r ivileges . 4 Sel[...]

  • Page 67

    Chapter 5 Understanding and Controlling Access Privileges 67 Each of these featur es can be enabled or disabled independently of each other , or you can enable all of Remote Desktop ’ s features for nonadministrat or users. T o enable User Mode: 1 Make sure you are logged in as an administrator user . 2 Open Remote Desktop . 3 Choose Remote Deskt[...]

  • Page 68

    68 Chapter 5 Understanding and Controlling Access Privileges T o allow VNC access: 1 On the client computer , open System Pref erence s and click Sharing. If prompted , enter the user name and password of a user with administrator privileges on that computer . 2 Select Apple Remote Desktop in the Sharing pane. 3 Click Access P r ivileges . 4 Select[...]

  • Page 69

    Chapter 5 Understanding and Controlling Access Privileges 69 Getting an Administration Settings Report Y ou can quer y active Apple Remot e Desktop clients f or a report on what commands they are accepting from y our administrator a uthentication. The report is a list of the Apple Remote Desktop administrator acce ss types each with an “On” or [...]

  • Page 70

    70 Chapter 5 Understanding and Controlling Access Privileges 8 Add a new user by clicking Add and filling in the appropriat e information. Click OK after adding each user , and click Continue when y ou ’ re r eady to go on. 9 Choose whether to assign Apple Remote Deskt op administrator access privilege s to Director y Services groups. If you choo[...]

  • Page 71

    6 71 6 Setting Up the Network and Maintaining Security This chapter de scribes the main aspects of setting up your network f or use with Apple Remote Desktop syst em administration, as well as best-practice tips f or your netw ork. Additionally , it con tains information about Apple Remot e Desktop security featur es , and detailed instructions for[...]

  • Page 72

    72 Chapter 6 Setting Up the Network and Maintaining Security  Organize comput ers 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, co[...]

  • Page 73

    Chapter 6 Setting Up the Network and Maintaining Security 73 Â Wireless networks also ar e not suited for multicast traffic. However A pple Remote Desktop ’ s multi-observe feature is diff erent beca use it doesn ’t use multicast traffic . Â Display shar ed screens in black and white rather than in color . Â Configure y our AirP ort Base Sta[...]

  • Page 74

    74 Chapter 6 Setting Up the Network and Maintaining Security Administrat or Application Security  Make use of user mode to limit what nonadministrator users can do with Remote Desktop . See “ Apple Remote Desktop Nonadministrator Acc ess” on page 66.  If you leave the Remot e Desktop password in y our keychain, be sure to lock your keychain[...]

  • Page 75

    Chapter 6 Setting Up the Network and Maintaining Security 75  Quit the Remote Desktop application when you ha ve finished using it. If you have not stored the Remote Desktop passw ord in your keychain, the application prompts you to ent er the administrator name and passwor d when you open it again. Physical A ccess Security  If you have st ore[...]

  • Page 76

    76 Chapter 6 Setting Up the Network and Maintaining Security T o enable Observe and Contr ol transport encryption: 1 Choose Remote Desktop > P refer ences. 2 Click the Security button. 3 In the “Controlling comput ers” section, select “Encr ypt all network data.” Encr ypting Netw ork Data During C opy Items and Install P ackages T asks R[...]

  • Page 77

    7 77 7 Int eracting with Users Apple Remote Desktop is a po wer ful tool f or int eracting with computer users across a netw ork. Y ou can interact by contr olling or obser ving remot e screens , text messaging with remote users , or sharing your screen with others . This chapter describes Remot e Desktop ’ s user int eraction capabilities and gi[...]

  • Page 78

    78 Chapter 7 Interacting with Users Con trolling Apple Remot e Desktop allows you to control remote computers as if you were sitting in front of them. Y ou can only contr ol the keyboard and mouse of any one computer at a time. There are tw o kinds of remote computers that Apple Remote Desktop can control: Apple Remote Desktop clients and Vir tual [...]

  • Page 79

    Chapter 7 Interacting with Users 79 Also , special keys including the sound v olume, screen brightness, and Media Ejec t keys do not affect the client computer . These instructions assume the that observed computer has Apple Remote Desktop installed and configured properly (see “Setting Up an Apple Remot e Desktop Client Computer f or the F irst [...]

  • Page 80

    80 Chapter 7 Interacting with Users Switching the C on trol Window Between F ull Siz e And F it-T o-Window When controlling a clien t, you can see the client window at full size , or scaled to fit the control windo w . Viewing the client window at full siz e will show the client scr een at its real pixel r esolution. I f the con trolled computer’[...]

  • Page 81

    Chapter 7 Interacting with Users 81 Hiding a User’ s Screen While C on trolling Sometimes you ma y want to con trol a client comput er with a user at the client computer , but you don’ t want the user to see what y ou’ re doing. In such a case, you can disable the client computer’ s screen while preserving your own view of the client comput[...]

  • Page 82

    82 Chapter 7 Interacting with Users Sharing Clipboards f or Cop y and P aste Y ou can transfer data between the Clipboar ds of the administrator and clien t comput er . F or example , you ma y want to c opy some text from a file on the administrator computer and paste it int o a document open on the client comput er . Similarly , you could copy a l[...]

  • Page 83

    Chapter 7 Interacting with Users 83 2 Select one computer from the list. 3 Choose Interact > Con trol. If the controlled computer’ s screen is larger than your con trol window , the screen scrolls as the pointer appr oaches the edge of the window . 4 T o customize the contr ol window and session, see “Control Window Options” on page 79. 5 [...]

  • Page 84

    84 Chapter 7 Interacting with Users VNC Con trol Options After you hav e added a VNC server to a computer list (or when you ar e first adding it), you can set a custom port for VNC communication, and you can designate a displa y to control. T o set a custom port on an existing computer list member: 1 Select a computer list in the Remote Desktop win[...]

  • Page 85

    Chapter 7 Interacting with Users 85 If you want to con trol the third dis play , you w ould enter: vncserver.example.com:5902 Configuring an A pple Remote Desktop Clien t to be C ontr olled by a VNC V iewer When configured to do so , an Apple Remot e Desktop client can be con trolled with a non–Apple VNC viewer . Allowing a non–Apple VNC viewer[...]

  • Page 86

    86 Chapter 7 Interacting with Users Remote Desktop allows y ou to observe multiple clients on the same screen, c ycling through the list of observed computers. T his allows you t o monitor many screens without having to select each one individually . Dealing With Many Clien t Screens When observing a single client, you can see the clien t window at[...]

  • Page 87

    Chapter 7 Interacting with Users 87  the obser v e window is resiz ed, shrinking the information beneath the threshold  the setting for the number of viewed machine s is changed The computer inf ormation area is reenabled when the size s are returned to more than the image size threshhold . Changing Observe Settings While Observing While you ar[...]

  • Page 88

    88 Chapter 7 Interacting with Users Changing Screen Titles While Obser ving While you are observing multiple computers, you can change the title underneath the desktops shown in the observe window . The main title can be the:  Name (the computer sharing name)  IP Address  Host Name T o change your observe window titles: 1 Click View Options i[...]

  • Page 89

    Chapter 7 Interacting with Users 89 There are tw o levels of detail for syst em statistics. The top level is a single ic on (a red , yellow , or green icon). Y ou show the second level of detail b y placing the mouse pointer ov er the high-level status icon. T he icon changes to an “i” and you can click the “i” to get more information. Clic[...]

  • Page 90

    90 Chapter 7 Interacting with Users T o show system sta tus in the observe window : 1 Click View Options in the obser ve windo w ’ s toolbar . 2 Select Display Computer Inf ormation. 3 Select Computer Status. 4 Click Done. Shor tcuts in the Multiple Scr een Observe Window Y ou can access several A pple Remote Desktop commands using icons in the o[...]

  • Page 91

    Chapter 7 Interacting with Users 91 Obser ving Multiple C omputers When you observe multiple client comput ers, each client screen is scaled down, so that several computers can be view ed at the same time. Y ou can set the number of client screens that appear at any one time . S ee “Setting P refer ences f or the Remote Desktop Administrator A pp[...]

  • Page 92

    92 Chapter 7 Interacting with Users Sending Messages Apple Remote Desktop allo ws you to communicat e with users of Apple Remote Desktop client comput ers using text messaging. Y ou can use text messages t o give instructions or announcements, to collaborate remotely , or troubleshoot with users. There are tw o types of text messaging: one-way mess[...]

  • Page 93

    Chapter 7 Interacting with Users 93 5 Pr ess the Return key to complete and send each line. Viewing Atten tion Requests After a client user sends an atten tion request, the Apple Remote Desktop administrat or can read the attention r equest text. T o view atten tion requests: 1 Choose Window > Messages F rom Users. 2 Select the message you want [...]

  • Page 94

    94 Chapter 7 Interacting with Users Monitoring a Screen Sharing T asks Y ou may want to keep track of the screen sharing tasks y ou have begun. Y ou can get information on all active screen sharing tasks , and can sort the tasks by time star ted , source screen, or target computers. T o view current active scr een sharing tasks: m Choose Window >[...]

  • Page 95

    Chapter 7 Interacting with Users 95 Canceling an A tten tion Request If a user no longer needs the Apple Remote Desktop administrat or ’ s atten tion, he or she can cancel the attention r equest after it has been sent. T o cancel an atten tion request: 1 Click the Apple Remote Desktop status ic on and choose Message to A dministrator . 2 Click th[...]

  • Page 96

    8 96 8 Administ ering Clien t C omput ers Apple Remote Desktop giv es y ou pow er ful administrativ e contr ol. Y ou can manually or aut omatically get detailed information about ev ery computer , install software, and maintain systems fr om a single administrat or computer . This chapter describes Remot e Desktop ’ s capabilities and giv es comp[...]

  • Page 97

    Chapter 8 Administering Client Computers 97 Remote Desktop keeps track of three kinds of task progress: active , T ask Server , and completed . Active tasks are those which are currently being proce ssed by the client computers , and the client c omputers hav e not all reported back to the administrator console. Some tasks are so short that they on[...]

  • Page 98

    98 Chapter 8 Administering Client Computers Getting Active T ask Status When you get a task’ s current status, you see the progress of the task, the computers inv olved , and their feedback to the administrator computer . T o get status on a curren tly running task: 1 Select the Active T asks list. 2 Select the desired task in the Remote Desktop [...]

  • Page 99

    Chapter 8 Administering Client Computers 99 T o stop a curren tly running task: 1 Select the Active T asks list. 2 Select the desired task in the Remote Desktop window . The task status and computers in volv ed are shown in the Remote Desktop windo w . 3 Click the Stop button in the top-right of the main windo w . Getting Completed T ask History Af[...]

  • Page 100

    100 Chapter 8 Administering Client Computers Creating and U sing T ask T emplates 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 alwa ys use certain copy options for a C opy Items task, you can sav e those settings as a template , and have them ap[...]

  • Page 101

    Chapter 8 Administering Client Computers 101 Editing a Sav ed T ask Y ou may wan t to change a previously saved task, changing whether what the task doe s or changing the target computers . T o edit a sav ed task: 1 Double-click the saved task y ou want to edit. Alternatively , you could use Control-click or right-click and choose Edit T ask from c[...]

  • Page 102

    102 Chapter 8 Administering Client Computers Y ou can choose t o initiate the installation of a package from the de signated T ask Ser ver rather from a Remote Desktop task. This allows you to install packages on to computers that may not be c onnected to the network (with a status of “Offline”) when you run the task. The T ask Ser ver monit or[...]

  • Page 103

    Chapter 8 Administering Client Computers 103 7 Select other installation parameters, as desired. F or more information on the a vailable options , see “Copy Options” on page 1 07. Note: Client computers ar e not restarted automatically after an installation is complet e unless explicitly selected in the task command . 8 Click Install. During in[...]

  • Page 104

    104 Chapter 8 Administering Client Computers Installing by Using the C opy Items C ommand Many applications can be installed simply by copying the application or its folder to the client computer . Consult the application ’ s documentation to v erify that you can simply copy the application to the hard disk t o install it. T o install software by[...]

  • Page 105

    Chapter 8 Administering Client Computers 105 The software is copied to the indicat ed destination. If the copy is operation unsuccessful, an error message appears in the task feedback window . 8 Select a computer that received the copy of the installer . 9 Choose Interact > Con trol. 1 0 Control the screen of the selected computer and complet e [...]

  • Page 106

    106 Chapter 8 Administering Client Computers 3 Use the appropriate installation method to install the new v ersion of the software. For more information, see: Â “Installing by P ack age and Metapackage” on page 1 0 1 Â “Installing by Using the C opy Items Command” on page 1 04 Â “Using Installers from Other Companies ” on page 1 04 C[...]

  • Page 107

    Chapter 8 Administering Client Computers 107 If you choose to copy out to man y client comput ers simultaneously , Remote Desktop uses network multicasts to send the files . I f there is a significan t number of multicast networking errors, Remote Desktop tries to copy individually to each client computer . Cop y Options Each time you copy an item [...]

  • Page 108

    108 Chapter 8 Administering Client Computers More Options When the Item Already Exists If an item with the same name as the item you selected to c opy already exists at the destination, you have several options f or handing the name conflict. Y ou can:  replace the existing item  replace the existing item if the existing it em is older  renam[...]

  • Page 109

    Chapter 8 Administering Client Computers 109 Cop ying Using Drag and Drop Using Apple Remote Deskt op , you can c opy items by dragging them between F inder windows on your administrat or computer , the Remote Deskt op window , and control windows. For example , you can drag an item from a F inder window to a selected computer in the Remote Desktop[...]

  • Page 110

    110 Chapter 8 Administering Client Computers Alternatively , you can drag items from a control windo w to the administrator computer’ s desktop. Restoring Items from a Master C opy Y our client computers can r estore non-syst em software from a master copy . This is helpful if you want to make sure each clien t computer has the same software . Y [...]

  • Page 111

    Chapter 8 Administering Client Computers 111 Creating Reports Apple Remote Desktop allo ws you to query client computers for man y kinds of information, from installed software to network speed and reliability . Cr eating reports gives you v aluable information about the clien t computers. Repor ts also help when you ’ re copying files and organi[...]

  • Page 112

    112 Chapter 8 Administering Client Computers The database , which is a P ostgreSQL database located at /var/db/Remot eManagement/ RMDB/ can be accessed using other tools beside s Remote Desktop . T o find out more about the database schema, see “P ostgreSQL Schema Sample” on page 1 80. The last kind of new data search is a Spotlight search. T h[...]

  • Page 113

    Chapter 8 Administering Client Computers 113 Y ou do this using the Get Info windo w of any client computer or the client’ s own Apple Remote Desktop pref erences . See “Setting the Client’ s Data Repor ting P olicy ” on page 1 5 2 and “Creating a T emplate Data Reporting Policy ” on page 1 5 3. Repor t Database Rec ommendations and Ban[...]

  • Page 114

    114 Chapter 8 Administering Client Computers System Report Size The file system data which is uploaded to the r eport database (labeled “F ile Search data ” in the Scheduling sheet of the T ask Ser ver pr eferenc e pane) contains a significant amount of data. For a client with 1 0 GB of files on the hard disk, the repor t data uploaded can easi[...]

  • Page 115

    Chapter 8 Administering Client Computers 115 T o generate a U ser History repor t: 1 Select a computer list in the Remote Desktop window . 2 Select one or more computers in the selected computer list. 3 Choose Repor t > User Hist or y . 4 Select the time frame for the user history information. 5 Click Generate Report. The newly generated report [...]

  • Page 116

    116 Chapter 8 Administering Client Computers F inding F iles , F olders, and Ap plications Apple Remote Desktop allo ws you to search the c ontents of clien t computer hard disks for specific file s, folders, or applications. A dditionally , it can compare the re sults of such searches to the it ems on the administrator computer . T hese searches c[...]

  • Page 117

    Chapter 8 Administering Client Computers 117 The results of the sear ch are listed in the pane at the bottom of the window . Note: The “Home ” Spotlight search location means the Home folder of the currently logged in user . Generating a F ile Search Report The F ile Search report allows you to find up to a total of 3 2,000 items on selected co[...]

  • Page 118

    118 Chapter 8 Administering Client Computers 7 Click Search. The newly generated report window appears. Comparing Software Apple Remote Desktop has several specialized reports for comparing software on clien t computers with software on the administrator c omputer . These repor ts can ’t be run comparing two client comput ers. One computer in the[...]

  • Page 119

    Chapter 8 Administering Client Computers 119 T o generate a Software Diff erence report: 1 Select a computer list in the Remote Desktop window . 2 Select one or more computers in the selected computer list. 3 Choose Repor t > Software Differenc e. 4 Select the sof tware type you want t o compare . Selecting Applications compares all ex ecutable [...]

  • Page 120

    120 Chapter 8 Administering Client Computers Getting Serial Numbers Although there is no specific serial number report for Apple Remote Desktop , the serial number of any client is in the C omputer section of the System Overview Repor t. In addition to using Apple Remote Desktop t o retrieve a comput er ’ s serial number , you could use the comma[...]

  • Page 121

    Chapter 8 Administering Client Computers 121 Getting FireW ire Device Inf ormation The F ireWire Devices r eport gets information about FireWire device s connected to the client computer . I t can get the following inf ormation from a device:  Manufacturer  Model  Device speed  Software version  Firmwar e revision F or more information ab[...]

  • Page 122

    122 Chapter 8 Administering Client Computers T o generate a USB Devic es report: 1 Select a computer list in the Remote Desktop window . 2 Select one or more computers in the selected computer list. 3 Choose Repor t > USB Devices . 4 Select the USB device information desired . 5 T o search using new data, select Rebuild Data F or Report. 6 Click[...]

  • Page 123

    Chapter 8 Administering Client Computers 123 Getting Memor y Informa tion The Memory repor t gets specific information about the installed memory in a client computer . In addition to reporting how much memory the client has, it shows information about each memory module, including the module ’ s:  Slot identifier  Size , type, and speed Memo[...]

  • Page 124

    124 Chapter 8 Administering Client Computers T o generate a PCI C ards report: 1 Select a computer list in the Remote Desktop window . 2 Select one or more computers in the selected computer list. 3 Choose Repor t > PCI Cards . 4 Select the PCI card information desired . 5 T o search using new data, select Rebuild Data F or Report. 6 Click Get R[...]

  • Page 125

    Chapter 8 Administering Client Computers 125 Here are some suggestions f or evaluating your netw ork per f ormance based on this report: Â The number of r outers between your computer and another computer can affect the time the packets take to return. When you evaluate the times f or a computer , you should compare them to the times f or a comput[...]

  • Page 126

    126 Chapter 8 Administering Client Computers  Unicode (UTF-1 6): Best choice if the repor t con tains Asian language characters. 7 Select a field separator .  T ab: Inserts a T ab character between column v alues.  Comma: Inserts a comma between column values . 8 If you hav e selected only some ro ws of the report and want to export only the [...]

  • Page 127

    Chapter 8 Administering Client Computers 127 Maintaining Syst ems Apple Remote Desktop pr ovides easy and pow er ful tools f or maintaining client computers , including tasks such as deleting files , empt ying the Tr ash, and setting computer startup options. Deleting Items If you delete a file from a client c omputer , it is mov ed to the client?[...]

  • Page 128

    128 Chapter 8 Administering Client Computers Emptying the T rash Apple Remote Desktop allo ws you to empty the T rash on clients to free up disk spac e. T o find out how much free disk space is on a c omputer , create a S ystem Overview or Storage report using the Repor t menu. As a part of routine maintenance for clien t computers , you can fr ee [...]

  • Page 129

    Chapter 8 Administering Client Computers 129 If you select Restar t When Done, the client comput er will restart after having its star tup volume set. Y ou need to hav e Restart privileges to use this option. 8 Click Set. Renaming C omputers Apple Remote Desktop can set the name that a clien t computer uses f or file sharing. Y ou can rename multip[...]

  • Page 130

    130 Chapter 8 Administering Client Computers T o synchronize clien t computer clocks: 1 Select a computer list in the Remote Desktop window . 2 Select one or more computers in the selected computer list. 3 Choose Manage > Send UNIX Command. 4 Use the provided T emplates for Send UNIX Command t o set the time server (see “Send UNIX Command T em[...]

  • Page 131

    Chapter 8 Administering Client Computers 131 5 Alternatively , manually enter the UNIX command. a T ype or paste the f ollowing UNIX command: osascript -e 'set volume output volume any_number_from_0-100' b or for Mac OS X v . 1 0.3 clients enter or past e the following: osascript -e 'set volume any_number_from_0-7' 6 Click Send.[...]

  • Page 132

    132 Chapter 8 Administering Client Computers 4 T ype or paste the f ollowing UNIX command (replac e /Path_To_Application with your own path to the desir ed application, and be sure t o include the application file extension, .app): defaults write com.apple.dock persistent-apps -array-add '<dict><key>tile- data</key><dict&g[...]

  • Page 133

    Chapter 8 Administering Client Computers 133 a T ype or paste the f ollowing UNIX command: systemsetup -setsleep minutes number_of_minutes_to_sleep -setwakeonmodem (on | off) -setwakeonnetworkaccess (on | off) -setrestartpowerfailure (on | off) -setrestartfreeze (on | off) b Set the permissions for this command to root. 6 Click Send. Changing Shari[...]

  • Page 134

    134 Chapter 8 Administering Client Computers T o set up printer pref erence s using Copy Items: 1 Set up a client computer’ s print preference using the P rinter Setup Utility . 2 Use the Copy Items task to copy the f ollowing file and f older to all the target computers: /private/etc/cups/printers.conf /private/etc/cups/ppd/ Because these files [...]

  • Page 135

    Chapter 8 Administering Client Computers 135 Managing Computers Using Apple Remote Desktop , y ou can control multiple clien t computers simultaneously , issuing commands that are f ound in Mac OS X’ s Apple menu (Log Out, Sleep , Restart, etc .), as well as other c ommands. Opening F iles and F olders Apple Remote Desktop can open existing it em[...]

  • Page 136

    136 Chapter 8 Administering Client Computers T o open an item: 1 Select a computer list in the Remote Desktop window . 2 Select one or more computers in the selected computer list. 3 Choose Manage > Open Items. 4 Click the Add (+) button and br owse for the it em on the administrator computer . Alternatively , drag the item from the administrato[...]

  • Page 137

    Chapter 8 Administering Client Computers 137 Quitting Applications Without Logging Out the U ser Apple Remote Deskt op can quit running applications on client comput ers. Y ou can quit both Mac OS X and Classic applications with this command . The administrat or must be able to use the Send UNIX Command on the client c omputer . Y ou can get more i[...]

  • Page 138

    138 Chapter 8 Administering Client Computers W ak ing Up a Comput er Apple Remote Deskt op can wake up computers that hav e gone to sleep or been put to sleep with Remote Desktop . T o wake a computer using Remot e Desktop , the computer’ s network ing hardwar e must suppor t waking via network packet (wakeonlan), and the computer must ha ve “ [...]

  • Page 139

    Chapter 8 Administering Client Computers 139 T o 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 Scr een. 4 Enter a message t o be display ed on the locked screen, if desir ed. 5 Click Lock Screen. The client screen goe s black,[...]

  • Page 140

    140 Chapter 8 Administering Client Computers Disabling a Computer Scr een Sometimes you ma y want to con trol a client comput er with a user at the client computer , but you don’ t want the user to see what y ou’ re doing. In such a case, you can disable the client computers scr een while preserving your own view of the client computer . This i[...]

  • Page 141

    Chapter 8 Administering Client Computers 141 keystroke return end tell EndOfMyScript 5 Choose user “root” to run the c ommand. 6 Click Send. The client comput er execute s the script. Logging Out the C urren t User Apple Remote Desktop can log out the curren t user on a client computer . O ther users, besides the curren t active user , who are [...]

  • Page 142

    142 Chapter 8 Administering Client Computers Shutting Down a Comput er Apple Remote Desktop can shut do wn a client computer . T his has the same result as choosing the Shut Down command from the client comput er ’ s A pple menu. Note: If you shut down an Apple Remote Deskt op client, you cannot star t it up using Remote Desktop . This command is[...]

  • Page 143

    Chapter 8 Administering Client Computers 143 UNIX Shell Commands In addition to its own tasks , Apple Remot e Desktop provide s a way to easily ex ecute UNIX commands on client computers . In order to send UNIX commands to the client computers , the client c omputers must hav e the BSD subsystem installed. The UNIX commands are shell command , whic[...]

  • Page 144

    144 Chapter 8 Administering Client Computers F or more information about T ask T emplates , see “Cr eating and Using T ask T emplate s” on page 1 00. The built-in Send UNIX Command templat es include: T emplate sub-menu T emplate name Network Setup  List All Services  Manual IP  DHCP  BOOTP  Manual with DHCP Router  DNS Ser vers  [...]

  • Page 145

    Chapter 8 Administering Client Computers 145 Executing a Single UNIX C ommand Using the UNIX Command window , you can send a single c ommand to the selected client computers . The c ommand is executed using the bash shell. T o execut e a single UNIX command: 1 Select a computer list in the Remote Desktop window . 2 Select one or more computers in t[...]

  • Page 146

    146 Chapter 8 Administering Client Computers T o copy and ex ecute a script: 1 Pr epare and save y our script. Make sure your script is saved as plain t ext with UNIX line breaks. 2 Open Remote Desktop . 3 Select a computer list in the Remote Desktop window . 4 Select one or more computers in the selected computer list. 5 Use the Copy Items command[...]

  • Page 147

    Chapter 8 Administering Client Computers 147 Alternatively , you could use a UNIX “ read standard input” redirection which looks like: osascript <<EndOfMyScript ...insert script here... EndOfMyScript F or example, a simple script to create a folder and set its label w ould be enter ed as: osascript <<EndOfMyScript tell the applicati[...]

  • Page 148

    148 Chapter 8 Administering Client Computers /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Support/ networksetup -help  F or Mac OS X v . 1 0.4 clients use the follo wing from Send UNIX Command: networksetup -help A few of the capabilities of networksetup are list ed below . flag description -listallnetworkservices Displays [...]

  • Page 149

    Chapter 8 Administering Client Computers 149 Any command in the Mac OS X Server command-line guide which uses networksetup can be used in Remote Desktop using the Send UNIX Command task. Using systemsetup The command-line tool systemsetup is used to c onfigure other nonnetwork system settings. Y ou can use it to query or alter time zones, network t[...]

  • Page 150

    150 Chapter 8 Administering Client Computers -setremotelogin ( on | off ) Sets remote login (SSH) to either on or off . Important If you turn off remote login, y ou won ’t be able to administer the server using SSH for remote login. Example: systemsetup -setremotelogin on -setrestartfreeze ( on | off ) Use this command to specify whether the serv[...]

  • Page 151

    Chapter 8 Administering Client Computers 151 Any command in the Mac OS X Server command-line guide that uses systemsetup can be used in Remote Desktop using the Send UNIX Command task. Using kickstart The kickstart command-line utility is embedded within the Apple Remote Desktop client software. I t allows y ou to install, uninstall, activ ate, con[...]

  • Page 152

    152 Chapter 8 Administering Client Computers  Deactivate Remote Desktop acce ss for a computer: $ sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/ Contents/Resources/kickstart -deactivate -configure -access -off Automa ting F unc tions Y ou can automate an y command or function in Remote Desktop . Additionally , Remote Desktop sup[...]

  • Page 153

    Chapter 8 Administering Client Computers 153 The user accounting data include s all possible reported information for the follo wing report: Â User History The application usage data includes all possible reported information f or the following report: Â Application Usage T o set a client’ s data reporting policy : 1 Select a computer list in t[...]

  • Page 154

    154 Chapter 8 Administering Client Computers T o set the default data reporting policy template: 1 Choose Remote Desktop > P refer ences. 2 Select T ask Server . 3 Check which additional data types the clients will collect: Application Usage Data, User Accounting Data, or both. 4 Check “Upload repor t data to the T ask Ser ver on a schedule.?[...]

  • Page 155

    Chapter 8 Administering Client Computers 155 T o set the T ask Server location: 1 Open Remote Desktop . 2 Choose Remote Desktop > P refer ences. 3 Click T ask Server . 4 If you want to use the database on this administrat or computer , selec t “Use T ask Server on this computer .” 5 If you use your Remote Deskt op administration computer as [...]

  • Page 156

    156 Chapter 8 Administering Client Computers 8 Click OK. 9 Save the task and choose where the task will appear in the Remote Deskt op window . Editing Scheduled T asks Once sav ed, a task can be changed and all future executions of the task will reflect the changes. Y ou may wan t to edit which computers ar e affected by the task or an y other task[...]

  • Page 157

    Chapter 8 Administering Client Computers 157 Remote Desktop ’ s AppleScript Basics AppleScript scripts c onsist of c ommands that are sent t o objects. Objects can be a wide variety of things, including applications, scripts , windows , settings, or the F inder . The se objects can receive a specific set of commands and r espond with the desir ed[...]

  • Page 158

    158 Chapter 8 Administering Client Computers This entry tells you what the verb can act on and how . This entry says that Remote Desktop can add a specified comput er to a computer list. The objects “ computer ” and “ computer list” are being acted upon by “ add .” T o access the full Ap pleScript dictionar y f or Remote Desktop: 1 Laun[...]

  • Page 159

    Chapter 8 Administering Client Computers 159 -- perform the task execute clean_task on these_computers -- empty the trash afterward execute (make new empty trash task) on these_computers -- unlock the screen when finished execute (make new unlock screen task) on these_computers end tell Using Aut omator with Remot e Desktop Accomplish all of y our [...]

  • Page 160

    160 Chapter 8 Administering Client Computers Using Automat or actions, you can even create your own in terfaces to Apple Remote Desktop functions without having to give users acc ess to Remote Desktop . F or instance, say you want ed to give all y our teachers a tool to lock and unlock screens in their classrooms. Y ou still need to configure Remot[...]

  • Page 161

    161 A Appendix A Icon and P ort Reference The f ollowing tables illustr ate some of the ic ons found in the main window of Remote Deskt op . The final table shows which network port numbers are in use by Apple Remote Desktop . Client Status Ic ons The follo wing icons appear next to the names of computers in a scanner search r esults list. The ic o[...]

  • Page 162

    162 Appendix A Icon and Port Reference List Menu Icons The following ic ons are used in the Apple Remote Deskt op list area of Remote Desktop ’ s main window . T ask Sta tus Icons The follo wing icons are used in task list areas of Remote Deskt op ’ s main window . Icon What it means Master list Apple Remote Desktop list Smart list Scanner Acti[...]

  • Page 163

    Appendix A Icon and Port Reference 163 Syst em Status Icons (Basic) The follo wing icons are shown as initial high-lev el status indicators for observed client computers. Syst em Status Icons (Detailed) The follo wing icons are shown after further inspection of obser ved client comput er status indicators. Icon Indicates or One or more service stat[...]

  • Page 164

    164 Appendix A Icon and Port Reference T CP and UDP P or t Refer ence Apple Remote Desktop use s the following TCP and UDP ports for the functions indicated . Over 95% used No status information is av ailable Service Ic on Status P ort Protoc ol F unction 5900 TCP Observe and Control 5900 UDP Send screen, share screen 3 283 T CP Repor ting 3 283 UD[...]

  • Page 165

    165 B Appendix B Repor t F ield Definitions Refer ence The follo wing sections describe the a vailable fields in some of the Apple Remote Desktop r epor ts. F or information on generating reports, see “Creating Reports” on page 1 1 1. The file search reports (File Search, Soft ware V ersion, and Software Differenc e) are not included because th[...]

  • Page 166

    166 Appendix B Report Field Definitions Reference V elocity Engine Y es/No L2 Cache Size In KB L3 Cache Size In KB Machine Model Memor y In KB Empty RAM Slots PCI slots Used Proce ssor Count CPU T ype Internal value Sales Order Number VM Size T otal RAM Slots Devices A T A Device Count Firewir e Device Count Keyboard Connected Mouse Connected Optic[...]

  • Page 167

    Appendix B Report Field Definitions Reference 167 Primary Network Hardware Address Primary Network Input Errors Primary Network Input Packets Primary Network Output Errors Primary Network Output Packets Primary Network Pref erences Sleep Display Y es/No Sleep Hard Disk Y es/No Sleep Computer Y es/No W ake for Ethernet Access Y es/No Printing Printe[...]

  • Page 168

    168 Appendix B Report Field Definitions Reference Storage Report List category Field name Notes or example Hardware Options Drive Manufacturer Drive Model Drive Revision Drive Pr otocol Removable Y es/No Serial Number Logical Unit Number Detachable V olume Options Creation date UNIX GMT format Disk Name Macintosh HD File C ount F older Count T otal[...]

  • Page 169

    Appendix B Report Field Definitions Reference 169 USB Devices Report F ireWire Devic es Report Memor y Repor t PCI Cards Report Field name Notes or e xample Product Name Product ID V endor ID V endor Name Device Speed 1 .5Mb , 1 2Mb Bus P ower In mA Date collected Field name Notes or e xample Device Speed 200, 400, 800 Mbits per second Software V e[...]

  • Page 170

    170 Appendix B Report Field Definitions Reference Network Int er faces Report ROM Revision Displays only Card Revision Card Memory Displays only Date collected Field name Notes or e xample List category Field name Notes or example Network Over view Name Location name Active Y es/No Primary Y es/No Configured With Ethernet Hardware Addr ess 00:3 0:6[...]

  • Page 171

    Appendix B Report Field Definitions Reference 171 Output Queue Stall Count Ethernet Statistics Ethernet Alignment Errors Ethernet FCS Errors Frame Check Sequence errors Ethernet Single Collision F rames Ethernet Multiple Collision Frame s Ethernet SQE T est Errors “heartbeat ” t est errors Ethernet Deferred T ransmissions Ethernet Late Collisio[...]

  • Page 172

    172 Appendix B Report Field Definitions Reference Network T e st Repor t Administra tion Settings Repor t Ethernet T ransmitter Resource Errors Ethernet Collision F requencies List category Field name Notes or example Field name Notes or e xample Computer Computer sharing name Min,. Time Shor test time f or ping response Max. TIme Longest time f or[...]

  • Page 173

    Appendix B Report Field Definitions Reference 173 Application Usage Report User History Repor t General Version Apple Remote Desktop version and build number Last Contacted Relative date List category Field name Notes or example Field name Notes or e xample Computer name File sharing computer name Name Application name Launch date 24 hour local tim[...]

  • Page 174

    174 Appendix C C AppleScript Remot e Desktop Suite This appendix shows the c onten ts of Remote Deskt op ’ s AppleScript Dictionar y . This appendix is not a substitute for the AppleScript Dictionar y view in Script Editor . It is included as a quick reference so that AppleScript c ommands might be found by a search of PDF conten ts. The Dictiona[...]

  • Page 175

    Appendix C AppleScript Remote Desktop Suite 175 application n [inh. application; see also Standard Suite]: Remote Desktop ’ s top level scripting object. ELEMENTS contains comput ers, computer lists, copy items tasks, copy to me tasks, documents, empty trash tasks, install package tasks, lock screen tasks, logout tasks , open application tasks, o[...]

  • Page 176

    176 Appendix C AppleScript Remote Desktop Suite copy items task n [inh. task > it em]: Copy items t o the target comput ers. ELEMENTS contained by application. PROPERTIES bandwidth limit (integer): Netw ork usage limit in kilobytes per second (0 = unlimited). conflict resolution (ask what to do/rename the existing it em/rename the item being cop[...]

  • Page 177

    Appendix C AppleScript Remote Desktop Suite 177 empty trash task n [inh. task > item]: Empty the trash on the target computers . ELEMENTS contained by application. install package task n [inh. task > item]: Install package(s) on the target computers. ELEMENTS contained by application. PROPERTIES after installing (attempt restart/do nothing/fo[...]

  • Page 178

    178 Appendix C AppleScript Remote Desktop Suite naming uniquely (boolean): Should each machine be forced t o have a numerically unique 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 change s or cancel (bo[...]

  • Page 179

    Appendix C AppleScript Remote Desktop Suite 179 share screen task n [inh. task > it em]: Share a computers screen t o the target computers. ELEMENTS contained by application. PROPERTIES source computer (c omputer): The computer (other than the admin) whose screen to share. shutdown task n [inh. task > item]: Shutdo wn the target computers . E[...]

  • Page 180

    180 Appendix D D P ostgr eSQL Schema Sample This chapter c ontains SQL commands t o assist SQL programmers in obtaining the database schema used in Apple Remote Desktop ’ s repor t database . Y ou can use this knowledge about the schema to create y our own applications that acce ss Apple Remote Deskt op report information. Sample list of main dat[...]

  • Page 181

    Appendix D PostgreSQL Schema Sample 181 lastupdated | timestamp with time zone | Sample list of propert y names Command: /System/Library/CoreServices/RemoteManagement/rmdb.bundle/bin/psql -U ard -c "select * from propertynamemap" ard Output: objectname | propertyname | propertymapid -----------------------+------------------------------+-[...]

  • Page 182

    Index 182 Index A aborting a task 98 access changing privileges 69 group-based 62 via local account 61 Access Privileges 59 adding Dock items 131 administrator announce 92 Apple keyboard keys 79 Apple Remote Desktop menu icon 94, 95 application use report 115 asset tracking application use 115 FireWire devices 121 hardware 119 management 118 memory[...]

  • Page 183

    Index 183 G General preferences 36 group-based authorization 65 guest access 65 H hard disk maintenance 131 hardware asset management 119 Help Desk Mode. See sharing control human interface customizing 36 icons 29 tips and shortcuts 37 I installation, Remote Desktop 40 Install Packages options 107 K keyboard shortcut exceptions 78 kickstart tool 14[...]

  • Page 184

    184 Index Automator 159 Secure Screen Blanking. See curtain mode. security best practices 73 preferences 36 sending scripts via UNIX command 145–147 serial number 40 setting boot disk 128 setting encryption defaults 75 setting Energy Saver preferences 132 setting up a Task Server 154 setting wake-on-LAN 132 sharing control 80 Sharing Preference 5[...]