Document Juno EOL

Juno is EOL in code repositories, mark the Juno guides as frozen
as well.

Since Juno is EOL-ed, there's no stable/juno branch anymore, we need to
use juno-eol instead of stable/juno.

Change-Id: I1115dc8009d31d56e62290ca4019c910993b0433
This commit is contained in:
Andreas Jaeger 2015-12-07 14:03:02 +01:00
parent 12be9cb2ab
commit 304d14ffb9
13 changed files with 61 additions and 40 deletions

View File

@ -7,6 +7,17 @@
<title>Preface</title>
<?dbhtml stop-chunking?>
<warning>
<para>
This guide documents OpenStack Juno release and is frozen
since OpenStack Juno has reached its official end-of-life and
will not get any updates by the OpenStack project anymore.
Check the <link
xlink:href="http://docs.openstack.org/">OpenStack
Documentation page</link> for newer documents.
</para>
</warning>
<xi:include href="section_conventions.xml"/>
<xi:include href="section_dochistory.xml"/>
</preface>

View File

@ -10,26 +10,26 @@
<para>Use the <filename>cinder.conf</filename> file to configure the
majority of the Block Storage service options.</para>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/cinder.conf.sample?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/cinder.conf.sample?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_cinder-api-paste.ini">
<title>api-paste.ini</title>
<para>Use the <filename>api-paste.ini</filename> file to configure the Block Storage API service.</para>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/api-paste.ini?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/api-paste.ini?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_cinder-policy.json">
<title>policy.json</title>
<para>The <filename>policy.json</filename> file defines additional access controls that apply to the Block Storage service.</para>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/policy.json?h=stable/juno"/></programlisting>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/policy.json?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_cinder-rootwrap.conf">
<title>rootwrap.conf</title>
<para>The <filename>rootwrap.conf</filename> file defines configuration values used by the
<command>rootwrap</command> script when the Block Storage service must escalate its
privileges to those of the root user.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/rootwrap.conf?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/cinder/plain/etc/cinder/rootwrap.conf?h=juno-eol"/></programlisting>
</section>
</section>

View File

@ -25,6 +25,16 @@
<listitem><para>Telemetry</para></listitem>
<listitem><para>Orchestration</para></listitem>
</itemizedlist>
<warning>
<para>This guide documents the OpenStack Juno release. In
accordance with the official OpenStack Juno end-of-life, this
document is frozen and will receive no further updates from the
OpenStack project. Check the <link
xlink:href="http://docs.openstack.org/">OpenStack Documentation
page</link> for newer documents.
</para>
</warning>
<xi:include href="../common/section_conventions.xml"/>
<xi:include href="../common/section_dochistory.xml"/>
<xi:include href="../common/section_config_format.xml"/>

View File

@ -40,7 +40,7 @@
href="../common/tables/swift-object-server-filter-xprofile.xml"/>
<section xml:id="object-server-conf">
<title>Sample object server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/object-server.conf-sample?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/object-server.conf-sample?h=juno-eol"/></programlisting>
</section>
</section>
<section xml:id="object-expirer-configuration">
@ -65,7 +65,7 @@
href="../common/tables/swift-object-expirer-pipeline-main.xml"/>
<section xml:id="object-expirer-conf">
<title>Sample object expirer configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/object-expirer.conf-sample?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/object-expirer.conf-sample?h=juno-eol"/></programlisting>
</section>
</section>
<section xml:id="container-server-configuration">
@ -97,7 +97,7 @@
href="../common/tables/swift-container-server-filter-xprofile.xml"/>
<section xml:id="container-server-conf">
<title>Sample container server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/container-server.conf-sample?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/container-server.conf-sample?h=juno-eol"/></programlisting>
</section>
</section>
@ -115,7 +115,7 @@
href="../common/tables/swift-container-sync-realms-realm2.xml"/>
<section xml:id="container-sync-realms-conf">
<title>Sample container sync realms configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/container-sync-realms.conf-sample?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/container-sync-realms.conf-sample?h=juno-eol"/></programlisting>
</section>
</section>
<section xml:id="container-reconciler-configuration">
@ -171,7 +171,7 @@
href="../common/tables/swift-account-server-filter-xprofile.xml"/>
<section xml:id="account-server-conf">
<title>Sample account server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/account-server.conf-sample?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/account-server.conf-sample?h=juno-eol"/></programlisting>
</section>
</section>
<section xml:id="proxy-server-configuration">
@ -214,7 +214,7 @@
href="../common/tables/swift-proxy-server-filter-xprofile.xml"/>
<section xml:id="proxy-server-conf">
<title>Sample proxy server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/proxy-server.conf-sample?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/swift/plain/etc/proxy-server.conf-sample?h=juno-eol"/></programlisting>
</section>
</section>
<section xml:id="swift-memcache-configuration">

View File

