353 Commits

Author SHA1 Message Date
Roger Luethi
949110d114 Add path configuration file
This file is used by all scripts to find the directories for the files
they read or write. They find this file as "$TOP_DIR/config/paths".

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Ia63b8489c66acf174f3b3850d24fd7c6108f59b4
2014-06-17 14:52:55 +02:00
Jenkins
c5ce58a26b Merge "Removes unrelated references to diagrams." 2014-06-17 11:53:44 +00:00
Pranav Salunke
c48b0e63f4 Removes unrelated references to diagrams.
Disk labels were referred to diagrams which was not requried at this
stage of learning for the students. This patch removes the references to the
diagrams to avoid confusion.

Change-Id: I3fc41cf7a96916b2f3eadfba953fa5f9e26c095a
Closes-Bug: #1267673
Implements: blueprint training-manuals
2014-06-17 16:16:45 +05:30
Roger Luethi
8c7bbe82be Enable autostart in osbash
This change enables autostart functionality for osbash.

activate_autostart is called by a minimal script written by
preseed/kickstart files (if configured).

It creates (and grants sudo privileges to) the osbash user if
that has not been done by preseed/kickstart.

It uses template-osbashauto to generate /etc/init.d/osbashauto and
configures the system to run the script immediately and during every
subsequent system boot.

osbashauto iterates over all files in the autostart directory (in the
VirtualBox shared folder; filled by osbash from the host side) and
executes them as the osbash user. It writes its log files into the log
directory in the shared folder.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: I0394c5ea4e3f75a9d9bee30d119e047a762e86ce
2014-06-17 11:25:59 +02:00
Jenkins
6acd3cadd9 Merge "Add functions used inside and outside of VMs" 2014-06-17 09:14:16 +00:00
Jenkins
c78a2ec4e4 Merge "Add guest functions library" 2014-06-17 09:08:59 +00:00
Roger Luethi
0064265812 Add functions used inside and outside of VMs
The helper functions in this library are for use by host-side scripts
(osbash) and by scripts running inside the node VMs.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Ie3f7ec480a70beea1abedb3bb81d7380b978d7b2
2014-06-17 10:54:21 +02:00
Jenkins
eec809bee2 Merge "Add function for creating basedisk" 2014-06-17 08:43:59 +00:00
Jenkins
e154867eaf Merge "Add functions for creating node VMs" 2014-06-17 08:43:29 +00:00
Roger Luethi
db8bc7b50b Add guest functions library
This change adds a library of functions that are used by scripts running
inside the node VMs (i.e. scripts located in the scripts directory).

Many of them are specific to either Vagrant or osbash, so they might
get split out later on.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Ieb57e77bb65c562d3674b964af4ac28bc8766c65
2014-06-17 10:40:32 +02:00
Roger Luethi
63480bd8b3 Add functions-common from devstack
This changeset adds the functions-common library from the devstack
project.

As the file's header states: "The canonical copy of this file is
maintained in the DevStack repo. All modifications should be made there
and then sync'ed to other repos as required."

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: I726414adca545fc6d6e59cd900b6179a6233f096
2014-06-17 10:20:24 +02:00
Roger Luethi
510ca6cd4c Add functions for creating node VMs
The functions introduced with this changeset create and configure
VirtualBox node VMs.

The VMs use copy-on-write disks based on previously created base disks.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Idfb78f3683c5bedba96f16fdef23512be6c251d9
2014-06-17 10:10:27 +02:00
Roger Luethi
8691fc7e15 Add function for creating basedisk
The function introduced with this changeset creates a base disk that
can be used to create custom node VMs.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Ib736b65ec0f87decd81866a60ed82d6f8b5aa0f1
2014-06-17 09:54:45 +02:00
Roger Luethi
a17aa7c02a Add library of VirtualBox functions
This changeset adds a library of functions for interacting with
VirtualBox via VBoxManage. It contains functions for creating and
booting VMs, taking snapshots, configuring disks, networking, and
shared folders.

