<?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.
            The Templates/* should be changed 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 they run correctly. Do not install Virtual Box,
        although it is recommended because your host machine might fail.</para>
      <para>To test the scripts, 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>