@ -10,14 +10,14 @@
<para>The Compute service stores its API configuration settings in the
<filename>api-paste.ini</filename> file.</para>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/nova/plain/etc/nova/api-paste.ini?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/nova/plain/etc/nova/api-paste.ini?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_nova-policy.json">
<title>policy.json</title>
<para>The <filename>policy.json</filename> file defines additional access controls that apply to the Compute service.</para>
<programlisting language="json">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/nova/plain/etc/nova/policy.json?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/nova/plain/etc/nova/policy.json?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_nova-rootwrap.conf">
@ -26,7 +26,7 @@
values used by the rootwrap script when the Compute service
needs to escalate its privileges to those of the root user.</para>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/nova/plain/etc/nova/rootwrap.conf?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/nova/plain/etc/nova/rootwrap.conf?h=juno-eol"/>
</programlisting>
</section>
</section>

View File

@ -11,7 +11,7 @@
<title>keystone.conf</title>
<para>Use the <filename>keystone.conf</filename> file to
configure most Identity service options:</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/keystone.conf.sample?h=stable/juno"/>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/keystone.conf.sample?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_keystone-paste.ini">
@ -19,7 +19,7 @@
<para>Use the <filename>keystone-paste.ini</filename> file to
configure the Web Service Gateway Interface (WSGI)
middleware pipeline for the Identity service.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/keystone-paste.ini?h=stable/juno"/>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/keystone-paste.ini?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_keystone-logging.conf">
@ -31,7 +31,7 @@
<para>For details, see the (<link
xlink:href="http://docs.python.org/2/howto/logging.html#configuring-logging"
>Python logging module documentation</link>).</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/logging.conf.sample?h=stable/juno"/>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/logging.conf.sample?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_keystone-policy.json">
@ -39,7 +39,7 @@
<para>Use the <filename>policy.json</filename> file to define
additional access controls that apply to the Identity
service.</para>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/policy.json?h=stable/juno"/></programlisting>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/keystone/plain/etc/policy.json?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_keystone-domain-configs">
<title>Domain-specific configuration</title>

View File

@ -12,7 +12,7 @@
<para>The configuration file for the Image Service API is found in the
<filename>glance-api.conf</filename> file.</para>
<para>This file must be modified after installation.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-api.conf?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-api.conf?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_glance-registry.conf">
<title>glance-registry.conf</title>
@ -20,20 +20,20 @@
stores the metadata about images, is found in the
<filename>glance-registry.conf</filename> file.</para>
<para>This file must be modified after installation.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-registry.conf?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-registry.conf?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_glance-api-paste.conf">
<title>glance-api-paste.ini</title>
<para>Configuration for the Image Service's API middleware pipeline is found in the
<filename>glance-api-paste.ini</filename> file.</para>
<para>You should not need to modify this file.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-api-paste.ini?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-api-paste.ini?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_glance-registry-paste.conf">
<title>glance-registry-paste.ini</title>
<para>The Image Service's middleware pipeline for its registry is found in the
<filename>glance-registry-paste.ini</filename> file.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-registry-paste.ini?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-registry-paste.ini?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_glance-scrubber.conf">
<title>glance-scrubber.conf</title>
@ -47,12 +47,12 @@
<systemitem>cleanup_scrubber</systemitem> coordinates other
<systemitem>glance-scrubber</systemitem> instances by maintaining the master queue
of images that need to be removed.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-scrubber.conf?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/glance-scrubber.conf?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_glance-policy.json">
<title>policy.json</title>
<para>The <filename>/etc/glance/policy.json</filename> file defines additional access controls
that apply to the Image Service.</para>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/policy.json?h=stable/juno"/></programlisting>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/glance/plain/etc/policy.json?h=juno-eol"/></programlisting>
</section>
</section>

View File

@ -10,14 +10,14 @@
<para>Use the <filename>neutron.conf</filename> file to configure the
majority of the OpenStack Networking options.</para>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/neutron.conf?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/neutron.conf?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_neutron-api-paste.ini">
<title>api-paste.ini</title>
<para>Use the <filename>api-paste.ini</filename> to configure the OpenStack Networking API.</para>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/api-paste.ini?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/api-paste.ini?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_neutron-policy.json">
@ -25,7 +25,7 @@
<para>Use the <filename>policy.json</filename> file to define additional access controls
that apply to the OpenStack Networking service.</para>
<programlisting language="json">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/policy.json?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/policy.json?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_neutron-rootwrap.conf">
@ -34,7 +34,7 @@
<command>rootwrap</command> script when the OpenStack Networking service must escalate its
privileges to those of the root user.</para>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/rootwrap.conf?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/rootwrap.conf?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_plugin-agent-conf">
@ -45,25 +45,25 @@
<section xml:id="section_neutron-dhcp_agent.ini">
<title>dhcp_agent.ini</title>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/dhcp_agent.ini?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/dhcp_agent.ini?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_neutron-l3_agent.ini.conf">
<title>l3_agent.ini</title>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/l3_agent.ini?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/l3_agent.ini?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_neutron-lbaas_agent.ini">
<title>lbaas_agent.ini</title>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/lbaas_agent.ini?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/lbaas_agent.ini?h=juno-eol"/>
</programlisting>
</section>
<section xml:id="section_neutron-metadata_agent.ini">
<title>metadata_agent.ini</title>
<programlisting language="ini">
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/metadata_agent.ini?h=stable/juno"/>
<xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/metadata_agent.ini?h=juno-eol"/>
</programlisting>
</section>
</section>

