openstack/training-guides - training-guides - OpenDev: Free Software Needs Free Tools

If we change configuration files right after installing service
packages, automatically started services may pick up changed
configuration files rather than the default files they were packaged
with.
If the neutron-l3-agent starts with our custom configuration file which
refers to the external bridge br-ex while that bridge is not there
(yet), the port is permanently marked as unavailable (vlan tag=4095).
In such a case, a line like this can be found in /etc/openvswitch/conf.db:
{"_date":1435514607570,
"Port":{"20b0e96c-6103-46e6-a234-a4d5439eece7":{"tag":4095}}, "_comment":"
ovs-vsctl: /usr/bin/ovs-vsctl --timeout=10 set Port qr-4be1ab91-60 tag=4095"
,"Open_vSwitch":{"e00f3d6f-e55a-419a-a605-141021026dee":{"next_cfg":15}}}
For additional information, check this neutron bug:
Neutron openvswitch-agent doesn't recover ports from binding_failed status
https://bugs.launchpad.net/neutron/+bug/1399249
This is another race -- waiting for a few seconds before changing the
configuration files fixes the problem. The alternative used in this
patch is to stop the neutron-l3-agent before editing the configuration
files and to start it only once the bridge is ready.
Change-Id: I55762d17817e5e1cdb4c0420374c9fbc314bdff1
Co-Authored-By: Vigneshvar.A.S <vigneshvar.a.s@gmail.com>
Co-Authored-By: sayalilunkad <sayali.92720@gmail.com>

* remove the "Indices and tables" slide
There is no need for a "Indices and tables" slide. The slide is
confusing and should be removed.
* convert the index.rst file from a default Sphinx documentation
 index.rst file into a more useful hieroglyph index.rst file
Change-Id: I15f9b5a44fd86972d6d937f11922335fa4cc1163

Change-Id: I4cddc03268c47575fc25b60c4c3c87816170b8cf

Change-Id: Ic446c3929b988525b1cb9d987f4a598bf28bf99d

Add small Openstack logo in the footer of the Associate guide slides.
Change-Id: I33125365851229d169414696a9a5a0f727a9e84f

Use Upstream training version of the cleaned up conf.py.
Change-Id: Id493b417365c8a42f8e77214b7e2fdf2c1486c53

Resolves some PEP8 issues and uses the same default values like used in
other documentation projects.
Change-Id: Iaf30083904eb9a204a8421db278be6227c224b3f

The available and documented tox virutal environments should
be used to build the upstream training guide and not the Makefile. To
avoid confusion the Makefile should be removed.
Change-Id: I65cd0ddb307f02909062c1129cddfa651eeaa2ba

Telemetry service comes with high overhead by consuming higher
resources than expected for the default minimal cluster configuration
for training labs.
Commented out the telementry related scripts under the config folder.
To re-enable it, just uncomment the required lines.
Change-Id: I6d53c4aefe689100c0315a366430a34ff1a807fe

This change reverses the order of the PTL, APC, and ATC slides in
response to student feedback in the last two Upstream training sessions.
Change-Id: I95ec52898115ecec37f084efb476db82e4f38658
Closes-Bug: #1457174 

The tox environment name should be publishdocs for proper publishing.
Change-Id: I654c20a2adcf83626971b445b0909cbffb40d944

The http://ci.openstack.org/ documentation site has been deprecated,
replaced by redirects to corresponding paths within
http://docs.openstack.org/infra/ where other Project Infrastructure
documentation already resides.
Change-Id: If4000b7f3366a028861698614bf67a3dfeb2ad10

Adding details about the "Big Tent" and DefCore
Change-Id: I722f406bfcf83f645f2aa9df924053be76534a55

Create publishbuild and checkbuild targets so that the upstream-training
slides will be gated and published at
http://docs.openstack.org/draft/upstream-training
Change-Id: I2ad3736cbd5e66d07bb84ffb9f805a0270663f7b

Added an initial slide about OpenStack governance.
Change-Id: I881ab4279d1b01bdd57cbcd299210b706030489b

It colorizes the output of osbash.sh using
the conventions given in lib-color.sh.
Implements: blueprint osbash-color-support
Closes-Bug: #1443136
Change-Id: I42ca96454fdab47b283222e2deaf3e9b51d03106

Add a slide with stats about the OpenStack community as an intro
for chapter 02.
Change-Id: I83e2856f34d7d2a65598f2303ad33a52413ecafc

Although lbaas controller script does not install any package(s), it
still has ubuntu oriented workflow.
Change-Id: If8ff129c796cca0cea3198bd31830c135be2c351

Cinder is failing after upgrade to Juno. This is because of the
following race conditions:
 - Cinder takes time to update the current status of the services.
 - Cinder sometimes gets stuck at creating block device.
 - While creating block device, deleting that device is not allowed.
 This creates error and stops the script from running.
Fixes include some helper functions which adds to the robustness of
cinder test cases.
Co-Authored-By: Roger Luethi <rl@patchworkscience.org>
Change-Id: I3254438fdac0bd4a7f927f0f203c51ab6e45b9c0

Adding orchestration and telementry services require more disk size.
The current base disk size may not be sufficient for newely added
services.
Change-Id: Id8fc90a434cade6e1c9833935938869f6a84252a

With this changeset, the cluster build can be tested starting from a
specific snapshot. This is mostly useful for testing client scripts
without having to go through the whole cluster build every time.
For instance, to rebuild the cluster from snapshot neuntron_configured:
./tools/repeat-test.sh -b -t neutron_configured -s "controller compute"
This will restore the appropriate snapshot on each node, boot nodes
controller and compute, and continue the cluster build from the named
snapshot onward.
Note: this procedure restores, boots, and continues in short order which
uncovers new shortcomings (races) in scripts that assume a service is
available when they should check and wait for the service.
If you just want to restore all nodes to the appropriate snapshots:
./tools/restore-cluster.sh -t <snapshot>
Change-Id: I0b7888d02de6eb50760d421d6d897f516f8c7718

Apache2 service was not restarting properly since Ubuntu14.04
which resulted in race conditions. This is explained in detail in the
script. Adds a work around to fix apache2 race invoked by lack of
www-browser virtual package linking to a basic text browser. Adding
w3m before hand to avoid any future issues. Ofcourse lynx or links
works here too.
Also provides more systematic stopping and starting of apache service
for eliminating restart/start-stop race issues.
Change-Id: I541d5b27bbfdda9b9f3eda72a0f13e9e8333faa2

If the test fails, it should exit the script not the cluster. Just
reporting this error and gracefully exiting the script should be
sufficient. My reasons for this are:
 * The tests are not completely reliable to say if the cluster is
 broken for sure.
 * The tests are not meant to fix the issues with the cluster, it
 could be a packaging issue or bug in the product. Our aim is
 not to catch them.
 * If there is a problem with heat, the other servies are still
 running fine. And the cluster is still usable.
Change-Id: I246bd3144189eba69a64ad545e6fe123e310595e

Following actions are performed by this patch:
1) Adds the ceilometer packages to the pre-download script.
2) Adds telemetry services on controller node.
3) Configures glance, cinder to send notification to the telemetry module.
4) Adds ceilometer compute agent on compute node.
Co-authored-by: Pranav Salunke <dguitarbite@gmail.com>
Change-Id: I82e8f4799e724e09748bb9c743ec8b77e82af39a