- Unpack the service package
- Install the service
- Add your license
- Configure the service
- Start the service
- Configure the client
As of release
1.32.0, our Remote Execution software runs on the following
versions of macOS:
- 10.14 (Mojave)
- 10.15 (Catalina)
Need other OS support or want to run in an AWS or MacStadium environment? Contact us.
1. Unpack the service package¶
It contains the installer for the scheduler and worker services (
It does not contain a valid license file. We send you a license separately.
2. Install the service¶
On every machine, make sure you have at least Java 11 installed.
Need support for older versions of Java? Contact us.
Select at least one machine that will run the scheduler and install
scheduler.pkgon that machine.
Select at least one machine that will run the worker and install
worker.pkgon that machine.
You typically have significantly more workers than schedulers in a cluster.
Do not copy your source tree on these machines. The build tool uploads files if build actions need them.
3. Add your license¶
Copy your license onto every machine as
4. Configure the service¶
See the dedicated articles for details.
All service instances (schedulers and workers) can use the same
config file. Schedulers ignore worker-specific options and vice versa.
(Optional) Customize the
configfile we sent you as part of the trial agreement
Copy the file to every machine as
(Optional) Customize the file per-machine:
For a first time trial setup we recommend using the
config file we send
you as part of the trial agreement. Later (and especially before
productionizing) you should customize this config more. Consider:
- network settings (e.g.
As of release
localis the only supported execution strategy on macOS.
See the Service Options Reference for more info.
5. Start the service¶
The service is configured to start automatically. All you need to do is to reboot the machine.
If rebooting the machine is not possible or not desirable, you can also start the service by SSH into every machine and running the following commands:
For first-time setup, or after changing the configuration, we recommend to start the service temporarily in a shell session to verify it is up and running:
6. Configure the client¶
See Client configuration.