Headless setup Linux

Typical setup example

The following is a typical step-by-step setup and install of a worker and manager as services:

  1. Unzip Network Rendering distribution anywhere
  2. cd into the unzipped distribution folder
  3. Run basic setup: % sudo ./setup.sh
  4. Copy the license file into “/var/local/share/KeyShot11NetworkResources/”
  5. % cd bin
  6. Configure the manager via terminal prompts:
    % ./keyshot_network_manager --config
    Follow on-screen commands.
  7. Configure the worker via terminal prompts:
    % ./keyshot_network_worker --config
    Follow on-screen commands.
  8. Install the manager watchdog service:
    # ./keyshot_network_manager_watchdog -install
  9. Install the worker watchdog service:
    # ./keyshot_network_worker_watchdog -install
  10. Start the manager watchdog service:
    % ./keyshot_network_manager_watchdog
  11. Start the worker watchdog service:
    % ./keyshot_network_worker_watchdog

At this point, both the Network Rendering Manager and Worker services are running in the background.

Stop Services

  1. Open a Terminal
  2. cd into the installations bin folder
  3. Stop the manager watchdog service:
    % ./keyshot_network_manager_watchdog -terminate
  4. Stop the worker watchdog service:
    % ./keyshot_network_worker_watchdog -terminate
Note

If you are running a SystemD service, remember to stop the SystemD before stopping the watchdogs.

Services via SystemD

Auto start Worker Service

  1. Browse to cd /etc/systemd/system
  2. Create a file named ‘keyshot_network_worker_watchdog.service’ containing the following: 
[Unit]
Description=KeyShot Network Rendering Worker Watchdog
Wants=network-online.target
After=network.target

[Service]
Type=forking
WorkingDirectory=/home/luxion/Documents/keyshot_network_12/bin/
User=luxion
ExecStart=/home/luxion/Documents/keyshot_network_12/bin/keyshot_network_worker_watchdog
ExecStop=/home/luxion/Documents/keyshot_network_12/bin/keyshot_network_worker_watchdog -terminate
Restart=always

[Install]
WantedBy=multi-user.target
Note

The luxion is used as an example username. You will need to replace it with your actual username in User= and in the filepaths.

  1. Reload the service file to include the newly created service
    # systemctl daemon-reload
  2. To enable your Worker service on every reboot
    % systemctl enable keyshot_network_worker_watchdog.service
  3. To start your service
    % systemctl start keyshot_network_worker_watchdog.service

Auto start Manager Service

  1. Browse to cd /etc/systemd/system
  2. Create a file named ‘keyshot_network_manager_watchdog.service’ containing the following: 
[Unit]
Description=KeyShot Network Rendering Manager Watchdog
Wants=network-online.target
After=network.target

[Service]
Type=forking
WorkingDirectory=/home/luxion/Documents/keyshot_network_12/bin/
User=luxion
ExecStart=/home/luxion/Documents/keyshot_network_12/bin/keyshot_network_manager_watchdog
ExecStop=/home/luxion/Documents/keyshot_network_12/bin/keyshot_network_manager_watchdog -terminate
Restart=always

[Install]
WantedBy=multi-user.target
Note

The luxion is used as an example username. You will need to replace it with your actual username in User= and in the filepaths.

  1. Reload the service file to include the newly created service
    # systemctl daemon-reload
  2. To enable your Manager service on every reboot
    # systemctl enable keyshot_network_manager_watchdog.service
  3. To start your service
    # systemctl start keyshot_network_manager_watchdog.service

Stop SystemD Services

  1. Open a Terminal
  2. To stop your Worker service
    # systemctl stop keyshot_network_worker_watchdog.service
  3. To disable your Worker service on every reboot
    # systemctl disable keyshot_network_worker_watchdog.service
  4. To stop your Manager service
    # systemctl stop keyshot_network_manager_watchdog.service
  5. To disable your Manager service on every reboot
    # systemctl disable keyshot_network_manager_watchdog.service