Made book titles consistent

bug: #1178295

Change-Id: Idc3126541ad8c4c66cb88c77f06f5075d3647b44
author: Diane Fleming
This commit is contained in:
Diane Fleming
2013-05-09 11:36:04 -05:00
parent a416259bcb
commit 4335ea3b77
12 changed files with 362 additions and 271 deletions

View File

@@ -3,11 +3,9 @@
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk_block-storage-grizzly"> xml:id="bk_block-storage-grizzly">
<title>OpenStack Block Storage Service Administration <title>OpenStack Block Storage Service Administration Guide</title>
Guide</title> <?rax title.font.size="28px" subtitle.font.size="28px"?>
<?rax title.font.size="32px"?> <titleabbrev>OpenStack Block Storage Service Administration Guide</titleabbrev>
<titleabbrev>OpenStack Block Storage Service Administration
Guide</titleabbrev>
<info> <info>
<author> <author>
<personname> <personname>
@@ -25,6 +23,7 @@
</copyright> </copyright>
<releaseinfo>Grizzly, 2013.1</releaseinfo> <releaseinfo>Grizzly, 2013.1</releaseinfo>
<productname>OpenStack Block Storage Service</productname> <productname>OpenStack Block Storage Service</productname>
<releaseinfo>Grizzly, 2013.1</releaseinfo>
<pubdate/> <pubdate/>
<legalnotice role="apache2"> <legalnotice role="apache2">
<annotation> <annotation>

View File

@@ -4,12 +4,13 @@
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"> version="5.0">
<title>EMC SMI-S iSCSI Driver</title> <title>EMC SMI-S iSCSI Driver</title>
<para>The EMCSMISISCSIDriver is based on the existing ISCSIDriver, <para>The EMCISCSIDriver is based on the existing ISCSIDriver,
with the ability to create/delete and attach/detach volumes and with the ability to create/delete and attach/detach volumes
create/delete snapshots, etc.</para> and create/delete snapshots, and so on.</para>
<para>The EMCSMISISCSIDriver executes the volume operations by <para>The EMCISCSIDriver executes the volume operations by
communicating with the backend EMC storage. It uses a CIM client communicating with the backend EMC storage. It uses a CIM
in python called PyWBEM to make CIM operations over HTTP.</para> client in python called PyWBEM to make CIM operations over
HTTP.</para>
<para>The EMC CIM Object Manager (ECOM) is packaged with the EMC SMI-S <para>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 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 operations over HTTP, using SMI-S in the backend for EMC storage
@@ -17,15 +18,15 @@
<para>The EMC SMI-S Provider supports the SNIA Storage Management <para>The EMC SMI-S Provider supports the SNIA Storage Management
Initiative (SMI), an ANSI standard for storage management. It Initiative (SMI), an ANSI standard for storage management. It
supports VMAX and VNX storage systems.</para> supports VMAX and VNX storage systems.</para>
<simplesect> <section xml:id="emc-reqs">
<title>Requirements</title> <title>System Requirements</title>
<para>EMC SMI-S Provider V4.5.1 and higher is required. SMI-S <para>EMC SMI-S Provider V4.5.1 and higher is required. SMI-S
can be downloaded from <link xlink:href="http://powerlink.emc.com"> can be downloaded from <link xlink:href="http://powerlink.emc.com">
EMC's Powerlink</link> web site. Refer to the EMC SMI-S Provider EMC's Powerlink</link> web site. Refer to the EMC SMI-S Provider
release notes for installation instructions.</para> release notes for installation instructions.</para>
<para>EMC storage VMAX Family and VNX Series are supported.</para> <para>EMC storage VMAX Family and VNX Series are supported.</para>
</simplesect> </section>
<simplesect> <section xml:id="emc-supported-ops">
<title>Supported Operations</title> <title>Supported Operations</title>
<para>The following operations will be supported on both VMAX <para>The following operations will be supported on both VMAX
and VNX arrays:</para> and VNX arrays:</para>
@@ -45,8 +46,8 @@
<listitem><para>Create volume from snapshot</para></listitem> <listitem><para>Create volume from snapshot</para></listitem>
</itemizedlist> </itemizedlist>
<para>Only thin provisioning is supported.</para> <para>Only thin provisioning is supported.</para>
</simplesect> </section>
<simplesect> <section xml:id="emc-prep">
<title>Preparation</title> <title>Preparation</title>
<itemizedlist> <itemizedlist>
<listitem><para>Install python-pywbem package. For example:</para> <listitem><para>Install python-pywbem package. For example:</para>
@@ -58,8 +59,8 @@
<listitem><para>Register with VNX.</para></listitem> <listitem><para>Register with VNX.</para></listitem>
<listitem><para>Create Masking View on VMAX.</para></listitem> <listitem><para>Create Masking View on VMAX.</para></listitem>
</itemizedlist> </itemizedlist>
</simplesect> </section>
<simplesect> <section xml:id="register-emc">
<title>Register with VNX</title> <title>Register with VNX</title>
<para>For a VNX volume to be exported to a Compute node, the node needs <para>For a VNX volume to be exported to a Compute node, the node needs
to be registered with VNX first.</para> to be registered with VNX first.</para>
@@ -86,10 +87,14 @@
<screen> <screen>
<prompt>$</prompt> <userinput>sudo iscsiadm -m node -T <literal>iqn.1992-04.com.emc:cx.apm01234567890.a0</literal> -p <literal>10.10.61.35</literal> -l</userinput> <prompt>$</prompt> <userinput>sudo iscsiadm -m node -T <literal>iqn.1992-04.com.emc:cx.apm01234567890.a0</literal> -p <literal>10.10.61.35</literal> -l</userinput>
</screen></para> </screen></para>
<para> <para>Assume
Assume <literal>iqn.1993-08.org.debian:01:1a2b3c4d5f6g</literal> is the initiator name of the Compute node. <literal>iqn.1993-08.org.debian:01:1a2b3c4d5f6g</literal>
Login to Unisphere, go to <literal>VNX00000</literal>->Hosts->Initiators, Refresh and wait until initiator is the initiator name of the Compute node. Login to
<literal>iqn.1993-08.org.debian:01:1a2b3c4d5f6g</literal> with SP Port <literal>A-8v0</literal> appears.</para> Unisphere, go to
<literal>VNX00000</literal>->Hosts->Initiators, Refresh
and wait until initiator
<literal>iqn.1993-08.org.debian:01:1a2b3c4d5f6g</literal>
with SP Port <literal>A-8v0</literal> appears.</para>
<para>Click the "Register" button, select "CLARiiON/VNX" and enter the host name <literal>myhost1</literal> <para>Click the "Register" button, select "CLARiiON/VNX" and enter the host name <literal>myhost1</literal>
and IP address <literal>myhost1</literal>. Click Register. Now host <literal>1.1.1.1</literal> will appear and IP address <literal>myhost1</literal>. Click Register. Now host <literal>1.1.1.1</literal> will appear
under Hosts->Host List as well.</para> under Hosts->Host List as well.</para>
@@ -106,15 +111,15 @@
<screen> <screen>
<prompt>$</prompt> <userinput>sudo iscsiadm -m node -u</userinput> <prompt>$</prompt> <userinput>sudo iscsiadm -m node -u</userinput>
</screen> </screen>
</simplesect> </section>
<simplesect> <section xml:id="create-masking">
<title>Create Masking View on VMAX</title> <title>Create Masking View on VMAX</title>
<para>For VMAX, user needs to do initial setup on the Unisphere for VMAX server first. On the Unisphere for VMAX server, <para>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. 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 Initiator group contains the initiator names of the openstack hosts. Storage group
should have at least 6 gatekeepers.</para> should have at least 6 gatekeepers.</para>
</simplesect> </section>
<simplesect> <section xml:id="emc-config-file">
<title>Config file <filename>cinder.conf</filename></title> <title>Config file <filename>cinder.conf</filename></title>
<para>Make the following changes in <filename>/etc/cinder/cinder.conf</filename>.</para> <para>Make the following changes in <filename>/etc/cinder/cinder.conf</filename>.</para>
<para>For VMAX, we have the following entries where <literal>10.10.61.45</literal> is the IP address of the <para>For VMAX, we have the following entries where <literal>10.10.61.45</literal> 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 cinder_emc_config_file = /etc/cinder/cinder_emc_config.xml
</programlisting> </programlisting>
<para>Restart the cinder-volume service.</para> <para>Restart the cinder-volume service.</para>
</simplesect> </section>
<simplesect> <section xml:id="emc-config-file-2">
<title>Config file <filename>cinder_emc_config.xml</filename></title> <title>Config file <filename>cinder_emc_config.xml</filename></title>
<para>Create the file <filename>/etc/cinder/cinder_emc_config.xml</filename>. <para>Create the file <filename>/etc/cinder/cinder_emc_config.xml</filename>.
We don't need to restart service for this change.</para> We don't need to restart service for this change.</para>
@@ -172,5 +177,5 @@ cinder_emc_config_file = /etc/cinder/cinder_emc_config.xml
<para>EcomServerIp and EcomServerPort are the IP address and port number of the <para>EcomServerIp and EcomServerPort are the IP address and port number of the
ECOM server which is packaged with SMI-S. EcomUserName and EcomPassword are ECOM server which is packaged with SMI-S. EcomUserName and EcomPassword are
credentials for the ECOM server.</para> credentials for the ECOM server.</para>
</simplesect> </section>
</section> </section>

