Starting a session with a macOS target

Learn how to start an On Demand Target session with a macOS target.

Before you begin

Ensure on the Remote Control Server, in the ondemand.properties file, the property ondemand.macos.package is set to .pkg. To check that:
  1. In the Remote Control Server UI, clickAdmin > Edit the properties file.
  2. From the drop-down menu, select ondemand.properties and check the value of the ondemand.macos.package property.

About this task

When you set the ondemand.macos.package to .pkg, you can start the session on the macOS target without manually changing the permissions on the downloaded file. After setting the property, to start a session on a macOS target, do the following steps:

Procedure

  1. Start a broker session. For instructions, see Starting a session with a macOS target
  2. Open the browser on the macOS target in which you want to start the session.
  3. Open the connection URL displayed in the Controller and follow the instructions shown on that page. The .pkg file is downloaded automatically.
  4. After the .pkg file gets downloaded successfully, double click the file to start it.
  5. Follow the instructions shown in the installer to complete the installation.
  6. Click Close to close the installer.
    Note: If you do not have the administrator rights to select Change Install Location..., the error message You cannot install Remote Control On-demand Target in this location ... might appear. However, you can safely ignore this message, as this seems to be a bug in the macOS installer application).

Results

  • When the installation completes, the On-demand Target application starts and connects to the broker session automatically.
  • If you have selected Install for me Only during the installation, the On-demand Target application is installed in the folder /Library/Caches/RCODT or $HOME/Library/Caches/RCODT.
  • After successful installation, the .pkg file is deleted automatically.
  • When the Broker session is terminated, the application is deleted automatically; therefore, no track of the application is left after that the session is terminated.
Note: To work correctly, the On-demand Target needs the "Accessibility" and "Screen Recordings" permissions. For the instructions to set these permissions, see Enable the required macOS permission on Remote Control Target version V10 IF0001 or later.