Merge "bug 1192994 Describe the project code name change from Quantum to Neutron. Replace the Quantum references for Neutron in preface, install, use and config sections."

This commit is contained in:
Jenkins 2013-06-30 03:01:32 +00:00 committed by Gerrit Code Review
commit 5826c91473
4 changed files with 43 additions and 39 deletions

View File

@ -211,13 +211,11 @@ catalog.$Region.network.name = Network Service</programlisting>
</section> </section>
<section xml:id="nova_config_metadata"> <section xml:id="nova_config_metadata">
<title>Metadata Configuration</title> <title>Metadata Configuration</title>
<para>The OpenStack Compute service allows VMs to query metadata <para>The OpenStack Compute service allows VMs to query metadata associated with a VM by
associated with a VM by making a web request to a special making a web request to a special 169.254.169.254 address. Neutron supports proxying
169.254.169.254 address. Quantum supports proxying those those requests to nova-api, even when the requests are made from isolated networks,
requests to nova-api, even when the requests are made from isolated or from multiple networks that use overlapping IP addresses. Enabling this requires
networks, or from multiple networks that use overlapping IP addresses. setting the following fields in nova.conf: </para>
Enabling this requires setting the following fields in nova.conf:
</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>

View File

@ -389,8 +389,8 @@ interface_driver = quantum.agent.linux.interface.OVSInterfaceDriver
</section> </section>
<section xml:id="install_quantum-l3"> <section xml:id="install_quantum-l3">
<title>Install L3 Agent</title> <title>Install L3 Agent</title>
<para>Quantum has a widely used API extension to allow administrators and tenants to create "routers" that <para>Neutron has a widely used API extension to allow administrators and tenants to
connect to L2 networks.</para> create "routers" that connect to L2 networks.</para>
<para>Many plugins rely on the L3 service agent to implement this L3 functionality. <para>Many plugins rely on the L3 service agent to implement this L3 functionality.
However, the following plugins have built in L3 capabilities: However, the following plugins have built in L3 capabilities:
</para> </para>

View File

@ -4,11 +4,18 @@
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="ch_preface"> xml:id="ch_preface">
<title>Preface</title> <title>Preface</title>
<para>OpenStack Networking was created to provide a rich and <para>OpenStack Networking was created to provide a rich and tenant-facing
tenant-facing API for defining network connectivity and API for defining network connectivity and addressing in the cloud.
addressing in the cloud. The project, code-named "quantum," The project, code-named "Neutron" (formerly known as Quantum), gives
gives operators the ability to leverage different networking operators the ability to leverage different networking technologies to
technologies to power their cloud networking.   </para> power their cloud networking. </para>
<para>The Board of Directors and Technical Committee members involved in
Networking related development and documentation has decided to change
the project name to "Neutron", as part of a legal agreement with Quantum
Corporation, the owner of the "Quantum" trademark.</para>
<para>Any references to the previous project code name will be removed in this guide whenever is
possible, all the configuration files will change in Havana release and this guide will be
updated respectively.</para>
<section xml:id="Intended_Audience-d1e85"> <section xml:id="Intended_Audience-d1e85">
<title>Intended Audience</title> <title>Intended Audience</title>
<para>This guide assists OpenStack administrators in <para>This guide assists OpenStack administrators in
@ -87,19 +94,17 @@
</section> </section>
<section xml:id="resources"> <section xml:id="resources">
<title>Resources</title> <title>Resources</title>
<para>For more information on OpenStack Networking and the <para>For more information on OpenStack Networking and the other network-related projects,
other network-related projects, see the project page on see the project page on the OpenStack wiki (<link
the OpenStack wiki (<link xlink:href="https://wiki.openstack.org/wiki/Neutron"
xlink:href="http://wiki.openstack.org/Quantum" >wiki.openstack.org/Neutron</link>). </para>
>wiki.openstack.org/Quantum</link>). </para>
<para>For information about programming against the OpenStack <para>For information about programming against the OpenStack
Networking API, see the <link Networking API, see the <link
xlink:href="http://docs.openstack.org/api/openstack-network/2.0/content/" xlink:href="http://docs.openstack.org/api/openstack-network/2.0/content/"
><citetitle>OpenStack Networking API Guide ><citetitle>OpenStack Networking API Guide
(v2.0)</citetitle></link>.</para> (v2.0)</citetitle></link>.</para>
<para>We welcome feedback, comments, and bug reports at <link <para>We welcome feedback, comments, and bug reports at <link
xlink:href="http://bugs.launchpad.net/Quantum" xlink:href="https://bugs.launchpad.net/neutron">bugs.launchpad.net/Neutron</link>. </para>
>bugs.launchpad.net/Quantum</link>. </para>
</section> </section>
<?hard-pagebreak?> <?hard-pagebreak?>
</preface> </preface>

