Provider Jetstream API

Getting Started

While you're free to set up an OpenStack client natively, Burke has created a Docker-based tool that allows you to skip that step. Start by confirming that recent versions of git, docker, and docker-compose are installed on your machine:

$ git --version && docker --version && docker-compose --version
git version 2.9.3 (Apple Git-75)
Docker version 1.12.3, build 6b644ec
docker-compose version 1.8.1, build 878cff1

If you don't have git installed on your machine, you probably shouldn't be reading this document. 😉 If you don't have docker or docker-compose installed, go to Docker.com and follow the install instructions for your OS to get both installed and working in your environment. Then you can clone Burke's Jetstream API CLI tool and run it:

$ git clone https://github.com/bmamlin/jetstream-api-cli.git
$ cd jetstream-api-cli
$ cp jetstream.env.sample jetstream.env ;# edit jetstream.env settings
$ ./cli.sh

Before you can successfully use the API, you will need to configure the settings in a jetstream.env file. The parts you will need to provide are:

• project-name = TG-ASC160035
• username = your TACC portal username (probably same as XSEDE portal)
• password = your TACC portal password (NOT your XSEDE password)
• auth-url for IU = you'll need to get this from someone on the infra team who already has access
• auth-url for TACC = you'll need to get this from someone on the infra team who already has access
• default-auth-url = set this to the auth-url for IU

The Jetstream team has asked that the Auth URLs for the Jetstream APIs not be shared publicly, so they should not be posted in public chats (IRC or Telegram) or put into any website contact out of respect for their request. Sharing amongst our team is no problem. You can get these API urls from anyone on the infra team who has them.

If you have the APIs properly configured, you can confirm it by listing the servers at each site:

$ iu
OpenStack pointing to IU
$ nova list
+-----------------------...
| List of servers at IU ...
+-----------------------...

$ tacc
OpenStack pointing to TACC
$ nova list
+-------------------------...
| List of servers at TACC ...
+-------------------------...

If you get errors instead of a list of servers, then you probably don't have your jetstream.env settings configured properly.