Help Desk

Submit a ticket My Tickets
Welcome
Login

Linux & macOS Installation

This section will describe the process of installing a OneCloud GroundRunner on a Linux and macOS operating system.

Installation Steps

  1. Place the GroundRunner installation file in its own directory such as:
    /home/<username>/onecloud/
  2. Unzip the files in the directory created in step #1. Assuming unzip is installed, use the following command:

    unzip linux_amd64_ground_runner.zip
  3. NOTE: Only do this step if installing the OneCloud GroundRunner as a system service and logged in as a user with root access.
    Use the following command to install the OneCloud as a Service. Note you must have "root" access:

    sudo ./occli install
  4. NOTE: Only do this step if installing the OneCloud GroundRunner as a foreground process and using a non-privileged account.
    Use the following command to install the OneCloud as a foreground process. Be sure to select none for the init system option.

    ./occli install
  5. The installer will ask various questions. Press <enter> to accept the default. See a sample installation below, so you know what to expect.

  6. Delete the installation files, downloaded ZIP file, leaving only the OneCloud GroundRunner executable directory under the "Contents" directory.


Which init System?

The GroundRunner installation will ask for the system init. One way to check which init system is being used is to check for the existence of two directories:

  • systemd based system (most modern Linux distributions systemd):
    /usr/lib/systemd
  • upstart based system:
    /usr/share/upstart

Note: For macOS, neither applies. Please run the GroundRunner as a foreground process (see below).

Post Installation Steps

Running as a Service

  • If the installation was successful, start and stop the OneCloud GroundRunner with the following commands (note: installation path will be different)
    cd /home/<username>/onecloud/Contents
    sudo ./occli start
  • To stop the OneCloud GroundRunner service, use the Windows Services Manager or use the command:
    cd /home/<username>/onecloud/Contents
    sudo ./occli start

Running as a Foreground Process (log written to console)

  • The OneCloud GroundRunner can be run as a foreground process with the following commands;
    cd /home/<username>/onecloud/Contents
    sudo ./ocrunner
  • To stop the foreground process, press the key sequence:
    <ctrl> <c>

Running as a Foreground Process (log written to logfile)

  • The OneCloud GroundRunner can be run as a foreground process with the following commands;
    cd /home/<username>/onecloud/Contents
    sudo ./ocrunnermonitor.exe
  • To stop the foreground process, press the key sequence:
    <ctrl> <c>

Example Installation Session

The following session demonstrates installing the OneCloud GroundRunner with the following configuration: 

  • Accept default installation locations 
  • Use the GroundRunner without a proxy 
  • Configure the GroundRunner to run systemd

Uninstall

To remove the OneCloud GroundRunner service simply perform the following steps: 

  1. Stop the OneCloud Service (see instructions above)
  2. Remove the service with the following command:
     sudo ./occli uninstall
  3. Delete the "Contents" executable directory.

These instructions assume the OneCloud GroundRunner executable directory is the following:

/home/<username>/onecloud/

Always download the latest GroundRunner

If the OneCloud GroundRunner needs to be installed in the future, simply download a new copy from OneCloud and do not use a previously download versions.


What's Next?

How to Whitelist GroundRunner Domains.

B
Brian is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.