openinfra/refstack
Code Issues Proposed changes
16f6e2f941
refstack/doc/tcup.md
Praveen Madire a4309f3012 updated run_tempest_manually.md based on Forrest comments 
updated tcup.md with latest instructions.
adding instructions to run_tempest_manually.md

cleanup

Change-Id: I69b1a45e2c5d9abfd9dc9e579b8104788f0d6584
2014-05-21 15:15:33 +01:00

3.2 KiB
Raw Blame History

TCUP Configuration

The following instructions are designs run Refstack/Tempest in a container with minimal setup on your system.

These steps are do not install Refstack for contributions or development, they are intended for a user who wants to just run and report test results.

  1. Make sure you have python and wget installed for your operating system.

  2. Install Docker using https://www.docker.io/gettingstarted/#h_installation

  3. Note: if you are in an environment with a proxy, make sure you configure /etc/default/docker to leverage the proxy too!

  4. You may want to prep-the environment using sudo docker pull ubuntu:13.10

  5. Setup Docker to run without sudo

  6. permanently (recommended): 1. sudo usermod -a -G docker <your-user> 1. you will need to reboot after this change

  7. short term: sudo chmod 666 /var/run/docker.sock

  8. Get the code: wget https://raw.githubusercontent.com/stackforge/refstack/master/scripts/tcup.py

  9. note: you can also get the code by cloning the Refstack and running the code in /scripts/tcup.py

  10. Set your environment variables to access the test target cloud

  11. generally, you will source openrc.sh to load the cloud credentials and URLs

Note : once you have loaded openrc.sh, type this command : ‘env | grep OS_’ then make sure values are assigned to each of the below:

*OS_TENANT_ID *OS_PASSWORD *OS_AUTH_URL *OS_USERNAME *OS_TENANT_NAME

If values are missing for any of the above, you could manually export for missing env variable (ex:‘export OS_PASSWORD=’)

  1. Run TCUP: python tcup.py
  2. if you want to work on the code from Refstack, use `scripts/tcup.py'

Troubleshooting TCUP

Before troubleshooting TCUP, make sure that you have network connectivity to our target cloud from the host system (the one you run TCUP on).

  1. ping the IP or FQDN from echo $OS_AUTH_URL
  2. get a "HTTP/1.1 200 OK" response from curl -I $OS_AUTH_URL

There are several ways to trouble shoot, TCUP.

  1. Run TCUP using the debug flag: tcup.py --debug
  2. Attach to the container as instructed at the end of the TCUP script
  3. Inside the container:
  4. check your environment variables include the OS_* values using export | grep OS_
  5. ping the IP or FQDN from echo $OS_AUTH_URL
  6. get "200 OK" from Keystone using curl -I $OS_AUTH_URL
  7. confirm your credentials are working using keystone catalog

Docker Tips

  1. You can inspect which containers are running!
  2. docker ps shows the running containers
  3. docker attach allows you to connect to a container (may have to press enter)
  4. exit from inside the container with Ctrl-p + Ctrl-q
  5. Orphaned Containers: Over time, you may end up with orphaned contaniers, use the following to clean them up
  6. docker rm $(docker ps -a -q)
  7. docker rmi $(docker images | grep "^<none>" | awk "{print $3}")

For Developers

If you run TCUP in debug mode (export DEBUG=true or using --debug parameter) then TCUP will automatically mount your PWD as /dev. If you run TCUP from your Refstack clone, then you can work directly in Refstack code from inside a TCUP container from the /dev directory.