diff --git a/doc/training-guides/training-cluster-by-script.xml b/doc/training-guides/training-cluster-by-script.xml index fb487d46b4..b28060f927 100644 --- a/doc/training-guides/training-cluster-by-script.xml +++ b/doc/training-guides/training-cluster-by-script.xml @@ -1,57 +1,75 @@ -
- Building the Training Cluster, Scripted - Setting Up Test Environment - For using Virtual Box as test environment, you need to attach three network adapters - - - - Host-Only/ Bridged -- 10.10.10.51 (Guest) -- 10.10.10.xx (Host IP for - Host-Only) - - - Host-Only/ Bridged -- 192.168.100.51 (Guest) -- 192.168.100.xx (Host IP for - Host-Only) - - - Bridged/NAT -- DHCP -- These Scripts should be run without internet connection after - Pre-Install.sh. If your networking configuration is not exact a few command will not work. - you need to change the Templates/* to the required IP Addresses for custom - networks. - - - Extract the - scripts locally by downloading and running the scripts tar file. - Testing - As of now only */Scripts/ folders content are being tested. Please run the file - ~/Scripts/test_scripts.sh for testing all the scripts at once with one click. - - + Build the Training Cluster, Scripted + Extract the scripts locally by downloading and running the + scripts tar file. + Currently, only */Scripts/ folders + content are being tested. Run the + ~/Scripts/test_scripts.sh file to test all + scripts at once. + + To test scripts + + Set up the test environment + To use Virtual Box as test environment, you must attach + the following network adapters: + - Test Scripts Individually. Run the Scripts inside - the Scripts Folder to check whether the shell scripts are properly functioning. You - Don't Need to install Vitual Box although it is advised to do so, as there is a good - chance that you may end up breaking your host machine. + Host-Only/ Bridged -- 10.10.10.51 (Guest) -- + 10.10.10.xx (Host IP for Host-Only) - How to Test them. Testing these scripts is as - simple as running them. Although some of the scripts need the required Input - parameters. If you do not want to run them manually then you may run the - Scripts/test_scripts.sh file. No Need for Virutalbox Guest Addons for testing the - scripts as units. + Host-Only/ Bridged -- 192.168.100.51 (Guest) -- + 192.168.100.xx (Host IP for Host-Only) - Test Entire System you need to install Virtual Box, - install Ubuntu Server 12.04 or 13.04. After installation you also need to install - Virtual Box Guest Addons. To install Virtual Box guest addons you need do the - following : Either use the Virtual Box Guest Addons Installation via. ISO, - #apt-get install linux-headers-generic #mount /dev/cdrom0/ /tmp/cdrom #cd - /tmp/cdrom/ #./virtualboxOr You May use Ubuntu Repositories for the - same #apt-get install linux-headers-generic #apt-get - --no-install-recommends install virtualbox-guest-additions - - - + Bridged/NAT -- DHCP -- These Scripts should be run + without internet connection after Pre-Install.sh. If your + networking configuration is not exact a few command will + not work. you need to change the Templates/* to the + required IP Addresses for custom networks. + + + + + Test scripts individually + Run the shell scripts in the Scripts + folder to verify that they run correctly. You do not need to + install Virtual Box, although it is recommended because your + host machine might fail. + To test scripts, simply run them. Some scripts require + input parameters. If you do not want to run them manually, run + the Scripts/test_scripts.sh file. Virtual + Box guest add-ons are not required to test the scripts as + units. + + + Test the entire system + You must install Virtual Box, Ubuntu Server 12.04 or + 13.04, and the Virtual Box guest add-ons. + To install Virtual Box guest add-ons, complete one of + these steps: + + + Install the Virtual Box guest add-ons through + ISO: + # apt-get install linux-headers-generic + # mount /dev/cdrom0/ /tmp/cdrom + #cd /tmp/cdrom/ + # ./virtualbox + + + Install the Virtual Box guest add-ons through Ubuntu + repositories: + # apt-get install linux-headers-generic + # apt-get --no-install-recommends install virtualbox-guest-additions + + + +