diff --git a/doc/training-guides/bk000-preface.xml b/doc/training-guides/bk000-preface.xml index 863e444e..0f25fd41 100644 --- a/doc/training-guides/bk000-preface.xml +++ b/doc/training-guides/bk000-preface.xml @@ -2,12 +2,13 @@ + xml:id="bk000-preface"> Start Here Preface - + + OpenStack Training Guides Are Under Construction @@ -148,5 +149,5 @@ - + diff --git a/doc/training-guides/bk001-ch003-associate-controller-node.xml b/doc/training-guides/bk001-ch003-associate-controller-node.xml index 02640e80..854bd568 100644 --- a/doc/training-guides/bk001-ch003-associate-controller-node.xml +++ b/doc/training-guides/bk001-ch003-associate-controller-node.xml @@ -35,49 +35,49 @@ Administration Tasks
Identity CI Commands - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Identity User Management - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Image CLI Commands - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Image List Images - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Image Adding Images - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Image Manage Images - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Message Queue Configuration - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing diff --git a/doc/training-guides/bk001-ch005-associate-compute-node.xml b/doc/training-guides/bk001-ch005-associate-compute-node.xml index 6214928b..63783804 100644 --- a/doc/training-guides/bk001-ch005-associate-compute-node.xml +++ b/doc/training-guides/bk001-ch005-associate-compute-node.xml @@ -35,42 +35,42 @@ Administration Tasks
Block Storage CLI Commands - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Block Storage Manage Volumes - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Compute CLI Commands - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Compute Image creation - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Compute Boot Instance - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Compute Terminate Instance - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing diff --git a/doc/training-guides/bk001-ch007-associate-network-node.xml b/doc/training-guides/bk001-ch007-associate-network-node.xml index 42b8f932..c4fb5496 100644 --- a/doc/training-guides/bk001-ch007-associate-network-node.xml +++ b/doc/training-guides/bk001-ch007-associate-network-node.xml @@ -28,14 +28,14 @@ Administration Tasks
Network CLI Commands - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Manage Networks - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing diff --git a/doc/training-guides/bk001-ch009-associate-object-storage-node.xml b/doc/training-guides/bk001-ch009-associate-object-storage-node.xml index d397d403..4c1eead9 100644 --- a/doc/training-guides/bk001-ch009-associate-object-storage-node.xml +++ b/doc/training-guides/bk001-ch009-associate-object-storage-node.xml @@ -12,14 +12,14 @@
Introduction to Object Storage - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
Features and Benefits - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing @@ -28,7 +28,7 @@ Administration Tasks
Object Storage CLI Commands - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing diff --git a/doc/training-guides/bk002-ch013-operator-object-storage-node.xml b/doc/training-guides/bk002-ch013-operator-object-storage-node.xml index 12ea7496..2bd23110 100644 --- a/doc/training-guides/bk002-ch013-operator-object-storage-node.xml +++ b/doc/training-guides/bk002-ch013-operator-object-storage-node.xml @@ -12,19 +12,19 @@
Review Associate Introduction to Object Storage - Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
- +
Review Associate Administration Tasks
- - - + + +
More Swift Concepts Remote content not availableimage sourcehttps://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing
- - - + + + diff --git a/doc/training-guides/bk002-operator-training-guide.xml b/doc/training-guides/bk002-operator-training-guide.xml index 332297ad..0ce1adac 100644 --- a/doc/training-guides/bk002-operator-training-guide.xml +++ b/doc/training-guides/bk002-operator-training-guide.xml @@ -15,7 +15,7 @@ - + - + diff --git a/doc/training-guides/lab000-virtualbox-basics.xml b/doc/training-guides/lab000-virtualbox-basics.xml index 90857564..694b1b86 100644 --- a/doc/training-guides/lab000-virtualbox-basics.xml +++ b/doc/training-guides/lab000-virtualbox-basics.xml @@ -1,6 +1,6 @@ + %openstack; ]> Intel ix or AMD QuadCore - 4 GB RAM: + 4 GB RAM: DDR2/DDR3 @@ -380,8 +380,8 @@ KVM acceleration can NOT be used Select the appropriate amount of RAM. For the control node, - the minimum is 512 MB of RAM. For other settings, use the - defaults. The hard disk size can be 8 GB. + the minimum is 512 MB of RAM. For other settings, use the + defaults. The hard disk size can be 8 GB. Configure the networks (Ignore the IP Address for now, you will set it up from inside the VM) @@ -453,8 +453,8 @@ KVM acceleration can NOT be used Network node Create a new virtual machine, minimum RAM is - 512 MB. The remainder can be left as default. The minimum HDD - space is 8 GB. + 512 MB. The remainder can be left as default. The minimum HDD + space is 8 GB.
Create New Virtual Machine @@ -549,8 +549,8 @@ KVM acceleration can NOT be used
Compute node - Create a virtual machine with at least 1,000 MB RAM and - 8 GB HDD. For other settings, use the defaults. + Create a virtual machine with at least 1,000 MB RAM and + 8 GB HDD. For other settings, use the defaults.
Create new virtual machine diff --git a/doc/training-guides/locale/training-guides.pot b/doc/training-guides/locale/training-guides.pot index 5cfb44fe..2fe12619 100644 --- a/doc/training-guides/locale/training-guides.pot +++ b/doc/training-guides/locale/training-guides.pot @@ -5845,7 +5845,7 @@ msgstr "" #. When image changes, this message will be marked fuzzy or untranslated for you. #. It doesn't matter what you translate it to: it's not used at all. #: ./doc/training-guides/module001-ch009-vm-placement.xml:200(None) -msgid "@@image: '../common/figures/nova-weighting-hosts.png'; md5=000eab4cf0deb1da2e692e023065a6ae" +msgid "@@image: 'https://raw.githubusercontent.com/openstack/openstack-manuals/master/doc/common/figures/nova-weighting-hosts.png'; md5=000eab4cf0deb1da2e692e023065a6ae" msgstr "" #: ./doc/training-guides/module001-ch009-vm-placement.xml:7(title) ./doc/training-guides/bk001-ch005-associate-compute-node.xml:14(title) diff --git a/doc/training-guides/module001-ch009-vm-placement.xml b/doc/training-guides/module001-ch009-vm-placement.xml index 38e75098..e9eb9742 100644 --- a/doc/training-guides/module001-ch009-vm-placement.xml +++ b/doc/training-guides/module001-ch009-vm-placement.xml @@ -196,7 +196,7 @@ Weights - diff --git a/doc/training-guides/module003-ch006-more-concepts.xml b/doc/training-guides/module003-ch006-more-concepts.xml index 03e6b20e..1283a08b 100644 --- a/doc/training-guides/module003-ch006-more-concepts.xml +++ b/doc/training-guides/module003-ch006-more-concepts.xml @@ -1,6 +1,6 @@ + %openstack; ]> The maximum allowable size for a storage object upon - upload is 5 GB and the minimum is zero bytes. + upload is 5 GB and the minimum is zero bytes. You can use the built-in large object support and the - swift utility to retrieve objects larger than 5 GB. + swift utility to retrieve objects larger than 5 GB. For metadata, you should not exceed 90 individual key/value pairs for any one object and the total byte - length of all key/value pairs should not exceed 4 KB - (4096 bytes). + length of all key/value pairs should not exceed 4 KB + (4096 bytes). Language-Specific API Bindings A set of supported API bindings in several popular diff --git a/doc/training-guides/pom.xml b/doc/training-guides/pom.xml index de4a0926..748d827a 100644 --- a/doc/training-guides/pom.xml +++ b/doc/training-guides/pom.xml @@ -2,28 +2,33 @@ - - org.openstack.docs - parent-pom - 1.0.0-SNAPSHOT - ../pom.xml - + 4.0.0 + org.opensatck.docs openstack-training-guides + 1.0.0 jar OpenStack Training Guides + local 1 ubuntu + + + + + + com.rackspace.cloud.api clouddocs-maven-plugin - + 2.0.2 + training-guides @@ -39,10 +44,12 @@ ${comments.enabled} 1 UA-17511903-1 + 1 0 1 0 + appendix toc,title article/appendix nop @@ -56,6 +63,7 @@ reference toc,title set toc,title + 9.68in 7.44in 1 @@ -72,4 +80,27 @@ + + + + Rackspace Research Repositories + + true + + + + rackspace-research + Rackspace Research Repository + http://maven.research.rackspacecloud.com/content/groups/public/ + + + + + rackspace-research + Rackspace Research Repository + http://maven.research.rackspacecloud.com/content/groups/public/ + + + + diff --git a/doc/training-guides/under-contruction-notice.xml b/doc/training-guides/under-contruction-notice.xml new file mode 100644 index 00000000..e366f91b --- /dev/null +++ b/doc/training-guides/under-contruction-notice.xml @@ -0,0 +1,121 @@ + + + Under Construction + + OpenStack Training Guides Are Under Construction + We need your help! This is a community driven project to provide the user group community + access to OpenStack training materials. We cannot make this work without your help. + There are a few ways to get involved. The easiest way is to use the training guides. Look at + the end of each section and you will see the Submit a Bug link. When you find something that can + be improved or fixed, submit a bug by clicking on the link. + If you want to get involved with the effort around OpenStack community training, read on, + here are the options: + + + + Attending a user group using the training materials + The OpenStack community training started at the SFBay OpenStack User Group. More + information on this user group and others using the training guides on the OpenStack User Groups + page. + + + + Teach / Lead a user group using the training materials + Awesome! Your experience will not only give you more experience with OpenStack, but + you will help some people find new jobs. We have put all the information about How To Run An OpenStack Hackathon here. + + + + Help create the training pages + + + + We are currently working on creating the Associate Training Guide. It is the + first of four training guides. We are using the Install Guide, Administration + Guides, Developer Documentation, and Aptira supplied content as the sources for + most of the Associate Training Guide. The basic idea is that we use XML include + statements to actually use the source content to create new pages. We aim to use + as much of the material as possible from existing documentation. By doing this + we reuse and improve the existing docs. The topics in the Associate Training + Guide are in a bunch of KanBan story board cards. Each card in the story board + represents something that an Associate trainee needs to learn. But first things + first, you need to get some basic tools and accounts installed and configured + before you can really start. + + + Getting Accounts and Tools: We can't do + this without operators and developers using and creating the content. Anyone can + contribute content. You will need the tools to get started. Go to the Getting Tools and Accounts page. + + + Pick a Card: Once you have your tools ready + to go, you can assign some work to yourself. Go to the Training Trello/KanBan storyboard and assign a card / user story from + the Sprint Backlog to yourself. If you do not have a Trello account, no problem, + just create one. Email seanrob@yahoo-inc.com and you will have access. + + + Create the Content: Each card / user story + from the KanBan story board will be a separate chunk of content that you will + add to the openstack-manuals repository openstack-training sub-project. + + More details on creating training content here. + + + + + + Here are more details on committing changes to OpenStack fixing a documentation bug + , OpenStack Gerrit + Workflow, OpenStack + Documentation HowTo and , Git Documentation + + + + + More details on the OpenStack Training project. + + + + OpenStack Training + Wiki (describes the project in detail) + + + OpenStack Training blueprint(this is the key project page) + + + Bi-Weekly SFBay Hackathon meetup + page(we discuss project details with all team members) + + + Bi-Weekly SFBay + Hackathon Etherpad(meetup notes) + + + Core + Training Weekly Meeting Agenda(we review project action items here) + + + Training Trello/KanBan storyboard(we develop high level project action items + here) + + + + Submit a bug. Enter the summary as "Training, " with a few words. Be descriptive as possible in the description field. Open the tag pull-down and enter training-manuals. + + +