# README
#
# Malek Musleh                                                                                                     
# mmusleh@isi.edu                                                                                                
# June. 5, 2013                                                                                               
#                                                                                                               
# (c) 2013 USC/ISI                                                                                           
#                                                                                                               
# Documentation for running hpc-grizzly test-scripts

Images:

This script relies on image files that can be found on bespin105:/home/musleh/test-scripts/

- ttylinux-uec-amd64-12.1_2.6.35-22_1.img
- ttylinux-uec-amd64-12.1_2.6.35-22_1-initrd
- ttylinux-uec-amd64-12.1_2.6.35-22_1-loader
- ttylinux-uec-amd64-12.1_2.6.35-22_1-vmlinuz

Additional images are necessary for several of the subscripts (update README as testing proceeds)


#### Running

# Options:

-a (add images during init? default: false)                                                                            
-d (delete images? default: false)   

-h (hypervisor LXC or KVM, default KVM)                                                                               
-f (flavor, default m1.tiny)                                                                                          
-i (image, default kvm_fs)                                                                                            
-r (openrc_root full path, default /root/openrc)                                                                      
-p (path to openrc-demo1/2, default /root/jp_scripts/)                                                               

-s (SLEEP Period to wait for instances to run) 
-t (timeout period, recommended 100 for KVM, 200 for LXC) 

-l (log file for test outputs (Pass/Fail)                                                                             
-m (the Member role, default Member)                                                                                  
-n (network, default public)                                                                                          
-u (user, default root)                                                                                               
-S (Start Test Number)                                                                                            
-E (End Test Number)                                                                                               
                                                                                                                      
e.g: sh tests_39_to_52.sh -h LXC -f cg1.medium -i lxc-fs -r /root/keystonerc -m _member_ -n net1 -p /root/ -u nova    
# NOTE:
  By Default, the initialization does not add the images to the glance repository (to reduce repeated run-times. Add '-a 1' to the command line if user wants the default images added to glance.


# Run all tests with admin credentials file:/root/openrc and output to log file: log.txt
e.g. clear; bash regression-test.sh -r /root/openrc/ -l log.txt    

# Run: 
- all tests
- admin credentials file:/root/openrc
- output to log file: log.txt
- using KVM hypervisor
bash regression-test.sh -l log.txt -r /root/openrc -p . -h kvm

# Run set of test-cases: e.g. 7-14
  $ bash regression-test.sh -l log.txt -r /root/openrc -S 7 -E 14

# Run LXC Test:
- all tests
- admin credentials file:/root/openrc
- output to log file: log.txt
- User Root
- cg1.medium flavor 
  $ bash regression-test.sh - log.txt -r /root/openrc -p . -h lxc -u root -f cg1.medium

- Note that for tests15-27 that includes add file contents, the user must be specified as 'nova'
  instead of the default for the keypair to work:
  $ clear; bash regression-test.sh -r /root/openrc -l log.txt -h lxc -t 230 -f cg1.medium -u nova


############## Other Functions ###############

- delete all volumes:

$ source volume.sh; delete_all_volumes "${OPENRC_DEMO1}"

- delete all images/meta data from glance repo:

$ source glance.sh; clean_glance_repo "${OPENRC_DEMO1}"

- terminate all euca instances

$ source functions.sh; delete_all_instances "${OPENRC_DEMO1}"