View File

@ -22,7 +22,7 @@
events received from other OpenStack components should be translated
to Telemetry samples.</para>
<para>You should not need to modify this file.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/ceilometer/plain/etc/ceilometer/event_definitions.yaml?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/ceilometer/plain/etc/ceilometer/event_definitions.yaml?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_pipeline.yaml">
<title>pipeline.yaml</title>
@ -31,13 +31,13 @@
data. They are defined in the <filename>pipeline.yaml</filename>
file.</para>
<para>You should not need to modify this file.</para>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/ceilometer/plain/etc/ceilometer/pipeline.yaml?h=stable/juno"/></programlisting>
<programlisting language="ini"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/ceilometer/plain/etc/ceilometer/pipeline.yaml?h=juno-eol"/></programlisting>
</section>
<section xml:id="section_ceilometer-policy.json">
<title>policy.json</title>
<para>The <filename>policy.json</filename> file defines additional
access controls that apply to the Telemetry service.</para>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/ceilometer/plain/etc/ceilometer/policy.json?h=stable/juno"/></programlisting>
<programlisting language="json"><xi:include parse="text" href="http://git.openstack.org/cgit/openstack/ceilometer/plain/etc/ceilometer/policy.json?h=juno-eol"/></programlisting>
</section>
<!-- TODO(gpocentek): include sources.json -->
</section>

View File

@ -113,7 +113,7 @@
<para>Obtain the proxy service configuration file from the Object
Storage source repository:</para>
<screen><prompt>#</prompt> <userinput>curl -o /etc/swift/proxy-server.conf \
https://raw.githubusercontent.com/openstack/swift/stable/juno/etc/proxy-server.conf-sample</userinput></screen>
https://raw.githubusercontent.com/openstack/swift/juno-eol/etc/proxy-server.conf-sample</userinput></screen>
</step>
<step>
<para>Edit the <filename>/etc/swift/proxy-server.conf</filename>

View File

@ -11,7 +11,7 @@
<para>Obtain the <filename>/etc/swift/swift.conf</filename> file from
the Object Storage source repository:</para>
<screen><prompt>#</prompt> <userinput>curl -o /etc/swift/swift.conf \
https://raw.githubusercontent.com/openstack/swift/stable/juno/etc/swift.conf-sample</userinput></screen>
https://raw.githubusercontent.com/openstack/swift/juno-eol/etc/swift.conf-sample</userinput></screen>
</step>
<step>
<para>Edit the <filename>/etc/swift/swift.conf</filename> file and

View File

@ -191,11 +191,11 @@ lock file = /var/lock/object.lock</programlisting>
<para>Obtain the accounting, container, and object service configuration
files from the Object Storage source repository:</para>
<screen><prompt>#</prompt> <userinput>curl -o /etc/swift/account-server.conf \
https://raw.githubusercontent.com/openstack/swift/stable/juno/etc/account-server.conf-sample</userinput></screen>
https://raw.githubusercontent.com/openstack/swift/juno-eol/etc/account-server.conf-sample</userinput></screen>
<screen><prompt>#</prompt> <userinput>curl -o /etc/swift/container-server.conf \
https://raw.githubusercontent.com/openstack/swift/stable/juno/etc/container-server.conf-sample</userinput></screen>
https://raw.githubusercontent.com/openstack/swift/juno-eol/etc/container-server.conf-sample</userinput></screen>
<screen><prompt>#</prompt> <userinput>curl -o /etc/swift/object-server.conf \
https://raw.githubusercontent.com/openstack/swift/stable/juno/etc/object-server.conf-sample</userinput></screen>
https://raw.githubusercontent.com/openstack/swift/juno-eol/etc/object-server.conf-sample</userinput></screen>
</step>
<step>
<para>Edit the

View File

@ -99,7 +99,7 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
<step os="opensuse;sles;fedora;rhel;centos;ubuntu">
<para os="fedora;rhel;centos">Get the <filename>api-paste.ini</filename> file and save it to <filename>/etc/trove</filename>. You can get the file from this location:</para>
<para os="fedora;rhel;centos"><link xlink:href="http://git.openstack.org/cgit/openstack/trove/plain/etc/trove/api-paste.ini?h=stable/juno">http://git.openstack.org/cgit/openstack/trove/plain/etc/trove/api-paste.ini?h=stable/juno</link></para>
<para os="fedora;rhel;centos"><link xlink:href="http://git.openstack.org/cgit/openstack/trove/plain/etc/trove/api-paste.ini?h=juno-eol">http://git.openstack.org/cgit/openstack/trove/plain/etc/trove/api-paste.ini?h=juno-eol</link></para>
<para>Edit the <literal>[filter:authtoken]</literal> section
of the <filename>api-paste.ini</filename> file so it matches the
listing shown below:</para>