Apple MC172Z/A Administration Guide

Apple MC172Z/A - Remote Desktop Unlimited Managed Systems Edition Manual

Apple MC172Z/A manual content summary:

  • Apple MC172Z/A | Administration Guide - Page 1
    Apple Remote Desktop Administrator's Guide Version 3.2
  • Apple MC172Z/A | Administration Guide - Page 2
    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-K) for commercial purposes without the prior written consent of
  • Apple MC172Z/A | Administration Guide - Page 3
    This Book 10 Using This 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 Users 24 Providing Help Desk
  • Apple MC172Z/A | Administration Guide - Page 4
    #1-Remote Upgrade Installation 45 Method #2-Manual Installation 46 Upgrading Apple Remote Desktop Clients Using SSH 46 Apple Remote Desktop Administrator Access Authorization and Privileges Using Local Accounts in Mac OS X v10.4 69 Apple Remote Desktop Administrator Access Using Directory Services
  • Apple MC172Z/A | Administration Guide - Page 5
    72 Apple Remote Desktop Guest Access 73 Apple Remote Desktop Nonadministrator Access 73 Limiting Features in the Administrator Application 74 a Non-Mac OS X VNC Server 92 VNC Control Options 93 Configuring an Apple Remote Desktop Client to be Controlled by a VNC Viewer 93 Observing 95 Changing
  • Apple MC172Z/A | Administration Guide - Page 6
    Using Task Templates 110 Editing a Saved Task 110 Installing Software Using Apple Remote Desktop 110 Installing by Package and Metapackage 112 Installing Software on Usage Information 126 Finding Files, Folders, and Applications 128 Comparing Software 130 Auditing Hardware 135 Testing Network
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 8
    Desktop Appendix A 177 Icon and Port Reference 177 Client Status Icons 177 Apple Remote Desktop Status Icons 178 List Menu Icons 178 Task Status Icons Report 188 Network Test Report 188 Administration Settings Report 189 Application Usage Report 189 User History Report Appendix C 191 AppleScript
  • Apple MC172Z/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 costs, and increasing productivity. Apple Remote Desktop can also be used by educators to facilitate instruction in computer labs or one-on
  • Apple MC172Z/A | Administration Guide - Page 10
    Remote Desktop to interact with computer users. This guide is provided on the Apple Remote Desktop installation disc and on the Apple Remote Desktop support website as a fully searchable, bookmarked PDF file. You can use Apple's Preview application or Adobe (Acrobat) Reader to browse the contents
  • Apple MC172Z/A | Administration Guide - Page 11
    that you might type, along with other 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/remotedesktop/ Â the Help Menu in the Remote Desktop application
  • Apple MC172Z/A | Administration Guide - Page 12
    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 Remote Desktop Mailing list, visit: lists.apple.com/mailman/listinfo/remote-desktop
  • Apple MC172Z/A | Administration Guide - Page 13
    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 interaction capabilities and tells you
  • Apple MC172Z/A | Administration Guide - Page 14
    Apple 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 for multicomputer management. A computer can be categorized by its type (laptop, desktop), its physical location (building 3, 4th floor
  • Apple MC172Z/A | Administration Guide - Page 15
    lets you distribute software and related files to client computers 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
  • Apple MC172Z/A | Administration Guide - Page 16
    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 that you'll be using
  • Apple MC172Z/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. Use Apple Apple Remote Desktop to distribute AppleScript files that automate PDF workflows, or job instructions
  • Apple MC172Z/A | Administration Guide - Page 18
    , 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 data. You
  • Apple MC172Z/A | Administration Guide - Page 19
    node Marketing department Engineering department Using the collected data, Apple Remote Desktop generates reports tailored to your specifications. File 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
  • Apple MC172Z/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 identifying problems or verifying system configurations before installing new software, or determining how many devices of a particular type (such 1 Using Apple Remote Desktop
  • Apple MC172Z/A | Administration Guide - Page 21
    administrator computer and your client computers. The Network Interfaces report might also help troubleshooting network hardware issues. Use this report to help identify reasons for network communication problems that could affect Apple Remote Desktop. For example, if you're unable to copy items to
  • Apple MC172Z/A | Administration Guide - Page 22
    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 UNIX shell script
  • Apple MC172Z/A | Administration Guide - Page 23
    the desktop of Xserve computers, or use graphical applications on them. Apple Remote Desktop replaces the need for KVM (keyboard-video performance or other problems. Changing Startup Disks Change the startup disk of a client computer to perform diagnostic or troubleshooting activities. For example
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 25
    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 Use
  • Apple MC172Z/A | Administration Guide - Page 26
    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. For example, notify
  • Apple MC172Z/A | Administration Guide - Page 27
    perform tasks by controlling their screens from your computer, opening applications and using files as required. Locking Screens Lock student 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
  • Apple MC172Z/A | Administration Guide - Page 28
    instructions for performing the tasks highlighted in this chapter- and more-throughout this manual. To learn more about Remote Desktop interface Computer lists Apple Customizing reports Exporting report data User login accounting Application usage Deleting items Emptying the Trash Setting startup
  • Apple MC172Z/A | Administration Guide - Page 29
    instructions for customizing the appearance and preferences of the application. You will learn about: Â "Remote Desktop Human Interface Guide Interface Guide The following sections give basic information about the human interface of Remote Desktop, Apple Remote Desktop's administrator application. Â
  • Apple MC172Z/A | Administration Guide - Page 30
    them. If you have a 10-client license, the All Computers list can contain only 10 computers. B Apple Remote Desktop computer lists: A list of computers in the left portion of the main window. They have the icon of the type of task and have a user-changeable name. F Scanner: Scanners find clients
  • Apple MC172Z/A | Administration Guide - Page 31
    those run directly from the application. When all the target computers can be fully customized with icons of your most-used Apple Remote Desktop features. Task Dialogs When you click a task the task. A B G C D E F A Task type header: This header area shows you the kind of task represented.
  • Apple MC172Z/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 MC172Z/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 MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 36
    the 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 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 MC172Z/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 MC172Z/A | Administration Guide - Page 38
    and Install Packages tasks  Which features of Remote Desktop are available to nonadministrator users See "Apple Remote Desktop Nonadministrator Access" on page 73.  A new Remote Desktop application password Interface Tips and Shortcuts There are a number of features of the Remote Desktop interface
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 40
    40 Chapter 2 Getting to Know Remote Desktop
  • Apple MC172Z/A | Administration Guide - Page 41
    , 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 user interaction and gives ) Â Mac OS X Server version 10.3 or later with NetBoot and NetInstall services enabled 41
  • Apple MC172Z/A | Administration Guide - Page 42
    Apple Remote Desktop installation disc. 2 Double-click the Remote Desktop installer package and follow the onscreen instructions. The Remote Desktop application will be installed in the Applications Desktop. 7 If you have another unlimited-licensed copy of Apple Remote Desktop acting as a Task Server
  • Apple MC172Z/A | Administration Guide - Page 43
    Remote Desktop manually. 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
  • Apple MC172Z/A | Administration Guide - Page 44
    Remote Desktop Administrator Software" on page 42, for detailed instructions. If you are upgrading from version 1.2 and changing system requirements (see "System Requirements for Apple Remote Desktop" on page 41). Please note that there is no supported "downgrade" to any previous version, and
  • Apple MC172Z/A | Administration Guide - Page 45
    can be configured 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
  • Apple MC172Z/A | Administration Guide - Page 46
    to store such custom installers securely. Upgrading Apple Remote Desktop Clients Using SSH You may 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
  • Apple MC172Z/A | Administration Guide - Page 47
    in the appropriate information. Click OK after adding each 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 MC172Z/A | Administration Guide - Page 48
    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 Desktop
  • Apple MC172Z/A | Administration Guide - Page 49
    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 Remote Desktop
  • Apple MC172Z/A | Administration Guide - Page 50
    OS X v10.3, v10.4, and v10.5 installation, do not remove the Apple Remote Desktop client components. To disable the client software on a client computer version 10.4 or earlier, deselect Apple Remote Desktop in the Sharing pane. 3 Quit System Preferences. Apple Remote Desktop is now disabled and
  • Apple MC172Z/A | Administration Guide - Page 51
    software. Disabling the client software is 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
  • Apple MC172Z/A | Administration Guide - Page 52
    52 Chapter 3 Installing Apple Remote Desktop
  • Apple MC172Z/A | Administration Guide - Page 53
    Remote Desktop Computer Lists Before you can audit, control, or maintain any client, you need to add it to an Apple Remote Desktop computer list. To use Bonjour to discover computers on your local subnet, your local network's routers and firewalls must allow multicast DNS (mDNS)
  • Apple MC172Z/A | Administration Guide - Page 54
    in the Sharing pane of System Preferences. The computer's IP address, if any. The computer's DNS name, found by reverse lookup, if any. Apple Remote Desktop client software version. Which interface the client responded through. If you want to change the default display list for the scanner, you can
  • Apple MC172Z/A | Administration Guide - Page 55
    list. 5 Authenticate by providing a user name and password for an Apple Remote Desktop administrator. The computer is now in your All Computers list. range, you provide a beginning and ending IP address to scan, and Apple Remote Desktop queries each IP address in that range in sequence, asking if
  • Apple MC172Z/A | Administration Guide - Page 56
    . 5 Select the desired computers. 6 Drag the selected computers to the All Computers list. 7 Authenticate by providing a user name and password for an Apple Remote Desktop administrator. The computer is now in your All Computers list. 56 Chapter 4 Organizing Client Computers Into Computer Lists
  • Apple MC172Z/A | Administration Guide - Page 57
    list. 6 Authenticate by providing a user name and password for an Apple Remote Desktop administrator. The computer is now in your All Computers list. several scanners in order to search for specific address ranges or to do other types of searches. You can make and save your own scanner so you can
  • Apple MC172Z/A | Administration Guide - Page 58
    dragging them up and down the left side of the main window. Apple Remote Desktop has several different kinds of lists. The following section describes the  The All Computers list can have up to the number of computers your license allows.  Computers can appear in more than one list.  Lists can
  • Apple MC172Z/A | Administration Guide - Page 59
    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 Remote Desktop computer list: 1 Select the All Computers list icon in the main Remote Desktop window. 2 Select the computers you want to add to the
  • Apple MC172Z/A | Administration Guide - Page 60
    came from. To create an list of computer lists: 1 Create the lists which will serve as the sources of the smart list. See "Creating an Apple Remote Desktop Computer List" on page 59 or "Creating a Smart Computer List" on page 59 for more information. 2 Create the Smart List which will draw
  • Apple MC172Z/A | Administration Guide - Page 61
    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 password used for
  • Apple MC172Z/A | Administration Guide - Page 62
    existing computer lists to the new administrator computer before installing version 3.1. These instructions only apply when moving Apple Remote Desktop 1.2 computer lists to a new computer. Throughout these instructions, the computer with the original lists is the "source computer." The computer
  • Apple MC172Z/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 each entry. 19 Quit Keychain Access on the source computer. When you open Apple Remote Desktop on the new computer, you will notice that the computer lists
  • Apple MC172Z/A | Administration Guide - Page 64
    64 Chapter 4 Organizing Client Computers Into Computer Lists
  • Apple MC172Z/A | Administration Guide - Page 65
    tools. This chapter explains the various access types, their configuration, and 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 MC172Z/A | Administration Guide - Page 66
    computer is being observed or controlled. For more information, see "Apple Remote Desktop Status Icons" on page 177. Create hardware and software Set Reporting Policy and Spotlight Search. Use these Manage menu commands: Open Application, Open Items, Send UNIX Command and Log Out Current User. Use
  • Apple MC172Z/A | Administration Guide - Page 67
    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 Using Local Accounts in Mac OS X v10.5 To prepare a client for administration, you enable Remote
  • Apple MC172Z/A | Administration Guide - Page 68
    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 whose access privileges
  • Apple MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 71
    and leaves no group with the "ard_reports" privilege set. Here's the XML: mcx_application_data com
  • Apple MC172Z/A | Administration Guide - Page 72
    be the Directory Services administrator and have access to your organization's users and groups server. To enable Apple Remote Desktop Applications/Utilities/). Apple Remote Desktop Guest Access You can configure an Apple Remote Desktop client to give temporary, one-time access to an Apple
  • Apple MC172Z/A | Administration Guide - Page 73
     Restart, shut down, and power on computers  Open or quit files and applications  Rename computers  Generate reports and software searches  Copy items, delete items, and empty the Trash  Create Apple Remote Desktop custom client installers  Upgrade clients and change client settings  Install
  • Apple MC172Z/A | Administration Guide - Page 74
    password does not necessarily correspond to any other password on the system, and is determined by the VNC configuration. VNC access is similar to Apple Remote Desktop's Control command. It allows you to use your keyboard and mouse to control a VNC server across a network. It doesn't give any other
  • Apple MC172Z/A | Administration Guide - Page 75
    pane of System Preferences (called "Remote Login") and is separate from Apple Remote Desktop access types. When you log in to a client remotely using SSH, you have sub-administrators. The following section gives detailed instructions for checking the administrator privilege settings of client
  • Apple MC172Z/A | Administration Guide - Page 76
    a list of the Apple Remote Desktop administrator access types each with an "On" or "Off" to indicate whether that access type is available to you. using the Change Client Settings command. If you are using Directory Services to designate administrator privileges, you don't need to change the settings
  • Apple MC172Z/A | Administration Guide - Page 77
    on. 9 Choose whether to assign Apple Remote Desktop administrator access privileges to Directory Services groups. If you choose to do so 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 MC172Z/A | Administration Guide - Page 78
    78 Chapter 5 Understanding and Controlling Access Privileges
  • Apple MC172Z/A | Administration Guide - Page 79
    -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 an AirPort Wireless Network" on
  • Apple MC172Z/A | Administration Guide - Page 80
    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 in a list
  • Apple MC172Z/A | Administration Guide - Page 81
    networks also are not suited for multicast traffic. However Apple Remote Desktop's multi-observe feature is different because it doesn 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
  • Apple MC172Z/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  To disable or limit an administrator's access to an Apple Remote Desktop client, open System Preferences on the client computer
  • Apple MC172Z/A | Administration Guide - Page 83
    and Data Transport Encryption Authentication to Apple Remote Desktop clients uses an these as well by changing your application preferences). This information is encrypted VNC server which is not Remote Desktop, it will not support Remote Desktop keystroke encryption. If you try to control that
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 85
    Interacting with Users 7 7 Apple Remote Desktop is a powerful tool for interacting with 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
  • Apple MC172Z/A | Administration Guide - Page 86
    Remote Desktop permissions. While you control an Apple Remote Desktop client computer, 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
  • Apple MC172Z/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 Time" on page 43) and that the computer has been added to an Apple Remote Desktop computer list (see "Finding and
  • Apple MC172Z/A | Administration Guide - Page 88
    in the control window toolbar. Sharing Control with a User You can either take complete mouse and keyboard control or share control with an Apple Remote Desktop client user. This allows you to have more control over the client interaction as well as prevents possible client side interference. This
  • Apple MC172Z/A | Administration Guide - Page 89
    , the client computer screen is scaled up to completely fill the administrator screen. In addition to the client screen, there are a number of Apple Remote Desktop controls still visible overlaying the client screen. In in-a-window mode, you can switch between fitting the client screen in the window
  • Apple MC172Z/A | Administration Guide - Page 90
    In an Apple Remote Desktop computer list If the you are trying to control a VNC server which is not Remote Desktop, it will not support Remote Desktop instructions assume the observed computer has been added to an Apple Remote Desktop computer list (see "Finding and Adding Clients to Apple
  • Apple MC172Z/A | Administration Guide - Page 91
    to be viewed with Remote Desktop. This section cannot give detailed instructions, since the client operating system, VNC software, and firewall will be box. There is no user name for a VNC server, just a password. Apple Remote Desktop Control and the PC's Ctrl-Alt-Del If you use Remote Desktop
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 93
    "VNC viewers may control screen with the password." 4 Enter a VNC password. 5 Click OK. WARNING: Do not use the same password as any user or Apple Remote Desktop administrator. The password may not be secure. Observing You may not want to control a computer, but merely monitor what is on its screen
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 95
    each page. Drag the slider to adjust the screen color depth from black and white to millions of colors. If you're observing a computer with Apple Remote Desktop client version 3.2 or later installed, drag the slider to the second notch from the right to use the Adaptive Quality Codec. This codec
  • Apple MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 98
    Service . Shortcuts in the Multiple Screen Observe Window You can access several Apple Remote Desktop commands using icons in the observe window. You can of your toolbar customizations, you'll be able to advance through pages manually, change the titling of the observed screens, change the number of
  • Apple MC172Z/A | Administration Guide - Page 99
    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 in your All Computers list and be authenticated with permission to Observe. Apple Remote Desktop does not have to be launched to use the widget.
  • Apple MC172Z/A | Administration Guide - Page 100
    Remote Desktop allows you to communicate with users of Apple Remote Desktop client computers using text messaging. You can use text messages to give instructions or announcements, to collaborate remotely, or troubleshoot with users. There are two types of text messaging: one-way messages and two-way
  • Apple MC172Z/A | Administration Guide - Page 101
    target computers and the source computer. 3 Choose Interact > Share Screen. 4 Select the screen to be shared. If you want to share the Apple Remote Desktop administrator screen, select "Share your screen." If you want to share a client screen, select "Share a different screen," and drag a computer
  • Apple MC172Z/A | Administration Guide - Page 102
    administrator is currently monitoring the client computer, the client user can send an attention request. To request administrator attention: 1 Click the Apple Remote Desktop status icon and choose Message to Administrator. The attention request window appears. 2 If the network has more than one
  • Apple MC172Z/A | Administration Guide - Page 103
    has been sent. To cancel an attention request: m Click the Apple Remote Desktop status icon in the menu bar and choose Cancel Message. 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
  • Apple MC172Z/A | Administration Guide - Page 104
    104 Chapter 7 Interacting with Users
  • Apple MC172Z/A | Administration Guide - Page 105
    computer. This chapter describes Remote Desktop's capabilities and gives complete instructions for using them. You can learn about: Â "Keeping Track of Task Progress and History" on page 105 Â "Installing Software Using Apple Remote Desktop" on page 110 Â "Upgrading Software" on page 115
  • Apple MC172Z/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 MC172Z/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 MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 110
    or NetInstall. WARNING: Distributing copyrighted software without the appropriate license agreement is a violation of copyright law. Installing by Package packages (.pkg or .mpkg files) to one or more remote clients. Apple Remote Desktop copies the package to the computers you choose, runs the
  • Apple MC172Z/A | Administration Guide - Page 111
    the Task Server" on page 166. For detailed instructions about installing via the Task Server, see "Installing restart the computers upon completion, or restart the computers manually later. It is not possible to stop the application (available on the Apple Remote Desktop CD or with the Apple
  • Apple MC172Z/A | Administration Guide - Page 112
    created by the installer. Installing Software on Offline Computers Using Apple Remote Desktop, you can install software on a computer application performs the installation. Remote Desktop first copies the installation package to the Task Server, and gives the Task Server the necessary instructions
  • Apple MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 115
    their applications open. Make sure the software to be upgraded is not running. WARNING: Distributing copyrighted software without the appropriate license new version. Consult the software's manual for instructions on removing its software. If an uninstaller application is necessary, you can copy it
  • Apple MC172Z/A | Administration Guide - Page 116
    Copying Files Apple Remote Desktop makes it easy to copy items (other than the .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
  • Apple MC172Z/A | Administration Guide - Page 117
    available in the "Place Items In" destination popup menu, including the Applications folder. If you do not see the destination you want, you can copies are done at the maximum sustainable rate for the network. This allows Apple Remote Desktop to use all the resources at its disposal to quickly and
  • Apple MC172Z/A | Administration Guide - Page 118
    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 copy items to clients
  • Apple MC172Z/A | Administration Guide - Page 119
    116 for more information on the available options for copy tasks. 7 Click Copy. Copying from a Client to the Finder Using Apple Remote Desktop, you can copy files, applications, or folders from a remote computer to the administrator's computer. The process requires that you find the file you want to
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 121
    queries Apple Remote Desktop's internal database of collected system information (such as hardware information and system settings), file information (including installed applications and versions, and software names), or both. You determine how often the data is collected, and what type of
  • Apple MC172Z/A | Administration Guide - Page 122
    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 report data, if you have another unlimited-managed computer license for Apple Remote Desktop. Using a server that is always running
  • Apple MC172Z/A | Administration Guide - Page 123
    Usage You can have a single Apple Remote Desktop data collection database for probably give yourself your own denial-of-service attack. Increasing the number of Task Server to use all available bandwidth (most IP-based client/server applications work this way). Therefore, on a 10Mbit/sec. network,
  • Apple MC172Z/A | Administration Guide - Page 124
    for other reports (System Overview, Application Usage, and User History) are only 8 KB to 12 KB can customize which type of data is collected, as desired. Auditing Client Usage Information With Apple Remote Desktop, instructions. 124 Chapter 8 Administering Client Computers
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 126
    and Applications Apple Remote Desktop allows you to search the contents of client computer hard disks for specific files, folders, or applications. 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. For
  • Apple MC172Z/A | Administration Guide - Page 127
    ,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. search parameters for Apple Remote Desktop are slightly different from those used by the Finder's Find command. For example, Apple Remote Desktop does
  • Apple MC172Z/A | Administration Guide - Page 128
    The newly generated report window appears. Comparing Software Apple Remote Desktop has several specialized reports for comparing software 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
  • Apple MC172Z/A | Administration Guide - Page 129
    your clients have the applications or fonts they need. Comparing differences in installed packages can help you troubleshoot software conflicts, and keep Difference. 4 Select the software type you want to compare. Selecting Applications compares all executable applications. You can limit which
  • Apple MC172Z/A | Administration Guide - Page 130
    Management in the Sharing pane. If the client computer is running Mac OS X version 10.4 or earlier, add comments or notes by selecting Apple Remote Desktop in the Sharing pane and clicking Access Privileges. 3 Click Computer Settings. 4 In the Computer Information fields, enter comments or notes
  • Apple MC172Z/A | Administration Guide - Page 131
    Remote Desktop to retrieve a computer's serial number, you could use the command-line tool systemprofiler with Apple Remote Desktop's Send UNIX Command feature. To generate a serial number report: 1 Select a computer list in the Remote Desktop window. 2 Select one or more computers in
  • Apple MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 134
    memory module, including the module's:  Slot 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
  • Apple MC172Z/A | Administration Guide - Page 135
    using new data, select Rebuild Data For Report. 6 Click Get Report. The newly generated report window appears. Testing Network Responsiveness Apple Remote Desktop can test network responsiveness between your administrator computer and client computers. It sends network packets to the clients and
  • Apple MC172Z/A | Administration Guide - Page 136
    to diagnose whether task failures in Apple Remote Desktop are due to network lost packets, there may be a network connection problem or a problem with an intervening router or bridge. Exporting Report with your own SQL query tools or applications. Using standard SQL database queries you can
  • Apple MC172Z/A | Administration Guide - Page 137
    exported document will be opened in an application or on an operating system that does not support Unicode text encoding (for example, some the Manage menu. This has the same effect as selecting the computer in an Apple Remote Desktop computer list. Â Interact with users. Select any row in a report
  • Apple MC172Z/A | Administration Guide - Page 138
    Maintaining Systems Apple Remote Desktop provides easy and powerful tools for maintaining 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
  • Apple MC172Z/A | Administration Guide - Page 139
    the Remote Desktop window. 2 Select one or more computers in the selected computer list. 3 Choose Manage > Empty Trash. 4 Click Empty. Setting the Startup Disk Apple Remote Desktop can set the startup disk on any client computer. You can choose between a volume on a local hard disk or any available
  • Apple MC172Z/A | Administration Guide - Page 140
    have Restart privileges to use this option. 8 Click Set. Renaming Computers Apple Remote Desktop can set the name that a client computer uses for file correlate events between clients on the network. In addition, many internet services rely on, or benefit from, clock times that are synchronized to
  • Apple MC172Z/A | Administration Guide - Page 141
    Server from the 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
  • Apple MC172Z/A | Administration Guide - Page 142
    5 Alternatively, manually enter the UNIX command. a Type or paste . Repairing file permissions requires the use of Apple Remote Desktop's Send UNIX Command feature, and the file, folder, or application isn't immediately added to the user's Dock. The instructions provided here are a workaround
  • Apple MC172Z/A | Administration Guide - Page 143
    4 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 MC172Z/A | Administration Guide - Page 144
    . Setting the remote login sharing preference requires the use of Apple Remote Desktop's built-in command-line tool, systemsetup. See 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 |
  • Apple MC172Z/A | Administration Guide - Page 145
    window. 2 Select one or more computers in the selected computer list. 3 Choose Manage > Send UNIX Command. 4 Type or paste the following UNIX command: lpadmin -p printer_name -E -v lpd://printer_and_queue_address -m printer_model_ppd_file -L "text_description_of_printer_location" 5 Set the user
  • Apple MC172Z/A | Administration Guide - Page 146
    commands. Opening Files and Folders Apple Remote Desktop can open existing items (files, folders, and applications) on client computers. The item type, size, permissions, and file creation date as the item on the administrator computer. The Open Items command opens files in the application used
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 148
    Fill in the desired Application Name. 5 Alternatively, manually enter the UNIX command. a Type or paste the following UNIX command: killall "application_name" b Set the user permissions for this command to be sent as the user "root." 6 Click Send. Putting a Computer to Sleep Apple Remote Desktop can
  • Apple MC172Z/A | Administration Guide - Page 149
    on a wakeonlan packet. If you must wake computers on a different subnet, you may want to use a computer on that subnet as a type of sentry. It never sleeps, and runs another licensed copy of Remote Desktop, as well as allows itself to be controlled by your local copy of Remote Desktop. That way
  • Apple MC172Z/A | Administration Guide - Page 150
    message text. Displaying a Custom Picture on a Locked Screen You can display a picture of your choice on the client screen while it is locked by Apple Remote Desktop. When creating images, make sure the image size will fit on the client computer's screen. For example, if you have clients with 800
  • Apple MC172Z/A | Administration Guide - Page 151
    in Curtain Mode" button to your toolbar, click that toolbar icon. You can also select Interact > Curtain. Logging In a User at the Login Window Apple Remote Desktop can log in any user on a client computer by using AppleScript System Events and the Send UNIX Command feature. Using these powerful
  • Apple MC172Z/A | Administration Guide - Page 152
    tell application "System Events" keystroke "" keystroke tab delay 0.5 keystroke "" delay 0.5 keystroke return end tell EndOfMyScript 5 Choose user "root" to run the command. 6 Click Send. The client computer executes the script. Logging Out the Current User Apple Remote
  • Apple MC172Z/A | Administration Guide - Page 153
    computers in the selected computer list. 3 Choose Manage > Restart. 4 Select the type of restart. You can allow users to save files or cancel the restart, or a shutdown. Note: If you shut down an Apple Remote Desktop client that does not support lightsout management, you cannot start it up using
  • Apple MC172Z/A | Administration Guide - Page 154
    Starting Up a Computer Apple Remote Desktop can start up clients that support lights-out management (LOM). Unlike waking 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
  • Apple MC172Z/A | Administration Guide - Page 155
    Shell Commands In addition to its own tasks, Apple Remote Desktop provides a way to easily execute 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
  • Apple MC172Z/A | Administration Guide - Page 156
    All Services  Manual IP  DHCP  BOOTP  Manual with Apple Events  Remote Login (SSH)  Restart After Freeze  Restart After Power Failure  System Sleep Time  Display Sleep Time  Hard Disk Sleep Time  Delay After Power Failure  Wake On Modem Activity  Wake On Network Access  Quit Application
  • Apple MC172Z/A | Administration Guide - Page 157
    more computers in the selected computer list. 3 Choose Manage > Send UNIX Command. 4 Type or paste the command. If your command is a multi-line script, enter each programming language and they are created using the Script Editor application. Running a UNIX command as the current user will fail
  • Apple MC172Z/A | Administration Guide - Page 158
    or go to: www.apple.com/applescript/. To send and execute an AppleScript: 1 Save the AppleScript as an application. 2 Open Remote Desktop. in the selected computer list. 3 Choose Manage > Send UNIX Command. 4 Type or paste the AppleScript in the UNIX Command window, like this: osascript -e
  • Apple MC172Z/A | Administration Guide - Page 159
    label would be entered as: osascript
  • Apple MC172Z/A | Administration Guide - Page 160
    Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/ Support/networksetup -help  service to use BOOTP. networksetup -setbootp "Built-in Ethernet" -setmanualwithdhcprouter Use this command to specify a manual all DNS entries for the specified network service, type "empty" in place of the DNS
  • Apple MC172Z/A | Administration Guide - Page 161
    service with domain and port number. Turns proxy on. Optionally, specify on or off to enable and disable authenticated proxy support /CoreServices/RemoteManagement/ARDAgent.app/Contents/Support/ systemsetup -help . Example: systemsetup -setnetworktimeserver time.apple.com Use this command to set
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 163
    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 app/Contents/ Resources/kickstart -help If you are running the kickstart utility through Apple section should be typed as one line
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 165
    Apple Remote Desktop, and AppleScript or UNIX scripts. This chapter describes Remote Desktop's automation capabilities and gives instructions for cached report data. The Remote Desktop application console doesn't need to be open and Systems license. Also, the Task Server performs only two of
  • Apple MC172Z/A | Administration Guide - Page 166
    but will be regenerated at the next collection interval. If you choose to use another Apple Remote Desktop administrator computer's database, you must configure it to allow data access to other Apple Remote Desktop administrators. The default Task Server is the computer on which you installed Remote
  • Apple MC172Z/A | Administration Guide - Page 167
    copy tools to install the Remote Desktop application. For more information, see "Using administrators. For more information, see "Apple Remote Desktop Administrator Access" on page You'll need to install and configure a second licensed copy of Remote Desktop on the administrator computer. Although
  • Apple MC172Z/A | Administration Guide - Page 168
    them to a list. For information, see "Finding and Adding Clients to Apple Remote Desktop Computer Lists" on page 53. Setting Up Clients to Interface information: system data, file data, user accounting data, and application usage data. System data includes information for the following reports:
  • Apple MC172Z/A | Administration Guide - Page 169
    Application Usage Setting the Client's Data Reporting Policy To speed up reporting and allow reporting from offline clients, Apple 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
  • Apple MC172Z/A | Administration Guide - Page 170
    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 schedule almost any task. For
  • Apple MC172Z/A | Administration Guide - Page 171
    tasks. For example, you can use AppleScript to automate Remote Desktop itself. Also by using Automator actions, you can even create your own interfaces to Apple Remote Desktop functions without having to give users access to Remote Desktop. Chapter 9 Automating Tasks 171
  • Apple MC172Z/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 MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 175
    your time-consuming, repetitive manual tasks quickly, efficiently, tasks again and again. Simple and easy-to-understand application actions are the building blocks, so you don't have actions, you can even create your own interfaces to Apple Remote Desktop functions without having to give users access
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 177
    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 a scanner search results list. The icons show the status
  • Apple MC172Z/A | Administration Guide - Page 178
    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 are used in task
  • Apple MC172Z/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 MC172Z/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 for the functions indicated. Port 5900 5900 3283 3283 22 Protocol TCP UDP TCP UDP TCP
  • Apple MC172Z/A | Administration Guide - Page 181
    B The following sections describe the available fields in some of the Apple Remote Desktop reports. For information on generating reports, see "Creating Reports Firmware Version AirPort Hardware Address AirPort Locale AirPort Type AirPort Installed AirPort Network Channel AirPort Network in
  • Apple MC172Z/A | Administration Guide - Page 182
    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 Keyboard Connected Mouse Connected Optical Drive
  • Apple MC172Z/A | Administration Guide - Page 183
    for Ethernet Access Yes/No Printer Name Printer Sharing Yes/No Printer Type Printer Version Computer Info #1 Computer Info #2 Computer Info #3 Computer File sharing name, "Bob's Computer" FTP Access Yes/No Remote Apple Events Yes/No Remote Login Yes/No UNIX hostname foo.example.
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 185
    Manufacturer Model Firmware Revision Date collected Notes or example 200, 400, 800 Mbits per second Memory Report Field name Slot Identifier Size Speed Type Date collected Notes or example DIMM0/J21 In MB PC133-222 (Mac OS X 10.3 only) SDRAM Appendix B Report Field Definitions Reference 185
  • Apple MC172Z/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
  • Apple MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 189
    or off Apple Remote Desktop version and build number Relative date Application Usage application was the frontmost application Short user name of application process owner What the application is doing now (running, terminated, etc.) User History Report Field name Computer User name Login type
  • Apple MC172Z/A | Administration Guide - Page 190
    190 Appendix B Report Field Definitions Reference
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 192
    boot volume (Unicode text, r/o): The boot volume of the computer. CPU (Unicode text, r/o): The CPU type of the computer. current application (Unicode text, r/o): The current frontmost application on the computer. current user (Unicode text, r/o): The currently logged in user on the computer. DNS
  • Apple MC172Z/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 MC172Z/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 MC172Z/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 MC172Z/A | Administration Guide - Page 196
    abstract class represents the tasks which can be executed by Remote Desktop. There are subclasses for each specific type of task. ELEMENTS contained by application. PROPERTIES computer list (computer list): The computer list associated with the task. id (Unicode text, r/o): The unique identifier
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 198
    198 Appendix C AppleScript Remote Desktop Suite
  • Apple MC172Z/A | Administration Guide - Page 199
    use this knowledge about the schema to create your own applications that access Apple Remote Desktop report information. Sample list of main database systeminformation" ard Output: Table "public.systeminformation" Column | Type | Modifiers computerid | character(17) | not null objectname
  • Apple MC172Z/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 MC172Z/A | Administration Guide - Page 201
    announce 100 Apple keyboard keys 86 Apple Remote Desktop menu icon 102, 103 application use report 125 asset tracking application use 125 99 deleting files 139 demonstration mode 101 designated data collector 122 directory services 69 drag and drop copies 118 installation 113 E enabling SSH
  • Apple MC172Z/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 MC172Z/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