Commit af8f46b7 by Ilya Etingof

Configuration documentation migrated

Documentation layout aligned with the OS standards.

The admin page cleaned up - unrelated references moved
elsewhere linking merely admin pages.

The configuration page refactored, ironic.conf
and policy.conf documentation and samples
automatically generated by oslo_config.sphinxext.

Change-Id: I9075e2688f59ecd8ab5c489679f2c53d6294f28d
parent 60aec738
Administrator's Guide
=====================
Installation & Operations
-------------------------
If you are a system administrator running Ironic, this section contains
information that should help you understand how to deploy, operate, and upgrade
information that may help you understand how to operate and upgrade
the services.
.. toctree::
:maxdepth: 1
Installation Guide </install/index>
gmr
Upgrade Guide <upgrade-guide>
upgrade-to-hardware-types
Release Notes <http://docs.openstack.org/releasenotes/ironic/>
Troubleshooting FAQ <troubleshooting>
Configuration
-------------
There are many aspects of the Bare Metal service which are environment
specific. The following pages will be helpful in configuring specific aspects
of ironic that may or may not be suitable to every situation.
.. toctree::
:maxdepth: 1
Guide to Node Cleaning <cleaning>
Configuring Node Inspection <inspection>
Configuring RAID during deployment <raid>
Configuring to boot from volume <boot-from-volume>
Security considerations for your Bare Metal installation <security>
Adopting Nodes in an ACTIVE state <adoption>
Configuring for Multi-tenant Networking <multitenancy>
Configuring for port groups <portgroups>
Configuring node web or serial console <console>
Emitting software metrics <metrics>
Auditing API Traffic <api-audit-support>
Notifications <notifications>
Ceph Object Gateway support <radosgw>
/configuration/sample-config
/configuration/sample-policy
Enabling Drivers <drivers>
Ironic Python Agent <drivers/ipa>
Node Hardware Inspection <inspection>
Node Cleaning <cleaning>
Node Adoption <adoption>
RAID Configuration <raid>
Configuring to boot from volume <boot-from-volume>
Multi-tenant Networking <multitenancy>
Port Groups <portgroups>
Configuring Web or Serial Console <console>
Enabling Notifications <notifications>
Ceph Object Gateway <radosgw>
Emitting Software Metrics <metrics>
Auditing API Traffic <api-audit-support>
Service State Reporting <gmr>
Upgrade Guide <upgrade-guide>
Security <security>
Troubleshooting FAQ <troubleshooting>
Dashboard Integration
---------------------
......
......@@ -321,6 +321,11 @@ Upgrading from Ocata to Pike
Other upgrade instructions are in the `Pike release notes
<https://docs.openstack.org/releasenotes/ironic/pike.html>`_.
.. toctree::
:maxdepth: 1
upgrade-to-hardware-types.rst
Upgrading from Newton to Ocata
==============================
......
......@@ -21,7 +21,9 @@ extensions = ['sphinx.ext.autodoc',
'sphinxcontrib.pecanwsme.rest',
'sphinxcontrib.seqdiag',
'wsmeext.sphinxext',
'oslo_config.sphinxext',
'oslo_config.sphinxconfiggen',
'oslo_policy.sphinxext',
'oslo_policy.sphinxpolicygen',
]
......
=====================
Configuration Options
=====================
The following is an overview of all available configuration options in
Ironic. For a sample configuration file, refer to
:doc:`sample-config`.
.. show-options::
:config-file: tools/config/ironic-config-generator.conf
Configuration Guide
-------------------
=======================
Configuration Reference
=======================
Here are sample configuration files generated automatically for Ironic.
Many aspects of the Bare Metal service are specific to the environment
it is deployed in. The following pages describe configuration
options that can be used to adjust the service to your particular
situation.
.. toctree::
:maxdepth: 1
sample-config
sample-policy
Configuration Options <config>
Sample Config File <sample-config>
Policies <policy>
Sample Policy File <sample-policy>
========
Policies
========
The following is an overview of all available policies in Ironic. For
a sample configuration file, refer to :doc:`sample-policy`.
.. show-policy::
:config-file: tools/policy/ironic-policy-generator.conf
============================
Ironic Configuration Options
============================
=========================
Sample Configuration File
=========================
The following is a sample Ironic configuration for adaptation and use. It is
auto-generated from Ironic when this documentation is built, so
if you find issues with an option, please compare your version of
Ironic with the version of this documentation.
The following is a sample Ironic configuration for adaptation and use. For a
detailed overview of all available configuration options, refer to
:doc:`config`.
The sample configuration can also be downloaded as a :download:`file
The sample configuration can also be viewed in :download:`file form
</_static/ironic.conf.sample>`.
.. important::
The sample configuration file is auto-generated from Ironic when this
documentation is built. You must ensure your version of Ironic matches the
version of this documentation.
.. literalinclude:: /_static/ironic.conf.sample
......@@ -22,6 +22,22 @@ previous release of ironic, append the OpenStack release name to the URL; for
example, the ``ocata`` release is available at
http://docs.openstack.org/ironic/ocata/.
Installation Guide
==================
.. toctree::
:maxdepth: 2
install/index
Upgrade Guide
=============
.. toctree::
:maxdepth: 2
admin/upgrade-guide
User Guide
==========
......@@ -38,26 +54,14 @@ Administrator Guide
admin/index
Configuration Reference
=======================
Configuration Guide
===================
.. toctree::
:maxdepth: 2
configuration/index
Driver References
=================
Every driver author is expected to document the use and configuration of their
driver. These pages are linked below.
.. toctree::
:maxdepth: 1
Driver Documentation pages <admin/drivers>
Further Considerations for the Agent Drivers <admin/drivers/ipa>
Bare Metal API References
=========================
......@@ -90,6 +94,11 @@ Contributor Guide
contributor/index
Release Notes
=============
`Release Notes <http://docs.openstack.org/releasenotes/ironic/>`_
Indices and tables
==================
......
=====================================
Bare Metal service installation guide
Bare Metal Service Installation Guide
=====================================
The Bare Metal service is a collection of components that provides support to
......
.. _user-guide:
======================
Introduction to Ironic
======================
=============================
Bare Metal Service User Guide
=============================
Ironic is an OpenStack project which provisions bare metal (as opposed to
virtual) machines. It may be used independently or as part of an OpenStack
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment