Command Line
Last updated
Was this helpful?
Last updated
Was this helpful?
opencga.sh is the officially recommended command line tool for users. It implements most of the functionality with many different commands and subcommands. These commands are a one-to-one mapping of Resources from REST web services and subcommands are mapping to end-points. All the operations that can be performed using the command line internally create one or several REST calls, so access to REST machine/cluster is required.
OpenCGA command line can be downloaded from the main GitHub repository:
For a detailed description of all the steps required to download and configure the CLI, refer to the xxx section of the USER MANUAL.
In the following URL, "samples" is the resource and "search" is the endpoint:
the corresponding command in the command line is :
./opencga.sh samples
and the corresponding subcommand is :
./opencga.sh samples search
Generally, unless we are pointing to a public OpenCGA installation, users will first need to log in using the "users login" command line. Once the user has successfully logged in, a session file will be generated in their home folder:
~/.opencga/session.json
This session file contains the following information:
This makes it easier for users to login only once and execute any number of commands till the session token is expired. Session expiration is set by OpenCGA server independently from the client. Once the token is expired, the user has to login again and can perform desired operations as normal.