openstack-manuals/doc/training-guides/training-cluster-by-script.xml
Andreas Jaeger 2b96462949 Fix link for training-cluster-scripts
Currently we link to a copy of the scripts on docs.openstack.org - and
that location does not exist.

Instead of putting this data on docs.openstack.org, let's give a
reference to github and distribute it from there.

Change-Id: I4dc7f31a3a50520ccef16db7e4ff0b54d02d89ff
Closes-Bug: #1282874
2014-03-07 12:30:30 -06:00

76 lines
3.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="training-cluster-by-script">
<title>Build the Training Cluster, Scripted</title>
<para><link
xlink:href="http://github.com/openstack/openstack-manuals/raw/master/doc/training-guides/training-labs/training-guides-cluster-scripts.tar"
>Extract the scripts locally by downloading and running the
scripts tar file.</link></para>
<para>Currently, only <filename>*/Scripts/</filename> folders
content are being tested. Run the
<filename>~/Scripts/test_scripts.sh</filename> file to test all
scripts at once.</para>
<procedure>
<title>To test scripts</title>
<step>
<title>Set up the test environment</title>
<para>To use Virtual Box as test environment, you must attach
the following network adapters:</para>
<itemizedlist>
<listitem>
<para>Host-Only/ Bridged -- 10.10.10.51 (Guest) --
10.10.10.xx (Host IP for Host-Only)</para>
</listitem>
<listitem>
<para>Host-Only/ Bridged -- 192.168.100.51 (Guest) --
192.168.100.xx (Host IP for Host-Only)</para>
</listitem>
<listitem>
<para>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.</para>
</listitem>
</itemizedlist>
</step>
<step>
<title>Test scripts individually</title>
<para>Run the shell scripts in the <filename>Scripts</filename>
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.</para>
<para>To test scripts, simply run them. Some scripts require
input parameters. If you do not want to run them manually, run
the <filename>Scripts/test_scripts.sh</filename> file. Virtual
Box guest add-ons are not required to test the scripts as
units.</para>
</step>
<step>
<title>Test the entire system</title>
<para>You must install Virtual Box, Ubuntu Server 12.04 or
13.04, and the Virtual Box guest add-ons.</para>
<para>To install Virtual Box guest add-ons, complete one of
these steps:</para>
<itemizedlist>
<listitem>
<para>Install the Virtual Box guest add-ons through
ISO:</para>
<screen><prompt>#</prompt> <userinput>apt-get install linux-headers-generic</userinput></screen>
<screen><prompt>#</prompt> <userinput>mount /dev/cdrom0/ /tmp/cdrom</userinput> </screen>
<screen><prompt>#</prompt><userinput>cd /tmp/cdrom/</userinput></screen>
<screen><prompt>#</prompt> <userinput>./virtualbox</userinput></screen>
</listitem>
<listitem>
<para>Install the Virtual Box guest add-ons through Ubuntu
repositories:</para>
<screen><prompt>#</prompt> <userinput>apt-get install linux-headers-generic</userinput></screen>
<screen><prompt>#</prompt> <userinput>apt-get --no-install-recommends install virtualbox-guest-additions</userinput></screen>
</listitem>
</itemizedlist>
</step>
</procedure>
</section>