Basic usage

Once installed, there will be four programs present in the installation folder:

Getting help

Run the clcserver command with no arguments or with an incomplete set of arguments to see information about what can be run on the server. Below is a list of command forms, and the type of information produced using them.

The clcserver command - details

The clcserver program requires the following four flags, which provide information about the connection to the server:

-S <hostname or IP address of the server>
-P <port the server runs on>
When omitted, port 7777 is used, which is the default for server installations.
-U <user name>
The username used to log into the server.
-W <password or token>
See Handling passwords for how to avoid entering passwords in clear text.

The commands that can be run on the server are supplied with the flag:

-A <command to be executed on server>

If you supply the -A flag followed by a tool or workflow name, but do not provide all the required parameters in the command, then a listing of configurable parameters is returned, as well as a list of the missing required parameters.

When optional parameters are not explicitly included in a command, the default values are used by the tool or workflow.

Input data is specified using an input parameter per input element or input file, while a single parameter specifies the folder to save CLC outputs to or the folder an exporter should export files to. The location of input data for an analysis, and the locations to save outputs or export results to, are specified using URLs (see Specifying locations for inputs, outputs and exports).

-O <filename>
The name of a file to be created to hold a summary of steps carried out on the server and data locations of the results generated. This is an optional parameter, but useful when working with scripts as the data locations are of a form that can be used by downstream CLC commands. See Result files and connecting analyses in pipelines for information about parsing this file. By default, this file is placed in your working directory.

For those working with the CLC Grid Integration Tool, you can run import and algorithm commands through your grid nodes by adding the following flag to your clcserver command:

-G <grid preset name>

Options available for managing and querying jobs and results include:

-Y
Execute the command asynchronously. The returned process ID can be used to query for status and results by using the -I and -R flags, respectively.
-I <process IDs>
Return information about the listed processes. If a list of process IDs is not provided, information about all processes submitted by the current user are returned.
-R <process IDs>
Returns the results of the finished processes. Results for a given process can only be retrieved once using this option. To cancel a specific process use
-R <process ID> -R cancel. To cancel all processes owned by current user, use
-R cancel-all. Using that option as an administrative user will cancel all processes.

Other optional flags available for the clcserver command are:

-C <integer>
Specify the column width of the help output.
-D <boolean>
Enables debug mode when set to true, providing more elaborate output and error messages.
-H
Display general help instructions.
-V
Display the version number of CLC Server Command Line Tools.

Hint: When launching multiple tasks via a script, putting sleep 10 between the commands can help keep the memory needed for the waiting command to a minimum. It can also be worth checking that the number of user processes allowed is sufficient (ulimit setting).