In addition, its vm_attach_guestadd-iso can ask VirtualBox for the
guest-additions ISO and, if that fails, look for it on the local
filesystem or download the correct version from virtualbox.org. On
Windows (wbatch), the function relies on VirtualBox providing the
guest-additions ISO (which on that platform appears to be a safe bet).

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Id5529432eba01bd1e3e67a1d64b7517efd1966d0
2014-06-17 09:02:47 +02:00
Roger Luethi
be6ca70211 Add distro-specific boot libraries
This changeset adds two files (one for Ubuntu 12.04.4 LTS amd64 server,
one for Fedora 20 x86_64) containing the distribution specific
boot code.

This includes the URL for the installation ISO image, the location of the
distribution-specific preseed or kickstart files, the boot arguments,
and the sequence of keys needed to get the installer to take our boot
arguments.

The preseed or kickstart file to use is selected based on the VM_ACCESS
variable.

In the case of Fedora, VM memory is increased to 1024 MB to allow a
smooth install.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Idaf8b859e2b58036948f1a3ad077d797b3757d61
2014-06-17 07:58:44 +02:00
Jenkins
926bc2e2db Merge "Add figure to the appropriate place" 2014-06-17 05:54:31 +00:00
Jenkins
d9a990396a Merge "Add network configuration templates" 2014-06-17 03:50:19 +00:00
Jenkins
0aa5e37db6 Merge "Add batch_for_windows" 2014-06-17 03:47:04 +00:00
LingxianKong
e46a149a8a Add figure to the appropriate place
There is a wrong caption in the subsection of 'Launch an instance from an
image' in the 'Controller Node' section of Associate Training Guide. And
there is no figure for it. This patch fix the problem.

Change-Id: I112bbfc9947091e36a55ba0471928b5822c29424
Closes-Bug: #1327017
2014-06-17 09:15:25 +08:00
Roger Luethi
c628cc38c4 Add network configuration templates
This changeset adds templates used by osbash/wbatch guest-side scripts
when creating network configuration files.

The template-ubuntu-interfaces-* files are for /etc/network/interfaces
(as used by Ubuntu and Debian).

The template-fedora-ifcfg-* files are for ifcfg-<interfacename> files
in /etc/sysconfig/network-scripts/ (as used by Fedora).

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: I0aebc71e416bf931aa698d66d9e135ba05fda017
2014-06-16 15:55:23 +02:00
Jenkins
e28cf12271 Merge "Add Windows batch templates used by wbatch/osbash" 2014-06-16 13:23:42 +00:00
Jenkins
4877c9cf99 Merge "Add README.rst for subdirectories" 2014-06-16 12:27:46 +00:00
Roger Luethi
271448cee6 Add Windows batch templates used by wbatch/osbash
The files added in this changeset are used by osbash as templates when
the user requests the creation of Windows batch files.

The names of the templates end on _bat rather than .bat because some
mail providers refuse to deliver .bat files even within archives.

The generated Windows batch files will have the proper extension (.bat).

Change-Id: I5dbed4bc6a4e30b50693208812d3dbfebecb2f19
Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
2014-06-16 14:22:52 +02:00
Jenkins
aefe47bb64 Merge "Add functions.host library" 2014-06-16 12:21:26 +00:00
Roger Luethi
d9433b8aad Add batch_for_windows
Add a library used by osbash to generate Windows batch files that
can build a base disk and create a VM cluster with no dependency
other than VirtualBox.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: I43cf5f47ac17b8292c5ce32a6849e89d1e192be3
2014-06-16 14:13:24 +02:00
Roger Luethi
9ada0ed032 Add README.rst for subdirectories
This changeset adds README.rst files to several subdirectories
to explain their content and purpose.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Ibba6a68d104b2aade412a06d63ed49467fb2bba3
2014-06-16 16:55:23 +05:30
Roger Luethi
bb303c8889 Add functions.host library
This library is used by osbash host-side scripts.

