openstack/ironic
Code Issues Proposed changes

Fix small issues in the installation documentation

Browse Source 
Fixes nits spotted on the following reviews:
* https://review.openstack.org/#/c/461834/
* https://review.openstack.org/#/c/462151/
* https://review.openstack.org/#/c/466741/
* https://review.openstack.org/#/c/466734/

Also updated links in the touched files.

Related-Bug: #1524745
Change-Id: I12cfbbd4cbdd9423f86d0b3d9f4209427313c472
This commit is contained in:
Dmitry Tantsur 2017-07-24 16:59:41 +02:00
parent 7cbcb6003d
commit fe295ffb5a
6 changed files with 43 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
doc/source/admin/drivers/ipmitool.rst
View File

@ -32,10 +32,10 @@ Glossary
* BMC_ - Baseboard Management Controller. * BMC_ - Baseboard Management Controller.
* RMCP - Remote Management Control Protocol. * RMCP - Remote Management Control Protocol.
Enabling the IPMITool driver(s) Enabling the IPMItool driver(s)
=============================== ===============================
Please see `IPMI configuration guide`_ for the required dependencies. Please see :doc:`/install/configure-ipmi` for the required dependencies.
#. The ``ipmi`` hardware type is enabled by default starting with the Ocata #. The ``ipmi`` hardware type is enabled by default starting with the Ocata
release. To enable it explicitly, add the following to your ``ironic.conf``: release. To enable it explicitly, add the following to your ``ironic.conf``:
@ -46,7 +46,7 @@ Please see `IPMI configuration guide`_ for the required dependencies.
enabled_hardware_types = ipmi enabled_hardware_types = ipmi
#. The ``pxe_ipmitool`` classic driver is enabled by default. To enable one or #. The ``pxe_ipmitool`` classic driver is enabled by default. To enable one or
more of the other ipmitool classic drivers, add them to the more of the other IPMI classic drivers, add them to the
``enabled_drivers`` configuration option in your ``ironic.conf``. ``enabled_drivers`` configuration option in your ``ironic.conf``.
The following enables ``pxe_ipmitool`` and ``agent_ipmitool`` drivers: The following enables ``pxe_ipmitool`` and ``agent_ipmitool`` drivers:
@ -57,14 +57,14 @@ Please see `IPMI configuration guide`_ for the required dependencies.
#. Restart the Ironic conductor service. #. Restart the Ironic conductor service.
Please see `documentation on enabling drivers`_ for more details. Please see :doc:`/install/enabling-drivers` for more details.
Registering a node with the IPMItool driver Registering a node with the IPMItool driver
=========================================== ===========================================
Nodes configured to use the IPMItool drivers should have the driver field set Nodes configured to use the IPMItool drivers should have the ``driver`` field
to ``ipmi`` (hardware type) or to the name of one of the classic drivers set to ``ipmi`` (hardware type) or to the name of one of the classic drivers
that support ipmitool. that support IPMItool.
The following configuration value is required and has to be added to The following configuration value is required and has to be added to
the node's ``driver_info`` field: the node's ``driver_info`` field:
@ -85,7 +85,7 @@ good practice to have them set:
your BMC. your BMC.
The ``ironic node-create`` command can be used to enroll a node with The ``ironic node-create`` command can be used to enroll a node with
an IPMITool-based driver. For example:: an IPMItool-based driver. For example::
ironic node-create -d ipmi -i ipmi_address=<address> \ ironic node-create -d ipmi -i ipmi_address=<address> \
-i ipmi_username=<username> -i ipmi_password=<password> -i ipmi_username=<username> -i ipmi_password=<password>
@ -105,7 +105,7 @@ Single/Double bridging functionality
the bridging functionality. the bridging functionality.
There are two different bridging functionalities supported by the There are two different bridging functionalities supported by the
IPMITool-based drivers: *single* bridge and *dual* bridge. IPMItool-based drivers: *single* bridge and *dual* bridge.
The following configuration values need to be added to the node's The following configuration values need to be added to the node's
``driver_info`` field so bridging can be used: ``driver_info`` field so bridging can be used:
@ -177,5 +177,3 @@ protocol version::
.. _IPMItool: https://sourceforge.net/projects/ipmitool/ .. _IPMItool: https://sourceforge.net/projects/ipmitool/
.. _IPMI: https://en.wikipedia.org/wiki/Intelligent_Platform_Management_Interface .. _IPMI: https://en.wikipedia.org/wiki/Intelligent_Platform_Management_Interface
.. _BMC: https://en.wikipedia.org/wiki/Intelligent_Platform_Management_Interface#Baseboard_management_controller .. _BMC: https://en.wikipedia.org/wiki/Intelligent_Platform_Management_Interface#Baseboard_management_controller
.. _IPMI configuration guide: https://docs.openstack.org/project-install-guide/baremetal/draft/configure-ipmi.html
.. _documentation on enabling drivers: https://docs.openstack.org/project-install-guide/baremetal/draft/enabling-drivers.html