View File

@@ -2,15 +2,12 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" <project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion> <modelVersion>4.0.0</modelVersion>
<groupId>org.openstack.docs</groupId> <groupId>org.openstack.docs</groupId>
<artifactId>openstack-guide</artifactId> <artifactId>openstack-guide</artifactId>
<version>1.0.0-SNAPSHOT</version> <version>1.0.0-SNAPSHOT</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<name>OpenStack Guides</name> <name>OpenStack Administration Guides</name>
<properties> <properties>
<!-- This is set by Jenkins according to the branch. --> <!-- This is set by Jenkins according to the branch. -->
<release.path.name>local</release.path.name> <release.path.name>local</release.path.name>
@@ -41,10 +38,8 @@
</pluginRepositories> </pluginRepositories>
</profile> </profile>
</profiles> </profiles>
<build> <build>
<plugins> <plugins>
<plugin> <plugin>
<groupId>com.rackspace.cloud.api</groupId> <groupId>com.rackspace.cloud.api</groupId>
<artifactId>clouddocs-maven-plugin</artifactId> <artifactId>clouddocs-maven-plugin</artifactId>
@@ -60,6 +55,7 @@
<highlightSource>false</highlightSource> <highlightSource>false</highlightSource>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections--> <!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>0</sectionAutolabel> <sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel> <sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel>
</configuration> </configuration>
</execution> </execution>
@@ -90,16 +86,14 @@
</generateToc> </generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections--> <!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>0</sectionAutolabel> <sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel> <sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel>
<targetDirectory>${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-block-storage</targetDirectory> <targetDirectory>${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-block-storage</targetDirectory>
<webhelpDirname>admin</webhelpDirname> <webhelpDirname>admin</webhelpDirname>
<pdfFilenameBase>bk-block-storage-adminguide-${release.path.name}</pdfFilenameBase> <pdfFilenameBase>bk-block-storage-adminguide-${release.path.name}</pdfFilenameBase>
<postProcess> <postProcess>
<!--Deletes leftover uneeded directories --> <!--Deletes leftover uneeded directories -->
<!--<delete dir="${basedir}/target/docbkx/webhelp/bk-block-storage-adminguide"/>--> <!--<delete dir="${basedir}/target/docbkx/webhelp/bk-block-storage-adminguide"/>-->
</postProcess> </postProcess>
</configuration> </configuration>
</execution> </execution>
@@ -111,14 +105,12 @@
<includes> <includes>
bk-block-storage-adminguide.xml bk-block-storage-adminguide.xml
</includes> </includes>
<canonicalUrlBase>http://docs.openstack.org/${release.path.name}/openstack-block-storage/admin/content/</canonicalUrlBase> <canonicalUrlBase>http://docs.openstack.org/${release.path.name}/openstack-block-storage/admin/content/</canonicalUrlBase>
<profileSecurity>reviewer</profileSecurity> <profileSecurity>reviewer</profileSecurity>
<branding>openstack</branding> <branding>openstack</branding>
<strictImageValidation>false</strictImageValidation> <strictImageValidation>false</strictImageValidation>
</configuration> </configuration>
</plugin> </plugin>
</plugins> </plugins>
</build> </build>
</project> </project>

View File

@@ -6,7 +6,9 @@
xmlns:html="http://www.w3.org/1999/xhtml" xmlns:html="http://www.w3.org/1999/xhtml"
version="5.0" version="5.0"
xml:id="openstack-compute-admin-manual-grizzly"> xml:id="openstack-compute-admin-manual-grizzly">
<title>OpenStack Compute Administration Manual</title> <title>OpenStack Compute Administration Guide</title>
<?rax title.font.size="28px" subtitle.font.size="28px"?>
<titleabbrev>OpenStack Compute Administration Guide</titleabbrev>
<info> <info>
<author> <author>
<personname> <personname>
@@ -14,7 +16,7 @@
<surname/> <surname/>
</personname> </personname>
<affiliation> <affiliation>
<orgname>OpenStack</orgname> <orgname>OpenStack Foundation</orgname>
</affiliation> </affiliation>
</author> </author>
<copyright> <copyright>
@@ -26,7 +28,7 @@
</copyright> </copyright>
<releaseinfo>Grizzly, 2013.1</releaseinfo> <releaseinfo>Grizzly, 2013.1</releaseinfo>
<productname>OpenStack Compute</productname> <productname>OpenStack Compute</productname>
<pubdate>2013-04-30</pubdate> <pubdate></pubdate>
<legalnotice role="apache2"> <legalnotice role="apache2">
<annotation> <annotation>
<remark>Copyright details are filled in by the template.</remark> <remark>Copyright details are filled in by the template.</remark>
@@ -44,6 +46,16 @@
</abstract> </abstract>
<revhistory> <revhistory>
<!-- ... continue adding more revisions here as you change this document using the markup shown below... --> <!-- ... continue adding more revisions here as you change this document using the markup shown below... -->
<revision>
<date>2013-05-09</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Updated the book title for consistency.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
<revision> <revision>
<date>2013-04-30</date> <date>2013-04-30</date>
<revdescription> <revdescription>
@@ -212,6 +224,7 @@
</revhistory> </revhistory>
</info> </info>
<!-- Chapters are referred from the book file through these include statements. You can add additional chapters using these types of statements. --> <!-- Chapters are referred from the book file through these include statements. You can add additional chapters using these types of statements. -->
<xi:include href="preface.xml"/>
<xi:include href="../common/getstart.xml"/> <xi:include href="../common/getstart.xml"/>
<xi:include href="aboutcompute.xml"/> <xi:include href="aboutcompute.xml"/>
<xi:include href="computeinstall.xml"/> <xi:include href="computeinstall.xml"/>

View File

@@ -9,7 +9,7 @@
<artifactId>openstack-guide</artifactId> <artifactId>openstack-guide</artifactId>
<version>1.0.0-SNAPSHOT</version> <version>1.0.0-SNAPSHOT</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<name>OpenStack Guides</name> <name>OpenStack Administration Guides</name>
<properties> <properties>
<!-- This is set by Jenkins according to the branch. --> <!-- This is set by Jenkins according to the branch. -->
@@ -26,7 +26,7 @@
<plugin> <plugin>
<groupId>com.rackspace.cloud.api</groupId> <groupId>com.rackspace.cloud.api</groupId>
<artifactId>clouddocs-maven-plugin</artifactId> <artifactId>clouddocs-maven-plugin</artifactId>
<version>1.7.2</version> <version>1.8.0</version>
<executions> <executions>
<execution> <execution>
<id>generate-webhelp</id> <id>generate-webhelp</id>
@@ -46,6 +46,7 @@
article toc,title article toc,title
book title,figure,table,example,equation book title,figure,table,example,equation
chapter toc,title chapter toc,title
section toc
part toc,title part toc,title
preface toc,title preface toc,title
qandadiv toc qandadiv toc
@@ -55,6 +56,7 @@
</generateToc> </generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections--> <!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>0</sectionAutolabel> <sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel> <sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel>
<targetDirectory>target/docbkx/webhelp/${release.path.name}/openstack-compute</targetDirectory> <targetDirectory>target/docbkx/webhelp/${release.path.name}/openstack-compute</targetDirectory>
<webhelpDirname>admin</webhelpDirname> <webhelpDirname>admin</webhelpDirname>

View File

@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="UTF-8"?>
<preface xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="ch_preface">
<title>Preface</title>
<para>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. </para>
<section xml:id="Document_Change_History-d1e118">
<title>Document Change History</title>
<para>The most recent changes are described in the table
below:</para>
<?rax revhistory?>
</section>
</preface>

View File

@@ -14,7 +14,7 @@
<holder>OpenStack Contributors</holder> <holder>OpenStack Contributors</holder>
</copyright> </copyright>
<releaseinfo>trunk</releaseinfo> <releaseinfo>trunk</releaseinfo>
<productname>OpenStack</productname> <productname>OpenStack Foundation</productname>
<pubdate>2012-01-16</pubdate> <pubdate>2012-01-16</pubdate>
<legalnotice role="apache2"> <legalnotice role="apache2">
<annotation> <annotation>

View File

@@ -16,6 +16,8 @@
xmlns:db="http://docbook.org/ns/docbook" version="5.0" xmlns:db="http://docbook.org/ns/docbook" version="5.0"
status="final" xml:id="Quantum-admin-guide-grizzly"> status="final" xml:id="Quantum-admin-guide-grizzly">
<title>OpenStack Networking Administration Guide</title> <title>OpenStack Networking Administration Guide</title>
<?rax title.font.size="28px" subtitle.font.size="28px"?>
<titleabbrev>OpenStack Networking Administration Guide</titleabbrev>
<info> <info>
<author> <author>
<personname> <personname>
@@ -39,13 +41,22 @@
</annotation> </annotation>
</legalnotice> </legalnotice>
<abstract> <abstract>
<para>This document is intended for administrators <para>This document is for administrators
interested in running the OpenStack Networking Virtual interested in running the OpenStack Networking Service. </para>
Network Service. </para>
</abstract> </abstract>
<revhistory> <revhistory>
<!-- ... continue adding more revisions here as you change this document using the markup shown below... --> <!-- ... continue adding more revisions here as you change this document using the markup shown below... -->
<revision>
<date>2013-05-09</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Updated the book title for consistency.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
<revision> <revision>
<date>2013-04-30</date> <date>2013-04-30</date>
<revdescription> <revdescription>
@@ -112,8 +123,6 @@
</itemizedlist> </itemizedlist>
</revdescription> </revdescription>
</revision> </revision>
</revhistory> </revhistory>
</info> </info>
<xi:include href="ch_preface.xml"/> <xi:include href="ch_preface.xml"/>
@@ -130,6 +139,4 @@
<xi:include href="app_demo.xml"/> <xi:include href="app_demo.xml"/>
<xi:include href="app_core.xml"/> <xi:include href="app_core.xml"/>
<xi:include href="app_pagination_and_sorting_support.xml"/> <xi:include href="app_pagination_and_sorting_support.xml"/>
</book> </book>

View File

@@ -9,7 +9,7 @@
<artifactId>openstack-guide</artifactId> <artifactId>openstack-guide</artifactId>
<version>1.0.0-SNAPSHOT</version> <version>1.0.0-SNAPSHOT</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<name>OpenStack Guides</name> <name>OpenStack Administration Guides</name>
<properties> <properties>
<!-- This is set by Jenkins according to the branch. --> <!-- This is set by Jenkins according to the branch. -->
@@ -27,7 +27,7 @@
<plugin> <plugin>
<groupId>com.rackspace.cloud.api</groupId> <groupId>com.rackspace.cloud.api</groupId>
<artifactId>clouddocs-maven-plugin</artifactId> <artifactId>clouddocs-maven-plugin</artifactId>
<version>1.7.2</version> <version>1.8.0</version>
<executions> <executions>
<execution> <execution>
<id>networking-admin-webhelp</id> <id>networking-admin-webhelp</id>

View File

@@ -3,10 +3,12 @@
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:svg="http://www.w3.org/2000/svg" xmlns:svg="http://www.w3.org/2000/svg"
xmlns:html="http://www.w3.org/1999/xhtml" xmlns:html="http://www.w3.org/1999/xhtml" version="5.0"
version="5.0"
xml:id="openstack-object-storage-admin-manual-grizzly"> xml:id="openstack-object-storage-admin-manual-grizzly">
<title>OpenStack Object Storage Administration Manual</title> <title>OpenStack Object Storage Administration Guide</title>
<?rax title.font.size="28px" subtitle.font.size="28px"?>
<titleabbrev>OpenStack Object Storage Administration
Guide</titleabbrev>
<info> <info>
<author> <author>
<personname> <personname>
@@ -14,7 +16,7 @@
<surname/> <surname/>
</personname> </personname>
<affiliation> <affiliation>
<orgname>OpenStack</orgname> <orgname>OpenStack Foundation</orgname>
</affiliation> </affiliation>
</author> </author>
<copyright> <copyright>
@@ -24,24 +26,35 @@
<year>2013</year> <year>2013</year>
<holder>OpenStack Foundation</holder> <holder>OpenStack Foundation</holder>
</copyright> </copyright>
<releaseinfo>trunk</releaseinfo> <releaseinfo>Grizzly, 2013.1 with Object Storage 1.8.0</releaseinfo>
<productname>OpenStack Object Storage</productname> <productname>OpenStack Object Storage</productname>
<pubdate>2013-04-30</pubdate> <pubdate/>
<legalnotice role="apache2"> <legalnotice role="apache2">
<annotation> <annotation>
<remark>Copyright details are filled in by the template.</remark> <remark>Copyright details are filled in by the
template.</remark>
</annotation> </annotation>
</legalnotice> </legalnotice>
<abstract> <abstract>
<para>OpenStack™ Object Storage offers open source software for cloud-based object <para>OpenStack™ Object Storage offers open source
storage for any organization. This manual provides guidance for installing, software for cloud-based object storage for any
managing, and understanding the software that runs OpenStack Object Storage. </para> organization. This manual provides guidance for
installing, managing, and understanding the software
that runs OpenStack Object Storage. </para>
</abstract> </abstract>
<revhistory> <revhistory>
<!-- ... continue adding more revisions here as you change this document using the markup shown below... --> <!-- ... continue adding more revisions here as you change this document using the markup shown below... -->
<revision>
<date>2013-05-09</date>
<revdescription>
<para>Updated the book title for
consistency.</para>
</revdescription>
</revision>
<revision> <revision>
<date>2013-04-30</date> <date>2013-04-30</date>
<revdescription><para>Grizzly release.</para> <revdescription>
<para>Grizzly release.</para>
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
@@ -49,9 +62,14 @@
<revdescription> <revdescription>
<itemizedlist spacing="compact"> <itemizedlist spacing="compact">
<listitem> <listitem>
<para>Bug fixes and cleanup. Fix <link xlink:href="https://code.launchpad.net/bugs/1034144">bug 1034144</link></para> <para>Bug fixes and cleanup. Fix <link
<para>Add section about cluster health.</para> xlink:href="https://code.launchpad.net/bugs/1034144"
<para>Add a note about the apt-get install for swift3 from Ubuntu Cloud Archive.</para> >bug 1034144</link></para>
<para>Add section about cluster
health.</para>
<para>Add a note about the apt-get install
for swift3 from Ubuntu Cloud
Archive.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</revdescription> </revdescription>
@@ -61,7 +79,8 @@
<revdescription> <revdescription>
<itemizedlist spacing="compact"> <itemizedlist spacing="compact">
<listitem> <listitem>
<para>Folsom release of this document.</para> <para>Folsom release of this
document.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</revdescription> </revdescription>
@@ -89,7 +108,9 @@
<revdescription> <revdescription>
<itemizedlist spacing="compact"> <itemizedlist spacing="compact">
<listitem> <listitem>
<para>Fix <link xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1009170">bug 1009170</link>.</para> <para>Fix <link
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1009170"
>bug 1009170</link>.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</revdescription> </revdescription>
@@ -139,7 +160,8 @@
<!-- Chapters are referred from the book file through these include statements. You can add additional chapters using these types of statements. --> <!-- Chapters are referred from the book file through these include statements. You can add additional chapters using these types of statements. -->
<xi:include href="../common/getstart.xml"/> <xi:include href="../common/getstart.xml"/>
<xi:include href="aboutobjectstorage.xml"/> <xi:include href="aboutobjectstorage.xml"/>
<xi:include href="../openstack-install/ch_installobjectstorage.xml"/> <xi:include
href="../openstack-install/ch_installobjectstorage.xml"/>
<xi:include href="objectstorageadmin.xml"/> <xi:include href="objectstorageadmin.xml"/>
<xi:include href="objectstoragetutorials.xml"/> <xi:include href="objectstoragetutorials.xml"/>
<xi:include href="objectstoragemonitoring.xml"/> <xi:include href="objectstoragemonitoring.xml"/>

View File

@@ -2,30 +2,30 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" <project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion> <modelVersion>4.0.0</modelVersion>
<groupId>org.openstack.docs</groupId> <groupId>org.openstack.docs</groupId>
<artifactId>openstack-guide</artifactId> <artifactId>openstack-guide</artifactId>
<version>1.0.0-SNAPSHOT</version> <version>1.0.0-SNAPSHOT</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<name>OpenStack Guides</name> <name>OpenStack Administration Guides</name>
<properties> <properties>
<!-- This is set by Jenkins according to the branch. --> <!-- This is set by Jenkins according to the branch. -->
<release.path.name>unknown</release.path.name> <release.path.name>local</release.path.name>
<comments.enabled>1</comments.enabled> <comments.enabled>1</comments.enabled>
</properties> </properties>
<!-- ################################################ --> <!-- ################################################ -->
<!-- USE "mvn clean generate-sources" to run this POM --> <!-- USE "mvn clean generate-sources" to run this POM -->
<!-- ################################################ --> <!-- ################################################ -->
<build> <build>
<plugins> <plugins>
<plugin> <plugin>
<groupId>com.rackspace.cloud.api</groupId> <groupId>com.rackspace.cloud.api</groupId>
<artifactId>clouddocs-maven-plugin</artifactId> <artifactId>clouddocs-maven-plugin</artifactId>
<version>1.7.2</version> <version>1.8.0</version>
<executions> <executions>
<execution> <execution>
<id>generate-webhelp</id> <id>generate-webhelp</id>
@@ -39,28 +39,26 @@
<disqusShortname>openstackdocs</disqusShortname> <disqusShortname>openstackdocs</disqusShortname>
<enableGoogleAnalytics>1</enableGoogleAnalytics> <enableGoogleAnalytics>1</enableGoogleAnalytics>
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId> <googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
<generateToc> <generateToc> appendix toc,title
appendix toc,title article/appendix nop
article/appendix nop article toc,title
article toc,title book title,figure,table,example,equation
book title,figure,table,example,equation chapter toc,title
chapter toc,title section toc part
part toc,title toc,title
preface toc,title preface toc,title
qandadiv toc qandadiv toc
qandaset toc qandaset toc
reference toc,title reference toc,title
set toc,title set toc,title </generateToc>
</generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections--> <!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>0</sectionAutolabel> <sectionAutolabel>0</sectionAutolabel>
<tocDepthSection>1</tocDepthSection>
<sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel> <sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel>
<webhelpDirname>admin</webhelpDirname>
<webhelpDirname>admin</webhelpDirname> <targetDirectory>${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-object-storage</targetDirectory>
<targetDirectory>${basedir}/target/docbkx/webhelp/${release.path.name}/openstack-object-storage</targetDirectory> <includeDateInPdfFilename>0</includeDateInPdfFilename>
<includeDateInPdfFilename>0</includeDateInPdfFilename> <pdfFilenameBase>os-objectstorage-adminguide-${release.path.name}</pdfFilenameBase>
<pdfFilenameBase>os-objectstorage-adminguide-${release.path.name}</pdfFilenameBase>
</configuration> </configuration>
</execution> </execution>
<execution> <execution>
@@ -69,35 +67,33 @@
<goal>generate-webhelp</goal> <goal>generate-webhelp</goal>
</goals> </goals>
<phase>generate-sources</phase> <phase>generate-sources</phase>
<configuration> <configuration>
<includes>dummy.xml</includes> <includes>dummy.xml</includes>
<postProcess> <postProcess>
<delete includeemptydirs="true" verbose="true"> <delete includeemptydirs="true"
<fileset dir="${basedir}/target/docbkx/webhelp/${release.path.name}" > verbose="true">
<include name="**/*"/> <fileset
<exclude name="openstack-object-storage/**"/> dir="${basedir}/target/docbkx/webhelp/${release.path.name}">
</fileset> <include name="**/*"/>
</delete> <exclude name="openstack-object-storage/**"/>
</postProcess> </fileset>
</configuration> </delete>
</execution> </postProcess>
</configuration>
</execution>
</executions> </executions>
<configuration> <configuration>
<!-- These parameters apply to pdf and webhelp --> <!-- These parameters apply to pdf and webhelp -->
<xincludeSupported>true</xincludeSupported> <xincludeSupported>true</xincludeSupported>
<sourceDirectory>.</sourceDirectory> <sourceDirectory>.</sourceDirectory>
<includes> <includes> bk-objectstorage-adminguide.xml </includes>
bk-objectstorage-adminguide.xml
</includes>
<canonicalUrlBase>http://docs.openstack.org/${release.path.name}/openstack-object-storage/admin/content/</canonicalUrlBase> <canonicalUrlBase>http://docs.openstack.org/${release.path.name}/openstack-object-storage/admin/content/</canonicalUrlBase>
<profileSecurity>reviewer</profileSecurity> <profileSecurity>reviewer</profileSecurity>
<branding>openstack</branding> <branding>openstack</branding>
</configuration> </configuration>
</plugin> </plugin>
</plugins> </plugins>
</build> </build>
<profiles> <profiles>
<profile> <profile>
<id>Rackspace Research Repositories</id> <id>Rackspace Research Repositories</id>
@@ -120,5 +116,4 @@
</pluginRepositories> </pluginRepositories>
</profile> </profile>
</profiles> </profiles>
</project> </project>

View File

@@ -3,27 +3,32 @@
<html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head> <head>
<meta name="generator" content= <meta name="generator"
"HTML Tidy for Linux/x86 (vers 11 February 2007), see www.w3.org" /> content="HTML Tidy for Linux/x86 (vers 11 February 2007), see www.w3.org" />
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Type"
<meta name="google-site-verification" content= content="text/html; charset=us-ascii" />
"Ip5yk0nd8yQHEo8I7SjzVfAiadlHvTvqQHLGwn1GFyU" /> <meta name="google-site-verification"
content="Ip5yk0nd8yQHEo8I7SjzVfAiadlHvTvqQHLGwn1GFyU" />
<title>OpenStack Docs: current</title><!-- Google Fonts -->
<link href='http://fonts.googleapis.com/css?family=PT+Sans&amp;subset=latin' <title>OpenStack Docs: current</title>
rel='stylesheet' type='text/css' /><!-- Framework CSS --> <!-- Google Fonts -->
<link rel="stylesheet" href= <link
"http://openstack.org/themes/openstack/css/blueprint/screen.css" type= href="http://fonts.googleapis.com/css?family=PT+Sans&amp;subset=latin"
"text/css" media="screen, projection" /> rel="stylesheet" type="text/css" />
<link rel="stylesheet" href= <!-- Framework CSS -->
"http://openstack.org/themes/openstack/css/blueprint/print.css" type= <link rel="stylesheet"
"text/css" media="print" /> href="http://openstack.org/themes/openstack/css/blueprint/screen.css"
type="text/css" media="screen, projection" />
<link rel="stylesheet"
href="http://openstack.org/themes/openstack/css/blueprint/print.css"
type="text/css" media="print" />
<!--[if lt IE 8]><link rel="stylesheet" href="http://openstack.org/themes/openstack/css/blueprint/ie.css" type="text/css" media="screen, projection"><![endif]--> <!--[if lt IE 8]><link rel="stylesheet" href="http://openstack.org/themes/openstack/css/blueprint/ie.css" type="text/css" media="screen, projection"><![endif]-->
<!-- OpenStack Specific CSS --> <!-- OpenStack Specific CSS -->
<link rel="stylesheet" href= <link rel="stylesheet"
"http://openstack.org/themes/openstack/css/main.css" type="text/css" media= href="http://openstack.org/themes/openstack/css/main.css"
"screen, projection, print" /> type="text/css" media="screen, projection, print" />
<link rel="stylesheet" type="text/css" href="http://docs.openstack.org/common/css/docblitz.css" /> <link rel="stylesheet" type="text/css"
href="http://docs.openstack.org/common/css/docblitz.css" />
<!--<script type="text/javascript"> <!--<script type="text/javascript">
var _gaq = _gaq || []; var _gaq = _gaq || [];
@@ -39,158 +44,192 @@
</script>--> </script>-->
</head> </head>
<body class="docshome" id="docshome">
<div class="container">
<div id="header">
<div class="span-5">
<h1 id="logo"><a href="/">OpenStack</a></h1>
</div>
<div class="span-19 last blueLine">
<div id="navigation" class="span-19">
<ul id="Menu1">
<li><a href="http://www.openstack.org/" title="Go to the Home page">Home</a></li>
<li><a href="http://www.openstack.org/software/" title="Go to the Software page" class="link">Software</a></li>
<li><a href="http://www.openstack.org/user-stories/" title="Go to the User Stories page" class="link">User Stories</a></li>
<li><a href="http://www.openstack.org/community/" title="Go to the Community page" class="link">Community</a></li>
<li><a href="http://www.openstack.org/profile/" title="Go to the Profile page" class="link">Profile</a></li>
<li><a href="http://www.openstack.org/blog/" title="Go to the OpenStack Blog">Blog</a></li>
<li><a href="http://wiki.openstack.org/" title="Go to the OpenStack Wiki">Wiki</a></li>
<li><a href="http://docs.openstack.org/" title="Go to OpenStack Documentation" class="current">Documentation</a></li>
</ul>
<body class="docshome" id="docshome">
<div class="container">
<div id="header">
<div class="span-5">
<h1 id="logo"><a href="/">OpenStack</a></h1>
</div>
<div class="span-19 last blueLine">
<div id="navigation" class="span-19">
<ul id="Menu1">
<li><a href="http://www.openstack.org/"
title="Go to the Home page"
>Home</a></li>
<li><a
href="http://www.openstack.org/software/"
title="Go to the Software page"
class="link">Software</a></li>
<li><a
href="http://www.openstack.org/user-stories/"
title="Go to the User Stories page"
class="link">User Stories</a></li>
<li><a
href="http://www.openstack.org/community/"
title="Go to the Community page"
class="link">Community</a></li>
<li><a
href="http://www.openstack.org/profile/"
title="Go to the Profile page"
class="link">Profile</a></li>
<li><a
href="http://www.openstack.org/blog/"
title="Go to the OpenStack Blog"
>Blog</a></li>
<li><a href="http://wiki.openstack.org/"
title="Go to the OpenStack Wiki"
>Wiki</a></li>
<li><a href="http://docs.openstack.org/"
title="Go to OpenStack Documentation"
class="current"
>Documentation</a></li>
</ul>
</div>
</div> </div>
</div> </div>
</div> </div>
</div>
<!-- Page Content --> <!-- Page Content -->
<div class="container">
<div class="span-12">
<h3 class="subhead"><a href="http://docs.openstack.org/">Documentation</a> > Run </h3>
</div>
<div class="searchArea span-10 last">
<div id="cse" style="width: 100%;">
Loading
</div>
<script src="http://www.google.com/jsapi" type="text/javascript">
</script>
<script type="text/javascript">
//<![CDATA[
google.load('search', '1', {language : 'en'});
var _gaq = _gaq || [];
_gaq.push(["_setAccount", "UA-17511903-6"]);
function _trackQuery(control, searcher, query) {
var gaQueryParamName = "q";
var loc = document.location;
var url = [
loc.pathname,
loc.search,
loc.search ? '&' : '?',
gaQueryParamName == '' ? 'q' : encodeURIComponent(gaQueryParamName),
'=',
encodeURIComponent(query)
].join('');
_gaq.push(["_trackPageview", url]);
}
google.setOnLoadCallback(function() {
var customSearchControl = new google.search.CustomSearchControl('011012898598057286222:elxsl505o0o');
customSearchControl.setResultSetSize(google.search.Search.FILTERED_CSE_RESULTSET);
customSearchControl.setSearchStartingCallback(null, _trackQuery);
customSearchControl.draw('cse');
}, true);
//]]>
</script>
</div>
</div>
<div class="container"> <div class="container">
<div class="span-12"> <div class="span-12">
<h2><a href="http://docs.openstack.org/grizzly/openstack-block-storage/admin/content/">Block Storage Administration Guide</a> <h3 class="subhead"><a
</h2> href="http://docs.openstack.org/"
<p>For deployers and operators, offers information for OpenStack Block Storage (cinder). >Documentation</a> > Configure and Run </h3>
</p> <p>Configure and run OpenStack services.</p>
<h2><a href="http://docs.openstack.org/grizzly/openstack-compute/admin/content/">Compute Administration Guide</a> <p>&nbsp;</p>
</h2> </div>
<p>For deployers and operators, offers configuration information for OpenStack Compute (nova), Image (glance), and Identity (keystone). <div class="searchArea span-10 last">
</p> <div id="cse" style="width: 100%;"> Loading </div>
<h2><a href="http://docs.openstack.org/grizzly/openstack-network/admin/content/">Network Administration Guide <script src="http://www.google.com/jsapi" type="text/javascript">
</a> </script>
</h2> <script type="text/javascript">
<p>Provides network administrators and cloud deployers configuration information about Networking (quantum). //<![CDATA[
</p> google.load('search', '1', {
<h2><a href="http://docs.openstack.org/grizzly/openstack-object-storage/admin/content/">Object Storage Administration Guide</a> language: 'en'
</h2> });
<p>Describes configuration settings and operations information for Object Storage (swift) and Identity (keystone). var _gaq = _gaq ||[];
</p> _gaq.push([ "_setAccount", "UA-17511903-6"]);
function _trackQuery(control, searcher, query) {
var gaQueryParamName = "q";
var loc = document.location;
var url =[
loc.pathname,
loc.search,
loc.search ? '&': '?',
gaQueryParamName == '' ? 'q': encodeURIComponent(gaQueryParamName),
'=',
encodeURIComponent(query)].join('');
_gaq.push([ "_trackPageview", url]);
}
google.setOnLoadCallback(function () {
var customSearchControl = new google.search.CustomSearchControl('011012898598057286222:elxsl505o0o');
customSearchControl.setResultSetSize(google.search.Search.FILTERED_CSE_RESULTSET);
customSearchControl.setSearchStartingCallback(null, _trackQuery);
customSearchControl.draw('cse');
},
true);//]]>
</script>
</div>
</div>
<div class="container">
<div class="span-12">
<h2><a
href="http://docs.openstack.org/grizzly/openstack-block-storage/admin/content/"
>OpenStack Block Storage Service
Administration Guide</a>
</h2>
<p>Configure and run the OpenStack Block Storage
service. </p>
<h2><a
href="http://docs.openstack.org/grizzly/openstack-compute/admin/content/"
>OpenStack Compute Administration Guide</a>
</h2>
<p>Configure and run the OpenStack Compute, Image, and
Identity services. </p>
<h2><a
href="http://docs.openstack.org/grizzly/openstack-network/admin/content/"
>OpenStack Networking Administration Guide
</a>
</h2>
<p>Configure and run the OpenStack Networking service. </p>
<h2><a
href="http://docs.openstack.org/grizzly/openstack-object-storage/admin/content/"
>OpenStack Object Storage Administration
Guide</a>
</h2>
<p>Configure and run Openstack Object Storage and
Identity services. </p>
</div> </div>
<div class="span-12 last"> <div class="span-12 last">
<h2><a href="http://docs.openstack.org/folsom/openstack-ops/content/">OpenStack Operations Guide</a></h2> <h2><a
<p>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.</p> href="http://docs.openstack.org/folsom/openstack-ops/content/"
<h2><a href="http://docs.openstack.org/trunk/openstack-ha/content/index.html">OpenStack High Availability Guide</a></h2> >OpenStack Operations Guide</a></h2>
<p>Provides some guidance on minimizing system downtime and data loss in a production OpenStack environment.</p> <p>Make architecture decisions and perform day-to-day
</div> operations for OpenStack. This guide was written
</div> in a five-day book sprint in February 2013. For
stability, it targets the Folsom release.</p>
<p>&nbsp;</p>
<h2><a
href="http://docs.openstack.org/trunk/openstack-ha/content/index.html"
>OpenStack High Availability Guide</a></h2>
<p>Minimize system downtime and data loss in an
OpenStack production environment.</p>
</div>
</div> </div>
<div class="container"> <div class="container">
<div id="footer"> <div id="footer">
<hr /> <hr />
<p>Documentation treated like code, powered by the community - interested? Here's <a href="http://wiki.openstack.org/Documentation/HowTo">how to contribute</a>. </p> <p>Documentation treated like code, powered by the
<p>The OpenStack project is provided under the Apache 2.0 license. community - interested? Here's <a
Openstack.org is powered by <a href= href="http://wiki.openstack.org/Documentation/HowTo"
"http://www.rackspacecloud.com/">Rackspace Cloud Computing</a>.</p> >how to contribute</a>. </p>
<p>The OpenStack project is provided under the Apache
2.0 license. Openstack.org is powered by <a
href="http://www.rackspacecloud.com/"
>Rackspace Cloud Computing</a>.</p>
</div> </div>
</div> </div>
<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.js"></script> <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.js"></script>
<script src="http://docs.openstack.org/common/jquery/jquery.hoverIntent.minified.js" type="text/javascript" charset="utf-8"> <script src="http://docs.openstack.org/common/jquery/jquery.hoverIntent.minified.js" type="text/javascript" charset="utf-8">
</script> </script>
<script type="text/javascript" charset="utf-8"> <script type="text/javascript" charset="utf-8">
//<![CDATA[ //<![CDATA[
$(document).ready(function() { $(document).ready(function () {
function addMenu(){ function addMenu() {
$(".dropDown").addClass("menuHover"); $(".dropDown").addClass("menuHover");
} }
function removeMenu(){ function removeMenu() {
$(".dropDown").removeClass("menuHover"); $(".dropDown").removeClass("menuHover");
} }
var menuConfig = { var menuConfig = {
interval: 500, interval: 500,
sensitivity: 4, sensitivity: 4,
over: addMenu, over: addMenu,
timeout: 500, timeout: 500,
out: removeMenu out: removeMenu
}; };
$(".dropDownTrigger").hoverIntent(menuConfig); $(".dropDownTrigger").hoverIntent(menuConfig);
});//]]>
});
//]]>
</script> </script>
</body> </body>
</html> </html>