It contains exec_cmd, a simple function that is used when marking
commands for conditional execution, depending on whether the user
requested Windows batch files and whether the artifacts are to be
created on the local machine as well.

The library also contains functions that allow the host to execute
scripts in the VMs, either directly through ssh or indirectly, by
adding files to an autostart directory shared with the guest VMs.

In addition, the library contains functions to find and (if
necessary) download the install ISO image of the configured
Linux distribution.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: I49d49340db89b61a03dbc483291c252c8c72d61a
2014-06-16 16:51:18 +05:30
Roger Luethi
5c3c9dcd56 Vagrantfile: use documented IP addresses
For the compute and the network nodes, the current Vagrantfile uses IP
addresses that are different from those in the training-guide.

This patch fixes that.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Ib4909d42472e8a60397952d04d88e80f5d9daad1
2014-06-16 09:00:33 +02:00
Jenkins
ec2615fa7c Merge "Add scanlib for producing keyboard scancodes" 2014-06-16 06:50:26 +00:00
Jenkins
f31fdd1800 Merge "Fixing typo and adding example policy" 2014-06-15 16:22:46 +00:00
Roger Luethi
e914188a29 Add scanlib for producing keyboard scancodes
Add scanlib, a library for turning characters into keyboard scancodes
which are needed for scripted keyboard input to VirtualBox VMs.

The keyboard scancode strings returned by this library consist of groups
of two or four hex bytes: two for a key pressed and released, four if a
modifier key such as shift is involved.

The char2scancode function is complemented by two functions for special
keys, esc2scancode and enter2scancode.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: Id8691fff1499cc2428e4b7858c908c117f3c4bce
2014-06-14 12:58:30 +02:00
Roger Luethi
7d1f7434a4 Add kickstart files for Fedora 20 installer
These kickstart files take the Fedora 20 installer through the first
stage of installation.

The three files differ in what is configured when the freshly installed
system reboots:

ks-ssh.cfg:
  user osbash (password: osbash) can log in with the insecure Vagrant
  key and use password-less sudo for all commands.

ks-vbadd.cfg
  VirtualBox guest additions are installed from /dev/sr1 (will
  be put there by install script); a script is installed to run
  activate_autostart.sh from an auto-mounted shared folder upon reboot.

ks-all.cfg:
  Enables both VM access methods described above.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: I8d29b775b380f4efdcbca61ed1667b84db572bf5
2014-06-13 12:47:38 +02:00
Roger Luethi
dcf7e7ef1d Add preseed files for Ubuntu 12.04.4 LTS installer
These preseed files take the Ubuntu 12.04.4 LTS installer through the
first stage of installation.

The three files differ in what is configured when the freshly installed
system reboots:

preseed-ssh.cfg:
  user osbash (password: osbash) can log in with the insecure Vagrant
  key and use password-less sudo for all commands.

preseed-vbadd.cfg
  VirtualBox guest additions are installed from /dev/sr1 (will
  be put there by install script); a script is installed to run
  activate_autostart.sh from an auto-mounted shared folder upon reboot.

preseed-all.cfg:
  Enables both VM access methods described above.

Partial-Bug: 1312764
Implements: blueprint openstack-training-labs
Change-Id: I37752b7311f7e41b1a798a711f2059ab4ac51230
2014-06-13 12:08:56 +02:00
Sean Roberts
8fbfbe24d9 spec details for developer-training-guide-prerequisites
follows skeleton.rst, template.rst from neutron-spec

Implements blueprint developer-training-guide-prerequisites

Change-Id: I1997315e3bd94d95df844b4d5fad539cfe4aebf7
2014-06-12 10:42:19 -07:00
Pranav Salunke
0110baf375 Refactor Lab Section
Adds basic skeleton/structure with stubs. Changes are done as per Roger
Luethi's scripts. These changes are done to incorporate various features
like logging, multi-os setup etc. These scripts may also target more
virtualization products like KVM, LXC down the roadmap.

blueprint openstack-training-labs

