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
This commit is contained in:
Andreas Jaeger
committed by
Diane Fleming
Diane Fleming
parent
a378f82d73
commit
66fe38a94d
@@ -1,57 +1,75 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
|
<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"
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
||||||
xml:id="training-cluster-by-script">
|
xml:id="training-cluster-by-script">
|
||||||
<title>Building the Training Cluster, Scripted</title>
|
<title>Build the Training Cluster, Scripted</title>
|
||||||
<para>Setting Up Test Environment</para>
|
<para><link
|
||||||
<para>For using Virtual Box as test environment, you need to attach three network adapters</para>
|
xlink:href="http://github.com/openstack/openstack-manuals/raw/master/doc/training-guides/training-labs/training-guides-cluster-scripts.tar"
|
||||||
<para>
|
>Extract the scripts locally by downloading and running the
|
||||||
<orderedlist>
|
scripts tar file.</link></para>
|
||||||
<listitem>
|
<para>Currently, only <filename>*/Scripts/</filename> folders
|
||||||
<para>Host-Only/ Bridged -- 10.10.10.51 (Guest) -- 10.10.10.xx (Host IP for
|
content are being tested. Run the
|
||||||
Host-Only)</para>
|
<filename>~/Scripts/test_scripts.sh</filename> file to test all
|
||||||
</listitem>
|
scripts at once.</para>
|
||||||
<listitem>
|
<procedure>
|
||||||
<para>Host-Only/ Bridged -- 192.168.100.51 (Guest) -- 192.168.100.xx (Host IP for
|
<title>To test scripts</title>
|
||||||
Host-Only)</para>
|
<step>
|
||||||
</listitem>
|
<title>Set up the test environment</title>
|
||||||
<listitem>
|
<para>To use Virtual Box as test environment, you must attach
|
||||||
<para>Bridged/NAT -- DHCP -- These Scripts should be run without internet connection after
|
the following network adapters:</para>
|
||||||
Pre-Install.sh. If your networking configuration is not exact a few command will not work.
|
<itemizedlist>
|
||||||
you need to change the Templates/* to the required IP Addresses for custom
|
|
||||||
networks.</para>
|
|
||||||
</listitem>
|
|
||||||
</orderedlist></para>
|
|
||||||
<para><link xlink:href="./training-labs/training-guides-cluster-scripts.tar"> Extract the
|
|
||||||
scripts locally by downloading and running the scripts tar file.</link></para>
|
|
||||||
<para><emphasis role="bold">Testing</emphasis></para>
|
|
||||||
<para>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.</para>
|
|
||||||
<para>
|
|
||||||
<orderedlist>
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para><emphasis role="bold">Test Scripts Individually</emphasis>. Run the Scripts inside
|
<para>Host-Only/ Bridged -- 10.10.10.51 (Guest) --
|
||||||
the Scripts Folder to check whether the shell scripts are properly functioning. You
|
10.10.10.xx (Host IP for Host-Only)</para>
|
||||||
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.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para><emphasis role="bold">How to Test them</emphasis>. Testing these scripts is as
|
<para>Host-Only/ Bridged -- 192.168.100.51 (Guest) --
|
||||||
simple as running them. Although some of the scripts need the required Input
|
192.168.100.xx (Host IP for Host-Only)</para>
|
||||||
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.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para><emphasis role="bold">Test Entire System</emphasis> you need to install Virtual Box,
|
<para>Bridged/NAT -- DHCP -- These Scripts should be run
|
||||||
install Ubuntu Server 12.04 or 13.04. After installation you also need to install
|
without internet connection after Pre-Install.sh. If your
|
||||||
Virtual Box Guest Addons. To install Virtual Box guest addons you need do the
|
networking configuration is not exact a few command will
|
||||||
following : Either use the Virtual Box Guest Addons Installation via. ISO,
|
not work. you need to change the Templates/* to the
|
||||||
<literal>#apt-get install linux-headers-generic #mount /dev/cdrom0/ /tmp/cdrom #cd
|
required IP Addresses for custom networks.</para>
|
||||||
/tmp/cdrom/ #./virtualbox</literal>Or You May use Ubuntu Repositories for the
|
</listitem>
|
||||||
same <literal>#apt-get install linux-headers-generic #apt-get
|
</itemizedlist>
|
||||||
--no-install-recommends install virtualbox-guest-additions</literal></para>
|
</step>
|
||||||
</listitem>
|
<step>
|
||||||
</orderedlist>
|
<title>Test scripts individually</title>
|
||||||
</para>
|
<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>
|
</section>
|
||||||
|
|||||||
Reference in New Issue
Block a user