From b4f6cd97d8e9383d63aba7a19b415f163f48826b Mon Sep 17 00:00:00 2001 From: Pranav Salunke Date: Wed, 11 Jun 2014 19:20:16 +0530 Subject: [PATCH] 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 --- doc/training-guides/bk000-preface.xml | 7 +- .../bk001-ch003-associate-controller-node.xml | 14 +- .../bk001-ch005-associate-compute-node.xml | 12 +- .../bk001-ch007-associate-network-node.xml | 4 +- ...01-ch009-associate-object-storage-node.xml | 6 +- ...002-ch013-operator-object-storage-node.xml | 16 +-- .../bk002-operator-training-guide.xml | 4 +- .../lab000-virtualbox-basics.xml | 16 +-- .../locale/training-guides.pot | 2 +- .../module001-ch009-vm-placement.xml | 2 +- .../module003-ch006-more-concepts.xml | 10 +- doc/training-guides/pom.xml | 45 ++++++- .../under-contruction-notice.xml | 121 ++++++++++++++++++ 13 files changed, 206 insertions(+), 53 deletions(-) create mode 100644 doc/training-guides/under-contruction-notice.xml 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. + + +