Linux

You can start and stop the CLC Server service from the command line. You can also configure the service to start up automatically after the server machine is rebooted.

During installation of the CLC Server a systemd service unit file is created in /etc/systemd/system.

This file will have a name reflecting the server solution, and it includes the name of the custom user account specified during installation for running the CLC Server process.

Starting and stopping the service using the command line:

To start the CLC Server:

sudo systemctl start CLCGenomicsServer.service

To stop the CLC Server:

sudo systemctl stop CLCGenomicsServer.service

To restart the CLC Server:

sudo systemctl restart CLCGenomicsServer.service

To view the status of the CLC Server:

sudo systemctl status CLCGenomicsServer.service

Start service on boot up:

To enable automatic start of service:

sudo systemctl enable CLCGenomicsServer.service

To disable automatic start of service:

sudo systemctl disable CLCGenomicsServer.service

How to configure a service to automatically start on reboot depends on the specific Linux distribution. Please refer to your system documentation for further details.

Troubleshooting

If the CLC Server is run as a service as suggested above, then the files in the installation area of the software and the data files created after installation in CLC Server File Locations will be owned by the user specified to run the CLC Server process. If someone starts up the CLC Server process as root (i.e. an account with super-user privileges) then the following steps are recommended to rectify the situation:

  1. Stop the CLC Server process using the script located within the installation area of the CLC Server software. You can do that using the full path to this script, or by navigating to the installation area and running:

    sudo ./CLCGenomicsServer stop

  2. Change ownership recursively on all files in the installation area of the software and on all areas specified as Server File Locations.

  3. Start the CLC Server service as the specified user configured in the systemd service unit file:

    sudo systemctl start CLCGenomicsServer.service

  4. In case the server still fails to start correctly it can be started in the foreground with output being written to the console to help identify the problem. It is done by running:

    sudo ./CLCGenomicsServer start-launchd

Once your CLC Server has started up, log in as an administrative user to configure and to manage it, as described in later chapters.