Running Tango

Introduction

This is a guide to starting the Tango server. If you have yet to set up Tango itself, please see the guide on Setting up Tango first.

Instructions

1. Activate virtualenv.

   $ cd /path/to/Tango
   $ source bin/activate

2. Confirm that your VMMS is set up. If you are using docker, make sure your docker installation is up and ready to go. For the localDocker VMMS, you can check this by running docker ps. If you don't see an error message, you should be ready to go. Otherwise, you may need to restart the docker machine that you installed earlier and link your shell to the machine:

   $ docker-machine start <default>
   $ eval "$(docker-machine env <default>)"

3. Start the Tango Server with an optional command-line argument for the port. If this argument is not supplied, Tango will use the port defined in config.py.

   $ python restful-tango/server.py <port>

4. Make sure Tango is up and running. The default port that Tango starts with is 3000, although this can be changed in config.py or on the command-line.

   $ curl localhost:<port>

The response should be:

```sh
Hello, world! RESTful Tango here!
```

5. Send some test jobs to confirm that everything works. See Testing Tango for more info.

6. When finished with your Tango session, kill the Tango server. Python catches Ctrl-C, so you'll need to use Ctrl-Z followed by kill %1 instead. Then, deactivate virtualenv on the command-line:

   $ deactivate