2
doc/source/install/configure-pxe.rst
View File

@ -188,7 +188,7 @@ steps on the ironic conductor node to configure the PXE UEFI environment.
It redirects it to specific grub config file based on DHCP IP assigned to It redirects it to specific grub config file based on DHCP IP assigned to
baremetal node. baremetal node.
.. literalinclude:: ../../ironic/drivers/modules/master_grub_cfg.txt .. literalinclude:: ../../../ironic/drivers/modules/master_grub_cfg.txt
Change the permission of grub.cfg:: Change the permission of grub.cfg::

45
doc/source/install/enabling-drivers.rst
View File

@ -37,7 +37,7 @@ configuration option, for example:
[DEFAULT] [DEFAULT]
enabled_hardware_types = ipmi,redfish enabled_hardware_types = ipmi,redfish
However, due to their dynamic nature, they also require configuring enabled Due to the driver's dynamic nature, they also require configuring enabled
hardware interfaces. hardware interfaces.
.. note:: .. note::
@ -61,9 +61,11 @@ boot
enabled_boot_interfaces = pxe,ilo-virtual-media enabled_boot_interfaces = pxe,ilo-virtual-media
Boot interfaces with ``pxe`` in their name require :doc:`configure-pxe`. Boot interfaces with ``pxe`` in their name require :doc:`configure-pxe`.
There are also a few hardware-specific boot interfaces - see
:doc:`/admin/drivers` for their required configuration.
console console
manages access to the serial console of a bare metal node. manages access to the serial console of a bare metal node.
See `Configuring Web or Serial Console`_ for details. See :doc:`/admin/console` for details.
deploy deploy
defines how the image gets transferred to the target disk. defines how the image gets transferred to the target disk.
@ -92,7 +94,7 @@ inspect
enabled_hardware_types = ipmi,ilo,irmc enabled_hardware_types = ipmi,ilo,irmc
enabled_inspect_interfaces = ilo,irmc,inspector enabled_inspect_interfaces = ilo,irmc,inspector
See `inspection documentation`_ for more details. See :doc:`/admin/inspection` for more details.
management management
provides additional hardware management actions, like getting or setting provides additional hardware management actions, like getting or setting
boot devices. This interface is usually vendor-specific, and its name boot devices. This interface is usually vendor-specific, and its name
@ -106,7 +108,7 @@ management
enabled_management_interfaces = ipmitool,redfish,ilo,irmc enabled_management_interfaces = ipmitool,redfish,ilo,irmc
Using ``ipmitool`` requires :doc:`configure-ipmi`. See Using ``ipmitool`` requires :doc:`configure-ipmi`. See
`driver-specific documentation`_ for required configuration of each driver. :doc:`/admin/drivers` for the required configuration of each driver.
network network
connects/disconnects bare metal nodes to/from virtual networks. This is connects/disconnects bare metal nodes to/from virtual networks. This is
the only interface that is also pluggable for classic drivers. See the only interface that is also pluggable for classic drivers. See
@ -123,11 +125,11 @@ power
enabled_power_interfaces = ipmitool,redfish,ilo,irmc enabled_power_interfaces = ipmitool,redfish,ilo,irmc
Using ``ipmitool`` requires :doc:`configure-ipmi`. See Using ``ipmitool`` requires :doc:`configure-ipmi`. See
`driver-specific documentation`_ for required configuration of each driver. :doc:`/admin/drivers` for the required configuration of each driver.
raid raid
manages building and tearing down RAID on nodes. Similar to inspection, manages building and tearing down RAID on nodes. Similar to inspection,
it can be implemented either out-of-band or in-band (via ``agent`` it can be implemented either out-of-band or in-band (via ``agent``
implementation). See `RAID documentation`_ for details. implementation). See :doc:`/admin/raid` for details. For example:
.. code-block:: ini .. code-block:: ini
@ -135,8 +137,8 @@ raid
enabled_hardware_types = ipmi,redfish,ilo,irmc enabled_hardware_types = ipmi,redfish,ilo,irmc
enabled_raid_interfaces = agent,no-raid enabled_raid_interfaces = agent,no-raid
vendor vendor
is a place for vendor extensions to be exposed in API. See `vendor is a place for vendor extensions to be exposed in API. See
methods documentation`_ for details. :doc:`/contributor/vendor-passthru` for details.
.. code-block:: ini .. code-block:: ini
@ -213,23 +215,23 @@ respectively:
This is because the ``redfish`` hardware type will have different enabled This is because the ``redfish`` hardware type will have different enabled
*deploy* interfaces on these conductors. It would have been fine, if the second *deploy* interfaces on these conductors. It would have been fine, if the second
conductor had ``enabled_deploy_interface=direct`` instead of ``iscsi``. conductor had ``enabled_deploy_interfaces = direct`` instead of ``iscsi``.
This situation is not detected by the Bare Metal service, but it can cause This situation is not detected by the Bare Metal service, but it can cause
inconsistent behavior in the API, when node functionality will depend on inconsistent behavior in the API, when node functionality will depend on
which conductor it gets assigned to. which conductor it gets assigned to.
.. note:: .. note::
We don't treat it as an error, because such *temporary* inconsistency is We don't treat this as an error, because such *temporary* inconsistency is
inevitable during a rolling upgrade or a configuration update. inevitable during a rolling upgrade or a configuration update.
Configuring interface defaults Configuring interface defaults
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
When a user does not provide an explicit value for one of interfaces (when When an operator does not provide an explicit value for one of the interfaces
creating a node or updating its driver), the default value is calculated (when creating a node or updating its driver), the default value is calculated
as described in :ref:`hardware_interfaces_defaults`. An operator can override as described in :ref:`hardware_interfaces_defaults`. It is also possible
the defaults for any interfaces by setting one of options named to override the defaults for any interfaces by setting one of the options named
``default_<IFACE>_interface``, where ``<IFACE>`` is the interface name. ``default_<IFACE>_interface``, where ``<IFACE>`` is the interface name.
For example: For example:
@ -247,9 +249,11 @@ its hardware type. Thus, changing these configuration options has no effect on
existing nodes. existing nodes.
.. warning:: .. warning::
The default interface implementation has to be configured the same way The default interface implementation must be configured the same way
across all conductors in the cloud, except maybe for a short period of time across all conductors in the cloud, except maybe for a short period of time
during an upgrade or configuration update. during an upgrade or configuration update. Otherwise the default
implementation will depend on which conductor handles which node, and this
mapping is not predictable or even persistent.
.. warning:: .. warning::
These options should be used with care. If a hardware type does not These options should be used with care. If a hardware type does not
@ -280,14 +284,9 @@ be installed locally. For example,
* drivers ending with ``ipmitool`` require :doc:`configure-ipmi`. * drivers ending with ``ipmitool`` require :doc:`configure-ipmi`.
See `driver-specific documentation`_ for required configuration of each driver. See :doc:`/admin/drivers` for the required configuration of each driver.
.. _driver composition reform specification: http://specs.openstack.org/openstack/ironic-specs/specs/approved/driver-composition-reform.html .. _driver composition reform specification: http://specs.openstack.org/openstack/ironic-specs/specs/approved/driver-composition-reform.html
.. _driver-specific documentation: https://docs.openstack.org/ironic/latest/admin/drivers.html
.. _setup.cfg: https://git.openstack.org/cgit/openstack/ironic/tree/setup.cfg .. _setup.cfg: https://git.openstack.org/cgit/openstack/ironic/tree/setup.cfg
.. _`Configuring Web or Serial Console`: http://docs.openstack.org/ironic/latest/admin/console.html
.. _iSCSI: https://en.wikipedia.org/wiki/ISCSI .. _iSCSI: https://en.wikipedia.org/wiki/ISCSI
.. _ironic-inspector: https://docs.openstack.org/developer/ironic-inspector/ .. _ironic-inspector: https://docs.openstack.org/ironic-inspector/latest/
.. _inspection documentation: https://docs.openstack.org/ironic/latest/admin/inspection.html
.. _RAID documentation: https://docs.openstack.org/ironic/latest/admin/raid.html
.. _vendor methods documentation: https://docs.openstack.org/ironic/latest/contributor/vendor-passthru.html

