Mass Installation on macOS

You can customize the Remotix Agent installation file if you need to deploy many copies with the same custom settings.

There are two ways on how to create a package for the mass installation of Remotix Agent. One way is to create a modified .pkg file that will install Remotix Agent with the settings provided. To deploy this .pkg, you will have to use Apple Remote Desktop to install the package on multiple computers.
Note: if you run .pkg installation manually, macOS will refuse to install it since the injection of the settings file tampers the package cryptographic signature. To install such a package without ARD, you will need to change the settings of the macOS Gatekeeper or launch it with administrator rights (sudo).

The second option is to create a .zip file that will contain an untampered Remotix Agent.pkg along with the .rxasettings file ready for import. When a user installs the .pkg, the installer will automatically catch the .rxasettings file from the same folder where the .pkg is located and import it.

Creating a modified Agent package:

  1. Make a .rxasettings file containing a set of Agent preferences for mass deployment. To export current Remotix Agent preferences, choose File > Export Settings. To customize the settings file, you can use any plain text editor. For more information, see examples in the exported file.
  2. Locate Remotix Agent.pkg installation package.
  3. Download and save prepare-preconfigured-pkg.sh script from here.
  4. Go to the directory where the script file is located.
  5. Run the script with the following arguments:
    prepare-preconfigured-pkg.sh [Remotix Agent.pkg path] [.rxasettings path] [target .pkg path]

    An example of a correctly written command:
    ./prepare-preconfigured-pkg.sh ~/Downloads/RemotixAgent.pkg ~/work/Nulana.rxasettings ~/work/NulanaRXAgent.pkg

    If you get “permission denied” error when trying to run the script, make sure that the file is executable:
    1. In Terminal, navigate to the folder where the script file is located,
    2. Execute ls -l command,
    3. It should list all files in the folder with their permissions noted. If the script doesn’t have an ‘x’ letter in its permissions, it means that macOS thinks it is not executable.
    4. To make the script executable, use this command: chmod +x prepare-preconfigured-pkg.sh
    5. If you execute ls -l again, the script should have something like -rwxr-xr-x@ to the left and can now be executed.
  6. The script will compile an installation package and save it to the target location with the name provided.
  7. Use the target package to install Remotix Agent with the predefined settings.
    Note: installing this package would require either the Apple Remote Desktop app or changing the gatekeeper settings on target machines.

Creating an archive containing an unmodified Remotix Agent and a settings file ready for import:

  1. Make a .rxasettings file containing a set of Agent preferences for mass deployment.
  2. Locate Remotix Agent.pkg installation package.
  3. Download and save prepare-preconfigured-zip.sh script from here.
  4. Go to the directory where the script file is located.
  5. Run the script with the following arguments:
    prepare-preconfigured-zip.sh [Remotix Agent.pkg path] [.rxasettings path] [target .zip path]

    An example of a correctly written command:
    ./prepare-preconfigured-zip.sh ~/Downloads/RemotixAgent.pkg ~/work/Nulana.rxasettings ~/work/NulanaRXAgent.zip
  6. The script will create a .zip file with .pkg and .rxasettings files within.
  7. Use the resulting .zip file to install Remotix Agent and import the predefined settings automatically during the installation.