summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFrank Kloeker <f.kloeker@telekom.de>2018-10-27 21:30:06 +0200
committerFrank Kloeker <f.kloeker@telekom.de>2018-10-27 22:09:36 +0200
commitd647a8d0d925422dc1d759f599bf2dbd6415ef15 (patch)
tree91eaf87f0291be859399cf9aa6246ea7c64d73fe
parentfb6fc0df5bbb7a850abdd4f462d78edd60cd204e (diff)
Fix broken links
Notes
Notes (review): Code-Review+2: Sean McGinnis <sean.mcginnis@gmail.com> Code-Review+2: Andreas Jaeger <jaegerandi@gmail.com> Workflow+1: Andreas Jaeger <jaegerandi@gmail.com> Verified+2: Zuul Submitted-by: Zuul Submitted-at: Fri, 02 Nov 2018 18:57:32 +0000 Reviewed-on: https://review.openstack.org/613758 Project: openstack/operations-guide Branch: refs/heads/master
-rw-r--r--doc/source/acknowledgements.rst2
-rw-r--r--doc/source/app-crypt.rst6
-rw-r--r--doc/source/app-resources.rst19
-rw-r--r--doc/source/app-usecases.rst11
-rw-r--r--doc/source/common/app-support.rst6
-rw-r--r--doc/source/index.rst4
-rw-r--r--doc/source/ops-advanced-configuration.rst6
-rw-r--r--doc/source/ops-capacity-planning-scaling.rst2
-rw-r--r--doc/source/ops-customize-dashboard.rst2
-rw-r--r--doc/source/ops-customize-development.rst2
-rw-r--r--doc/source/ops-customize-objectstorage.rst6
-rw-r--r--doc/source/ops-deployment-factors.rst6
-rw-r--r--doc/source/ops-lay-of-the-land.rst11
-rw-r--r--doc/source/ops-maintenance-configuration.rst8
-rw-r--r--doc/source/ops-maintenance-database.rst2
-rw-r--r--doc/source/ops-monitoring.rst12
-rw-r--r--doc/source/ops-network-troubleshooting.rst8
-rw-r--r--doc/source/ops-planning.rst6
-rw-r--r--doc/source/ops-upgrades.rst26
-rw-r--r--doc/source/ops-user-facing-operations.rst36
-rw-r--r--doc/source/preface.rst4
21 files changed, 86 insertions, 99 deletions
diff --git a/doc/source/acknowledgements.rst b/doc/source/acknowledgements.rst
index ad027b7..925de5a 100644
--- a/doc/source/acknowledgements.rst
+++ b/doc/source/acknowledgements.rst
@@ -45,7 +45,7 @@ facilitator Adam Hyde. Without his tireless support and encouragement,
45we would have thought a book of this scope was impossible in five days. 45we would have thought a book of this scope was impossible in five days.
46Adam has proven the book sprint method effectively again and again. He 46Adam has proven the book sprint method effectively again and again. He
47creates both tools and faith in collaborative authoring at 47creates both tools and faith in collaborative authoring at
48`www.booksprints.net <http://www.booksprints.net/>`_. 48`www.booksprints.net <https://www.booksprints.net/>`_.
49 49
50We couldn't have pulled it off without so much supportive help and 50We couldn't have pulled it off without so much supportive help and
51encouragement. 51encouragement.
diff --git a/doc/source/app-crypt.rst b/doc/source/app-crypt.rst
index 3548041..88d8da8 100644
--- a/doc/source/app-crypt.rst
+++ b/doc/source/app-crypt.rst
@@ -213,10 +213,10 @@ its lease and all of the sudden I found a bunch of OpenStack and dnsmasq
213discussions that were identical to the problem we were seeing! 213discussions that were identical to the problem we were seeing!
214 214
215`Problem with Heavy Network IO and 215`Problem with Heavy Network IO and
216Dnsmasq <http://www.gossamer-threads.com/lists/openstack/operators/18197>`_. 216Dnsmasq <https://www.gossamer-threads.com/lists/openstack/operators/18197>`_.
217 217
218`instances losing IP address while running, due to No 218`instances losing IP address while running, due to No
219DHCPOFFER <http://www.gossamer-threads.com/lists/openstack/dev/14696>`_. 219DHCPOFFER <https://www.gossamer-threads.com/lists/openstack/dev/14696>`_.
220 220
221Seriously, Google. 221Seriously, Google.
222 222
@@ -245,7 +245,7 @@ Disappearing Images
245At the end of 2012, Cybera (a nonprofit with a mandate to oversee the 245At the end of 2012, Cybera (a nonprofit with a mandate to oversee the
246development of cyberinfrastructure in Alberta, Canada) deployed an 246development of cyberinfrastructure in Alberta, Canada) deployed an
247updated OpenStack cloud for their `DAIR 247updated OpenStack cloud for their `DAIR
248project <http://www.canarie.ca/cloud/>`_. A few days into 248project <https://www.canarie.ca/cloud/>`_. A few days into
249production, a compute node locks up. Upon rebooting the node, I checked 249production, a compute node locks up. Upon rebooting the node, I checked
250to see what instances were hosted on that node so I could boot them on 250to see what instances were hosted on that node so I could boot them on
251behalf of the customer. Luckily, only one instance. 251behalf of the customer. Luckily, only one instance.
diff --git a/doc/source/app-resources.rst b/doc/source/app-resources.rst
index 1c99898..e1bd067 100644
--- a/doc/source/app-resources.rst
+++ b/doc/source/app-resources.rst
@@ -16,14 +16,13 @@ OpenStack
16 16
17- `OpenStack Administrator Guide <https://docs.openstack.org/admin-guide/>`_ 17- `OpenStack Administrator Guide <https://docs.openstack.org/admin-guide/>`_
18 18
19- `OpenStack Cloud Computing Cookbook (Packt 19- `OpenStack Cloud Computing Cookbook <https://openstackcookbook.com/>`_
20 Publishing) <http://www.packtpub.com/openstack-cloud-computing-cookbook-second-edition/book>`_
21 20
22Cloud (General) 21Cloud (General)
23~~~~~~~~~~~~~~~ 22~~~~~~~~~~~~~~~
24 23
25- `The NIST Definition of Cloud 24- `The NIST Definition of Cloud
26 Computing <http://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-145.pdf>`_ 25 Computing <https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-145.pdf>`_
27 26
28Python 27Python
29~~~~~~ 28~~~~~~
@@ -34,29 +33,29 @@ Networking
34~~~~~~~~~~ 33~~~~~~~~~~
35 34
36- `TCP/IP Illustrated, Volume 1: The Protocols, 2/E 35- `TCP/IP Illustrated, Volume 1: The Protocols, 2/E
37 (Pearson) <http://www.pearsonhighered.com/educator/product/TCPIP-Illustrated-Volume-1-The-Protocols/9780321336316.page>`_ 36 (Pearson) <https://www.pearsonhighered.com/educator/product/TCPIP-Illustrated-Volume-1-The-Protocols/9780321336316.page>`_
38 37
39- `The TCP/IP Guide (No Starch 38- `The TCP/IP Guide (No Starch
40 Press) <http://www.nostarch.com/tcpip.htm>`_ 39 Press) <https://www.nostarch.com/tcpip.htm>`_
41 40
42- `A tcpdump Tutorial and 41- `A tcpdump Tutorial and
43 Primer <http://danielmiessler.com/study/tcpdump/>`_ 42 Primer <https://danielmiessler.com/study/tcpdump/>`_
44 43
45Systems Administration 44Systems Administration
46~~~~~~~~~~~~~~~~~~~~~~ 45~~~~~~~~~~~~~~~~~~~~~~
47 46
48- `UNIX and Linux Systems Administration Handbook (Prentice 47- `UNIX and Linux Systems Administration Handbook (Prentice
49 Hall) <http://www.admin.com/>`_ 48 Hall) <https://www.admin.com/>`_
50 49
51Virtualization 50Virtualization
52~~~~~~~~~~~~~~ 51~~~~~~~~~~~~~~
53 52
54- `The Book of Xen (No Starch 53- `The Book of Xen (No Starch
55 Press) <http://www.nostarch.com/xen.htm>`_ 54 Press) <https://nostarch.com/releases/xen.html>`_
56 55
57Configuration Management 56Configuration Management
58~~~~~~~~~~~~~~~~~~~~~~~~ 57~~~~~~~~~~~~~~~~~~~~~~~~
59 58
60- `Puppet Labs Documentation <http://docs.puppetlabs.com/>`_ 59- `Puppet Labs Documentation <https://docs.puppet.com/>`_
61 60
62- `Pro Puppet (Apress) <http://www.apress.com/9781430230571>`_ 61- `Pro Puppet (Apress) <https://www.apress.com/9781430230571>`_
diff --git a/doc/source/app-usecases.rst b/doc/source/app-usecases.rst
index 595a8ea..bc7b507 100644
--- a/doc/source/app-usecases.rst
+++ b/doc/source/app-usecases.rst
@@ -40,13 +40,8 @@ to 10 percent back-ported code from trunk and modifications.
40Resources 40Resources
41--------- 41---------
42 42
43- `OpenStack.org case
44 study <https://www.openstack.org/user-stories/nectar/>`_
45
46- `NeCTAR-RC GitHub <https://github.com/NeCTAR-RC/>`_ 43- `NeCTAR-RC GitHub <https://github.com/NeCTAR-RC/>`_
47 44
48- `NeCTAR website <https://www.nectar.org.au/>`_
49
50MIT CSAIL 45MIT CSAIL
51~~~~~~~~~ 46~~~~~~~~~
52 47
@@ -110,7 +105,7 @@ based networks.
110Resources 105Resources
111--------- 106---------
112 107
113- `CSAIL homepage <http://www.csail.mit.edu/>`_ 108- `CSAIL homepage <https://www.csail.mit.edu/>`_
114 109
115DAIR 110DAIR
116~~~~ 111~~~~
@@ -151,7 +146,7 @@ controller.
151Resources 146Resources
152--------- 147---------
153 148
154- `DAIR homepage <http://www.canarie.ca/cloud/>`__ 149- `DAIR homepage <https://www.canarie.ca/cloud/>`__
155 150
156CERN 151CERN
157~~~~ 152~~~~
@@ -183,7 +178,7 @@ Resources
183--------- 178---------
184 179
185- `OpenStack in Production: A tale of 3 OpenStack 180- `OpenStack in Production: A tale of 3 OpenStack
186 Clouds <http://openstack-in-production.blogspot.de/2013/09/a-tale-of-3-openstack-clouds-50000.html>`_ 181 Clouds <https://openstack-in-production.blogspot.de/2013/09/a-tale-of-3-openstack-clouds-50000.html>`_
187 182
188- `Review of CERN Data Centre 183- `Review of CERN Data Centre
189 Infrastructure <http://cds.cern.ch/record/1457989/files/chep%202012%20CERN%20infrastructure%20final.pdf?version=1>`_ 184 Infrastructure <http://cds.cern.ch/record/1457989/files/chep%202012%20CERN%20infrastructure%20final.pdf?version=1>`_
diff --git a/doc/source/common/app-support.rst b/doc/source/common/app-support.rst
index 3c8f960..ea26475 100644
--- a/doc/source/common/app-support.rst
+++ b/doc/source/common/app-support.rst
@@ -182,8 +182,8 @@ Documentation feedback
182 182
183To provide feedback on documentation, join our IRC channel ``#openstack-doc`` 183To provide feedback on documentation, join our IRC channel ``#openstack-doc``
184on the Freenode IRC network, or `report a bug in Launchpad 184on the Freenode IRC network, or `report a bug in Launchpad
185<https://bugs.launchpad.net/openstack/+filebug>`_ and choose the particular 185<https://bugs.launchpad.net/openstack/+filebug/+login>`_ and choose
186project that the documentation is a part of. 186the particular project that the documentation is a part of.
187 187
188The OpenStack IRC channel 188The OpenStack IRC channel
189~~~~~~~~~~~~~~~~~~~~~~~~~ 189~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -194,7 +194,7 @@ feedback for urgent and pressing issues. To install an IRC client or use
194a browser-based client, go to 194a browser-based client, go to
195`https://webchat.freenode.net/ <https://webchat.freenode.net>`_. You can 195`https://webchat.freenode.net/ <https://webchat.freenode.net>`_. You can
196also use `Colloquy <http://colloquy.info/>`_ (Mac OS X), 196also use `Colloquy <http://colloquy.info/>`_ (Mac OS X),
197`mIRC <http://www.mirc.com/>`_ (Windows), 197`mIRC <https://www.mirc.com/>`_ (Windows),
198or XChat (Linux). When you are in the IRC channel 198or XChat (Linux). When you are in the IRC channel
199and want to share code or command output, the generally accepted method 199and want to share code or command output, the generally accepted method
200is to use a Paste Bin. The OpenStack project has one at `Paste 200is to use a Paste Bin. The OpenStack project has one at `Paste
diff --git a/doc/source/index.rst b/doc/source/index.rst
index dd5b3db..bf6622f 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -8,14 +8,14 @@ Abstract
8This guide provides information about operating OpenStack clouds. 8This guide provides information about operating OpenStack clouds.
9 9
10We recommend that you turn to the `Installation Tutorials and Guides 10We recommend that you turn to the `Installation Tutorials and Guides
11<https://docs.openstack.org/project-install-guide/ocata/>`_, 11<https://docs.openstack.org/install/>`_,
12which contains a step-by-step guide on how to manually install the 12which contains a step-by-step guide on how to manually install the
13OpenStack packages and dependencies on your cloud. 13OpenStack packages and dependencies on your cloud.
14 14
15While it is important for an operator to be familiar with the steps 15While it is important for an operator to be familiar with the steps
16involved in deploying OpenStack, we also strongly encourage you to 16involved in deploying OpenStack, we also strongly encourage you to
17evaluate `OpenStack deployment tools 17evaluate `OpenStack deployment tools
18<https://docs.openstack.org/developer/openstack-projects.html>`_ 18<https://docs.openstack.org/rocky/projects.html>`_
19and configuration-management tools, such as :term:`Puppet` or 19and configuration-management tools, such as :term:`Puppet` or
20:term:`Chef`, which can help automate this deployment process. 20:term:`Chef`, which can help automate this deployment process.
21 21
diff --git a/doc/source/ops-advanced-configuration.rst b/doc/source/ops-advanced-configuration.rst
index 502749b..a7c0ab2 100644
--- a/doc/source/ops-advanced-configuration.rst
+++ b/doc/source/ops-advanced-configuration.rst
@@ -34,7 +34,7 @@ different tuning requirements.
34 <https://docs.openstack.org/ocata/config-reference/compute/hypervisors.html>`__. 34 <https://docs.openstack.org/ocata/config-reference/compute/hypervisors.html>`__.
35 You can see a matrix of the various features in OpenStack Compute 35 You can see a matrix of the various features in OpenStack Compute
36 (nova) hypervisor drivers at the `Hypervisor support matrix 36 (nova) hypervisor drivers at the `Hypervisor support matrix
37 page <https://docs.openstack.org/developer/nova/support-matrix.html>`_. 37 page <ttps://docs.openstack.org/nova/latest/user/support-matrix.html>`_.
38 38
39The point we are trying to make here is that just because an option 39The point we are trying to make here is that just because an option
40exists doesn't mean that option is relevant to your driver choices. 40exists doesn't mean that option is relevant to your driver choices.
@@ -146,6 +146,6 @@ quickly based on the closest data center. You configure a default region
146with one zone for each cluster, but be sure your network (WAN) can 146with one zone for each cluster, but be sure your network (WAN) can
147handle the additional request and response load between zones as you add 147handle the additional request and response load between zones as you add
148more zones and build a ring that handles more zones. Refer to 148more zones and build a ring that handles more zones. Refer to
149`Geographically Distributed Clusters 149`Geographically Distributed Swift Considerations
150<https://docs.openstack.org/developer/swift/admin_guide.html#geographically-distributed-clusters>`_ 150<https://docs.openstack.org/swift/latest/admin_guide.html#geographically-distributed-swift-considerations>`_
151in the documentation for additional information. 151in the documentation for additional information.
diff --git a/doc/source/ops-capacity-planning-scaling.rst b/doc/source/ops-capacity-planning-scaling.rst
index dd6d6b2..07c91f0 100644
--- a/doc/source/ops-capacity-planning-scaling.rst
+++ b/doc/source/ops-capacity-planning-scaling.rst
@@ -150,7 +150,7 @@ load-balancing method (DNS round robin, hardware load balancer, or
150software such as Pound or HAProxy). One caveat with dashboard is the VNC 150software such as Pound or HAProxy). One caveat with dashboard is the VNC
151proxy, which uses the WebSocket protocol— something that an L7 load 151proxy, which uses the WebSocket protocol— something that an L7 load
152balancer might struggle with. See also `Horizon session storage 152balancer might struggle with. See also `Horizon session storage
153<https://docs.openstack.org/developer/horizon/topics/deployment.html#session-storage>`_. 153<https://docs.openstack.org/horizon/latest/admin/sessions.html>`_.
154 154
155You can configure some services, such as ``nova-api`` and 155You can configure some services, such as ``nova-api`` and
156``glance-api``, to use multiple processes by changing a flag in their 156``glance-api``, to use multiple processes by changing a flag in their
diff --git a/doc/source/ops-customize-dashboard.rst b/doc/source/ops-customize-dashboard.rst
index 097edcc..3f034e6 100644
--- a/doc/source/ops-customize-dashboard.rst
+++ b/doc/source/ops-customize-dashboard.rst
@@ -5,4 +5,4 @@ Customizing the Dashboard (Horizon)
5The dashboard is based on the Python 5The dashboard is based on the Python
6`Django <https://www.djangoproject.com/>`_ web application framework. 6`Django <https://www.djangoproject.com/>`_ web application framework.
7To know how to build your Dashboard, see `Building a Dashboard using Horizon 7To know how to build your Dashboard, see `Building a Dashboard using Horizon
8<https://docs.openstack.org/developer/horizon/tutorials/dashboard.html>`_. 8<https://docs.openstack.org/horizon/latest/>`_.
diff --git a/doc/source/ops-customize-development.rst b/doc/source/ops-customize-development.rst
index a5ec4c8..dc7c938 100644
--- a/doc/source/ops-customize-development.rst
+++ b/doc/source/ops-customize-development.rst
@@ -8,4 +8,4 @@ builds an OpenStack development environment for you. You use it to
8create such an environment for developing a new feature. 8create such an environment for developing a new feature.
9 9
10For more information on installing DevStack, see the 10For more information on installing DevStack, see the
11`DevStack <https://docs.openstack.org/developer/devstack/>`_ website. 11`DevStack <https://docs.openstack.org/devstack/latest/>`_ website.
diff --git a/doc/source/ops-customize-objectstorage.rst b/doc/source/ops-customize-objectstorage.rst
index 0388aad..3788fa0 100644
--- a/doc/source/ops-customize-objectstorage.rst
+++ b/doc/source/ops-customize-objectstorage.rst
@@ -3,9 +3,9 @@ Customizing Object Storage (Swift) Middleware
3============================================= 3=============================================
4 4
5OpenStack Object Storage, known as swift when reading the code, is based 5OpenStack Object Storage, known as swift when reading the code, is based
6on the Python `Paste <http://pythonpaste.org/>`_ framework. The best 6on the Python `Paste <https://pypi.org/project/Paste/>`_ framework.
7introduction to its architecture is `A Do-It-Yourself 7The best introduction to its architecture is on `Read The
8Framework <http://pythonpaste.org/do-it-yourself-framework.html>`_. 8Docs <https://paste.readthedocs.io/en/latest/>`_.
9Because of the swift project's use of this framework, you are able to 9Because of the swift project's use of this framework, you are able to
10add features to a project by placing some custom code in a project's 10add features to a project by placing some custom code in a project's
11pipeline without having to change any of the core code. 11pipeline without having to change any of the core code.
diff --git a/doc/source/ops-deployment-factors.rst b/doc/source/ops-deployment-factors.rst
index c4229ca..d255f1d 100644
--- a/doc/source/ops-deployment-factors.rst
+++ b/doc/source/ops-deployment-factors.rst
@@ -217,9 +217,9 @@ Common areas of regulation include:
217This is an example of such legal frameworks: 217This is an example of such legal frameworks:
218 218
219Data storage regulations in Europe are currently driven by provisions of 219Data storage regulations in Europe are currently driven by provisions of
220the `Data protection framework <http://ec.europa.eu/justice/data-protection/>`_. 220the `Data protection board <https://edpb.europa.eu/>`_.
221`Financial Industry Regulatory Authority 221`Financial Industry Regulatory Authority
222<http://www.finra.org/Industry/Regulation/FINRARules/>`_ works on this in 222<http://finra.complinet.com/>`_ works on this in
223the United States. 223the United States.
224 224
225Privacy and security are spread over different industry-specific laws and 225Privacy and security are spread over different industry-specific laws and
@@ -262,7 +262,7 @@ Corrective controls:
262 system is an example of a corrective control. 262 system is an example of a corrective control.
263 263
264For more information, see See also `NIST Special Publication 800-53 264For more information, see See also `NIST Special Publication 800-53
265<https://web.nvd.nist.gov/view/800-53/home>`_. 265<https://web.nvd.nist.gov/view/800-53/>`_.
266 266
267 267
268Software licensing 268Software licensing
diff --git a/doc/source/ops-lay-of-the-land.rst b/doc/source/ops-lay-of-the-land.rst
index 75921cd..c53a703 100644
--- a/doc/source/ops-lay-of-the-land.rst
+++ b/doc/source/ops-lay-of-the-land.rst
@@ -18,7 +18,7 @@ tab with a :guilabel:`System Panel` and an :guilabel:`Identity` tab.
18These interfaces give you access to system information and usage as 18These interfaces give you access to system information and usage as
19well as to settings for configuring what 19well as to settings for configuring what
20end users can do. Refer to the `OpenStack Administrator 20end users can do. Refer to the `OpenStack Administrator
21Guide <https://docs.openstack.org/admin-guide/dashboard.html>`__ for 21Guide <https://docs.openstack.org/latest/admin/>`__ for
22detailed how-to information about using the dashboard as an admin user. 22detailed how-to information about using the dashboard as an admin user.
23 23
24Command-Line Tools 24Command-Line Tools
@@ -40,9 +40,8 @@ Install OpenStack command-line clients
40-------------------------------------- 40--------------------------------------
41 41
42For instructions on installing, upgrading, or removing command-line clients, 42For instructions on installing, upgrading, or removing command-line clients,
43see the `Install the OpenStack command-line clients 43see the `Install the OpenStack command-line client
44<https://docs.openstack.org/user-guide/common/cli-install-openstack-command-line-clients.html>`_ 44<https://docs.openstack.org/python-openstackclient/latest/>`_.
45section in OpenStack End User Guide.
46 45
47.. note:: 46.. note::
48 47
@@ -209,7 +208,7 @@ Underlying the use of the command-line tools is the OpenStack API, which
209is a RESTful API that runs over HTTP. There may be cases where you want 208is a RESTful API that runs over HTTP. There may be cases where you want
210to interact with the API directly or need to use it because of a 209to interact with the API directly or need to use it because of a
211suspected bug in one of the CLI tools. The best way to do this is to use 210suspected bug in one of the CLI tools. The best way to do this is to use
212a combination of `cURL <http://curl.haxx.se/>`_ and another tool, 211a combination of `cURL <https://curl.haxx.se/>`_ and another tool,
213such as `jq <http://stedolan.github.io/jq/>`_, to parse the JSON from 212such as `jq <http://stedolan.github.io/jq/>`_, to parse the JSON from
214the responses. 213the responses.
215 214
@@ -589,5 +588,5 @@ Summary
589We hope you have enjoyed this quick tour of your working environment, 588We hope you have enjoyed this quick tour of your working environment,
590including how to interact with your cloud and extract useful 589including how to interact with your cloud and extract useful
591information. From here, you can use the `OpenStack Administrator 590information. From here, you can use the `OpenStack Administrator
592Guide <https://docs.openstack.org/admin-guide/>`_ as your 591Guide <https://docs.openstack.org/latest/admin/>`_ as your
593reference for all of the command-line functionality in your cloud. 592reference for all of the command-line functionality in your cloud.
diff --git a/doc/source/ops-maintenance-configuration.rst b/doc/source/ops-maintenance-configuration.rst
index 16c3c77..6b58951 100644
--- a/doc/source/ops-maintenance-configuration.rst
+++ b/doc/source/ops-maintenance-configuration.rst
@@ -16,14 +16,14 @@ configuration options) in a version-controlled repository.
16 not recommend a specific one. The most popular ones in the OpenStack 16 not recommend a specific one. The most popular ones in the OpenStack
17 community are: 17 community are:
18 18
19 * `Puppet <https://puppetlabs.com/>`_, with available `OpenStack 19 * `Puppet <https://puppet.com/>`_, with available `OpenStack
20 Puppet modules <https://github.com/puppetlabs/puppetlabs-openstack>`_ 20 Puppet modules <https://github.com/puppetlabs/puppetlabs-openstack>`_
21 * `Ansible <https://www.ansible.com/>`_, with `OpenStack Ansible 21 * `Ansible <https://www.ansible.com/>`_, with `OpenStack Ansible
22 <https://github.com/openstack/openstack-ansible>`_ 22 <https://github.com/openstack/openstack-ansible>`_
23 * `Chef <http://www.getchef.com/chef/>`_, with available `OpenStack Chef 23 * `Chef <https://www.chef.io/chef/>`_, with available `OpenStack Chef
24 recipes <https://github.com/openstack/openstack-chef-repo>`_ 24 recipes <https://github.com/openstack/openstack-chef-repo>`_
25 25
26 Other newer configuration tools include `Juju <https://juju.ubuntu.com/>`_ 26 Other newer configuration tools include `Juju <https://jujucharms.com/>`_
27 and `Salt <http://www.saltstack.com/>`_; and more mature configuration 27 and `Salt <http://www.saltstack.com/>`_; and more mature configuration
28 management tools include `CFEngine <http://cfengine.com/>`_ and `Bcfg2 28 management tools include `CFEngine <https://cfengine.com/>`_ and `Bcfg2
29 <http://bcfg2.org/>`_. 29 <http://bcfg2.org/>`_.
diff --git a/doc/source/ops-maintenance-database.rst b/doc/source/ops-maintenance-database.rst
index 798ec63..b3d592b 100644
--- a/doc/source/ops-maintenance-database.rst
+++ b/doc/source/ops-maintenance-database.rst
@@ -48,4 +48,4 @@ As your cloud grows, MySQL is utilized more and more. If you suspect
48that MySQL might be becoming a bottleneck, you should start researching 48that MySQL might be becoming a bottleneck, you should start researching
49MySQL optimization. The MySQL manual has an entire section dedicated to 49MySQL optimization. The MySQL manual has an entire section dedicated to
50this topic: `Optimization Overview 50this topic: `Optimization Overview
51<http://dev.mysql.com/doc/refman/5.5/en/optimize-overview.html>`_. 51<https://dev.mysql.com/doc/refman/5.5/en/optimize-overview.html>`_.
diff --git a/doc/source/ops-monitoring.rst b/doc/source/ops-monitoring.rst
index e728698..d9027d9 100644
--- a/doc/source/ops-monitoring.rst
+++ b/doc/source/ops-monitoring.rst
@@ -90,13 +90,11 @@ The Telemetry service (:term:`ceilometer`) collects
90metering and event data relating to OpenStack services. Data collected 90metering and event data relating to OpenStack services. Data collected
91by the Telemetry service could be used for billing. Depending on 91by the Telemetry service could be used for billing. Depending on
92deployment configuration, collected data may be accessible to users 92deployment configuration, collected data may be accessible to users
93based on the deployment configuration. The Telemetry service provides a 93based on the deployment configuration. You can
94REST API documented at `ceilometer V2 Web API 94read more about the module in the `Ceilometer Administrator
95<https://docs.openstack.org/developer/ceilometer/webapi/v2.html>`_. You can 95Guide <https://docs.openstack.org/ceilometer/latest/admin/index.html>`_ or
96read more about the module in the `OpenStack Administrator 96in the `Ceilometer Contributor
97Guide <https://docs.openstack.org/admin-guide/telemetry.html>`_ or 97Guide <https://docs.openstack.org/ceilometer/latest/contributor/index.html>`_.
98in the `developer
99documentation <https://docs.openstack.org/developer/ceilometer>`_.
100 98
101OpenStack Specific Resources 99OpenStack Specific Resources
102~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 100~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/doc/source/ops-network-troubleshooting.rst b/doc/source/ops-network-troubleshooting.rst
index 2cdf29c..a19324f 100644
--- a/doc/source/ops-network-troubleshooting.rst
+++ b/doc/source/ops-network-troubleshooting.rst
@@ -98,7 +98,7 @@ software defined networking (SDN) hardware or plug-ins that use Linux
98native facilities on your hosts, such as Open vSwitch or Linux Bridge. 98native facilities on your hosts, such as Open vSwitch or Linux Bridge.
99 99
100The networking chapter of the `OpenStack Administrator 100The networking chapter of the `OpenStack Administrator
101Guide <https://docs.openstack.org/admin-guide/networking.html>`_ 101Guide <https://docs.openstack.org/admin-guide/>`_
102shows a variety of networking scenarios and their connection paths. The 102shows a variety of networking scenarios and their connection paths. The
103purpose of this section is to give you the tools to troubleshoot the 103purpose of this section is to give you the tools to troubleshoot the
104various components involved however they are plumbed together in your 104various components involved however they are plumbed together in your
@@ -473,7 +473,7 @@ is to use ``tcpdump``. We recommended using ``tcpdump`` at several
473points along the network path to correlate where a problem might be. If 473points along the network path to correlate where a problem might be. If
474you prefer working with a GUI, either live or by using a ``tcpdump`` 474you prefer working with a GUI, either live or by using a ``tcpdump``
475capture, check out 475capture, check out
476`Wireshark <http://www.wireshark.org/>`_. 476`Wireshark <https://www.wireshark.org/>`_.
477 477
478For example, run the following command: 478For example, run the following command:
479 479
@@ -920,7 +920,7 @@ Troubleshooting Open vSwitch
920Open vSwitch, as used in the previous OpenStack Networking examples is a 920Open vSwitch, as used in the previous OpenStack Networking examples is a
921full-featured multilayer virtual switch licensed under the open source 921full-featured multilayer virtual switch licensed under the open source
922Apache 2.0 license. Full documentation can be found at `the project's 922Apache 2.0 license. Full documentation can be found at `the project's
923website <http://openvswitch.org/>`_. In practice, given the preceding 923website <http://www.openvswitch.org/>`_. In practice, given the preceding
924configuration, the most common issues are being sure that the required 924configuration, the most common issues are being sure that the required
925bridges (``br-int``, ``br-tun``, and ``br-ex``) exist and have the 925bridges (``br-int``, ``br-tun``, and ``br-ex``) exist and have the
926proper ports connected to them. 926proper ports connected to them.
@@ -1091,5 +1091,5 @@ analysis and diagnostic system that provides a completely automated service
1091for verifying and diagnosing the networking functionality provided by OVS. 1091for verifying and diagnosing the networking functionality provided by OVS.
1092 1092
1093Additionally, you can refer to 1093Additionally, you can refer to
1094`neutron debug <https://docs.openstack.org/cli-reference/neutron-debug.html>`_ 1094`neutron client <https://docs.openstack.org/python-neutronclient/latest/>`_
1095for more options. 1095for more options.
diff --git a/doc/source/ops-planning.rst b/doc/source/ops-planning.rst
index 025682a..ab9d923 100644
--- a/doc/source/ops-planning.rst
+++ b/doc/source/ops-planning.rst
@@ -241,9 +241,9 @@ you build your use case and your deployment plan.
241 For further research about OpenStack deployment, investigate the 241 For further research about OpenStack deployment, investigate the
242 supported and documented preconfigured, prepackaged installers for 242 supported and documented preconfigured, prepackaged installers for
243 OpenStack from companies such as 243 OpenStack from companies such as
244 `Canonical <https://www.ubuntu.com/cloud/openstack>`_, 244 `Canonical <https://www.ubuntu.com/openstack>`_,
245 `Cisco <http://www.cisco.com/c/en/us/solutions/data-center-virtualization/openstack-at-cisco/index.html>`_, 245 `Cisco <https://www.cisco.com/c/en/us/solutions/data-center-virtualization/openstack-at-cisco/index.html>`_,
246 `Cloudscaling <http://www.cloudscaling.com>`_, 246 `Cloudscaling <http://cloudscaling.com/blog/>`_,
247 `IBM <http://www-03.ibm.com/software/products/en/ibm-cloud-orchestrator>`_, 247 `IBM <http://www-03.ibm.com/software/products/en/ibm-cloud-orchestrator>`_,
248 `Metacloud <http://www.cisco.com/c/en/us/products/cloud-systems-management/metacloud/index.html>`_, 248 `Metacloud <http://www.cisco.com/c/en/us/products/cloud-systems-management/metacloud/index.html>`_,
249 `Mirantis <https://www.mirantis.com>`_, 249 `Mirantis <https://www.mirantis.com>`_,
diff --git a/doc/source/ops-upgrades.rst b/doc/source/ops-upgrades.rst
index 0fbb033..b0362fb 100644
--- a/doc/source/ops-upgrades.rst
+++ b/doc/source/ops-upgrades.rst
@@ -96,7 +96,7 @@ Watch the network
96To set up the test environment, you can use one of several methods: 96To set up the test environment, you can use one of several methods:
97 97
98- Do a full manual install by using the `Installation Tutorials and Guides 98- Do a full manual install by using the `Installation Tutorials and Guides
99 <https://docs.openstack.org/project-install-guide/ocata/>`_ for 99 <https://docs.openstack.org/rocky/install/>`_ for
100 your platform. Review the final configuration files and installed 100 your platform. Review the final configuration files and installed
101 packages. 101 packages.
102 102
@@ -177,7 +177,7 @@ Upgrade process
177This section describes the process to upgrade a basic OpenStack 177This section describes the process to upgrade a basic OpenStack
178deployment based on the basic two-node architecture in the `Installation 178deployment based on the basic two-node architecture in the `Installation
179Tutorials and Guides 179Tutorials and Guides
180<https://docs.openstack.org/project-install-guide/ocata/>`_. All 180<https://docs.openstack.org/rocky/install/>`_. All
181nodes must run a supported distribution of Linux with a recent kernel 181nodes must run a supported distribution of Linux with a recent kernel
182and the current release packages. 182and the current release packages.
183 183
@@ -188,23 +188,21 @@ Refer to the following upgrade notes for information on upgrading specific
188OpenStack services: 188OpenStack services:
189 189
190* `Networking service (neutron) upgrades 190* `Networking service (neutron) upgrades
191 <https://docs.openstack.org/developer/neutron/devref/upgrade.html>`_ 191 <https://docs.openstack.org/neutron/latest/contributor/internals/upgrade.html>`_
192* `Compute service (nova) upgrades 192* `Compute service (nova) upgrades
193 <https://docs.openstack.org/developer/nova/upgrade.html>`_ 193 <https://docs.openstack.org/nova/latest/user/upgrade.html>`_
194* `Identity service (keystone) upgrades 194* `Identity service (keystone) upgrades
195 <https://docs.openstack.org/developer/keystone/upgrading.html>`_ 195 <https://docs.openstack.org/keystone/latest/admin/identity-upgrading.html>`_
196* `Block Storage service (cinder) upgrades 196* `Block Storage service (cinder) upgrades
197 <https://docs.openstack.org/developer/cinder/upgrade.html>`_ 197 <https://docs.openstack.org/cinder/latest/upgrade.html>`_
198* `Image service (glance) zero downtime database upgrades 198* `Image service (glance) database upgrades
199 <https://docs.openstack.org/developer/glance/db.html#zero-downtime-database-upgrades>`_ 199 <https://docs.openstack.org/glance/latest/admin/db.html>`_
200* `Image service (glance) rolling upgrades
201 <https://docs.openstack.org/developer/glance/rollingupgrades.html>`_
202* `Bare Metal service (ironic) upgrades 200* `Bare Metal service (ironic) upgrades
203 <https://docs.openstack.org/developer/ironic/deploy/upgrade-guide.html>`_ 201 <https://docs.openstack.org/ironic/latest/admin/upgrade-guide.html>`_
204* `Object Storage service (swift) upgrades 202* `Object Storage service (swift) upgrades
205 <https://docs.openstack.org/developer/swift/overview_policies.html#upgrade-policy>`_ 203 <https://docs.openstack.org/swift/latest/overview_policies.html#upgrading-and-confirming-functionality>`_
206* `Telemetry service (ceilometer) upgrades 204* `Telemetry service (ceilometer) upgrades
207 <https://docs.openstack.org/developer/ceilometer/install/upgrade.html>`_ 205 <https://docs.openstack.org/ceilometer/ocata/install/upgrade.html>`_
208 206
209Prerequisites 207Prerequisites
210------------- 208-------------
@@ -253,7 +251,7 @@ Perform a backup
253 251
254 Consider updating your SQL server configuration as described in the 252 Consider updating your SQL server configuration as described in the
255 `Installation Tutorials and Guides 253 `Installation Tutorials and Guides
256 <https://docs.openstack.org/project-install-guide/ocata/>`_. 254 <https://docs.openstack.org/rocky/install/>`_.
257 255
258Manage repositories 256Manage repositories
259------------------- 257-------------------
diff --git a/doc/source/ops-user-facing-operations.rst b/doc/source/ops-user-facing-operations.rst
index d1e41ba..dba7cd4 100644
--- a/doc/source/ops-user-facing-operations.rst
+++ b/doc/source/ops-user-facing-operations.rst
@@ -883,7 +883,7 @@ The default configuration of the Shared File Systems service depends on
883the back-end driver the admin chooses when starting the Shared File 883the back-end driver the admin chooses when starting the Shared File
884Systems service. For more information about existing back-end drivers, 884Systems service. For more information about existing back-end drivers,
885see `Share Backends 885see `Share Backends
886<https://docs.openstack.org/developer/manila/devref/index.html#share-backends>`__ 886<https://docs.openstack.org/manila/latest/admin/index.html#supported-share-back-ends>`__
887of Shared File Systems service Developer Guide. For example, in case of 887of Shared File Systems service Developer Guide. For example, in case of
888OpenStack Block Storage based back-end is used, the Shared File Systems 888OpenStack Block Storage based back-end is used, the Shared File Systems
889service cares about everything, including VMs, networking, keypairs, and 889service cares about everything, including VMs, networking, keypairs, and
@@ -907,37 +907,37 @@ large number of operations with shares:
907* Use security services 907* Use security services
908 908
909For more information on share management see `Share management 909For more information on share management see `Share management
910<https://docs.openstack.org/admin-guide/shared-file-systems-share-management.html>`__ 910<https://docs.openstack.org/manila/latest/admin/shared-file-systems-share-management.html>`__
911of chapter “Shared File Systems” in OpenStack Administrator Guide. 911in OpenStack Manila Administrator Guide.
912As to Security services, you should remember that different drivers 912As to Security services, you should remember that different drivers
913support different authentication methods, while generic driver does not 913support different authentication methods, while generic driver does not
914support Security Services at all (see section `Security services 914support Security Services at all (see section `Security services
915<https://docs.openstack.org/admin-guide/shared-file-systems-security-services.html>`__ 915<https://docs.openstack.org/manila/latest/admin/shared-file-systems-security-services.html>`__
916of chapter “Shared File Systems” in OpenStack Administrator Guide). 916in OpenStack Manila Administrator Guide).
917 917
918You can create a share in a network, list shares, and show information 918You can create a share in a network, list shares, and show information
919for, update, and delete a specified share. You can also create snapshots 919for, update, and delete a specified share. You can also create snapshots
920of shares (see `Share snapshots 920of shares (see `Share snapshots
921<https://docs.openstack.org/admin-guide/shared-file-systems-snapshots.html>`__ 921<https://docs.openstack.org/manila/latest/admin/shared-file-systems-snapshots.html>`__
922of chapter “Shared File Systems” in OpenStack Administrator Guide). 922in OpenStack Manila Administrator Guide).
923 923
924There are default and specific share types that allow you to filter or 924There are default and specific share types that allow you to filter or
925choose back-ends before you create a share. Functions and behaviour of 925choose back-ends before you create a share. Functions and behaviour of
926share type is similar to Block Storage volume type (see `Share types 926share type is similar to Block Storage volume type (see `Share types
927<https://docs.openstack.org/admin-guide/shared-file-systems-share-types.html>`__ 927<https://docs.openstack.org/manila/latest/admin/shared-file-systems-share-types.html>`__
928of chapter “Shared File Systems” in OpenStack Administrator Guide). 928in OpenStack Manila Administrator Guide).
929 929
930To help users keep and restore their data, Shared File Systems service 930To help users keep and restore their data, Shared File Systems service
931provides a mechanism to create and operate snapshots (see `Share snapshots 931provides a mechanism to create and operate snapshots (see `Share snapshots
932<https://docs.openstack.org/admin-guide/shared-file-systems-snapshots.html>`__ 932<https://docs.openstack.org/manila/latest/admin/shared-file-systems-snapshots.html>`__
933of chapter “Shared File Systems” in OpenStack Administrator Guide). 933in OpenStack Manila Administrator Guide).
934 934
935A security service stores configuration information for clients for 935A security service stores configuration information for clients for
936authentication and authorization. Inside Manila a share network can be 936authentication and authorization. Inside Manila a share network can be
937associated with up to three security types (for detailed information see 937associated with up to three security types (for detailed information see
938`Security services 938`Security services
939<https://docs.openstack.org/admin-guide/shared-file-systems-security-services.html>`__ 939<https://docs.openstack.org/manila/latest/admin/shared-file-systems-security-services.html>`__
940of chapter “Shared File Systems” in OpenStack Administrator Guide): 940in OpenStack Manila Administrator Guide).
941 941
942* LDAP 942* LDAP
943* Kerberos 943* Kerberos
@@ -958,16 +958,14 @@ called StandaloneNetworkPlugin is used. In this case, provide network
958information in the configuration: IP range, network type, and 958information in the configuration: IP range, network type, and
959segmentation ID. Also you can add security services to a share network 959segmentation ID. Also you can add security services to a share network
960(see section 960(see section
961`“Networking” <https://docs.openstack.org/admin-guide/shared-file-systems-networking.html>`__ 961`“Networking” <https://docs.openstack.org/manila/latest/admin/shared-file-systems-networking.html>`__
962of chapter “Shared File Systems” in OpenStack Administrator Guide). 962in OpenStack Manila Administrator Guide).
963 963
964 964
965The main idea of consistency groups is to enable you to create snapshots 965The main idea of consistency groups is to enable you to create snapshots
966at the exact same point in time from multiple file system shares. Those 966at the exact same point in time from multiple file system shares. Those
967snapshots can be then used for restoring all shares that were associated 967snapshots can be then used for restoring all shares that were associated
968with the consistency group (see section `“Consistency 968with the consistency group.
969groups” <https://docs.openstack.org/admin-guide/shared-file-systems-cgroups.html>`__
970of chapter “Shared File Systems” in OpenStack Administrator Guide).
971 969
972Shared File System storage allows administrators to set limits and 970Shared File System storage allows administrators to set limits and
973quotas for specific tenants and users. Limits are the resource 971quotas for specific tenants and users. Limits are the resource
@@ -1259,7 +1257,7 @@ specified access rules:
1259 1257
1260 For the details of features supported by different drivers see 1258 For the details of features supported by different drivers see
1261 `Manila share features support mapping 1259 `Manila share features support mapping
1262 <https://docs.openstack.org/developer/manila/devref/share_back_ends_feature_support_mapping.html>`__ 1260 <https://docs.openstack.org/manila/latest/admin/index.html#supported-share-back-ends>`__
1263 of Manila Developer Guide document. 1261 of Manila Developer Guide document.
1264 1262
1265Manage Shares 1263Manage Shares
diff --git a/doc/source/preface.rst b/doc/source/preface.rst
index 0c82c2e..cf187ab 100644
--- a/doc/source/preface.rst
+++ b/doc/source/preface.rst
@@ -284,7 +284,7 @@ We wrote this book to help you:
284 284
285We wrote this book in a book sprint, which is a facilitated, rapid 285We wrote this book in a book sprint, which is a facilitated, rapid
286development production method for books. For more information, see the 286development production method for books. For more information, see the
287`BookSprints site <http://www.booksprints.net/>`_. Your authors cobbled 287`BookSprints site <https://www.booksprints.net/>`_. Your authors cobbled
288this book together in five days during February 2013, fueled by caffeine 288this book together in five days during February 2013, fueled by caffeine
289and the best takeout food that Austin, Texas, could offer. 289and the best takeout food that Austin, Texas, could offer.
290 290
@@ -332,7 +332,7 @@ Lorin Hochstein
332Adam Hyde 332Adam Hyde
333 Adam facilitated this book sprint. He also founded the book sprint 333 Adam facilitated this book sprint. He also founded the book sprint
334 methodology and is the most experienced book-sprint facilitator 334 methodology and is the most experienced book-sprint facilitator
335 around. See `BookSprints <http://www.booksprints.net>`_ for more 335 around. See `BookSprints <https://www.booksprints.net>`_ for more
336 information. Adam founded FLOSS Manuals—a community of some 3,000 336 information. Adam founded FLOSS Manuals—a community of some 3,000
337 individuals developing Free Manuals about Free Software. He is also the 337 individuals developing Free Manuals about Free Software. He is also the
338 founder and project manager for Booktype, an open source project for 338 founder and project manager for Booktype, an open source project for