25
doc/source/install/enrollment.rst
View File

@ -56,8 +56,8 @@ also list only classic or only dynamic drivers:
+---------------------+-----------------------+ +---------------------+-----------------------+
The specific driver to use should be picked based on actual hardware The specific driver to use should be picked based on actual hardware
capabilities and expected features. See `driver-specific documentation`_ capabilities and expected features. See :doc:`/admin/drivers` for more hints
for more hints on that. on that.
Each driver has a list of *driver properties* that need to be specified via Each driver has a list of *driver properties* that need to be specified via
the node's ``driver_info`` field, in order for the driver to operate on node. the node's ``driver_info`` field, in order for the driver to operate on node.
@ -82,8 +82,6 @@ command:
The properties marked as required must be supplied either during node creation The properties marked as required must be supplied either during node creation
or shortly after. Some properties may only be required for certain features. or shortly after. Some properties may only be required for certain features.
.. _driver-specific documentation: https://docs.openstack.org/ironic/latest/admin/drivers.html
Note on API versions Note on API versions
-------------------- --------------------
@ -172,7 +170,7 @@ and may be combined if desired.
+------------------------+--------------------------------------+ +------------------------+--------------------------------------+
A node may also be referred to by a logical name as well as its UUID. A node may also be referred to by a logical name as well as its UUID.
A name can be assigned to the node during creating by adding the ``-n`` A name can be assigned to the node during its creation by adding the ``-n``
option to the ``node-create`` command or by updating an existing node with option to the ``node-create`` command or by updating an existing node with
the ``node-update`` command. See `Logical Names`_ for examples. the ``node-update`` command. See `Logical Names`_ for examples.
@ -198,7 +196,7 @@ and may be combined if desired.
--deploy-interface direct \ --deploy-interface direct \
--raid-interface agent --raid-interface agent
If no value is provided for certain interfaces, `Defaults for hardware If no value is provided for some interfaces, `Defaults for hardware
interfaces`_ are used instead. interfaces`_ are used instead.
It's an error to try changing this field for a node with a *classic driver*, It's an error to try changing this field for a node with a *classic driver*,
@ -449,10 +447,9 @@ To move a node from ``manageable`` to ``available`` provision state:
+------------------------+--------------------------------------------------------------------+ +------------------------+--------------------------------------------------------------------+
For more details on the Bare Metal service's state machine, see the For more details on the Bare Metal service's state machine, see the
`state machine <http://docs.openstack.org/ironic/latest/contributor/states.html>`_ :doc:`/contributor/states` documentation.
documentation.
.. _ComputeCapabilitiesFilter: http://docs.openstack.org/developer/nova/devref/filter_scheduler.html?highlight=computecapabilitiesfilter .. _ComputeCapabilitiesFilter: https://docs.openstack.org/nova/latest/user/filter-scheduler.html
Logical names Logical names
------------- -------------
@ -642,15 +639,9 @@ Hardware Inspection
------------------- -------------------
The Bare Metal service supports hardware inspection that simplifies enrolling The Bare Metal service supports hardware inspection that simplifies enrolling
nodes - please see `inspection`_ for details. nodes - please see :doc:`/admin/inspection` for details.
.. _`inspection`: http://docs.openstack.org/ironic/latest/admin/inspection.html
Tenant Networks and Port Groups Tenant Networks and Port Groups
------------------------------- -------------------------------
See `Multitenancy in Bare Metal service`_ and See :doc:`/admin/multitenancy` and :doc:`/admin/portgroups`.
`Port groups configuration in Bare Metal service`_.
.. _`Multitenancy in Bare Metal service`: http://docs.openstack.org/ironic/latest/admin/multitenancy.html
.. _`Port groups configuration in Bare Metal service`: http://docs.openstack.org/ironic/latest/admin/portgroups.html

