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

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

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

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