diff --git a/doc/source/install/configdrive.rst b/doc/source/install/configdrive.rst
index 0fc0c7a6ce..d8143e9dd6 100644
--- a/doc/source/install/configdrive.rst
+++ b/doc/source/install/configdrive.rst
@@ -49,7 +49,7 @@ and provide the file or HTTP URL to the Bare Metal service.
For the format of the configuration drive, Bare Metal service expects a
``gzipped`` and ``base64`` encoded ISO 9660 [*]_ file with a ``config-2``
label. The
-`ironic client `_
+`ironic client `_
can generate a configuration drive in the `expected format`_. Just pass a
directory path containing the files that will be injected into it via the
``--config-drive`` parameter of the ``node-set-provision-state`` command,
@@ -161,7 +161,7 @@ but in order to use it we should follow some rules:
DIB_CLOUD_INIT_DATASOURCES="ConfigDrive, OpenStack" disk-image-create -o fedora-cloud-image fedora baremetal
For more information see `how to configure cloud-init data sources
- `_.
+ `_.
-.. _`expected format`: http://docs.openstack.org/user-guide/cli_config_drive.html#openstack-metadata-format
-.. _disk-image-builder: http://docs.openstack.org/developer/diskimage-builder/
+.. _`expected format`: https://docs.openstack.org/nova/latest/user/vendordata.html
+.. _disk-image-builder: https://docs.openstack.org/diskimage-builder/latest/
diff --git a/doc/source/install/configure-glance-images.rst b/doc/source/install/configure-glance-images.rst
index 7b6e1d9f36..e4d3bd0ba1 100644
--- a/doc/source/install/configure-glance-images.rst
+++ b/doc/source/install/configure-glance-images.rst
@@ -15,7 +15,7 @@ them to the Image service:
The `disk-image-builder`_ can be used to create user images required for
deployment and the actual OS which the user is going to run.
- .. _disk-image-builder: http://docs.openstack.org/developer/diskimage-builder/
+ .. _disk-image-builder: https://docs.openstack.org/diskimage-builder/latest/
- Install diskimage-builder package (use virtualenv, if you don't
want to install anything globally):
@@ -105,7 +105,7 @@ them to the Image service:
one kernel disk ``coreos_production_pxe.vmlinuz`` and one ram disk
``coreos_production_pxe_image-oem.cpio.gz``.
- .. note:: If you want to customize your deploy images, please read `Image Builders `_.
+ .. note:: If you want to customize your deploy images, please read `Image Builders `_.
#. Add the deploy images to the Image service
diff --git a/doc/source/install/deploy-ramdisk.rst b/doc/source/install/deploy-ramdisk.rst
index 591a19dc2b..9558f2aa3a 100644
--- a/doc/source/install/deploy-ramdisk.rst
+++ b/doc/source/install/deploy-ramdisk.rst
@@ -12,7 +12,7 @@ the `CoreOS tools`_ at:
* `CoreOS deploy kernel `_
* `CoreOS deploy ramdisk `_
-.. _ironic-python-agent: http://docs.openstack.org/developer/ironic-python-agent/
+.. _ironic-python-agent: https://docs.openstack.org/ironic-python-agent/latest/
Building from source
--------------------
@@ -97,5 +97,5 @@ disk-image-builder
check the `diskimage-builder documentation`_ for other supported
operational systems.
-.. _`diskimage-builder documentation`: http://docs.openstack.org/developer/diskimage-builder
-.. _`diskimage-builder installation documentation`: http://docs.openstack.org/developer/diskimage-builder/user_guide/installation.html
+.. _`diskimage-builder documentation`: https://docs.openstack.org/diskimage-builder/latest/
+.. _`diskimage-builder installation documentation`: https://docs.openstack.org/diskimage-builder/latest/user_guide/installation.html
diff --git a/doc/source/install/enabling-https.rst b/doc/source/install/enabling-https.rst
index c9cf120d8b..a70c402fab 100644
--- a/doc/source/install/enabling-https.rst
+++ b/doc/source/install/enabling-https.rst
@@ -19,7 +19,7 @@ of the following ways:
`_
* `Using native SSL support in swift
- `_
+ `_
(recommended only for testing purpose by swift).
.. _EnableHTTPSinGlance:
@@ -32,7 +32,7 @@ image service does not use HTTPS, but it is required for secure communication.
It can be enabled by making the following changes to ``/etc/glance/glance-api.conf``:
#. `Configuring SSL support
- `_
+ `_
#. Restart the glance-api service::
@@ -42,7 +42,7 @@ It can be enabled by making the following changes to ``/etc/glance/glance-api.co
Debian/Ubuntu:
sudo service glance-api restart
-See the `Glance `_ documentation,
+See the `Glance `_ documentation,
for more details on the Image service.
Enabling HTTPS communication between Image service and Object storage
@@ -56,7 +56,7 @@ To enable secure HTTPS communication between Image service and Object storage fo
#. :ref:`EnableHTTPSinSwift`
#. `Configure Swift Storage Backend
- `_
+ `_
#. :ref:`EnableHTTPSinGlance`
diff --git a/doc/source/install/get_started.rst b/doc/source/install/get_started.rst
index 3ab9d7b5e4..535752f998 100644
--- a/doc/source/install/get_started.rst
+++ b/doc/source/install/get_started.rst
@@ -74,8 +74,8 @@ bifrost_
A set of Ansible playbooks that automates the task of deploying a base image
onto a set of known hardware using ironic in a standalone mode.
-.. _python-ironicclient: http://docs.openstack.org/developer/python-ironicclient/
-.. _ironic-inspector: http://docs.openstack.org/developer/ironic-inspector/
-.. _diskimage-builder: http://docs.openstack.org/developer/diskimage-builder/
-.. _bifrost: http://docs.openstack.org/developer/bifrost/
+.. _python-ironicclient: https://docs.openstack.org/python-ironicclient/latest/
+.. _ironic-inspector: https://docs.openstack.org/ironic-inspector/latest/
+.. _diskimage-builder: https://docs.openstack.org/diskimage-builder/latest/
+.. _bifrost: https://docs.openstack.org/bifrost/latest/
diff --git a/doc/source/install/include/configure-ironic-conductor.rst b/doc/source/install/include/configure-ironic-conductor.rst
index 7681a1197d..e2cb9d1f25 100644
--- a/doc/source/install/include/configure-ironic-conductor.rst
+++ b/doc/source/install/include/configure-ironic-conductor.rst
@@ -173,4 +173,4 @@ Configuring ironic-conductor service
Ubuntu:
sudo service ironic-conductor restart
-.. _Keystoneauth documentation: http://docs.openstack.org/developer/keystoneauth/
+.. _Keystoneauth documentation: https://docs.openstack.org/keystoneauth/latest/
diff --git a/doc/source/install/include/local-boot-partition-images.rst b/doc/source/install/include/local-boot-partition-images.rst
index b0a758c155..7ef085baf5 100644
--- a/doc/source/install/include/local-boot-partition-images.rst
+++ b/doc/source/install/include/local-boot-partition-images.rst
@@ -18,7 +18,7 @@ Enabling the local boot is different when Bare Metal service is used with
Compute service and without it.
The following sections will describe both methods.
-.. _ironic-python-agent: http://docs.openstack.org/developer/ironic-python-agent/
+.. _ironic-python-agent: https://docs.openstack.org/ironic-python-agent/latest/
Enabling local boot with Compute service
diff --git a/doc/source/install/include/notifications.rst b/doc/source/install/include/notifications.rst
index 26ed7b741e..9541d1836a 100644
--- a/doc/source/install/include/notifications.rst
+++ b/doc/source/install/include/notifications.rst
@@ -4,7 +4,7 @@ Notifications
The Bare Metal service supports the emission of notifications, which are
messages sent on a message broker (like RabbitMQ or anything else supported by
the `oslo messaging library
-`_) that
+`_) that
indicate various events which occur, such as when a node changes power states.
These can be consumed by an external service reading from the message bus. For
example, `Searchlight `_ is an
@@ -12,5 +12,5 @@ OpenStack service that uses notifications to index (and make searchable)
resources from the Bare Metal service.
Notifications are disabled by default. For a complete list of available
-notifications and instructions for how to enable them, see the `deploy
-guide `_.
+notifications and instructions for how to enable them, see the
+:doc:`/admin/notifications`.
diff --git a/doc/source/install/include/root-device-hints.rst b/doc/source/install/include/root-device-hints.rst
index 8ad8ea63a7..e53b3393e6 100644
--- a/doc/source/install/include/root-device-hints.rst
+++ b/doc/source/install/include/root-device-hints.rst
@@ -55,7 +55,7 @@ and ``s==`` (for string values). The supported operators are:
* For numerical values:
* ``=`` equal to or greater than. This is equivalent to ``>=`` and is
- supported for `legacy reasons `_
+ supported for `legacy reasons `_
* ``==`` equal to
* ``!=`` not equal to
* ``>=`` greater than or equal to
diff --git a/doc/source/install/standalone.rst b/doc/source/install/standalone.rst
index 7a12d159cd..abcb389db1 100644
--- a/doc/source/install/standalone.rst
+++ b/doc/source/install/standalone.rst
@@ -62,7 +62,7 @@ There are however some limitations for different drivers:
Steps to start a deployment are pretty similar to those when using Compute:
-#. To use the `ironic CLI `_,
+#. To use the `ironic CLI `_,
set up these environment variables. Since no authentication strategy is
being used, the value can be any string for OS_AUTH_TOKEN. IRONIC_URL is
the URL of the ironic-api process.
diff --git a/doc/source/install/troubleshooting.rst b/doc/source/install/troubleshooting.rst
index 6e51c3c2b3..53b9c8d900 100644
--- a/doc/source/install/troubleshooting.rst
+++ b/doc/source/install/troubleshooting.rst
@@ -124,4 +124,4 @@ following command.
$ ironic node-set-maintenance $NODE_UUID off
-.. _ironic-python-agent: http://docs.openstack.org/developer/ironic-python-agent/
+.. _ironic-python-agent: https://docs.openstack.org/ironic-python-agent/latest/