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.1OpenStack 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 RequirementsEMC 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 OperationsThe following operations will be supported on both VMAX
and VNX arrays:
@@ -45,8 +46,8 @@
Create volume from snapshotOnly thin provisioning is supported.
-
-
+
+ PreparationInstall python-pywbem package. For example:
@@ -58,8 +59,8 @@
Register with VNX.Create Masking View on VMAX.
-
-
+
+ Register with VNXFor 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 VMAXFor 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 cinder.confMake 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 cinder_emc_config.xmlCreate 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.docsopenstack-guide1.0.0-SNAPSHOTjar
- OpenStack Guides
-
+ OpenStack Administration Guideslocal
@@ -41,10 +38,8 @@
-
-
com.rackspace.cloud.apiclouddocs-maven-plugin
@@ -60,6 +55,7 @@
false0
+ 10
@@ -90,16 +86,14 @@
0
+ 10${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-block-storageadminbk-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/revieweropenstackfalse
-
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.1OpenStack 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-guide1.0.0-SNAPSHOTjar
- OpenStack Guides
+ OpenStack Administration Guides
@@ -26,7 +26,7 @@
com.rackspace.cloud.apiclouddocs-maven-plugin
- 1.7.2
+ 1.8.0generate-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
+ 10target/docbkx/webhelp/${release.path.name}/openstack-computeadmin
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 Contributorstrunk
- OpenStack
+ OpenStack Foundation2012-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-guide1.0.0-SNAPSHOTjar
- OpenStack Guides
+ OpenStack Administration Guides
@@ -27,7 +27,7 @@
com.rackspace.cloud.apiclouddocs-maven-plugin
- 1.7.2
+ 1.8.0networking-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 @@
2013OpenStack Foundation
- trunk
+ Grizzly, 2013.1 with Object Storage 1.8.0OpenStack 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.docsopenstack-guide1.0.0-SNAPSHOTjar
- OpenStack Guides
+ OpenStack Administration Guides
- unknown
+ local1
-
+
-
+
com.rackspace.cloud.apiclouddocs-maven-plugin
- 1.7.2
+ 1.8.0generate-webhelp
@@ -39,28 +39,26 @@
openstackdocs1UA-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
+ 10
-
- 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-webhelpgenerate-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/revieweropenstack
-
-
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
+
+
+
+
+
-
-
+
+
-
-
-
-
Describes architecture decisions and day-to-day operations for running OpenStack. Written in a five-day book sprint in February 2013, targeting the Folsom release for stability.
Make architecture decisions and perform day-to-day
+ operations for OpenStack. This guide was written
+ in a five-day book sprint in February 2013. For
+ stability, it targets the Folsom release.