View File

@ -15,15 +15,12 @@
admin on behalf of the tenant.  </para> admin on behalf of the tenant.  </para>
<section xml:id="api_features"> <section xml:id="api_features">
<title>Core OpenStack Networking API Features</title> <title>Core OpenStack Networking API Features</title>
<para>Once OpenStack Networking is installed and running, both tenants and <para>Once OpenStack Networking is installed and running, both tenants and admins primarily
admins primarily interact with the service via interact with the service via create-read-update-delete (CRUD) API operations performed
create-read-update-delete (CRUD) API operations performed either directly against the API, or more commonly via the 'neutron' CLI tool.  Like
either directly against the API, or more commonly via the other OpenStack CLI tools, the 'neutron' tool is just a basic wrapper around the
'quantum' CLI tool.  Like other OpenStack CLI tools, the OpenStack Networking API, so any operation that can be performed via the CLI has an
'quantum' tool is just a basic wrapper around the OpenStack Networking equivalent API call that can be performed programmatically.  </para>
API, so any operation that can be performed via the CLI
has an equivalent API call that can be performed
programmatically.  </para>
<para>The CLI supports many options for filtering results, limiting fields show, etc.  For <para>The CLI supports many options for filtering results, limiting fields show, etc.  For
details, refer to the OpenStack Networking CLI documentation.   </para> details, refer to the OpenStack Networking CLI documentation.   </para>
<section xml:id="api_abstractions"> <section xml:id="api_abstractions">
@ -442,21 +439,25 @@ nova boot --image &lt;img&gt; --flavor &lt;flavor&gt; --nic port-id=&lt;port-id&
</section> </section>
<section xml:id="enabling_ping_and_ssh"> <section xml:id="enabling_ping_and_ssh">
<title>Security Groups (Enabling Ping and SSH on VMs)</title> <title>Security Groups (Enabling Ping and SSH on VMs)</title>
<para>If using a plugin that implements quantum security groups you can configure security group rules directly <para>If using a plugin that implements neutron security groups you can configure security
by using quantum security-group-rule-create to enable access to your VMs. The example below allows <command>ping</command> group rules directly by using quantum security-group-rule-create to enable access to
and <command>ssh</command> to your VMs. your VMs. The example below allows <command>ping</command> and
<command>ssh</command> to your VMs.
<screen> <screen>
<prompt>$</prompt> <userinput>quantum security-group-rule-create --protocol icmp --direction ingress default</userinput> <prompt>$</prompt> <userinput>quantum security-group-rule-create --protocol icmp --direction ingress default</userinput>
<prompt>$</prompt> <userinput>quantum security-group-rule-create --protocol tcp --port-range-min 22 --port-range-max 22 --direction ingress default</userinput> <prompt>$</prompt> <userinput>quantum security-group-rule-create --protocol tcp --port-range-min 22 --port-range-max 22 --direction ingress default</userinput>
</screen></para> </screen></para>
<para>If your plugin does not implement quantum security group, security groups can still be leveraged via OpenStack Compute. <para>If your plugin does not implement neutron security group, security groups can still be
This can be done using <command>nova secgroup-add-rule</command> or <command>euca-authorize</command> command to enable accesses to your VMs. leveraged via OpenStack Compute. This can be done using <command>nova
Below are the nova commands to allow <command>ping</command> and <command>ssh</command> to your VMs.</para> secgroup-add-rule</command> or <command>euca-authorize</command> command to
enable accesses to your VMs. Below are the nova commands to allow
<command>ping</command> and <command>ssh</command> to your VMs.</para>
<screen> <screen>
<prompt>$</prompt> <userinput>nova secgroup-add-rule default icmp -1 -1 0.0.0.0/0</userinput> <prompt>$</prompt> <userinput>nova secgroup-add-rule default icmp -1 -1 0.0.0.0/0</userinput>
<prompt>$</prompt> <userinput>nova secgroup-add-rule default tcp 22 22 0.0.0.0/0</userinput></screen> <prompt>$</prompt> <userinput>nova secgroup-add-rule default tcp 22 22 0.0.0.0/0</userinput></screen>
<note><para>If your plugin implements quantum security groups you can still leverage nova security groups by setting security_group_api = quantum in <filename>nova.conf</filename>. <note><para>If your plugin implements neutron security groups you can still leverage nova security groups
After setting this all nova security group commands will be proxied to quantum.</para></note></section> by setting security_group_api = quantum in <filename>nova.conf</filename>. After
setting this all nova security group commands will be proxied to quantum.</para></note></section>
</section> </section>
</chapter> </chapter>