Skip to main content
System StatusContact Support
VersionOne Community

Installing the Continuum Command Line Tools on Another Server or Desktop

 Overview

The Continuum client tools are written in the Python programming language and use some Python tools to install. Theses instructions are slightly different whether on Linux/OSX or on Windows.

Linux/OSX Install

To install the command line tools on Linux or Mac OSX, you must first make sure you have Python 2.7 installed as well as the `pip` installer.

At the command line, run the following command:

    python -V

If python is not installed on your target machine, first install that. See https://www.python.org/downloads/. Make sure to choose Python 2.7.9.

Next run the following:

    pip -V

If you have Python 2.7.9 installed, pip should be installed as well. If not, see the following link: https://pip.pypa.io/en/latest/installing.html for installation instructions.

Once python and pip are ready, run the following command to install the Continuum command line tools.

pip install https://s3.amazonaws.com/downloads.c...-latest.tar.gz

If you receive an error running the command above, you may need to run the pip install command under `sudo`.

The commands should automatically be added to the user's path.

Windows Install

To install the Continuum command line tools on Windows, you also need to make sure you have Python 2.7 and `pip` installed.

First a command line session on Windows. Run the following command:

    python -V

Unlike Linux and Mac OSX, Python is not part of the standard Windows install so it is likely that the python command will not be found.  If Python is not installed on your target machine, first install that. See https://www.python.org/downloads/. Make sure to choose Python 2.7.9.

Make sure to allow the Python installer to associate `.py` file extensions with Python. This is very important.

Next run the following:

pip -V

If pip is not available, see https://pip.pypa.io/en/latest/installing.html for installation instructions.

Now install the latest Continuum command line tools for Windows.

pip install https://s3.amazonaws.com/downloads.c...-latest.tar.gz

The commands should automatically be added to the user's path.

On Windows the all commands end with the `.py` file extension. This is because Windows uses the file extension to determine how the file should behave when executed. The Python installer will register itself as associated with the .py file. Anytime in the Continuum documentation that you see a command line tool referenced in an instruction, for Windows clients append the .py file extension on the command before running.

After the Command Line Tool Install on Linux, OSX and Windows

You will probably want to go ahead and setup a .ctmclient.conf file as mentioned above so that you don't need to always pass in credentials to the Continuum REST API server.

Create a file in the user's home directory named `.ctmclient.conf`. Edit the file and place the following text in the file:

    {
        "url": "http://serveraddress:8080",
        "token": "enter_token_here"
    }

Where serveraddress is the address of the Continuum server, token is the string of characters you copied from your user profile in Continuum. Save the file.

Now test the commands ability to connect to the address and that the credentials are valid:

ctm-version

Or on Windows

ctm-version.py

You should see text come back such as `1.43`. If not look at your .ctmclient.conf or any other error messages that responded to the command.

  • Was this article helpful?