auto commit

README.md

@@ -0,0 +1,117 @@
+# Eucalyptus Testunit Framework
+
+Eucalyptus Testunit Framework is designed to run a list of test scripts written by Eucalyptus developers.
+
+
+
+## How to Set Up Testunit Environment
+
+On **Ubuntu** Linux Distribution,
+
+### 1. UPDATE THE IMAGE
+
+<code>
+apt-get -y update
+</code>
+
+### 2. BE SURE THAT THE CLOCK IS IN SYNC
+
+<code>
+apt-get -y install ntp
+</code>
+
+<code>
+date
+</code>
+
+### 3. INSTALL DEPENDENCIES
+<note>
+YOUR TESTUNIT **MIGHT NOT** NEED ALL THE PACKAGES BELOW; CHECK THE TESTUNIT DESCRIPTION.
+</note>
+
+<code>
+apt-get -y install git-core bzr gcc make ruby libopenssl-ruby curl rubygems swig help2man libssl-dev python-dev libright-aws-ruby nfs-common openjdk-6-jdk zip libdigest-hmac-perl libio-pty-perl libnet-ssh-perl euca2ools
+</code>
+
+### 4. CLONE test_share DIRECTORY FOR TESTUNIT
+<note>
+YOUR TESTUNIT **MIGHT NOT** NEED test_share DIRECTORY. CHECK THE TESTUNIT DESCRIPTION.
+</note>
+
+<code>
+git clone git://github.com/eucalyptus-qa/test_share.git
+</code>
+
+### 4.1. CREATE /home/test-server/test_share DIRECTORY AND LINK IT TO THE CLONED test_share
+
+<code>
+mkdir -p /home/test-server
+</code>
+
+<code>
+ln -s ~/test_share/ /home/test-server/.
+</code>
+
+### 5. CLONE TESTUNIT OF YOUR CHOICE
+
+<code>
+git clone git://github.com/eucalyptus-qa/**testunit_of_your_choice**
+</code>
+
+### 6. CHANGE DIRECTORY
+
+<code>
+cd ./**testunit_of_your_choice**
+</code>
+
+### 7. CREATE 2b_tested.lst FILE in ./input DIRECTORY
+
+<code>
+vim ./input/2b_tested.lst
+</code>
+
+### 7.1. TEMPLATE OF 2b_tested.lst, SEPARATED BY TAB
+
+<sample>
+192.168.51.85	CENTOS	6.3	64	REPO	[CC00 UI CLC SC00 WS]
+
+192.168.51.86	CENTOS	6.3	64	REPO	[NC00]
+</sample>
+
+### 8. RUN THE TEST
+
+<code>
+./run_test.pl **testunit_of_your_choice.conf**
+</code>
+
+
+## How to Examine the Test Result
+
+### 1. GO TO THE artifacts DIRECTORY
+
+<code>
+cd ./artifacts
+</code>
+
+### 2. CHECK OUT THE RESULT FILES
+
+<code>
+ls -l
+</code>
+
+
+## How to Rerun the Testunit
+
+### 1. CLEAN UP THE ARTIFACTS
+
+<code>
+./cleanup_test.pl
+</code>
+
+### 2. RERUN THE TEST
+
+<code>
+./run_test.pl **testunit_of_your_choice.conf**
+</code>
+
+