2
doc/source/install/include/configure-ironic-conductor.rst
View File

@ -66,7 +66,7 @@ Configuring ironic-conductor service
glance_host=GLANCE_IP glance_host=GLANCE_IP
.. note:: .. note::
Swift backend for the Image service should be installed and configured Swift backend for the Image service must be installed and configured
for ``agent_*`` drivers. Ceph Object Gateway (RADOS Gateway) is also for ``agent_*`` drivers. Ceph Object Gateway (RADOS Gateway) is also
supported as the Image service's backend (`radosgw support supported as the Image service's backend (`radosgw support
<http://docs.openstack.org/ironic/latest/admin/radosgw.html#radosgw-support>`_). <http://docs.openstack.org/ironic/latest/admin/radosgw.html#radosgw-support>`_).

4
doc/source/install/standalone.rst
View File

@ -2,7 +2,7 @@
Using Bare Metal service as a standalone service Using Bare Metal service as a standalone service
================================================ ================================================
It's possible to use the Bare Metal service without other OpenStack services. It is possible to use the Bare Metal service without other OpenStack services.
You should make the following changes to ``/etc/ironic/ironic.conf``: You should make the following changes to ``/etc/ironic/ironic.conf``:
#. To disable usage of Identity service tokens:: #. To disable usage of Identity service tokens::
@ -151,7 +151,7 @@ For iLO drivers, fields that should be provided are:
* ``ilo_boot_iso``, ``image_source``, ``root_gb`` under ``instance_info``. * ``ilo_boot_iso``, ``image_source``, ``root_gb`` under ``instance_info``.
.. note:: .. note::
The Bare metal service tracks content changes for non-Glance images by The Bare Metal service tracks content changes for non-Glance images by
checking their modification date and time. For example, for HTTP image, checking their modification date and time. For example, for HTTP image,
if 'Last-Modified' header value from response to a HEAD request to if 'Last-Modified' header value from response to a HEAD request to
"http://my.server.net/images/deploy.ramdisk" is greater than cached image "http://my.server.net/images/deploy.ramdisk" is greater than cached image