Change-Id: I0bb33b518080f8a9b9c0e1624f43a66337eb8278
2014-06-12 18:15:41 +05:30
Pranav Salunke
72cd9532b3 Move Training Labs Folder
Training Labs folder was kept inside the training-guides folder since the
project was sheltered under openStack manuals project. To keep the content
more organized, moving the folder to appropriate location would be necessary.

blueprint openstack-training-labs
blueprint training-manuals

Change-Id: I4007c3fb64e76cda798ffe6cb68557f462ad07ff
2014-06-12 12:52:25 +05:30
Jenkins
9258d14d28 Merge "Fixes README for training-labs" 2014-06-12 05:18:50 +00:00
Jenkins
1568020355 Merge "Adds .gitignore file" 2014-06-12 04:33:24 +00:00
Pranav Salunke
1b4889e120 Fixes README for training-labs
Removes unnecessary content from README.md and adds basic introduction about
training-labs folder.

blueprint openstack-training-labs

Change-Id: Id3a1fb7db838a23904c38d69d29403f656e13783
2014-06-12 08:27:35 +05:30
Sean Roberts
016dfcc7c6 adding missing .gitignore file
Change-Id: Ifce1b934ed5624cfe0418f278e57e4e8d5f80532
Closes-Bug: #1329137
2014-06-11 19:36:27 -07:00
Pranav Salunke
b24ddfeb3d Adds .gitignore file
Adds .gitignore file which tells git to ignore spcific file types.

blueprint training-manuals

Change-Id: Ibddc1d8cc7138218f28dce26229934b81179bd75
2014-06-12 07:56:57 +05:30
Jenkins
21b45a6573 Merge "adds the specs to the training guides repo" 2014-06-12 02:16:13 +00:00
Sean Roberts
19f7d1b7e1 adds the specs to the training guides repo
added the files to explain the spec basics. We
will follow using tox as it seems to be too much
overhead for little benefit for the volume of
spec requests the team is likely to get.

Implements blueprint training-guide-spec

Change-Id: I7ba685c94b375f1e1ef2f7203034ad2b86c0c748
2014-06-11 18:38:36 -07:00
Sean Roberts
07debe516f add .gitreview file
required for git review

Change-Id: I6de195bda63ba1c0d4c78d5a22b02c6cb6349e20
2014-06-11 18:04:08 -07:00
Pranav Salunke
b4f6cd97d8 Modify POM.xml file for new repository
POM.xml was not updated for the changes in the repository structure. This patch
address the changes required for repo migration.

all 49 entries using the local reference ../common/ were updated with the
raw github URL.

bk002-ch013-operator-object-storage-node.xml is commented out while we figure out
how to correct including remote content that references local content.

Change-Id: Iea78458e536330778360f87993cbbb37d4b389d2
2014-06-11 17:00:08 -07:00
Priti Desai
f816dec181 Fixing typo and adding example policy
Keystone Architecture in OpenStack Training Guides has
typo with cinder policy instead of nova policy filename.
Also, the policy sample was missing. Added policy sample
on privileges for creating volumes.

Change-Id: I85e2e6a3c75a98e2cb5c5e5eda3ff8647aa32e66
Closes-bug: #1326104
2014-06-11 23:20:33 +00:00
Tom Fifield
bdd58c0ee7 Fix title of README
The title of the readme still read "OpenStack Manuals".
This commit updates it to "OpenStack Training Guides".
2014-05-29 10:35:39 +08:00
Tom Fifield
15cfe96f3b Add structure for inital import
* Move the files into doc/training-guides subdirectory
* Add README, LICENSE, tox test config
2014-05-29 10:32:06 +08:00
OpenStack Proposal Bot
96f440299c Imported Translations from Transifex
Change-Id: I99420d59b199ce883b0ee49b7dea3e469cbd586b
2014-05-24 06:12:13 +00:00
Jenkins
bc15c6d179 Merge "small change to lab001-control-node" 2014-05-23 06:16:46 +00:00