Installation

To use the NLDS, first you must install the client software. This guide will show you how to install it into a Python virtual-environment (virtualenv) in your user space or home directory.

  1. Log onto the machine where you wish to install the NLDS client into your user space or home directory.

  2. Create a Python virtual environment:
    python3 -m venv ~/nlds-client

  3. Activate your new virtual environment:
    source ~/nlds-client/bin/activate

  4. It is a good idea to upgrade your version of pip - otherwise some modules may fail to install:
    pip install --upgrade pip

  5. Install the nlds-client package from GitHub:
    pip install git+https://github.com/cedadev/nlds-client.git

Upgrading to v1.0.12

Here’s how to upgrade the NLDS client to v1.0.12:

  1. Activate your virtual environment:
    source ~/nlds-client/bin/activate

  2. Upgrade using the latest nlds-client package from GitHub:
    pip install --upgrade git+https://github.com/cedadev/nlds-client.git@1.0.12

  3. Check if you have the right client by issuing the command:
    nlds --version
    The output should start with: Near Line Data Store client 1.0.12

  4. Update your ~/.nlds-config file:
    The line that reads "api": "api/0.1" should now read "api": "api/1.0.0"