diff --git a/doc/src/docbkx/openstack-block-storage-admin/bk-block-storage-adminguide.xml b/doc/src/docbkx/openstack-block-storage-admin/bk-block-storage-adminguide.xml index dea3971217..2bd262631f 100644 --- a/doc/src/docbkx/openstack-block-storage-admin/bk-block-storage-adminguide.xml +++ b/doc/src/docbkx/openstack-block-storage-admin/bk-block-storage-adminguide.xml @@ -3,11 +3,9 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="bk_block-storage-grizzly"> - OpenStack Block Storage Service Administration - Guide - - OpenStack Block Storage Service Administration - Guide + OpenStack Block Storage Service Administration Guide + + OpenStack Block Storage Service Administration Guide @@ -25,6 +23,7 @@ Grizzly, 2013.1 OpenStack Block Storage Service + Grizzly, 2013.1 diff --git a/doc/src/docbkx/openstack-block-storage-admin/drivers/emc-volume-driver.xml b/doc/src/docbkx/openstack-block-storage-admin/drivers/emc-volume-driver.xml index 7f7ac7f2da..79e41dbd6e 100644 --- a/doc/src/docbkx/openstack-block-storage-admin/drivers/emc-volume-driver.xml +++ b/doc/src/docbkx/openstack-block-storage-admin/drivers/emc-volume-driver.xml @@ -4,12 +4,13 @@ xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> EMC SMI-S iSCSI Driver - The EMCSMISISCSIDriver is based on the existing ISCSIDriver, - with the ability to create/delete and attach/detach volumes and - create/delete snapshots, etc. - The EMCSMISISCSIDriver executes the volume operations by - communicating with the backend EMC storage. It uses a CIM client - in python called PyWBEM to make CIM operations over HTTP. + The EMCISCSIDriver is based on the existing ISCSIDriver, + with the ability to create/delete and attach/detach volumes + and create/delete snapshots, and so on. + The EMCISCSIDriver executes the volume operations by + communicating with the backend EMC storage. It uses a CIM + client in python called PyWBEM to make CIM operations over + HTTP. The EMC CIM Object Manager (ECOM) is packaged with the EMC SMI-S Provider. It is a CIM server that allows CIM clients to make CIM operations over HTTP, using SMI-S in the backend for EMC storage @@ -17,15 +18,15 @@ The EMC SMI-S Provider supports the SNIA Storage Management Initiative (SMI), an ANSI standard for storage management. It supports VMAX and VNX storage systems. - - Requirements +
+ System Requirements EMC SMI-S Provider V4.5.1 and higher is required. SMI-S can be downloaded from EMC's Powerlink web site. Refer to the EMC SMI-S Provider release notes for installation instructions. EMC storage VMAX Family and VNX Series are supported. - - +
+
Supported Operations The following operations will be supported on both VMAX and VNX arrays: @@ -45,8 +46,8 @@ Create volume from snapshot Only thin provisioning is supported. - - +
+
Preparation Install python-pywbem package. For example: @@ -58,8 +59,8 @@ Register with VNX. Create Masking View on VMAX. - - +
+
Register with VNX For a VNX volume to be exported to a Compute node, the node needs to be registered with VNX first. @@ -86,10 +87,14 @@ $ sudo iscsiadm -m node -T iqn.1992-04.com.emc:cx.apm01234567890.a0 -p 10.10.61.35 -l - - Assume iqn.1993-08.org.debian:01:1a2b3c4d5f6g is the initiator name of the Compute node. - Login to Unisphere, go to VNX00000->Hosts->Initiators, Refresh and wait until initiator - iqn.1993-08.org.debian:01:1a2b3c4d5f6g with SP Port A-8v0 appears. + Assume + iqn.1993-08.org.debian:01:1a2b3c4d5f6g + is the initiator name of the Compute node. Login to + Unisphere, go to + VNX00000->Hosts->Initiators, Refresh + and wait until initiator + iqn.1993-08.org.debian:01:1a2b3c4d5f6g + with SP Port A-8v0 appears. Click the "Register" button, select "CLARiiON/VNX" and enter the host name myhost1 and IP address myhost1. Click Register. Now host 1.1.1.1 will appear under Hosts->Host List as well. @@ -106,15 +111,15 @@ $ sudo iscsiadm -m node -u - - +
+
Create Masking View on VMAX For VMAX, user needs to do initial setup on the Unisphere for VMAX server first. On the Unisphere for VMAX server, create initiator group, storage group, port group, and put them in a masking view. Initiator group contains the initiator names of the openstack hosts. Storage group should have at least 6 gatekeepers. - - +
+
Config file <filename>cinder.conf</filename> Make the following changes in /etc/cinder/cinder.conf. For VMAX, we have the following entries where 10.10.61.45 is the IP address of the @@ -134,8 +139,8 @@ volume_driver = cinder.volume.emc.EMCISCSIDriver cinder_emc_config_file = /etc/cinder/cinder_emc_config.xml Restart the cinder-volume service. - - +
+
Config file <filename>cinder_emc_config.xml</filename> Create the file /etc/cinder/cinder_emc_config.xml. We don't need to restart service for this change. @@ -172,5 +177,5 @@ cinder_emc_config_file = /etc/cinder/cinder_emc_config.xml EcomServerIp and EcomServerPort are the IP address and port number of the ECOM server which is packaged with SMI-S. EcomUserName and EcomPassword are credentials for the ECOM server. - +
diff --git a/doc/src/docbkx/openstack-block-storage-admin/pom.xml b/doc/src/docbkx/openstack-block-storage-admin/pom.xml index 6f64058a27..a30084db1c 100644 --- a/doc/src/docbkx/openstack-block-storage-admin/pom.xml +++ b/doc/src/docbkx/openstack-block-storage-admin/pom.xml @@ -2,15 +2,12 @@ - 4.0.0 - org.openstack.docs openstack-guide 1.0.0-SNAPSHOT jar - OpenStack Guides - + OpenStack Administration Guides local @@ -41,10 +38,8 @@ - - com.rackspace.cloud.api clouddocs-maven-plugin @@ -60,6 +55,7 @@ false 0 + 1 0 @@ -90,16 +86,14 @@ 0 + 1 0 ${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-block-storage admin bk-block-storage-adminguide-${release.path.name} - - - @@ -111,14 +105,12 @@ bk-block-storage-adminguide.xml - http://docs.openstack.org/${release.path.name}/openstack-block-storage/admin/content/ reviewer openstack false - diff --git a/doc/src/docbkx/openstack-compute-admin/bk-compute-adminguide.xml b/doc/src/docbkx/openstack-compute-admin/bk-compute-adminguide.xml index 80aaaaebdb..4b67de003a 100644 --- a/doc/src/docbkx/openstack-compute-admin/bk-compute-adminguide.xml +++ b/doc/src/docbkx/openstack-compute-admin/bk-compute-adminguide.xml @@ -6,7 +6,9 @@ xmlns:html="http://www.w3.org/1999/xhtml" version="5.0" xml:id="openstack-compute-admin-manual-grizzly"> - OpenStack Compute Administration Manual + OpenStack Compute Administration Guide + + OpenStack Compute Administration Guide @@ -14,7 +16,7 @@ - OpenStack + OpenStack Foundation @@ -26,7 +28,7 @@ Grizzly, 2013.1 OpenStack Compute - 2013-04-30 + Copyright details are filled in by the template. @@ -44,6 +46,16 @@ + + 2013-05-09 + + + + Updated the book title for consistency. + + + + 2013-04-30 @@ -212,6 +224,7 @@ + diff --git a/doc/src/docbkx/openstack-compute-admin/pom.xml b/doc/src/docbkx/openstack-compute-admin/pom.xml index aadb28ca07..85a373df1f 100644 --- a/doc/src/docbkx/openstack-compute-admin/pom.xml +++ b/doc/src/docbkx/openstack-compute-admin/pom.xml @@ -9,7 +9,7 @@ openstack-guide 1.0.0-SNAPSHOT jar - OpenStack Guides + OpenStack Administration Guides @@ -26,7 +26,7 @@ com.rackspace.cloud.api clouddocs-maven-plugin - 1.7.2 + 1.8.0 generate-webhelp @@ -46,6 +46,7 @@ article toc,title book title,figure,table,example,equation chapter toc,title + section toc part toc,title preface toc,title qandadiv toc @@ -55,6 +56,7 @@ 0 + 1 0 target/docbkx/webhelp/${release.path.name}/openstack-compute admin diff --git a/doc/src/docbkx/openstack-compute-admin/preface.xml b/doc/src/docbkx/openstack-compute-admin/preface.xml new file mode 100644 index 0000000000..e93f1ab07c --- /dev/null +++ b/doc/src/docbkx/openstack-compute-admin/preface.xml @@ -0,0 +1,17 @@ + + + Preface + OpenStack™ Compute offers open source software for cloud + administration and management for any organization. This + manual provides guidance for installing, managing, and + understanding the software that runs OpenStack Compute. +
+ Document Change History + The most recent changes are described in the table + below: + +
+
diff --git a/doc/src/docbkx/openstack-ha/ha-guide-docinfo.xml b/doc/src/docbkx/openstack-ha/ha-guide-docinfo.xml index 8d2f5d20b8..8cb0099e1f 100644 --- a/doc/src/docbkx/openstack-ha/ha-guide-docinfo.xml +++ b/doc/src/docbkx/openstack-ha/ha-guide-docinfo.xml @@ -14,7 +14,7 @@ OpenStack Contributors trunk - OpenStack + OpenStack Foundation 2012-01-16 diff --git a/doc/src/docbkx/openstack-network-connectivity-admin/bk-networking-admin-guide.xml b/doc/src/docbkx/openstack-network-connectivity-admin/bk-networking-admin-guide.xml index 795abeb5f2..3c970dedf8 100644 --- a/doc/src/docbkx/openstack-network-connectivity-admin/bk-networking-admin-guide.xml +++ b/doc/src/docbkx/openstack-network-connectivity-admin/bk-networking-admin-guide.xml @@ -16,6 +16,8 @@ xmlns:db="http://docbook.org/ns/docbook" version="5.0" status="final" xml:id="Quantum-admin-guide-grizzly"> OpenStack Networking Administration Guide + + OpenStack Networking Administration Guide @@ -39,13 +41,22 @@ - This document is intended for administrators - interested in running the OpenStack Networking Virtual - Network Service. + This document is for administrators + interested in running the OpenStack Networking Service. + + 2013-05-09 + + + + Updated the book title for consistency. + + + + 2013-04-30 @@ -112,8 +123,6 @@ - -
@@ -130,6 +139,4 @@ - - diff --git a/doc/src/docbkx/openstack-network-connectivity-admin/pom.xml b/doc/src/docbkx/openstack-network-connectivity-admin/pom.xml index cc47f720db..ff74061d64 100644 --- a/doc/src/docbkx/openstack-network-connectivity-admin/pom.xml +++ b/doc/src/docbkx/openstack-network-connectivity-admin/pom.xml @@ -9,7 +9,7 @@ openstack-guide 1.0.0-SNAPSHOT jar - OpenStack Guides + OpenStack Administration Guides @@ -27,7 +27,7 @@ com.rackspace.cloud.api clouddocs-maven-plugin - 1.7.2 + 1.8.0 networking-admin-webhelp diff --git a/doc/src/docbkx/openstack-object-storage-admin/bk-objectstorage-adminguide.xml b/doc/src/docbkx/openstack-object-storage-admin/bk-objectstorage-adminguide.xml index 109ea14bc0..dfe4d0d4f6 100644 --- a/doc/src/docbkx/openstack-object-storage-admin/bk-objectstorage-adminguide.xml +++ b/doc/src/docbkx/openstack-object-storage-admin/bk-objectstorage-adminguide.xml @@ -3,10 +3,12 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:svg="http://www.w3.org/2000/svg" - xmlns:html="http://www.w3.org/1999/xhtml" - version="5.0" + xmlns:html="http://www.w3.org/1999/xhtml" version="5.0" xml:id="openstack-object-storage-admin-manual-grizzly"> - OpenStack Object Storage Administration Manual + OpenStack Object Storage Administration Guide + + OpenStack Object Storage Administration + Guide @@ -14,7 +16,7 @@ - OpenStack + OpenStack Foundation @@ -24,24 +26,35 @@ 2013 OpenStack Foundation - trunk + Grizzly, 2013.1 with Object Storage 1.8.0 OpenStack Object Storage - 2013-04-30 + - Copyright details are filled in by the template. + Copyright details are filled in by the + template. - OpenStack™ Object Storage offers open source software for cloud-based object - storage for any organization. This manual provides guidance for installing, - managing, and understanding the software that runs OpenStack Object Storage. + OpenStack™ Object Storage offers open source + software for cloud-based object storage for any + organization. This manual provides guidance for + installing, managing, and understanding the software + that runs OpenStack Object Storage. + + 2013-05-09 + + Updated the book title for + consistency. + + 2013-04-30 - Grizzly release. + + Grizzly release. @@ -49,9 +62,14 @@ - Bug fixes and cleanup. Fix bug 1034144 - Add section about cluster health. - Add a note about the apt-get install for swift3 from Ubuntu Cloud Archive. + Bug fixes and cleanup. Fix bug 1034144 + Add section about cluster + health. + Add a note about the apt-get install + for swift3 from Ubuntu Cloud + Archive. @@ -61,7 +79,8 @@ - Folsom release of this document. + Folsom release of this + document. @@ -89,7 +108,9 @@ - Fix bug 1009170. + Fix bug 1009170. @@ -139,7 +160,8 @@ - + diff --git a/doc/src/docbkx/openstack-object-storage-admin/pom.xml b/doc/src/docbkx/openstack-object-storage-admin/pom.xml index a6225e59ce..75e29c1dc2 100644 --- a/doc/src/docbkx/openstack-object-storage-admin/pom.xml +++ b/doc/src/docbkx/openstack-object-storage-admin/pom.xml @@ -2,30 +2,30 @@ - + 4.0.0 - + org.openstack.docs openstack-guide 1.0.0-SNAPSHOT jar - OpenStack Guides + OpenStack Administration Guides - unknown + local 1 - + - + com.rackspace.cloud.api clouddocs-maven-plugin - 1.7.2 + 1.8.0 generate-webhelp @@ -39,28 +39,26 @@ openstackdocs 1 UA-17511903-1 - - appendix toc,title - article/appendix nop - article toc,title - book title,figure,table,example,equation - chapter toc,title - part toc,title - preface toc,title - qandadiv toc - qandaset toc + appendix toc,title + article/appendix nop + article toc,title + book title,figure,table,example,equation + chapter toc,title + section toc part + toc,title + preface toc,title + qandadiv toc + qandaset toc reference toc,title - set toc,title - + set toc,title 0 + 1 0 - - admin - ${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-object-storage - 0 - os-objectstorage-adminguide-${release.path.name} - + admin + ${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-object-storage + 0 + os-objectstorage-adminguide-${release.path.name} @@ -69,35 +67,33 @@ generate-webhelp generate-sources - - dummy.xml - - - - - - - - - - + + dummy.xml + + + + + + + + + + true . - - bk-objectstorage-adminguide.xml - + bk-objectstorage-adminguide.xml http://docs.openstack.org/${release.path.name}/openstack-object-storage/admin/content/ reviewer openstack - - Rackspace Research Repositories @@ -120,5 +116,4 @@ - diff --git a/www/run/index.html b/www/run/index.html index 9e74b30d47..69de44955b 100644 --- a/www/run/index.html +++ b/www/run/index.html @@ -3,27 +3,32 @@ - - - - - OpenStack Docs: current - - - + + + + + OpenStack Docs: current + + + + + - - + + - - - -
- +
- - - + + - - - - +