nautobot 2.2.3__py3-none-any.whl → 2.2.4__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of nautobot might be problematic. Click here for more details.

Files changed (301) hide show
  1. nautobot/core/settings.py +6 -4
  2. nautobot/core/settings.yaml +51 -16
  3. nautobot/core/templates/admin/base.html +2 -2
  4. nautobot/core/templates/base_django.html +2 -2
  5. nautobot/core/templates/buttons/export.html +47 -47
  6. nautobot/core/templates/inc/javascript.html +3 -0
  7. nautobot/core/templates/inc/media.html +3 -0
  8. nautobot/core/templates/login.html +2 -2
  9. nautobot/core/templates/nautobot_config.py.j2 +2 -0
  10. nautobot/core/tests/test_jobs.py +79 -2
  11. nautobot/core/tests/test_views.py +33 -0
  12. nautobot/core/views/mixins.py +4 -0
  13. nautobot/dcim/tests/test_views.py +239 -55
  14. nautobot/dcim/views.py +23 -20
  15. nautobot/extras/api/serializers.py +17 -6
  16. nautobot/extras/tests/test_context_managers.py +18 -0
  17. nautobot/extras/utils.py +2 -1
  18. nautobot/extras/views.py +35 -21
  19. nautobot/ipam/views.py +6 -6
  20. nautobot/project-static/docs/404.html +107 -51
  21. nautobot/project-static/docs/apps/index.html +107 -51
  22. nautobot/project-static/docs/apps/nautobot-apps.html +107 -51
  23. nautobot/project-static/docs/assets/_mkdocstrings.css +6 -1
  24. nautobot/project-static/docs/assets/extra.css +7 -0
  25. nautobot/project-static/docs/assets/javascripts/bundle.3220b9d7.min.js +29 -0
  26. nautobot/project-static/docs/assets/javascripts/bundle.3220b9d7.min.js.map +7 -0
  27. nautobot/project-static/docs/assets/stylesheets/main.66ac8b77.min.css +1 -0
  28. nautobot/project-static/docs/assets/stylesheets/main.66ac8b77.min.css.map +1 -0
  29. nautobot/project-static/docs/code-reference/nautobot/apps/__init__.html +107 -51
  30. nautobot/project-static/docs/code-reference/nautobot/apps/admin.html +107 -51
  31. nautobot/project-static/docs/code-reference/nautobot/apps/api.html +107 -51
  32. nautobot/project-static/docs/code-reference/nautobot/apps/change_logging.html +107 -51
  33. nautobot/project-static/docs/code-reference/nautobot/apps/choices.html +107 -51
  34. nautobot/project-static/docs/code-reference/nautobot/apps/config.html +107 -51
  35. nautobot/project-static/docs/code-reference/nautobot/apps/constants.html +107 -51
  36. nautobot/project-static/docs/code-reference/nautobot/apps/datasources.html +107 -51
  37. nautobot/project-static/docs/code-reference/nautobot/apps/exceptions.html +107 -51
  38. nautobot/project-static/docs/code-reference/nautobot/apps/factory.html +107 -51
  39. nautobot/project-static/docs/code-reference/nautobot/apps/filters.html +107 -51
  40. nautobot/project-static/docs/code-reference/nautobot/apps/forms.html +107 -51
  41. nautobot/project-static/docs/code-reference/nautobot/apps/graphql.html +107 -51
  42. nautobot/project-static/docs/code-reference/nautobot/apps/jobs.html +107 -51
  43. nautobot/project-static/docs/code-reference/nautobot/apps/models.html +107 -51
  44. nautobot/project-static/docs/code-reference/nautobot/apps/querysets.html +107 -51
  45. nautobot/project-static/docs/code-reference/nautobot/apps/secrets.html +107 -51
  46. nautobot/project-static/docs/code-reference/nautobot/apps/tables.html +107 -51
  47. nautobot/project-static/docs/code-reference/nautobot/apps/testing.html +107 -51
  48. nautobot/project-static/docs/code-reference/nautobot/apps/ui.html +107 -51
  49. nautobot/project-static/docs/code-reference/nautobot/apps/urls.html +107 -51
  50. nautobot/project-static/docs/code-reference/nautobot/apps/utils.html +107 -51
  51. nautobot/project-static/docs/code-reference/nautobot/apps/views.html +107 -51
  52. nautobot/project-static/docs/development/apps/api/configuration-view.html +110 -54
  53. nautobot/project-static/docs/development/apps/api/database-backend-config.html +110 -54
  54. nautobot/project-static/docs/development/apps/api/models/django-admin.html +107 -51
  55. nautobot/project-static/docs/development/apps/api/models/global-search.html +110 -54
  56. nautobot/project-static/docs/development/apps/api/models/graphql.html +113 -57
  57. nautobot/project-static/docs/development/apps/api/models/index.html +107 -51
  58. nautobot/project-static/docs/development/apps/api/nautobot-app-config.html +113 -57
  59. nautobot/project-static/docs/development/apps/api/platform-features/custom-validators.html +107 -51
  60. nautobot/project-static/docs/development/apps/api/platform-features/filter-extensions.html +110 -54
  61. nautobot/project-static/docs/development/apps/api/platform-features/git-repository-content.html +107 -51
  62. nautobot/project-static/docs/development/apps/api/platform-features/index.html +107 -51
  63. nautobot/project-static/docs/development/apps/api/platform-features/jinja2-filters.html +110 -54
  64. nautobot/project-static/docs/development/apps/api/platform-features/jobs.html +110 -54
  65. nautobot/project-static/docs/development/apps/api/platform-features/populating-extensibility-features.html +110 -54
  66. nautobot/project-static/docs/development/apps/api/platform-features/secrets-providers.html +110 -54
  67. nautobot/project-static/docs/development/apps/api/platform-features/uniquely-identify-objects.html +107 -51
  68. nautobot/project-static/docs/development/apps/api/prometheus.html +110 -54
  69. nautobot/project-static/docs/development/apps/api/setup.html +107 -51
  70. nautobot/project-static/docs/development/apps/api/testing.html +113 -57
  71. nautobot/project-static/docs/development/apps/api/ui-extensions/banners.html +110 -54
  72. nautobot/project-static/docs/development/apps/api/ui-extensions/home-page.html +110 -54
  73. nautobot/project-static/docs/development/apps/api/ui-extensions/index.html +107 -51
  74. nautobot/project-static/docs/development/apps/api/ui-extensions/navigation.html +107 -51
  75. nautobot/project-static/docs/development/apps/api/ui-extensions/object-views.html +113 -57
  76. nautobot/project-static/docs/development/apps/api/views/base-template.html +107 -51
  77. nautobot/project-static/docs/development/apps/api/views/core-view-overrides.html +110 -54
  78. nautobot/project-static/docs/development/apps/api/views/django-generic-views.html +107 -51
  79. nautobot/project-static/docs/development/apps/api/views/help-documentation.html +110 -54
  80. nautobot/project-static/docs/development/apps/api/views/index.html +107 -51
  81. nautobot/project-static/docs/development/apps/api/views/nautobot-generic-views.html +113 -57
  82. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewset.html +122 -66
  83. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewsetrouter.html +110 -54
  84. nautobot/project-static/docs/development/apps/api/views/notes.html +110 -54
  85. nautobot/project-static/docs/development/apps/api/views/rest-api.html +107 -51
  86. nautobot/project-static/docs/development/apps/api/views/urls.html +107 -51
  87. nautobot/project-static/docs/development/apps/index.html +128 -72
  88. nautobot/project-static/docs/development/apps/migration/code-updates.html +107 -51
  89. nautobot/project-static/docs/development/apps/migration/dependency-updates.html +107 -51
  90. nautobot/project-static/docs/development/apps/migration/from-v1.html +107 -51
  91. nautobot/project-static/docs/development/apps/migration/model-updates/dcim.html +107 -51
  92. nautobot/project-static/docs/development/apps/migration/model-updates/extras.html +107 -51
  93. nautobot/project-static/docs/development/apps/migration/model-updates/global.html +107 -51
  94. nautobot/project-static/docs/development/apps/migration/model-updates/ipam.html +107 -51
  95. nautobot/project-static/docs/development/apps/porting-from-netbox.html +110 -54
  96. nautobot/project-static/docs/development/core/application-registry.html +119 -63
  97. nautobot/project-static/docs/development/core/best-practices.html +122 -66
  98. nautobot/project-static/docs/development/core/bootstrap-ui.html +107 -51
  99. nautobot/project-static/docs/development/core/caching.html +107 -51
  100. nautobot/project-static/docs/development/core/controllers.html +107 -51
  101. nautobot/project-static/docs/development/core/docker-compose-advanced-use-cases.html +113 -57
  102. nautobot/project-static/docs/development/core/generic-views.html +110 -54
  103. nautobot/project-static/docs/development/core/getting-started.html +135 -79
  104. nautobot/project-static/docs/development/core/homepage.html +110 -54
  105. nautobot/project-static/docs/development/core/index.html +107 -51
  106. nautobot/project-static/docs/development/core/model-checklist.html +107 -51
  107. nautobot/project-static/docs/development/core/model-features.html +107 -51
  108. nautobot/project-static/docs/development/core/natural-keys.html +110 -54
  109. nautobot/project-static/docs/development/core/navigation-menu.html +107 -51
  110. nautobot/project-static/docs/development/core/release-checklist.html +107 -51
  111. nautobot/project-static/docs/development/core/role-internals.html +107 -51
  112. nautobot/project-static/docs/development/core/settings.html +107 -51
  113. nautobot/project-static/docs/development/core/style-guide.html +110 -54
  114. nautobot/project-static/docs/development/core/templates.html +113 -57
  115. nautobot/project-static/docs/development/core/testing.html +125 -69
  116. nautobot/project-static/docs/development/core/user-preferences.html +107 -51
  117. nautobot/project-static/docs/development/index.html +107 -51
  118. nautobot/project-static/docs/development/jobs/index.html +173 -117
  119. nautobot/project-static/docs/development/jobs/migration/from-v1.html +110 -54
  120. nautobot/project-static/docs/docker/index.html +3 -3
  121. nautobot/project-static/docs/index.html +125 -69
  122. nautobot/project-static/docs/installation/selinux-troubleshooting.html +3 -3
  123. nautobot/project-static/docs/release-notes/index.html +107 -51
  124. nautobot/project-static/docs/release-notes/version-1.0.html +107 -51
  125. nautobot/project-static/docs/release-notes/version-1.1.html +107 -51
  126. nautobot/project-static/docs/release-notes/version-1.2.html +107 -51
  127. nautobot/project-static/docs/release-notes/version-1.3.html +107 -51
  128. nautobot/project-static/docs/release-notes/version-1.4.html +107 -51
  129. nautobot/project-static/docs/release-notes/version-1.5.html +116 -60
  130. nautobot/project-static/docs/release-notes/version-1.6.html +107 -51
  131. nautobot/project-static/docs/release-notes/version-2.0.html +110 -54
  132. nautobot/project-static/docs/release-notes/version-2.1.html +107 -51
  133. nautobot/project-static/docs/release-notes/version-2.2.html +321 -117
  134. nautobot/project-static/docs/requirements.txt +2 -2
  135. nautobot/project-static/docs/search/search_index.json +1 -1
  136. nautobot/project-static/docs/sitemap.xml +262 -262
  137. nautobot/project-static/docs/sitemap.xml.gz +0 -0
  138. nautobot/project-static/docs/user-guide/administration/configuration/authentication/ldap.html +107 -51
  139. nautobot/project-static/docs/user-guide/administration/configuration/authentication/remote.html +107 -51
  140. nautobot/project-static/docs/user-guide/administration/configuration/authentication/sso.html +107 -51
  141. nautobot/project-static/docs/user-guide/administration/configuration/index.html +107 -51
  142. nautobot/project-static/docs/user-guide/administration/configuration/optional-settings.html +251 -164
  143. nautobot/project-static/docs/user-guide/administration/configuration/required-settings.html +113 -57
  144. nautobot/project-static/docs/user-guide/administration/configuration/time-zones.html +107 -51
  145. nautobot/project-static/docs/user-guide/administration/guides/caching.html +113 -57
  146. nautobot/project-static/docs/user-guide/administration/guides/celery-queues.html +107 -51
  147. nautobot/project-static/docs/user-guide/administration/guides/healthcheck.html +107 -51
  148. nautobot/project-static/docs/user-guide/administration/guides/permissions.html +107 -51
  149. nautobot/project-static/docs/user-guide/administration/guides/prometheus-metrics.html +113 -57
  150. nautobot/project-static/docs/user-guide/administration/guides/replicating-nautobot.html +107 -51
  151. nautobot/project-static/docs/user-guide/administration/guides/request-profiling.html +107 -51
  152. nautobot/project-static/docs/user-guide/administration/guides/s3-django-storage.html +107 -51
  153. nautobot/project-static/docs/user-guide/administration/installation/app-install.html +171 -112
  154. nautobot/project-static/docs/user-guide/administration/installation/docker.html +13 -8626
  155. nautobot/project-static/docs/user-guide/administration/installation/external-authentication.html +117 -61
  156. nautobot/project-static/docs/user-guide/administration/installation/health-checks.html +13 -8614
  157. nautobot/project-static/docs/user-guide/administration/installation/http-server.html +252 -165
  158. nautobot/project-static/docs/user-guide/administration/installation/index.html +165 -192
  159. nautobot/project-static/docs/user-guide/administration/installation/install_system.html +411 -691
  160. nautobot/project-static/docs/user-guide/administration/installation/nautobot.html +248 -229
  161. nautobot/project-static/docs/user-guide/administration/installation/selinux-troubleshooting.html +13 -8118
  162. nautobot/project-static/docs/user-guide/administration/installation/services.html +350 -240
  163. nautobot/project-static/docs/user-guide/administration/installation-extras/docker.html +8684 -0
  164. nautobot/project-static/docs/user-guide/administration/installation-extras/health-checks.html +8672 -0
  165. nautobot/project-static/docs/user-guide/administration/installation-extras/selinux-troubleshooting.html +8176 -0
  166. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-netbox.html +110 -54
  167. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-postgresql.html +110 -54
  168. nautobot/project-static/docs/user-guide/administration/tools/nautobot-server.html +155 -99
  169. nautobot/project-static/docs/user-guide/administration/tools/nautobot-shell.html +107 -51
  170. nautobot/project-static/docs/user-guide/administration/upgrading/database-backup.html +109 -53
  171. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/after-you-upgrade.html +107 -51
  172. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/before-you-upgrade.html +107 -51
  173. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/for-developers.html +107 -51
  174. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/index.html +107 -51
  175. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/whats-changed.html +107 -51
  176. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/region-and-site-data-migration-guide.html +107 -51
  177. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/upgrading-from-nautobot-v1.html +113 -57
  178. nautobot/project-static/docs/user-guide/administration/upgrading/upgrading.html +113 -57
  179. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuit.html +107 -51
  180. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittermination.html +107 -51
  181. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittype.html +107 -51
  182. nautobot/project-static/docs/user-guide/core-data-model/circuits/provider.html +107 -51
  183. nautobot/project-static/docs/user-guide/core-data-model/circuits/providernetwork.html +110 -54
  184. nautobot/project-static/docs/user-guide/core-data-model/dcim/cable.html +107 -51
  185. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleport.html +110 -54
  186. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleporttemplate.html +110 -54
  187. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverport.html +110 -54
  188. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverporttemplate.html +110 -54
  189. nautobot/project-static/docs/user-guide/core-data-model/dcim/controller.html +107 -51
  190. nautobot/project-static/docs/user-guide/core-data-model/dcim/controllermanageddevicegroup.html +107 -51
  191. nautobot/project-static/docs/user-guide/core-data-model/dcim/device.html +113 -57
  192. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebay.html +110 -54
  193. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebaytemplate.html +110 -54
  194. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicefamily.html +110 -54
  195. nautobot/project-static/docs/user-guide/core-data-model/dcim/deviceredundancygroup.html +110 -54
  196. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicetype.html +116 -60
  197. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontport.html +110 -54
  198. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontporttemplate.html +110 -54
  199. nautobot/project-static/docs/user-guide/core-data-model/dcim/interface.html +119 -63
  200. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfaceredundancygroup.html +110 -54
  201. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfacetemplate.html +110 -54
  202. nautobot/project-static/docs/user-guide/core-data-model/dcim/inventoryitem.html +113 -57
  203. nautobot/project-static/docs/user-guide/core-data-model/dcim/location.html +113 -57
  204. nautobot/project-static/docs/user-guide/core-data-model/dcim/locationtype.html +113 -57
  205. nautobot/project-static/docs/user-guide/core-data-model/dcim/manufacturer.html +107 -51
  206. nautobot/project-static/docs/user-guide/core-data-model/dcim/platform.html +113 -57
  207. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerfeed.html +107 -51
  208. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlet.html +110 -54
  209. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlettemplate.html +110 -54
  210. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerpanel.html +107 -51
  211. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerport.html +110 -54
  212. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerporttemplate.html +110 -54
  213. nautobot/project-static/docs/user-guide/core-data-model/dcim/rack.html +107 -51
  214. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackgroup.html +107 -51
  215. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackreservation.html +107 -51
  216. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearport.html +110 -54
  217. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearporttemplate.html +110 -54
  218. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareimagefile.html +110 -54
  219. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareversion.html +110 -54
  220. nautobot/project-static/docs/user-guide/core-data-model/dcim/virtualchassis.html +107 -51
  221. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontext.html +113 -57
  222. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontextschema.html +110 -54
  223. nautobot/project-static/docs/user-guide/core-data-model/extras/contact.html +110 -54
  224. nautobot/project-static/docs/user-guide/core-data-model/extras/team.html +110 -54
  225. nautobot/project-static/docs/user-guide/core-data-model/ipam/ipaddress.html +125 -69
  226. nautobot/project-static/docs/user-guide/core-data-model/ipam/namespace.html +113 -57
  227. nautobot/project-static/docs/user-guide/core-data-model/ipam/prefix.html +128 -72
  228. nautobot/project-static/docs/user-guide/core-data-model/ipam/rir.html +110 -54
  229. nautobot/project-static/docs/user-guide/core-data-model/ipam/routetarget.html +107 -51
  230. nautobot/project-static/docs/user-guide/core-data-model/ipam/service.html +110 -54
  231. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlan.html +116 -60
  232. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlangroup.html +107 -51
  233. nautobot/project-static/docs/user-guide/core-data-model/ipam/vrf.html +113 -57
  234. nautobot/project-static/docs/user-guide/core-data-model/overview/introduction.html +107 -51
  235. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenant.html +110 -54
  236. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenantgroup.html +107 -51
  237. nautobot/project-static/docs/user-guide/core-data-model/virtualization/cluster.html +107 -51
  238. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustergroup.html +107 -51
  239. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustertype.html +107 -51
  240. nautobot/project-static/docs/user-guide/core-data-model/virtualization/virtualmachine.html +113 -57
  241. nautobot/project-static/docs/user-guide/core-data-model/virtualization/vminterface.html +113 -57
  242. nautobot/project-static/docs/user-guide/feature-guides/contacts-and-teams.html +107 -51
  243. nautobot/project-static/docs/user-guide/feature-guides/custom-fields.html +113 -57
  244. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-devices.html +107 -51
  245. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-location-types-and-locations.html +107 -51
  246. nautobot/project-static/docs/user-guide/feature-guides/getting-started/index.html +107 -51
  247. nautobot/project-static/docs/user-guide/feature-guides/getting-started/interfaces.html +107 -51
  248. nautobot/project-static/docs/user-guide/feature-guides/getting-started/ipam.html +107 -51
  249. nautobot/project-static/docs/user-guide/feature-guides/getting-started/platforms.html +107 -51
  250. nautobot/project-static/docs/user-guide/feature-guides/getting-started/search-bar.html +107 -51
  251. nautobot/project-static/docs/user-guide/feature-guides/getting-started/tenants.html +107 -51
  252. nautobot/project-static/docs/user-guide/feature-guides/getting-started/vlans-and-vlan-groups.html +107 -51
  253. nautobot/project-static/docs/user-guide/feature-guides/git-data-source.html +110 -54
  254. nautobot/project-static/docs/user-guide/feature-guides/graphql.html +113 -57
  255. nautobot/project-static/docs/user-guide/feature-guides/ip-address-merge-tool.html +107 -51
  256. nautobot/project-static/docs/user-guide/feature-guides/relationships.html +110 -54
  257. nautobot/project-static/docs/user-guide/feature-guides/software-image-files-and-versions.html +107 -51
  258. nautobot/project-static/docs/user-guide/index.html +109 -53
  259. nautobot/project-static/docs/user-guide/platform-functionality/change-logging.html +107 -51
  260. nautobot/project-static/docs/user-guide/platform-functionality/computedfield.html +113 -57
  261. nautobot/project-static/docs/user-guide/platform-functionality/customfield.html +128 -72
  262. nautobot/project-static/docs/user-guide/platform-functionality/customlink.html +107 -51
  263. nautobot/project-static/docs/user-guide/platform-functionality/dynamicgroup.html +125 -69
  264. nautobot/project-static/docs/user-guide/platform-functionality/exporttemplate.html +107 -51
  265. nautobot/project-static/docs/user-guide/platform-functionality/externalintegration.html +110 -54
  266. nautobot/project-static/docs/user-guide/platform-functionality/gitrepository.html +125 -69
  267. nautobot/project-static/docs/user-guide/platform-functionality/graphql.html +110 -54
  268. nautobot/project-static/docs/user-guide/platform-functionality/graphqlquery.html +107 -51
  269. nautobot/project-static/docs/user-guide/platform-functionality/imageattachment.html +107 -51
  270. nautobot/project-static/docs/user-guide/platform-functionality/jobs/index.html +128 -72
  271. nautobot/project-static/docs/user-guide/platform-functionality/jobs/job-scheduling-and-approvals.html +113 -57
  272. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobbutton.html +113 -57
  273. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobhook.html +110 -54
  274. nautobot/project-static/docs/user-guide/platform-functionality/jobs/models.html +119 -63
  275. nautobot/project-static/docs/user-guide/platform-functionality/napalm.html +107 -51
  276. nautobot/project-static/docs/user-guide/platform-functionality/note.html +110 -54
  277. nautobot/project-static/docs/user-guide/platform-functionality/relationship.html +116 -60
  278. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/authentication.html +110 -54
  279. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/filtering.html +131 -75
  280. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/overview.html +149 -93
  281. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/ui-related-endpoints.html +110 -54
  282. nautobot/project-static/docs/user-guide/platform-functionality/role.html +107 -51
  283. nautobot/project-static/docs/user-guide/platform-functionality/secret.html +116 -60
  284. nautobot/project-static/docs/user-guide/platform-functionality/status.html +119 -63
  285. nautobot/project-static/docs/user-guide/platform-functionality/tag.html +110 -54
  286. nautobot/project-static/docs/user-guide/platform-functionality/template-filters.html +137 -81
  287. nautobot/project-static/docs/user-guide/platform-functionality/users/objectpermission.html +110 -54
  288. nautobot/project-static/docs/user-guide/platform-functionality/users/token.html +107 -51
  289. nautobot/project-static/docs/user-guide/platform-functionality/webhook.html +110 -54
  290. nautobot/tenancy/views.py +2 -6
  291. nautobot/virtualization/views.py +5 -9
  292. {nautobot-2.2.3.dist-info → nautobot-2.2.4.dist-info}/METADATA +2 -2
  293. {nautobot-2.2.3.dist-info → nautobot-2.2.4.dist-info}/RECORD +297 -294
  294. nautobot/project-static/docs/assets/javascripts/bundle.bd41221c.min.js +0 -29
  295. nautobot/project-static/docs/assets/javascripts/bundle.bd41221c.min.js.map +0 -7
  296. nautobot/project-static/docs/assets/stylesheets/main.bcfcd587.min.css +0 -1
  297. nautobot/project-static/docs/assets/stylesheets/main.bcfcd587.min.css.map +0 -1
  298. {nautobot-2.2.3.dist-info → nautobot-2.2.4.dist-info}/LICENSE.txt +0 -0
  299. {nautobot-2.2.3.dist-info → nautobot-2.2.4.dist-info}/NOTICE +0 -0
  300. {nautobot-2.2.3.dist-info → nautobot-2.2.4.dist-info}/WHEEL +0 -0
  301. {nautobot-2.2.3.dist-info → nautobot-2.2.4.dist-info}/entry_points.txt +0 -0
@@ -18,7 +18,7 @@
18
18
 
19
19
 
20
20
  <link rel="icon" href="../../../assets/favicon.ico">
21
- <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.16">
21
+ <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.18">
22
22
 
23
23
 
24
24
 
@@ -26,12 +26,20 @@
26
26
 
27
27
 
28
28
 
29
- <link rel="stylesheet" href="../../../assets/stylesheets/main.bcfcd587.min.css">
29
+ <link rel="stylesheet" href="../../../assets/stylesheets/main.66ac8b77.min.css">
30
30
 
31
31
 
32
32
  <link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
33
33
 
34
34
 
35
+
36
+
37
+
38
+
39
+
40
+
41
+ <style>:root{--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M288 0H128c-17.7 0-32 14.3-32 32s14.3 32 32 32v132.8c0 11.8-3.3 23.5-9.5 33.5L10.3 406.2C3.6 417.2 0 429.7 0 442.6 0 480.9 31.1 512 69.4 512h309.2c38.3 0 69.4-31.1 69.4-69.4 0-12.8-3.6-25.4-10.3-36.4L329.5 230.4c-6.2-10.1-9.5-21.7-9.5-33.5V64c17.7 0 32-14.3 32-32S337.7 0 320 0h-32zm-96 196.8V64h64v132.8c0 23.7 6.6 46.9 19 67.1l34.5 56.1h-171l34.5-56.1c12.4-20.2 19-43.4 19-67.1z"/></svg>');}</style>
42
+
35
43
 
36
44
 
37
45
 
@@ -200,7 +208,7 @@
200
208
  <a href="https://github.com/nautobot/nautobot" title="Go to repository" class="md-source" data-md-component="source">
201
209
  <div class="md-source__icon md-icon">
202
210
 
203
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
211
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
204
212
  </div>
205
213
  <div class="md-source__repository">
206
214
  GitHub
@@ -360,7 +368,7 @@
360
368
  <a href="https://github.com/nautobot/nautobot" title="Go to repository" class="md-source" data-md-component="source">
361
369
  <div class="md-source__icon md-icon">
362
370
 
363
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
371
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
364
372
  </div>
365
373
  <div class="md-source__repository">
366
374
  GitHub
@@ -532,7 +540,7 @@
532
540
 
533
541
 
534
542
  <span class="md-ellipsis">
535
- Prerequisites
543
+ Getting Started
536
544
  </span>
537
545
 
538
546
 
@@ -613,168 +621,6 @@
613
621
  <nav class="md-nav" aria-label="Database Setup">
614
622
  <ul class="md-nav__list">
615
623
 
616
- <li class="md-nav__item">
617
- <a href="#install-postgresql" class="md-nav__link">
618
- <span class="md-ellipsis">
619
- Install PostgreSQL
620
- </span>
621
- </a>
622
-
623
- </li>
624
-
625
- <li class="md-nav__item">
626
- <a href="#create-a-postgresql-database" class="md-nav__link">
627
- <span class="md-ellipsis">
628
- Create a PostgreSQL Database
629
- </span>
630
- </a>
631
-
632
- <nav class="md-nav" aria-label="Create a PostgreSQL Database">
633
- <ul class="md-nav__list">
634
-
635
- <li class="md-nav__item">
636
- <a href="#verify-postgresql-service-status" class="md-nav__link">
637
- <span class="md-ellipsis">
638
- Verify PostgreSQL Service Status
639
- </span>
640
- </a>
641
-
642
- </li>
643
-
644
- </ul>
645
- </nav>
646
-
647
- </li>
648
-
649
- <li class="md-nav__item">
650
- <a href="#install-mysql" class="md-nav__link">
651
- <span class="md-ellipsis">
652
- Install MySQL
653
- </span>
654
- </a>
655
-
656
- </li>
657
-
658
- <li class="md-nav__item">
659
- <a href="#create-a-mysql-database" class="md-nav__link">
660
- <span class="md-ellipsis">
661
- Create a MySQL Database
662
- </span>
663
- </a>
664
-
665
- <nav class="md-nav" aria-label="Create a MySQL Database">
666
- <ul class="md-nav__list">
667
-
668
- <li class="md-nav__item">
669
- <a href="#verify-mysql-service-status" class="md-nav__link">
670
- <span class="md-ellipsis">
671
- Verify MySQL Service Status
672
- </span>
673
- </a>
674
-
675
- </li>
676
-
677
- </ul>
678
- </nav>
679
-
680
- </li>
681
-
682
- <li class="md-nav__item">
683
- <a href="#install-postgresql_1" class="md-nav__link">
684
- <span class="md-ellipsis">
685
- Install PostgreSQL
686
- </span>
687
- </a>
688
-
689
- </li>
690
-
691
- <li class="md-nav__item">
692
- <a href="#initialize-postgresql" class="md-nav__link">
693
- <span class="md-ellipsis">
694
- Initialize PostgreSQL
695
- </span>
696
- </a>
697
-
698
- </li>
699
-
700
- <li class="md-nav__item">
701
- <a href="#configure-authentication" class="md-nav__link">
702
- <span class="md-ellipsis">
703
- Configure Authentication
704
- </span>
705
- </a>
706
-
707
- <nav class="md-nav" aria-label="Configure Authentication">
708
- <ul class="md-nav__list">
709
-
710
- <li class="md-nav__item">
711
- <a href="#start-postgresql" class="md-nav__link">
712
- <span class="md-ellipsis">
713
- Start PostgreSQL
714
- </span>
715
- </a>
716
-
717
- </li>
718
-
719
- <li class="md-nav__item">
720
- <a href="#create-a-postgresql-database_1" class="md-nav__link">
721
- <span class="md-ellipsis">
722
- Create a PostgreSQL Database
723
- </span>
724
- </a>
725
-
726
- </li>
727
-
728
- </ul>
729
- </nav>
730
-
731
- </li>
732
-
733
- <li class="md-nav__item">
734
- <a href="#verify-postgresql-service-status_1" class="md-nav__link">
735
- <span class="md-ellipsis">
736
- Verify PostgreSQL Service Status
737
- </span>
738
- </a>
739
-
740
- </li>
741
-
742
- <li class="md-nav__item">
743
- <a href="#install-mysql_1" class="md-nav__link">
744
- <span class="md-ellipsis">
745
- Install MySQL
746
- </span>
747
- </a>
748
-
749
- </li>
750
-
751
- <li class="md-nav__item">
752
- <a href="#start-mysql" class="md-nav__link">
753
- <span class="md-ellipsis">
754
- Start MySQL
755
- </span>
756
- </a>
757
-
758
- </li>
759
-
760
- <li class="md-nav__item">
761
- <a href="#create-a-mysql-database_1" class="md-nav__link">
762
- <span class="md-ellipsis">
763
- Create a MySQL Database
764
- </span>
765
- </a>
766
-
767
- </li>
768
-
769
- <li class="md-nav__item">
770
- <a href="#verify-mysql-service-status_1" class="md-nav__link">
771
- <span class="md-ellipsis">
772
- Verify MySQL Service Status
773
- </span>
774
- </a>
775
-
776
- </li>
777
-
778
624
  <li class="md-nav__item">
779
625
  <a href="#troubleshooting" class="md-nav__link">
780
626
  <span class="md-ellipsis">
@@ -782,21 +628,6 @@
782
628
  </span>
783
629
  </a>
784
630
 
785
- <nav class="md-nav" aria-label="Troubleshooting">
786
- <ul class="md-nav__list">
787
-
788
- <li class="md-nav__item">
789
- <a href="#djangodbutilsnotsupportederror-conversion-between-utf8-and-sql_ascii-is-not-supported" class="md-nav__link">
790
- <span class="md-ellipsis">
791
- django.db.utils.NotSupportedError: conversion between UTF8 and SQL_ASCII is not supported
792
- </span>
793
- </a>
794
-
795
- </li>
796
-
797
- </ul>
798
- </nav>
799
-
800
631
  </li>
801
632
 
802
633
  </ul>
@@ -811,30 +642,6 @@
811
642
  </span>
812
643
  </a>
813
644
 
814
- <nav class="md-nav" aria-label="Redis Setup">
815
- <ul class="md-nav__list">
816
-
817
- <li class="md-nav__item">
818
- <a href="#start-redis" class="md-nav__link">
819
- <span class="md-ellipsis">
820
- Start Redis
821
- </span>
822
- </a>
823
-
824
- </li>
825
-
826
- <li class="md-nav__item">
827
- <a href="#verify-redis-service-status" class="md-nav__link">
828
- <span class="md-ellipsis">
829
- Verify Redis Service Status
830
- </span>
831
- </a>
832
-
833
- </li>
834
-
835
- </ul>
836
- </nav>
837
-
838
645
  </li>
839
646
 
840
647
  <li class="md-nav__item">
@@ -925,11 +732,11 @@
925
732
 
926
733
 
927
734
  <li class="md-nav__item">
928
- <a href="external-authentication.html" class="md-nav__link">
735
+ <a href="app-install.html" class="md-nav__link">
929
736
 
930
737
 
931
738
  <span class="md-ellipsis">
932
- External Authentication (Optional)
739
+ Installing and Using Apps
933
740
  </span>
934
741
 
935
742
 
@@ -946,11 +753,11 @@
946
753
 
947
754
 
948
755
  <li class="md-nav__item">
949
- <a href="app-install.html" class="md-nav__link">
756
+ <a href="external-authentication.html" class="md-nav__link">
950
757
 
951
758
 
952
759
  <span class="md-ellipsis">
953
- Installing and Using Plugins
760
+ External Authentication (Optional)
954
761
  </span>
955
762
 
956
763
 
@@ -960,6 +767,52 @@
960
767
 
961
768
 
962
769
 
770
+ </ul>
771
+ </nav>
772
+
773
+ </li>
774
+
775
+
776
+
777
+
778
+
779
+
780
+
781
+
782
+
783
+
784
+
785
+
786
+
787
+
788
+
789
+
790
+
791
+ <li class="md-nav__item md-nav__item--nested">
792
+
793
+
794
+
795
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2" >
796
+
797
+
798
+ <label class="md-nav__link" for="__nav_2_1_2" id="__nav_2_1_2_label" tabindex="0">
799
+
800
+
801
+ <span class="md-ellipsis">
802
+ Installation Extras
803
+ </span>
804
+
805
+
806
+ <span class="md-nav__icon md-icon"></span>
807
+ </label>
808
+
809
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_2_label" aria-expanded="false">
810
+ <label class="md-nav__title" for="__nav_2_1_2">
811
+ <span class="md-nav__icon md-icon"></span>
812
+ Installation Extras
813
+ </label>
814
+ <ul class="md-nav__list" data-md-scrollfix>
815
+
963
816
 
964
817
 
965
818
 
@@ -967,7 +820,7 @@
967
820
 
968
821
 
969
822
  <li class="md-nav__item">
970
- <a href="docker.html" class="md-nav__link">
823
+ <a href="../installation-extras/docker.html" class="md-nav__link">
971
824
 
972
825
 
973
826
  <span class="md-ellipsis">
@@ -988,7 +841,7 @@
988
841
 
989
842
 
990
843
  <li class="md-nav__item">
991
- <a href="health-checks.html" class="md-nav__link">
844
+ <a href="../installation-extras/health-checks.html" class="md-nav__link">
992
845
 
993
846
 
994
847
  <span class="md-ellipsis">
@@ -1009,7 +862,7 @@
1009
862
 
1010
863
 
1011
864
  <li class="md-nav__item">
1012
- <a href="selinux-troubleshooting.html" class="md-nav__link">
865
+ <a href="../installation-extras/selinux-troubleshooting.html" class="md-nav__link">
1013
866
 
1014
867
 
1015
868
  <span class="md-ellipsis">
@@ -1048,10 +901,10 @@
1048
901
 
1049
902
 
1050
903
 
1051
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2" >
904
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3" >
1052
905
 
1053
906
 
1054
- <label class="md-nav__link" for="__nav_2_1_2" id="__nav_2_1_2_label" tabindex="0">
907
+ <label class="md-nav__link" for="__nav_2_1_3" id="__nav_2_1_3_label" tabindex="0">
1055
908
 
1056
909
 
1057
910
  <span class="md-ellipsis">
@@ -1062,8 +915,8 @@
1062
915
  <span class="md-nav__icon md-icon"></span>
1063
916
  </label>
1064
917
 
1065
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_2_label" aria-expanded="false">
1066
- <label class="md-nav__title" for="__nav_2_1_2">
918
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_3_label" aria-expanded="false">
919
+ <label class="md-nav__title" for="__nav_2_1_3">
1067
920
  <span class="md-nav__icon md-icon"></span>
1068
921
  Upgrading
1069
922
  </label>
@@ -1128,7 +981,7 @@
1128
981
 
1129
982
 
1130
983
 
1131
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3" >
984
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3_3" >
1132
985
 
1133
986
 
1134
987
 
@@ -1144,14 +997,14 @@
1144
997
  </a>
1145
998
 
1146
999
 
1147
- <label class="md-nav__link " for="__nav_2_1_2_3" id="__nav_2_1_2_3_label" tabindex="0">
1000
+ <label class="md-nav__link " for="__nav_2_1_3_3" id="__nav_2_1_3_3_label" tabindex="0">
1148
1001
  <span class="md-nav__icon md-icon"></span>
1149
1002
  </label>
1150
1003
 
1151
1004
  </div>
1152
1005
 
1153
- <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_3_label" aria-expanded="false">
1154
- <label class="md-nav__title" for="__nav_2_1_2_3">
1006
+ <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_3_3_label" aria-expanded="false">
1007
+ <label class="md-nav__title" for="__nav_2_1_3_3">
1155
1008
  <span class="md-nav__icon md-icon"></span>
1156
1009
  Upgrading Nautobot from v1.X to v2.0
1157
1010
  </label>
@@ -1195,7 +1048,7 @@
1195
1048
 
1196
1049
 
1197
1050
 
1198
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3_2" >
1051
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3_3_2" >
1199
1052
 
1200
1053
 
1201
1054
 
@@ -1211,14 +1064,14 @@
1211
1064
  </a>
1212
1065
 
1213
1066
 
1214
- <label class="md-nav__link " for="__nav_2_1_2_3_2" id="__nav_2_1_2_3_2_label" tabindex="0">
1067
+ <label class="md-nav__link " for="__nav_2_1_3_3_2" id="__nav_2_1_3_3_2_label" tabindex="0">
1215
1068
  <span class="md-nav__icon md-icon"></span>
1216
1069
  </label>
1217
1070
 
1218
1071
  </div>
1219
1072
 
1220
- <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_3_2_label" aria-expanded="false">
1221
- <label class="md-nav__title" for="__nav_2_1_2_3_2">
1073
+ <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_3_3_2_label" aria-expanded="false">
1074
+ <label class="md-nav__title" for="__nav_2_1_3_3_2">
1222
1075
  <span class="md-nav__icon md-icon"></span>
1223
1076
  IPAM Migration Guide
1224
1077
  </label>
@@ -1349,10 +1202,10 @@
1349
1202
 
1350
1203
 
1351
1204
 
1352
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3" >
1205
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4" >
1353
1206
 
1354
1207
 
1355
- <label class="md-nav__link" for="__nav_2_1_3" id="__nav_2_1_3_label" tabindex="0">
1208
+ <label class="md-nav__link" for="__nav_2_1_4" id="__nav_2_1_4_label" tabindex="0">
1356
1209
 
1357
1210
 
1358
1211
  <span class="md-ellipsis">
@@ -1363,8 +1216,8 @@
1363
1216
  <span class="md-nav__icon md-icon"></span>
1364
1217
  </label>
1365
1218
 
1366
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_3_label" aria-expanded="false">
1367
- <label class="md-nav__title" for="__nav_2_1_3">
1219
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_4_label" aria-expanded="false">
1220
+ <label class="md-nav__title" for="__nav_2_1_4">
1368
1221
  <span class="md-nav__icon md-icon"></span>
1369
1222
  Migration
1370
1223
  </label>
@@ -1437,7 +1290,7 @@
1437
1290
 
1438
1291
 
1439
1292
 
1440
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4" >
1293
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_5" >
1441
1294
 
1442
1295
 
1443
1296
 
@@ -1453,14 +1306,14 @@
1453
1306
  </a>
1454
1307
 
1455
1308
 
1456
- <label class="md-nav__link " for="__nav_2_1_4" id="__nav_2_1_4_label" tabindex="0">
1309
+ <label class="md-nav__link " for="__nav_2_1_5" id="__nav_2_1_5_label" tabindex="0">
1457
1310
  <span class="md-nav__icon md-icon"></span>
1458
1311
  </label>
1459
1312
 
1460
1313
  </div>
1461
1314
 
1462
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_4_label" aria-expanded="false">
1463
- <label class="md-nav__title" for="__nav_2_1_4">
1315
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_5_label" aria-expanded="false">
1316
+ <label class="md-nav__title" for="__nav_2_1_5">
1464
1317
  <span class="md-nav__icon md-icon"></span>
1465
1318
  Configuration
1466
1319
  </label>
@@ -1546,10 +1399,10 @@
1546
1399
 
1547
1400
 
1548
1401
 
1549
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4_4" >
1402
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_5_4" >
1550
1403
 
1551
1404
 
1552
- <label class="md-nav__link" for="__nav_2_1_4_4" id="__nav_2_1_4_4_label" tabindex="0">
1405
+ <label class="md-nav__link" for="__nav_2_1_5_4" id="__nav_2_1_5_4_label" tabindex="0">
1553
1406
 
1554
1407
 
1555
1408
  <span class="md-ellipsis">
@@ -1560,8 +1413,8 @@
1560
1413
  <span class="md-nav__icon md-icon"></span>
1561
1414
  </label>
1562
1415
 
1563
- <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_4_4_label" aria-expanded="false">
1564
- <label class="md-nav__title" for="__nav_2_1_4_4">
1416
+ <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_5_4_label" aria-expanded="false">
1417
+ <label class="md-nav__title" for="__nav_2_1_5_4">
1565
1418
  <span class="md-nav__icon md-icon"></span>
1566
1419
  External Authentication
1567
1420
  </label>
@@ -1663,10 +1516,10 @@
1663
1516
 
1664
1517
 
1665
1518
 
1666
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_5" >
1519
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_6" >
1667
1520
 
1668
1521
 
1669
- <label class="md-nav__link" for="__nav_2_1_5" id="__nav_2_1_5_label" tabindex="0">
1522
+ <label class="md-nav__link" for="__nav_2_1_6" id="__nav_2_1_6_label" tabindex="0">
1670
1523
 
1671
1524
 
1672
1525
  <span class="md-ellipsis">
@@ -1677,8 +1530,8 @@
1677
1530
  <span class="md-nav__icon md-icon"></span>
1678
1531
  </label>
1679
1532
 
1680
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_5_label" aria-expanded="false">
1681
- <label class="md-nav__title" for="__nav_2_1_5">
1533
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_6_label" aria-expanded="false">
1534
+ <label class="md-nav__title" for="__nav_2_1_6">
1682
1535
  <span class="md-nav__icon md-icon"></span>
1683
1536
  Tools
1684
1537
  </label>
@@ -1751,10 +1604,10 @@
1751
1604
 
1752
1605
 
1753
1606
 
1754
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_6" >
1607
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_7" >
1755
1608
 
1756
1609
 
1757
- <label class="md-nav__link" for="__nav_2_1_6" id="__nav_2_1_6_label" tabindex="0">
1610
+ <label class="md-nav__link" for="__nav_2_1_7" id="__nav_2_1_7_label" tabindex="0">
1758
1611
 
1759
1612
 
1760
1613
  <span class="md-ellipsis">
@@ -1765,8 +1618,8 @@
1765
1618
  <span class="md-nav__icon md-icon"></span>
1766
1619
  </label>
1767
1620
 
1768
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_6_label" aria-expanded="false">
1769
- <label class="md-nav__title" for="__nav_2_1_6">
1621
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_7_label" aria-expanded="false">
1622
+ <label class="md-nav__title" for="__nav_2_1_7">
1770
1623
  <span class="md-nav__icon md-icon"></span>
1771
1624
  Guides
1772
1625
  </label>
@@ -8018,168 +7871,6 @@
8018
7871
  <nav class="md-nav" aria-label="Database Setup">
8019
7872
  <ul class="md-nav__list">
8020
7873
 
8021
- <li class="md-nav__item">
8022
- <a href="#install-postgresql" class="md-nav__link">
8023
- <span class="md-ellipsis">
8024
- Install PostgreSQL
8025
- </span>
8026
- </a>
8027
-
8028
- </li>
8029
-
8030
- <li class="md-nav__item">
8031
- <a href="#create-a-postgresql-database" class="md-nav__link">
8032
- <span class="md-ellipsis">
8033
- Create a PostgreSQL Database
8034
- </span>
8035
- </a>
8036
-
8037
- <nav class="md-nav" aria-label="Create a PostgreSQL Database">
8038
- <ul class="md-nav__list">
8039
-
8040
- <li class="md-nav__item">
8041
- <a href="#verify-postgresql-service-status" class="md-nav__link">
8042
- <span class="md-ellipsis">
8043
- Verify PostgreSQL Service Status
8044
- </span>
8045
- </a>
8046
-
8047
- </li>
8048
-
8049
- </ul>
8050
- </nav>
8051
-
8052
- </li>
8053
-
8054
- <li class="md-nav__item">
8055
- <a href="#install-mysql" class="md-nav__link">
8056
- <span class="md-ellipsis">
8057
- Install MySQL
8058
- </span>
8059
- </a>
8060
-
8061
- </li>
8062
-
8063
- <li class="md-nav__item">
8064
- <a href="#create-a-mysql-database" class="md-nav__link">
8065
- <span class="md-ellipsis">
8066
- Create a MySQL Database
8067
- </span>
8068
- </a>
8069
-
8070
- <nav class="md-nav" aria-label="Create a MySQL Database">
8071
- <ul class="md-nav__list">
8072
-
8073
- <li class="md-nav__item">
8074
- <a href="#verify-mysql-service-status" class="md-nav__link">
8075
- <span class="md-ellipsis">
8076
- Verify MySQL Service Status
8077
- </span>
8078
- </a>
8079
-
8080
- </li>
8081
-
8082
- </ul>
8083
- </nav>
8084
-
8085
- </li>
8086
-
8087
- <li class="md-nav__item">
8088
- <a href="#install-postgresql_1" class="md-nav__link">
8089
- <span class="md-ellipsis">
8090
- Install PostgreSQL
8091
- </span>
8092
- </a>
8093
-
8094
- </li>
8095
-
8096
- <li class="md-nav__item">
8097
- <a href="#initialize-postgresql" class="md-nav__link">
8098
- <span class="md-ellipsis">
8099
- Initialize PostgreSQL
8100
- </span>
8101
- </a>
8102
-
8103
- </li>
8104
-
8105
- <li class="md-nav__item">
8106
- <a href="#configure-authentication" class="md-nav__link">
8107
- <span class="md-ellipsis">
8108
- Configure Authentication
8109
- </span>
8110
- </a>
8111
-
8112
- <nav class="md-nav" aria-label="Configure Authentication">
8113
- <ul class="md-nav__list">
8114
-
8115
- <li class="md-nav__item">
8116
- <a href="#start-postgresql" class="md-nav__link">
8117
- <span class="md-ellipsis">
8118
- Start PostgreSQL
8119
- </span>
8120
- </a>
8121
-
8122
- </li>
8123
-
8124
- <li class="md-nav__item">
8125
- <a href="#create-a-postgresql-database_1" class="md-nav__link">
8126
- <span class="md-ellipsis">
8127
- Create a PostgreSQL Database
8128
- </span>
8129
- </a>
8130
-
8131
- </li>
8132
-
8133
- </ul>
8134
- </nav>
8135
-
8136
- </li>
8137
-
8138
- <li class="md-nav__item">
8139
- <a href="#verify-postgresql-service-status_1" class="md-nav__link">
8140
- <span class="md-ellipsis">
8141
- Verify PostgreSQL Service Status
8142
- </span>
8143
- </a>
8144
-
8145
- </li>
8146
-
8147
- <li class="md-nav__item">
8148
- <a href="#install-mysql_1" class="md-nav__link">
8149
- <span class="md-ellipsis">
8150
- Install MySQL
8151
- </span>
8152
- </a>
8153
-
8154
- </li>
8155
-
8156
- <li class="md-nav__item">
8157
- <a href="#start-mysql" class="md-nav__link">
8158
- <span class="md-ellipsis">
8159
- Start MySQL
8160
- </span>
8161
- </a>
8162
-
8163
- </li>
8164
-
8165
- <li class="md-nav__item">
8166
- <a href="#create-a-mysql-database_1" class="md-nav__link">
8167
- <span class="md-ellipsis">
8168
- Create a MySQL Database
8169
- </span>
8170
- </a>
8171
-
8172
- </li>
8173
-
8174
- <li class="md-nav__item">
8175
- <a href="#verify-mysql-service-status_1" class="md-nav__link">
8176
- <span class="md-ellipsis">
8177
- Verify MySQL Service Status
8178
- </span>
8179
- </a>
8180
-
8181
- </li>
8182
-
8183
7874
  <li class="md-nav__item">
8184
7875
  <a href="#troubleshooting" class="md-nav__link">
8185
7876
  <span class="md-ellipsis">
@@ -8187,21 +7878,6 @@
8187
7878
  </span>
8188
7879
  </a>
8189
7880
 
8190
- <nav class="md-nav" aria-label="Troubleshooting">
8191
- <ul class="md-nav__list">
8192
-
8193
- <li class="md-nav__item">
8194
- <a href="#djangodbutilsnotsupportederror-conversion-between-utf8-and-sql_ascii-is-not-supported" class="md-nav__link">
8195
- <span class="md-ellipsis">
8196
- django.db.utils.NotSupportedError: conversion between UTF8 and SQL_ASCII is not supported
8197
- </span>
8198
- </a>
8199
-
8200
- </li>
8201
-
8202
- </ul>
8203
- </nav>
8204
-
8205
7881
  </li>
8206
7882
 
8207
7883
  </ul>
@@ -8216,30 +7892,6 @@
8216
7892
  </span>
8217
7893
  </a>
8218
7894
 
8219
- <nav class="md-nav" aria-label="Redis Setup">
8220
- <ul class="md-nav__list">
8221
-
8222
- <li class="md-nav__item">
8223
- <a href="#start-redis" class="md-nav__link">
8224
- <span class="md-ellipsis">
8225
- Start Redis
8226
- </span>
8227
- </a>
8228
-
8229
- </li>
8230
-
8231
- <li class="md-nav__item">
8232
- <a href="#verify-redis-service-status" class="md-nav__link">
8233
- <span class="md-ellipsis">
8234
- Verify Redis Service Status
8235
- </span>
8236
- </a>
8237
-
8238
- </li>
8239
-
8240
- </ul>
8241
- </nav>
8242
-
8243
7895
  </li>
8244
7896
 
8245
7897
  <li class="md-nav__item">
@@ -8275,7 +7927,7 @@
8275
7927
  <li>Ubuntu 20.04+</li>
8276
7928
  <li>Debian 11+</li>
8277
7929
  <li>RHEL/CentOS 8.2+<ul>
8278
- <li>Also includes other derivatives of RHEL such as RockyLinux or AlmaLinux</li>
7930
+ <li>Delimited by <code>RHEL8</code> tabs in the docs, but also includes other derivatives of RHEL such as RockyLinux or AlmaLinux</li>
8279
7931
  </ul>
8280
7932
  </li>
8281
7933
  </ul>
@@ -8288,15 +7940,15 @@
8288
7940
  <li>Pip</li>
8289
7941
  <li>Redis server and client</li>
8290
7942
  </ul>
8291
- <div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Ubuntu/Debian</label><label for="__tabbed_1_2">RHEL8 + Derivatives</label></div>
7943
+ <div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Ubuntu/Debian</label><label for="__tabbed_1_2">RHEL8</label></div>
8292
7944
  <div class="tabbed-content">
8293
7945
  <div class="tabbed-block">
8294
- <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>sudo<span class="w"> </span>apt<span class="w"> </span>update<span class="w"> </span>-y
7946
+ <div class="highlight"><span class="filename">Install system dependencies</span><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>sudo<span class="w"> </span>apt<span class="w"> </span>update<span class="w"> </span>-y
8295
7947
  <a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>git<span class="w"> </span>python3<span class="w"> </span>python3-pip<span class="w"> </span>python3-venv<span class="w"> </span>python3-dev<span class="w"> </span>redis-server
8296
7948
  </code></pre></div>
8297
7949
  </div>
8298
7950
  <div class="tabbed-block">
8299
- <div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>sudo<span class="w"> </span>dnf<span class="w"> </span>check-update
7951
+ <div class="highlight"><span class="filename">Install system dependencies</span><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>sudo<span class="w"> </span>dnf<span class="w"> </span>check-update
8300
7952
  <a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>sudo<span class="w"> </span>dnf<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>git<span class="w"> </span>python38<span class="w"> </span>python38-devel<span class="w"> </span>python38-pip<span class="w"> </span>redis
8301
7953
  </code></pre></div>
8302
7954
  </div>
@@ -8306,65 +7958,85 @@
8306
7958
  <p>In this step you'll set up your database server, create a database and database user for use by Nautobot, and verify your connection to the database.</p>
8307
7959
  <p>You must select either MySQL (MariaDB is <strong>not</strong> supported) or PostgreSQL. PostgreSQL is used by default with Nautobot, so if you just want to get started or don't have a preference, please stick with PostgreSQL.</p>
8308
7960
  <p>Please follow the steps for your selected database backend below.</p>
8309
- <div class="tabbed-set tabbed-alternate" data-tabs="2:4"><input checked="checked" id="__tabbed_2_1" name="__tabbed_2" type="radio" /><input id="__tabbed_2_2" name="__tabbed_2" type="radio" /><input id="__tabbed_2_3" name="__tabbed_2" type="radio" /><input id="__tabbed_2_4" name="__tabbed_2" type="radio" /><div class="tabbed-labels"><label for="__tabbed_2_1">Ubuntu/Debian PostgreSQL</label><label for="__tabbed_2_2">Ubuntu/Debian MySQL</label><label for="__tabbed_2_3">RHEL8 PostgreSQL</label><label for="__tabbed_2_4">RHEL8 MySQL</label></div>
7961
+ <!--
7962
+ We intentionally use explicit <h3> tags inside the tabbed block below rather than ### markdown.
7963
+ This is done so that these subheads don't get included in the page table of contents, where it would be confusing
7964
+ to have multiple "Install PostgreSQL", "Create a PostgreSQL Database", etc. entries.
7965
+ -->
7966
+
7967
+ <div class="tabbed-set tabbed-alternate" data-tabs="2:2"><input checked="checked" id="__tabbed_2_1" name="__tabbed_2" type="radio" /><input id="__tabbed_2_2" name="__tabbed_2" type="radio" /><div class="tabbed-labels"><label for="__tabbed_2_1">Ubuntu/Debian</label><label for="__tabbed_2_2">RHEL8</label></div>
7968
+ <div class="tabbed-content">
7969
+ <div class="tabbed-block">
7970
+ <div class="tabbed-set tabbed-alternate" data-tabs="3:2"><input checked="checked" id="__tabbed_3_1" name="__tabbed_3" type="radio" /><input id="__tabbed_3_2" name="__tabbed_3" type="radio" /><div class="tabbed-labels"><label for="__tabbed_3_1">PostgreSQL</label><label for="__tabbed_3_2">MySQL</label></div>
8310
7971
  <div class="tabbed-content">
8311
7972
  <div class="tabbed-block">
8312
- <h3 id="install-postgresql">Install PostgreSQL<a class="headerlink" href="#install-postgresql" title="Permanent link">&para;</a></h3>
7973
+ <p><h3>Install PostgreSQL</h3></p>
8313
7974
  <p>This will install the PostgreSQL database server and client.</p>
8314
- <div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>sudo apt install -y postgresql
7975
+ <div class="highlight"><span class="filename">Install Postgres</span><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>sudo apt install -y postgresql
8315
7976
  </code></pre></div>
8316
- <h3 id="create-a-postgresql-database">Create a PostgreSQL Database<a class="headerlink" href="#create-a-postgresql-database" title="Permanent link">&para;</a></h3>
8317
- <p>At a minimum, we need to create a database for Nautobot and assign it a username and password for authentication. This
8318
- is done with the following commands.</p>
7977
+ <p><h3>Create a PostgreSQL Database</h3></p>
7978
+ <p>At a minimum, we need to create a database for Nautobot and assign it a username and password for authentication. This is done with the following commands.</p>
8319
7979
  <div class="admonition danger">
8320
7980
  <p class="admonition-title">Danger</p>
8321
7981
  <p><strong>Do not use the password from the example.</strong> Choose a strong, random password to ensure secure database authentication for your Nautobot installation.</p>
8322
7982
  </div>
8323
- <div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>sudo -u postgres psql
7983
+ <div class="highlight"><span class="filename">Enter into Postgres</span><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>sudo -u postgres psql
8324
7984
  </code></pre></div>
8325
- <p>Example output:</p>
8326
- <div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>psql (12.5 (Ubuntu 12.5-0ubuntu0.20.04.1))
7985
+ <details class="example">
7986
+ <summary>Example of Entering Postgres</summary>
7987
+ <div class="highlight"><span class="filename">Entering Postgres DB</span><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>psql (12.5 (Ubuntu 12.5-0ubuntu0.20.04.1))
8327
7988
  <a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>Type &quot;help&quot; for help.
8328
7989
  <a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>
8329
- <a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>postgres=# CREATE DATABASE nautobot;
8330
- <a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>CREATE DATABASE
8331
- <a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>postgres=# CREATE USER nautobot WITH PASSWORD &#39;insecure_password&#39;;
8332
- <a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>CREATE ROLE
8333
- <a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>postgres=# GRANT ALL PRIVILEGES ON DATABASE nautobot TO nautobot;
8334
- <a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>GRANT
8335
- <a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>postgres=# \connect nautobot
8336
- <a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a>You are now connected to database &quot;nautobot&quot; as user &quot;postgres&quot;.
8337
- <a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a>nautobot=# GRANT CREATE ON SCHEMA public TO nautobot;
8338
- <a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>GRANT
8339
- <a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a>nautobot=# \q
7990
+ <a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>postgres=#
8340
7991
  </code></pre></div>
8341
- <h4 id="verify-postgresql-service-status">Verify PostgreSQL Service Status<a class="headerlink" href="#verify-postgresql-service-status" title="Permanent link">&para;</a></h4>
7992
+ </details>
7993
+ <div class="highlight"><span class="filename">Create the Nautobot DB</span><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>CREATE DATABASE nautobot;
7994
+ <a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>CREATE USER nautobot WITH PASSWORD &#39;insecure_password&#39;;
7995
+ <a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>GRANT ALL PRIVILEGES ON DATABASE nautobot TO nautobot;
7996
+ <a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>\connect nautobot
7997
+ <a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a>GRANT CREATE ON SCHEMA public TO nautobot;
7998
+ <a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>\q
7999
+ </code></pre></div>
8000
+ <details class="example">
8001
+ <summary>Example Postgres DB Creation Output</summary>
8002
+ <div class="highlight"><span class="filename">Example output of creating the DB</span><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>postgres=# CREATE DATABASE nautobot;
8003
+ <a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>CREATE DATABASE
8004
+ <a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>postgres=# CREATE USER nautobot WITH PASSWORD &#39;insecure_password&#39;;
8005
+ <a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>CREATE ROLE
8006
+ <a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>postgres=# GRANT ALL PRIVILEGES ON DATABASE nautobot TO nautobot;
8007
+ <a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>GRANT
8008
+ <a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>postgres=# \connect nautobot
8009
+ <a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>You are now connected to database &quot;nautobot&quot; as user &quot;postgres&quot;.
8010
+ <a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>nautobot=# GRANT CREATE ON SCHEMA public TO nautobot;
8011
+ <a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a>GRANT
8012
+ <a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a>nautobot=# \q
8013
+ </code></pre></div>
8014
+ </details>
8015
+ <p><h3>Verify PostgreSQL Service Status</h3></p>
8342
8016
  <p>You can verify that authentication works issuing the following command and providing the configured password. (Replace <code>localhost</code> with your database server if using a remote database.)</p>
8343
8017
  <p>If successful, you will enter a <code>nautobot</code> prompt. Type <code>\conninfo</code> to confirm your connection, or type <code>\q</code> to exit.</p>
8344
- <div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>psql --username nautobot --password --host localhost nautobot
8018
+ <div class="highlight"><span class="filename">Connect to the Nautobot DB</span><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>psql --username nautobot --password --host localhost nautobot
8345
8019
  </code></pre></div>
8346
- <p>Example output:</p>
8347
- <div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>Password for user nautobot:
8348
- <a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>psql (12.5 (Ubuntu 12.5-0ubuntu0.20.04.1))
8349
- <a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
8350
- <a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>Type &quot;help&quot; for help.
8351
- <a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>
8352
- <a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>nautobot=&gt; \conninfo
8353
- <a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>You are connected to database &quot;nautobot&quot; as user &quot;nautobot&quot; on host &quot;localhost&quot; (address &quot;127.0.0.1&quot;) at port &quot;5432&quot;.
8354
- <a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
8355
- <a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>nautobot=&gt; \q
8020
+ <details class="example">
8021
+ <summary>Example Postgres Connection Output</summary>
8022
+ <div class="highlight"><span class="filename">Example output</span><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>Password for user nautobot:
8023
+ <a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a>psql (12.5 (Ubuntu 12.5-0ubuntu0.20.04.1))
8024
+ <a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
8025
+ <a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a>Type &quot;help&quot; for help.
8026
+ <a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a>
8027
+ <a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a>nautobot=&gt; \conninfo
8028
+ <a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a>You are connected to database &quot;nautobot&quot; as user &quot;nautobot&quot; on host &quot;localhost&quot; (address &quot;127.0.0.1&quot;) at port &quot;5432&quot;.
8029
+ <a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
8030
+ <a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a>nautobot=&gt; \q
8356
8031
  </code></pre></div>
8032
+ </details>
8357
8033
  </div>
8358
8034
  <div class="tabbed-block">
8359
- <h3 id="install-mysql">Install MySQL<a class="headerlink" href="#install-mysql" title="Permanent link">&para;</a></h3>
8035
+ <p><h3>Install MySQL</h3></p>
8360
8036
  <p>This will install the MySQL database server and client. Additionally, MySQL requires that the MySQL development libraries are installed so that we may compile the Python <code>mysqlclient</code> library during the Nautobot installation steps.</p>
8361
- <div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>sudo apt install -y libmysqlclient-dev mysql-server
8037
+ <div class="highlight"><span class="filename">Install MySQL required packages</span><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>sudo apt install -y libmysqlclient-dev mysql-server
8362
8038
  </code></pre></div>
8363
- <div class="admonition note">
8364
- <p class="admonition-title">Note</p>
8365
- <p>In the Nautobot Docker image <code>libmariadb-dev</code> is installed due to licensing challenges with <code>libmysqlclient-dev</code>. </p>
8366
- </div>
8367
- <h3 id="create-a-mysql-database">Create a MySQL Database<a class="headerlink" href="#create-a-mysql-database" title="Permanent link">&para;</a></h3>
8039
+ <p><h3>Create a MySQL Database</h3></p>
8368
8040
  <p>At a minimum, we need to create a database for Nautobot and assign it a username and password for authentication. This is done with the following commands.</p>
8369
8041
  <div class="admonition note">
8370
8042
  <p class="admonition-title">Note</p>
@@ -8374,163 +8046,191 @@ is done with the following commands.</p>
8374
8046
  <p class="admonition-title">Danger</p>
8375
8047
  <p><strong>Do not use the password from the example.</strong> Choose a strong, random password to ensure secure database authentication for your Nautobot installation.</p>
8376
8048
  </div>
8377
- <div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>sudo -u root mysql
8049
+ <div class="highlight"><span class="filename">Connect to MySQL</span><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>sudo -u root mysql
8050
+ </code></pre></div>
8051
+ <div class="highlight"><span class="filename">Create the Nautobot DB</span><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>CREATE DATABASE nautobot;
8052
+ <a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>CREATE USER &#39;nautobot&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;insecure_password&#39;;
8053
+ <a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a>GRANT ALL ON nautobot.* TO &#39;nautobot&#39;@&#39;localhost&#39;;
8054
+ <a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a>\q
8378
8055
  </code></pre></div>
8379
- <p>Example output:</p>
8380
- <div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8381
- <a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>Your MySQL connection id is 11
8382
- <a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>Server version: 8.0.25-0ubuntu0.20.04.1 (Ubuntu)
8383
- <a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a>
8384
- <a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a>Copyright (c) 2000, 2021, Oracle and/or its affiliates.
8385
- <a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a>
8386
- <a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8387
- <a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a>affiliates. Other names may be trademarks of their respective
8388
- <a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a>owners.
8389
- <a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a>
8390
- <a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8391
- <a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a>
8392
- <a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a>mysql&gt; CREATE DATABASE nautobot;
8393
- <a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a>Query OK, 1 row affected (0.00 sec)
8394
- <a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a>
8395
- <a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a>mysql&gt; CREATE USER &#39;nautobot&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;insecure_password&#39;;
8396
- <a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a>Query OK, 0 rows affected (0.01 sec)
8397
- <a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a>
8398
- <a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a>mysql&gt; GRANT ALL ON nautobot.* TO &#39;nautobot&#39;@&#39;localhost&#39;;
8399
- <a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a>Query OK, 0 rows affected (0.00 sec)
8400
- <a id="__codelineno-9-21" name="__codelineno-9-21" href="#__codelineno-9-21"></a>
8401
- <a id="__codelineno-9-22" name="__codelineno-9-22" href="#__codelineno-9-22"></a>mysql&gt; \q
8402
- <a id="__codelineno-9-23" name="__codelineno-9-23" href="#__codelineno-9-23"></a>Bye
8056
+ <details class="example">
8057
+ <summary>Example MySQL output</summary>
8058
+ <div class="highlight"><span class="filename">Example MySQL DB creation output.</span><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8059
+ <a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>Your MySQL connection id is 11
8060
+ <a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>Server version: 8.0.25-0ubuntu0.20.04.1 (Ubuntu)
8061
+ <a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a>
8062
+ <a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a>Copyright (c) 2000, 2021, Oracle and/or its affiliates.
8063
+ <a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a>
8064
+ <a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8065
+ <a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>affiliates. Other names may be trademarks of their respective
8066
+ <a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a>owners.
8067
+ <a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a>
8068
+ <a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8069
+ <a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a>
8070
+ <a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a>mysql&gt; CREATE DATABASE nautobot;
8071
+ <a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a>Query OK, 1 row affected (0.00 sec)
8072
+ <a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a>
8073
+ <a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a>mysql&gt; CREATE USER &#39;nautobot&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;insecure_password&#39;;
8074
+ <a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a>Query OK, 0 rows affected (0.01 sec)
8075
+ <a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a>
8076
+ <a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a>mysql&gt; GRANT ALL ON nautobot.* TO &#39;nautobot&#39;@&#39;localhost&#39;;
8077
+ <a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a>Query OK, 0 rows affected (0.00 sec)
8078
+ <a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a>
8079
+ <a id="__codelineno-12-22" name="__codelineno-12-22" href="#__codelineno-12-22"></a>mysql&gt; \q
8080
+ <a id="__codelineno-12-23" name="__codelineno-12-23" href="#__codelineno-12-23"></a>Bye
8403
8081
  </code></pre></div>
8404
- <h4 id="verify-mysql-service-status">Verify MySQL Service Status<a class="headerlink" href="#verify-mysql-service-status" title="Permanent link">&para;</a></h4>
8082
+ </details>
8083
+ <p><h3>Verify MySQL Service Status</h3></p>
8405
8084
  <p>You can verify that authentication works issuing the following command and providing the configured password.</p>
8406
8085
  <p>If successful, you will enter a <code>mysql&gt;</code> prompt. Type <code>status</code> to confirm your connection, or type <code>\q</code> to exit.</p>
8407
8086
  <div class="admonition note">
8408
8087
  <p class="admonition-title">Note</p>
8409
8088
  <p>Replace <code>localhost</code> below with your database server if using a remote database.</p>
8410
8089
  </div>
8411
- <div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>mysql --user nautobot --password --host localhost nautobot
8090
+ <div class="highlight"><span class="filename">Test the MySQL DB connection</span><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>mysql --user nautobot --password --host localhost nautobot
8091
+ </code></pre></div>
8092
+ <p>Then after the password prompt you can use <code>status</code> and <code>\q</code> commands</p>
8093
+ <div class="highlight"><span class="filename">Check the status and quit</span><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>status
8094
+ <a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>\q
8412
8095
  </code></pre></div>
8413
- <p>Example output:</p>
8414
- <div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>Enter password:
8415
- <a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8416
- <a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a>Your MySQL connection id is 13
8417
- <a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a>Server version: 8.0.25-0ubuntu0.20.04.1 (Ubuntu)
8418
- <a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a>
8419
- <a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a>Copyright (c) 2000, 2021, Oracle and/or its affiliates.
8420
- <a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a>
8421
- <a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8422
- <a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a>affiliates. Other names may be trademarks of their respective
8423
- <a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a>owners.
8424
- <a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a>
8425
- <a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8426
- <a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a>
8427
- <a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a>mysql&gt; status
8428
- <a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a>--------------
8429
- <a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a>mysql Ver 8.0.25-0ubuntu0.20.04.1 for Linux on x86_64 ((Ubuntu))
8430
- <a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a>
8431
- <a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a>Connection id: 13
8432
- <a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a>Current database: nautobot
8433
- <a id="__codelineno-11-20" name="__codelineno-11-20" href="#__codelineno-11-20"></a>Current user: nautobot@localhost
8434
- <a id="__codelineno-11-21" name="__codelineno-11-21" href="#__codelineno-11-21"></a>SSL: Not in use
8435
- <a id="__codelineno-11-22" name="__codelineno-11-22" href="#__codelineno-11-22"></a>Current pager: stdout
8436
- <a id="__codelineno-11-23" name="__codelineno-11-23" href="#__codelineno-11-23"></a>Using outfile: &#39;&#39;
8437
- <a id="__codelineno-11-24" name="__codelineno-11-24" href="#__codelineno-11-24"></a>Using delimiter: ;
8438
- <a id="__codelineno-11-25" name="__codelineno-11-25" href="#__codelineno-11-25"></a>Server version: 8.0.25-0ubuntu0.20.04.1 (Ubuntu)
8439
- <a id="__codelineno-11-26" name="__codelineno-11-26" href="#__codelineno-11-26"></a>Protocol version: 10
8440
- <a id="__codelineno-11-27" name="__codelineno-11-27" href="#__codelineno-11-27"></a>Connection: Localhost via UNIX socket
8441
- <a id="__codelineno-11-28" name="__codelineno-11-28" href="#__codelineno-11-28"></a>Server characterset: utf8mb4
8442
- <a id="__codelineno-11-29" name="__codelineno-11-29" href="#__codelineno-11-29"></a>Db characterset: utf8mb4
8443
- <a id="__codelineno-11-30" name="__codelineno-11-30" href="#__codelineno-11-30"></a>Client characterset: utf8mb4
8444
- <a id="__codelineno-11-31" name="__codelineno-11-31" href="#__codelineno-11-31"></a>Conn. characterset: utf8mb4
8445
- <a id="__codelineno-11-32" name="__codelineno-11-32" href="#__codelineno-11-32"></a>UNIX socket: /var/run/mysqld/mysqld.sock
8446
- <a id="__codelineno-11-33" name="__codelineno-11-33" href="#__codelineno-11-33"></a>Binary data as: Hexadecimal
8447
- <a id="__codelineno-11-34" name="__codelineno-11-34" href="#__codelineno-11-34"></a>Uptime: 26 min 31 sec
8448
- <a id="__codelineno-11-35" name="__codelineno-11-35" href="#__codelineno-11-35"></a>
8449
- <a id="__codelineno-11-36" name="__codelineno-11-36" href="#__codelineno-11-36"></a>Threads: 2 Questions: 29 Slow queries: 0 Opens: 193 Flush tables: 3 Open tables: 112 Queries per second avg: 0.018
8450
- <a id="__codelineno-11-37" name="__codelineno-11-37" href="#__codelineno-11-37"></a>--------------
8451
- <a id="__codelineno-11-38" name="__codelineno-11-38" href="#__codelineno-11-38"></a>
8452
- <a id="__codelineno-11-39" name="__codelineno-11-39" href="#__codelineno-11-39"></a>mysql&gt; \q
8453
- <a id="__codelineno-11-40" name="__codelineno-11-40" href="#__codelineno-11-40"></a>Bye
8096
+ <details class="example">
8097
+ <summary>Example Verification of MySQL database</summary>
8098
+ <div class="highlight"><span class="filename">Example test output</span><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>Enter password:
8099
+ <a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8100
+ <a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>Your MySQL connection id is 13
8101
+ <a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>Server version: 8.0.25-0ubuntu0.20.04.1 (Ubuntu)
8102
+ <a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a>
8103
+ <a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a>Copyright (c) 2000, 2021, Oracle and/or its affiliates.
8104
+ <a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a>
8105
+ <a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8106
+ <a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a>affiliates. Other names may be trademarks of their respective
8107
+ <a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a>owners.
8108
+ <a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a>
8109
+ <a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8110
+ <a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a>
8111
+ <a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a>mysql&gt; status
8112
+ <a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a>--------------
8113
+ <a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a>mysql Ver 8.0.25-0ubuntu0.20.04.1 for Linux on x86_64 ((Ubuntu))
8114
+ <a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a>
8115
+ <a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a>Connection id: 13
8116
+ <a id="__codelineno-15-19" name="__codelineno-15-19" href="#__codelineno-15-19"></a>Current database: nautobot
8117
+ <a id="__codelineno-15-20" name="__codelineno-15-20" href="#__codelineno-15-20"></a>Current user: nautobot@localhost
8118
+ <a id="__codelineno-15-21" name="__codelineno-15-21" href="#__codelineno-15-21"></a>SSL: Not in use
8119
+ <a id="__codelineno-15-22" name="__codelineno-15-22" href="#__codelineno-15-22"></a>Current pager: stdout
8120
+ <a id="__codelineno-15-23" name="__codelineno-15-23" href="#__codelineno-15-23"></a>Using outfile: &#39;&#39;
8121
+ <a id="__codelineno-15-24" name="__codelineno-15-24" href="#__codelineno-15-24"></a>Using delimiter: ;
8122
+ <a id="__codelineno-15-25" name="__codelineno-15-25" href="#__codelineno-15-25"></a>Server version: 8.0.25-0ubuntu0.20.04.1 (Ubuntu)
8123
+ <a id="__codelineno-15-26" name="__codelineno-15-26" href="#__codelineno-15-26"></a>Protocol version: 10
8124
+ <a id="__codelineno-15-27" name="__codelineno-15-27" href="#__codelineno-15-27"></a>Connection: Localhost via UNIX socket
8125
+ <a id="__codelineno-15-28" name="__codelineno-15-28" href="#__codelineno-15-28"></a>Server characterset: utf8mb4
8126
+ <a id="__codelineno-15-29" name="__codelineno-15-29" href="#__codelineno-15-29"></a>Db characterset: utf8mb4
8127
+ <a id="__codelineno-15-30" name="__codelineno-15-30" href="#__codelineno-15-30"></a>Client characterset: utf8mb4
8128
+ <a id="__codelineno-15-31" name="__codelineno-15-31" href="#__codelineno-15-31"></a>Conn. characterset: utf8mb4
8129
+ <a id="__codelineno-15-32" name="__codelineno-15-32" href="#__codelineno-15-32"></a>UNIX socket: /var/run/mysqld/mysqld.sock
8130
+ <a id="__codelineno-15-33" name="__codelineno-15-33" href="#__codelineno-15-33"></a>Binary data as: Hexadecimal
8131
+ <a id="__codelineno-15-34" name="__codelineno-15-34" href="#__codelineno-15-34"></a>Uptime: 26 min 31 sec
8132
+ <a id="__codelineno-15-35" name="__codelineno-15-35" href="#__codelineno-15-35"></a>
8133
+ <a id="__codelineno-15-36" name="__codelineno-15-36" href="#__codelineno-15-36"></a>Threads: 2 Questions: 29 Slow queries: 0 Opens: 193 Flush tables: 3 Open tables: 112 Queries per second avg: 0.018
8134
+ <a id="__codelineno-15-37" name="__codelineno-15-37" href="#__codelineno-15-37"></a>--------------
8135
+ <a id="__codelineno-15-38" name="__codelineno-15-38" href="#__codelineno-15-38"></a>
8136
+ <a id="__codelineno-15-39" name="__codelineno-15-39" href="#__codelineno-15-39"></a>mysql&gt; \q
8137
+ <a id="__codelineno-15-40" name="__codelineno-15-40" href="#__codelineno-15-40"></a>Bye
8454
8138
  </code></pre></div>
8139
+ </details>
8140
+ </div>
8141
+ </div>
8142
+ </div>
8455
8143
  </div>
8456
8144
  <div class="tabbed-block">
8457
- <h3 id="install-postgresql_1">Install PostgreSQL<a class="headerlink" href="#install-postgresql_1" title="Permanent link">&para;</a></h3>
8145
+ <div class="tabbed-set tabbed-alternate" data-tabs="4:2"><input checked="checked" id="__tabbed_4_1" name="__tabbed_4" type="radio" /><input id="__tabbed_4_2" name="__tabbed_4" type="radio" /><div class="tabbed-labels"><label for="__tabbed_4_1">PostgreSQL</label><label for="__tabbed_4_2">MySQL</label></div>
8146
+ <div class="tabbed-content">
8147
+ <div class="tabbed-block">
8148
+ <p><h3>Install PostgreSQL</h3></p>
8458
8149
  <p>This will install the PostgreSQL database server and client.</p>
8459
- <div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>sudo dnf install -y postgresql-server
8150
+ <div class="highlight"><span class="filename">Install Postgres</span><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>sudo dnf install -y postgresql-server
8460
8151
  </code></pre></div>
8461
- <h3 id="initialize-postgresql">Initialize PostgreSQL<a class="headerlink" href="#initialize-postgresql" title="Permanent link">&para;</a></h3>
8152
+ <p><h3>Initialize PostgreSQL</h3></p>
8462
8153
  <p>CentOS/RHEL requires a manual step to generate the initial configurations required by PostgreSQL.</p>
8463
- <div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>sudo postgresql-setup --initdb
8154
+ <div class="highlight"><span class="filename">Setup initial required configurations</span><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>sudo postgresql-setup --initdb
8464
8155
  </code></pre></div>
8465
- <h3 id="configure-authentication">Configure Authentication<a class="headerlink" href="#configure-authentication" title="Permanent link">&para;</a></h3>
8156
+ <p><h3>Configure Authentication</h3></p>
8466
8157
  <p>CentOS/RHEL configures PostgreSQL to use <a href="https://www.postgresql.org/docs/current/auth-ident.html"><code>ident</code></a> host-based authentication by default. Because Nautobot will need to authenticate using a username and password, we must update <code>pg_hba.conf</code> to support <a href="https://www.postgresql.org/docs/current/auth-password.html"><code>md5</code> password</a> authentication.</p>
8467
8158
  <p>As root, edit <code>/var/lib/pgsql/data/pg_hba.conf</code> and change <code>ident</code> to <code>md5</code> for the lines below.</p>
8468
8159
  <p>Before:</p>
8469
- <div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a># IPv4 local connections:
8470
- <a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>host all all 127.0.0.1/32 ident
8471
- <a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a># IPv6 local connections:
8472
- <a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a>host all all ::1/128 ident
8160
+ <div class="highlight"><span class="filename">Before /var/lib/pgsql/data/pg_hba.conf</span><pre><span></span><code><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a># IPv4 local connections:
8161
+ <a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a>host all all 127.0.0.1/32 ident
8162
+ <a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a># IPv6 local connections:
8163
+ <a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a>host all all ::1/128 ident
8473
8164
  </code></pre></div>
8474
8165
  <p>After:</p>
8475
- <div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a># IPv4 local connections:
8476
- <a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>host all all 127.0.0.1/32 md5
8477
- <a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a># IPv6 local connections:
8478
- <a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>host all all ::1/128 md5
8166
+ <div class="highlight"><span class="filename">After /var/lib/pgsql/data/pg_hba.conf</span><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a># IPv4 local connections:
8167
+ <a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a>host all all 127.0.0.1/32 md5
8168
+ <a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a># IPv6 local connections:
8169
+ <a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a>host all all ::1/128 md5
8479
8170
  </code></pre></div>
8480
- <h4 id="start-postgresql">Start PostgreSQL<a class="headerlink" href="#start-postgresql" title="Permanent link">&para;</a></h4>
8171
+ <p><h3>Start PostgreSQL</h3></p>
8481
8172
  <p>Start the service and enable it to run at system startup:</p>
8482
- <div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>sudo systemctl enable --now postgresql
8173
+ <div class="highlight"><span class="filename">Start and enable the Postgres service at start up</span><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>sudo systemctl enable --now postgresql
8483
8174
  </code></pre></div>
8484
- <h4 id="create-a-postgresql-database_1">Create a PostgreSQL Database<a class="headerlink" href="#create-a-postgresql-database_1" title="Permanent link">&para;</a></h4>
8175
+ <p><h3>Create a PostgreSQL Database</h3></p>
8485
8176
  <p>At a minimum, we need to create a database for Nautobot and assign it a username and password for authentication. This
8486
8177
  is done with the following commands.</p>
8487
8178
  <div class="admonition danger">
8488
8179
  <p class="admonition-title">Danger</p>
8489
8180
  <p><strong>Do not use the password from the example.</strong> Choose a strong, random password to ensure secure database authentication for your Nautobot installation.</p>
8490
8181
  </div>
8491
- <div class="highlight"><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>sudo -u postgres psql
8182
+ <div class="highlight"><span class="filename">Enter into Postgres</span><pre><span></span><code><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>sudo -u postgres psql
8492
8183
  </code></pre></div>
8493
- <p>Example output:</p>
8494
- <div class="highlight"><pre><span></span><code><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>psql (10.15)
8495
- <a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a>Type &quot;help&quot; for help.
8184
+ <p>Create the database and grant permissions to the Nautobot user.</p>
8185
+ <div class="highlight"><span class="filename">Create Nautobot DB</span><pre><span></span><code><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>CREATE DATABASE nautobot;
8186
+ <a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a>CREATE USER nautobot WITH PASSWORD &#39;insecure_password&#39;;
8187
+ <a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a>GRANT ALL PRIVILEGES ON DATABASE nautobot TO nautobot;
8188
+ <a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a>\connect nautobot
8189
+ <a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a>GRANT CREATE ON SCHEMA public TO nautobot;
8190
+ <a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a>\q
8496
8191
  </code></pre></div>
8497
- <div class="highlight"><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>postgres=# CREATE DATABASE nautobot;
8498
- <a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a>CREATE DATABASE
8499
- <a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a>postgres=# CREATE USER nautobot WITH PASSWORD &#39;insecure_password&#39;;
8500
- <a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a>CREATE ROLE
8501
- <a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a>postgres=# GRANT ALL PRIVILEGES ON DATABASE nautobot TO nautobot;
8502
- <a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a>GRANT
8503
- <a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a>postgres=# \connect nautobot
8504
- <a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a>You are now connected to database &quot;nautobot&quot; as user &quot;postgres&quot;.
8505
- <a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a>nautobot=# GRANT CREATE ON SCHEMA public TO nautobot;
8506
- <a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a>GRANT
8507
- <a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a>nautobot=# \q
8192
+ <details class="example">
8193
+ <summary>Example Database creation output.</summary>
8194
+ <div class="highlight"><span class="filename">Example DB creation output</span><pre><span></span><code><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>postgres=# CREATE DATABASE nautobot;
8195
+ <a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>CREATE DATABASE
8196
+ <a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>postgres=# CREATE USER nautobot WITH PASSWORD &#39;insecure_password&#39;;
8197
+ <a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a>CREATE ROLE
8198
+ <a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a>postgres=# GRANT ALL PRIVILEGES ON DATABASE nautobot TO nautobot;
8199
+ <a id="__codelineno-23-6" name="__codelineno-23-6" href="#__codelineno-23-6"></a>GRANT
8200
+ <a id="__codelineno-23-7" name="__codelineno-23-7" href="#__codelineno-23-7"></a>postgres=# \connect nautobot
8201
+ <a id="__codelineno-23-8" name="__codelineno-23-8" href="#__codelineno-23-8"></a>You are now connected to database &quot;nautobot&quot; as user &quot;postgres&quot;.
8202
+ <a id="__codelineno-23-9" name="__codelineno-23-9" href="#__codelineno-23-9"></a>nautobot=# GRANT CREATE ON SCHEMA public TO nautobot;
8203
+ <a id="__codelineno-23-10" name="__codelineno-23-10" href="#__codelineno-23-10"></a>GRANT
8204
+ <a id="__codelineno-23-11" name="__codelineno-23-11" href="#__codelineno-23-11"></a>nautobot=# \q
8508
8205
  </code></pre></div>
8509
- <h3 id="verify-postgresql-service-status_1">Verify PostgreSQL Service Status<a class="headerlink" href="#verify-postgresql-service-status_1" title="Permanent link">&para;</a></h3>
8206
+ </details>
8207
+ <p><h3>Verify PostgreSQL Service Status</h3></p>
8510
8208
  <p>You can verify that authentication works issuing the following command and providing the configured password. (Replace <code>localhost</code> with your database server if using a remote database.)</p>
8511
8209
  <p>If successful, you will enter a <code>nautobot</code> prompt. Type <code>\conninfo</code> to confirm your connection, or type <code>\q</code> to exit.</p>
8512
- <div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>psql --username nautobot --password --host localhost nautobot
8210
+ <div class="highlight"><span class="filename">Test connection to Nautobot DB</span><pre><span></span><code><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>psql --username nautobot --password --host localhost nautobot
8513
8211
  </code></pre></div>
8514
- <p>Example output:</p>
8515
- <div class="highlight"><pre><span></span><code><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>Password for user nautobot:
8516
- <a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a>psql (10.15)
8517
- <a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a>Type &quot;help&quot; for help.
8518
- <a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a>
8519
- <a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a>nautobot=&gt; \conninfo
8520
- <a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a>You are connected to database &quot;nautobot&quot; as user &quot;nautobot&quot; on host &quot;localhost&quot; (address &quot;127.0.0.1&quot;) at port &quot;5432&quot;.
8521
- <a id="__codelineno-21-7" name="__codelineno-21-7" href="#__codelineno-21-7"></a>nautobot=&gt; \q
8212
+ <details class="example">
8213
+ <summary>Example Verification Output</summary>
8214
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>Password for user nautobot:
8215
+ <a id="__codelineno-25-2" name="__codelineno-25-2" href="#__codelineno-25-2"></a>psql (10.15)
8216
+ <a id="__codelineno-25-3" name="__codelineno-25-3" href="#__codelineno-25-3"></a>Type &quot;help&quot; for help.
8217
+ <a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a>
8218
+ <a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a>nautobot=&gt; \conninfo
8219
+ <a id="__codelineno-25-6" name="__codelineno-25-6" href="#__codelineno-25-6"></a>You are connected to database &quot;nautobot&quot; as user &quot;nautobot&quot; on host &quot;localhost&quot; (address &quot;127.0.0.1&quot;) at port &quot;5432&quot;.
8220
+ <a id="__codelineno-25-7" name="__codelineno-25-7" href="#__codelineno-25-7"></a>nautobot=&gt; \q
8522
8221
  </code></pre></div>
8222
+ </details>
8523
8223
  </div>
8524
8224
  <div class="tabbed-block">
8525
- <h3 id="install-mysql_1">Install MySQL<a class="headerlink" href="#install-mysql_1" title="Permanent link">&para;</a></h3>
8225
+ <p><h3>Install MySQL</h3></p>
8526
8226
  <p>This will install the MySQL database server and client. Additionally, MySQL requires that <code>gcc</code> and the MySQL development libraries are installed so that we may compile the Python <code>mysqlclient</code> library during the Nautobot installation steps.</p>
8527
- <div class="highlight"><pre><span></span><code><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>sudo dnf install -y gcc mysql-server mysql-devel
8227
+ <div class="highlight"><span class="filename">Install MySQL packages</span><pre><span></span><code><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a>sudo dnf install -y gcc mysql-server mysql-devel
8528
8228
  </code></pre></div>
8529
- <h3 id="start-mysql">Start MySQL<a class="headerlink" href="#start-mysql" title="Permanent link">&para;</a></h3>
8229
+ <p><h3>Start MySQL</h3></p>
8530
8230
  <p>Start the service and enable it to run at system startup:</p>
8531
- <div class="highlight"><pre><span></span><code><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>sudo systemctl enable --now mysql
8231
+ <div class="highlight"><span class="filename">Start and enable at start up of the MySQL service</span><pre><span></span><code><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>sudo systemctl enable --now mysql
8532
8232
  </code></pre></div>
8533
- <h3 id="create-a-mysql-database_1">Create a MySQL Database<a class="headerlink" href="#create-a-mysql-database_1" title="Permanent link">&para;</a></h3>
8233
+ <p><h3>Create a MySQL Database</h3></p>
8534
8234
  <p>At a minimum, we need to create a database for Nautobot and assign it a username and password for authentication. This is done with the following commands.</p>
8535
8235
  <div class="admonition note">
8536
8236
  <p class="admonition-title">Note</p>
@@ -8540,113 +8240,131 @@ is done with the following commands.</p>
8540
8240
  <p class="admonition-title">Danger</p>
8541
8241
  <p><strong>Do not use the password from the example.</strong> Choose a strong, random password to ensure secure database authentication for your Nautobot installation.</p>
8542
8242
  </div>
8543
- <div class="highlight"><pre><span></span><code><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>sudo -u root mysql
8243
+ <div class="highlight"><span class="filename">Connect to MySQL</span><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a>sudo -u root mysql
8544
8244
  </code></pre></div>
8545
- <p>Example output:</p>
8546
- <div class="highlight"><pre><span></span><code><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8547
- <a id="__codelineno-25-2" name="__codelineno-25-2" href="#__codelineno-25-2"></a>Your MySQL connection id is 8
8548
- <a id="__codelineno-25-3" name="__codelineno-25-3" href="#__codelineno-25-3"></a>Server version: 8.0.21 Source distribution
8549
- <a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a>
8550
- <a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a>Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
8551
- <a id="__codelineno-25-6" name="__codelineno-25-6" href="#__codelineno-25-6"></a>
8552
- <a id="__codelineno-25-7" name="__codelineno-25-7" href="#__codelineno-25-7"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8553
- <a id="__codelineno-25-8" name="__codelineno-25-8" href="#__codelineno-25-8"></a>affiliates. Other names may be trademarks of their respective
8554
- <a id="__codelineno-25-9" name="__codelineno-25-9" href="#__codelineno-25-9"></a>owners.
8555
- <a id="__codelineno-25-10" name="__codelineno-25-10" href="#__codelineno-25-10"></a>
8556
- <a id="__codelineno-25-11" name="__codelineno-25-11" href="#__codelineno-25-11"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8557
- <a id="__codelineno-25-12" name="__codelineno-25-12" href="#__codelineno-25-12"></a>
8558
- <a id="__codelineno-25-13" name="__codelineno-25-13" href="#__codelineno-25-13"></a>mysql&gt; CREATE DATABASE nautobot;
8559
- <a id="__codelineno-25-14" name="__codelineno-25-14" href="#__codelineno-25-14"></a>Query OK, 1 row affected (0.00 sec)
8560
- <a id="__codelineno-25-15" name="__codelineno-25-15" href="#__codelineno-25-15"></a>
8561
- <a id="__codelineno-25-16" name="__codelineno-25-16" href="#__codelineno-25-16"></a>mysql&gt; CREATE USER &#39;nautobot&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;insecure_password&#39;;
8562
- <a id="__codelineno-25-17" name="__codelineno-25-17" href="#__codelineno-25-17"></a>Query OK, 0 rows affected (0.00 sec)
8563
- <a id="__codelineno-25-18" name="__codelineno-25-18" href="#__codelineno-25-18"></a>
8564
- <a id="__codelineno-25-19" name="__codelineno-25-19" href="#__codelineno-25-19"></a>mysql&gt; GRANT ALL ON nautobot.* TO &#39;nautobot&#39;@&#39;localhost&#39;;
8565
- <a id="__codelineno-25-20" name="__codelineno-25-20" href="#__codelineno-25-20"></a>Query OK, 0 rows affected (0.00 sec)
8566
- <a id="__codelineno-25-21" name="__codelineno-25-21" href="#__codelineno-25-21"></a>
8567
- <a id="__codelineno-25-22" name="__codelineno-25-22" href="#__codelineno-25-22"></a>mysql&gt; \q
8568
- <a id="__codelineno-25-23" name="__codelineno-25-23" href="#__codelineno-25-23"></a>Bye
8245
+ <div class="highlight"><span class="filename">Create Nautobot DB</span><pre><span></span><code><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a>CREATE DATABASE nautobot;
8246
+ <a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a>CREATE USER &#39;nautobot&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;insecure_password&#39;;
8247
+ <a id="__codelineno-29-3" name="__codelineno-29-3" href="#__codelineno-29-3"></a>GRANT ALL ON nautobot.* TO &#39;nautobot&#39;@&#39;localhost&#39;;
8248
+ <a id="__codelineno-29-4" name="__codelineno-29-4" href="#__codelineno-29-4"></a>\q
8569
8249
  </code></pre></div>
8570
- <h3 id="verify-mysql-service-status_1">Verify MySQL Service Status<a class="headerlink" href="#verify-mysql-service-status_1" title="Permanent link">&para;</a></h3>
8250
+ <details class="example">
8251
+ <summary>Example Creation of MySQL DB</summary>
8252
+ <div class="highlight"><span class="filename">Example output creation of DB</span><pre><span></span><code><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8253
+ <a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a>Your MySQL connection id is 8
8254
+ <a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a>Server version: 8.0.21 Source distribution
8255
+ <a id="__codelineno-30-4" name="__codelineno-30-4" href="#__codelineno-30-4"></a>
8256
+ <a id="__codelineno-30-5" name="__codelineno-30-5" href="#__codelineno-30-5"></a>Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
8257
+ <a id="__codelineno-30-6" name="__codelineno-30-6" href="#__codelineno-30-6"></a>
8258
+ <a id="__codelineno-30-7" name="__codelineno-30-7" href="#__codelineno-30-7"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8259
+ <a id="__codelineno-30-8" name="__codelineno-30-8" href="#__codelineno-30-8"></a>affiliates. Other names may be trademarks of their respective
8260
+ <a id="__codelineno-30-9" name="__codelineno-30-9" href="#__codelineno-30-9"></a>owners.
8261
+ <a id="__codelineno-30-10" name="__codelineno-30-10" href="#__codelineno-30-10"></a>
8262
+ <a id="__codelineno-30-11" name="__codelineno-30-11" href="#__codelineno-30-11"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8263
+ <a id="__codelineno-30-12" name="__codelineno-30-12" href="#__codelineno-30-12"></a>
8264
+ <a id="__codelineno-30-13" name="__codelineno-30-13" href="#__codelineno-30-13"></a>mysql&gt; CREATE DATABASE nautobot;
8265
+ <a id="__codelineno-30-14" name="__codelineno-30-14" href="#__codelineno-30-14"></a>Query OK, 1 row affected (0.00 sec)
8266
+ <a id="__codelineno-30-15" name="__codelineno-30-15" href="#__codelineno-30-15"></a>
8267
+ <a id="__codelineno-30-16" name="__codelineno-30-16" href="#__codelineno-30-16"></a>mysql&gt; CREATE USER &#39;nautobot&#39;@&#39;localhost&#39; IDENTIFIED BY &#39;insecure_password&#39;;
8268
+ <a id="__codelineno-30-17" name="__codelineno-30-17" href="#__codelineno-30-17"></a>Query OK, 0 rows affected (0.00 sec)
8269
+ <a id="__codelineno-30-18" name="__codelineno-30-18" href="#__codelineno-30-18"></a>
8270
+ <a id="__codelineno-30-19" name="__codelineno-30-19" href="#__codelineno-30-19"></a>mysql&gt; GRANT ALL ON nautobot.* TO &#39;nautobot&#39;@&#39;localhost&#39;;
8271
+ <a id="__codelineno-30-20" name="__codelineno-30-20" href="#__codelineno-30-20"></a>Query OK, 0 rows affected (0.00 sec)
8272
+ <a id="__codelineno-30-21" name="__codelineno-30-21" href="#__codelineno-30-21"></a>
8273
+ <a id="__codelineno-30-22" name="__codelineno-30-22" href="#__codelineno-30-22"></a>mysql&gt; \q
8274
+ <a id="__codelineno-30-23" name="__codelineno-30-23" href="#__codelineno-30-23"></a>Bye
8275
+ </code></pre></div>
8276
+ </details>
8277
+ <p><h3>Verify MySQL Service Status</h3></p>
8571
8278
  <p>You can verify that authentication works issuing the following command and providing the configured password.</p>
8572
8279
  <p>If successful, you will enter a <code>mysql&gt;</code> prompt. Type <code>status</code> to confirm your connection, or type <code>\q</code> to exit.</p>
8573
8280
  <div class="admonition note">
8574
8281
  <p class="admonition-title">Note</p>
8575
8282
  <p>Replace <code>localhost</code> below with your database server if using a remote database.</p>
8576
8283
  </div>
8577
- <div class="highlight"><pre><span></span><code><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a>mysql --user nautobot --password --host localhost nautobot
8284
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a>mysql --user nautobot --password --host localhost nautobot
8578
8285
  </code></pre></div>
8579
- <p>Example output:</p>
8580
- <div class="highlight"><pre><span></span><code><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>Enter password:
8581
- <a id="__codelineno-27-2" name="__codelineno-27-2" href="#__codelineno-27-2"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8582
- <a id="__codelineno-27-3" name="__codelineno-27-3" href="#__codelineno-27-3"></a>Your MySQL connection id is 10
8583
- <a id="__codelineno-27-4" name="__codelineno-27-4" href="#__codelineno-27-4"></a>Server version: 8.0.21 Source distribution
8584
- <a id="__codelineno-27-5" name="__codelineno-27-5" href="#__codelineno-27-5"></a>
8585
- <a id="__codelineno-27-6" name="__codelineno-27-6" href="#__codelineno-27-6"></a>Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
8586
- <a id="__codelineno-27-7" name="__codelineno-27-7" href="#__codelineno-27-7"></a>
8587
- <a id="__codelineno-27-8" name="__codelineno-27-8" href="#__codelineno-27-8"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8588
- <a id="__codelineno-27-9" name="__codelineno-27-9" href="#__codelineno-27-9"></a>affiliates. Other names may be trademarks of their respective
8589
- <a id="__codelineno-27-10" name="__codelineno-27-10" href="#__codelineno-27-10"></a>owners.
8590
- <a id="__codelineno-27-11" name="__codelineno-27-11" href="#__codelineno-27-11"></a>
8591
- <a id="__codelineno-27-12" name="__codelineno-27-12" href="#__codelineno-27-12"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8592
- <a id="__codelineno-27-13" name="__codelineno-27-13" href="#__codelineno-27-13"></a>
8593
- <a id="__codelineno-27-14" name="__codelineno-27-14" href="#__codelineno-27-14"></a>mysql&gt; status
8594
- <a id="__codelineno-27-15" name="__codelineno-27-15" href="#__codelineno-27-15"></a>--------------
8595
- <a id="__codelineno-27-16" name="__codelineno-27-16" href="#__codelineno-27-16"></a>mysql Ver 8.0.21 for Linux on x86_64 (Source distribution)
8596
- <a id="__codelineno-27-17" name="__codelineno-27-17" href="#__codelineno-27-17"></a>
8597
- <a id="__codelineno-27-18" name="__codelineno-27-18" href="#__codelineno-27-18"></a>Connection id: 10
8598
- <a id="__codelineno-27-19" name="__codelineno-27-19" href="#__codelineno-27-19"></a>Current database: nautobot
8599
- <a id="__codelineno-27-20" name="__codelineno-27-20" href="#__codelineno-27-20"></a>Current user: nautobot@localhost
8600
- <a id="__codelineno-27-21" name="__codelineno-27-21" href="#__codelineno-27-21"></a>SSL: Not in use
8601
- <a id="__codelineno-27-22" name="__codelineno-27-22" href="#__codelineno-27-22"></a>Current pager: stdout
8602
- <a id="__codelineno-27-23" name="__codelineno-27-23" href="#__codelineno-27-23"></a>Using outfile: &#39;&#39;
8603
- <a id="__codelineno-27-24" name="__codelineno-27-24" href="#__codelineno-27-24"></a>Using delimiter: ;
8604
- <a id="__codelineno-27-25" name="__codelineno-27-25" href="#__codelineno-27-25"></a>Server version: 8.0.21 Source distribution
8605
- <a id="__codelineno-27-26" name="__codelineno-27-26" href="#__codelineno-27-26"></a>Protocol version: 10
8606
- <a id="__codelineno-27-27" name="__codelineno-27-27" href="#__codelineno-27-27"></a>Connection: Localhost via UNIX socket
8607
- <a id="__codelineno-27-28" name="__codelineno-27-28" href="#__codelineno-27-28"></a>Server characterset: utf8mb4
8608
- <a id="__codelineno-27-29" name="__codelineno-27-29" href="#__codelineno-27-29"></a>Db characterset: utf8mb4
8609
- <a id="__codelineno-27-30" name="__codelineno-27-30" href="#__codelineno-27-30"></a>Client characterset: utf8mb4
8610
- <a id="__codelineno-27-31" name="__codelineno-27-31" href="#__codelineno-27-31"></a>Conn. characterset: utf8mb4
8611
- <a id="__codelineno-27-32" name="__codelineno-27-32" href="#__codelineno-27-32"></a>UNIX socket: /var/lib/mysql/mysql.sock
8612
- <a id="__codelineno-27-33" name="__codelineno-27-33" href="#__codelineno-27-33"></a>Binary data as: Hexadecimal
8613
- <a id="__codelineno-27-34" name="__codelineno-27-34" href="#__codelineno-27-34"></a>Uptime: 4 min 12 sec
8614
- <a id="__codelineno-27-35" name="__codelineno-27-35" href="#__codelineno-27-35"></a>
8615
- <a id="__codelineno-27-36" name="__codelineno-27-36" href="#__codelineno-27-36"></a>Threads: 2 Questions: 12 Slow queries: 0 Opens: 151 Flush tables: 3 Open tables: 69 Queries per second avg: 0.047
8616
- <a id="__codelineno-27-37" name="__codelineno-27-37" href="#__codelineno-27-37"></a>--------------
8617
- <a id="__codelineno-27-38" name="__codelineno-27-38" href="#__codelineno-27-38"></a>
8618
- <a id="__codelineno-27-39" name="__codelineno-27-39" href="#__codelineno-27-39"></a>mysql&gt; \q
8619
- <a id="__codelineno-27-40" name="__codelineno-27-40" href="#__codelineno-27-40"></a>Bye
8286
+ <details class="example">
8287
+ <summary>Example MySQL Verification</summary>
8288
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a>Enter password:
8289
+ <a id="__codelineno-32-2" name="__codelineno-32-2" href="#__codelineno-32-2"></a>Welcome to the MySQL monitor. Commands end with ; or \g.
8290
+ <a id="__codelineno-32-3" name="__codelineno-32-3" href="#__codelineno-32-3"></a>Your MySQL connection id is 10
8291
+ <a id="__codelineno-32-4" name="__codelineno-32-4" href="#__codelineno-32-4"></a>Server version: 8.0.21 Source distribution
8292
+ <a id="__codelineno-32-5" name="__codelineno-32-5" href="#__codelineno-32-5"></a>
8293
+ <a id="__codelineno-32-6" name="__codelineno-32-6" href="#__codelineno-32-6"></a>Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
8294
+ <a id="__codelineno-32-7" name="__codelineno-32-7" href="#__codelineno-32-7"></a>
8295
+ <a id="__codelineno-32-8" name="__codelineno-32-8" href="#__codelineno-32-8"></a>Oracle is a registered trademark of Oracle Corporation and/or its
8296
+ <a id="__codelineno-32-9" name="__codelineno-32-9" href="#__codelineno-32-9"></a>affiliates. Other names may be trademarks of their respective
8297
+ <a id="__codelineno-32-10" name="__codelineno-32-10" href="#__codelineno-32-10"></a>owners.
8298
+ <a id="__codelineno-32-11" name="__codelineno-32-11" href="#__codelineno-32-11"></a>
8299
+ <a id="__codelineno-32-12" name="__codelineno-32-12" href="#__codelineno-32-12"></a>Type &#39;help;&#39; or &#39;\h&#39; for help. Type &#39;\c&#39; to clear the current input statement.
8300
+ <a id="__codelineno-32-13" name="__codelineno-32-13" href="#__codelineno-32-13"></a>
8301
+ <a id="__codelineno-32-14" name="__codelineno-32-14" href="#__codelineno-32-14"></a>mysql&gt; status
8302
+ <a id="__codelineno-32-15" name="__codelineno-32-15" href="#__codelineno-32-15"></a>--------------
8303
+ <a id="__codelineno-32-16" name="__codelineno-32-16" href="#__codelineno-32-16"></a>mysql Ver 8.0.21 for Linux on x86_64 (Source distribution)
8304
+ <a id="__codelineno-32-17" name="__codelineno-32-17" href="#__codelineno-32-17"></a>
8305
+ <a id="__codelineno-32-18" name="__codelineno-32-18" href="#__codelineno-32-18"></a>Connection id: 10
8306
+ <a id="__codelineno-32-19" name="__codelineno-32-19" href="#__codelineno-32-19"></a>Current database: nautobot
8307
+ <a id="__codelineno-32-20" name="__codelineno-32-20" href="#__codelineno-32-20"></a>Current user: nautobot@localhost
8308
+ <a id="__codelineno-32-21" name="__codelineno-32-21" href="#__codelineno-32-21"></a>SSL: Not in use
8309
+ <a id="__codelineno-32-22" name="__codelineno-32-22" href="#__codelineno-32-22"></a>Current pager: stdout
8310
+ <a id="__codelineno-32-23" name="__codelineno-32-23" href="#__codelineno-32-23"></a>Using outfile: &#39;&#39;
8311
+ <a id="__codelineno-32-24" name="__codelineno-32-24" href="#__codelineno-32-24"></a>Using delimiter: ;
8312
+ <a id="__codelineno-32-25" name="__codelineno-32-25" href="#__codelineno-32-25"></a>Server version: 8.0.21 Source distribution
8313
+ <a id="__codelineno-32-26" name="__codelineno-32-26" href="#__codelineno-32-26"></a>Protocol version: 10
8314
+ <a id="__codelineno-32-27" name="__codelineno-32-27" href="#__codelineno-32-27"></a>Connection: Localhost via UNIX socket
8315
+ <a id="__codelineno-32-28" name="__codelineno-32-28" href="#__codelineno-32-28"></a>Server characterset: utf8mb4
8316
+ <a id="__codelineno-32-29" name="__codelineno-32-29" href="#__codelineno-32-29"></a>Db characterset: utf8mb4
8317
+ <a id="__codelineno-32-30" name="__codelineno-32-30" href="#__codelineno-32-30"></a>Client characterset: utf8mb4
8318
+ <a id="__codelineno-32-31" name="__codelineno-32-31" href="#__codelineno-32-31"></a>Conn. characterset: utf8mb4
8319
+ <a id="__codelineno-32-32" name="__codelineno-32-32" href="#__codelineno-32-32"></a>UNIX socket: /var/lib/mysql/mysql.sock
8320
+ <a id="__codelineno-32-33" name="__codelineno-32-33" href="#__codelineno-32-33"></a>Binary data as: Hexadecimal
8321
+ <a id="__codelineno-32-34" name="__codelineno-32-34" href="#__codelineno-32-34"></a>Uptime: 4 min 12 sec
8322
+ <a id="__codelineno-32-35" name="__codelineno-32-35" href="#__codelineno-32-35"></a>
8323
+ <a id="__codelineno-32-36" name="__codelineno-32-36" href="#__codelineno-32-36"></a>Threads: 2 Questions: 12 Slow queries: 0 Opens: 151 Flush tables: 3 Open tables: 69 Queries per second avg: 0.047
8324
+ <a id="__codelineno-32-37" name="__codelineno-32-37" href="#__codelineno-32-37"></a>--------------
8325
+ <a id="__codelineno-32-38" name="__codelineno-32-38" href="#__codelineno-32-38"></a>
8326
+ <a id="__codelineno-32-39" name="__codelineno-32-39" href="#__codelineno-32-39"></a>mysql&gt; \q
8327
+ <a id="__codelineno-32-40" name="__codelineno-32-40" href="#__codelineno-32-40"></a>Bye
8620
8328
  </code></pre></div>
8329
+ </details>
8330
+ </div>
8331
+ </div>
8332
+ </div>
8621
8333
  </div>
8622
8334
  </div>
8623
8335
  </div>
8624
8336
  <h3 id="troubleshooting">Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permanent link">&para;</a></h3>
8625
- <h4 id="djangodbutilsnotsupportederror-conversion-between-utf8-and-sql_ascii-is-not-supported">django.db.utils.NotSupportedError: conversion between UTF8 and SQL_ASCII is not supported<a class="headerlink" href="#djangodbutilsnotsupportederror-conversion-between-utf8-and-sql_ascii-is-not-supported" title="Permanent link">&para;</a></h4>
8337
+ <!-- markdownlint-disable-next-line no-inline-html -->
8338
+ <h4>django.db.utils.NotSupportedError: conversion between UTF8 and SQL_ASCII is not supported</h4>
8339
+
8626
8340
  <p>Django requires the database encoding for PostgreSQL databases to be set to UTF-8. If you receive the error <code>django.db.utils.NotSupportedError: conversion between UTF8 and SQL_ASCII is not supported</code>, you will need to drop and re-create the <code>nautobot</code> database with the correct encoding.</p>
8627
8341
  <h2 id="redis-setup">Redis Setup<a class="headerlink" href="#redis-setup" title="Permanent link">&para;</a></h2>
8628
- <div class="tabbed-set tabbed-alternate" data-tabs="3:2"><input checked="checked" id="__tabbed_3_1" name="__tabbed_3" type="radio" /><input id="__tabbed_3_2" name="__tabbed_3" type="radio" /><div class="tabbed-labels"><label for="__tabbed_3_1">Ubuntu/Debian</label><label for="__tabbed_3_2">RHEL8</label></div>
8342
+ <div class="tabbed-set tabbed-alternate" data-tabs="5:2"><input checked="checked" id="__tabbed_5_1" name="__tabbed_5" type="radio" /><input id="__tabbed_5_2" name="__tabbed_5" type="radio" /><div class="tabbed-labels"><label for="__tabbed_5_1">Ubuntu/Debian</label><label for="__tabbed_5_2">RHEL8</label></div>
8629
8343
  <div class="tabbed-content">
8630
8344
  <div class="tabbed-block">
8631
8345
  <p>Since Redis was already installed, let's just verify that it's working using <code>redis-cli</code>:</p>
8632
- <div class="highlight"><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a>redis-cli ping
8346
+ <div class="highlight"><span class="filename">Test Redis connection</span><pre><span></span><code><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a>redis-cli ping
8633
8347
  </code></pre></div>
8634
- <p>Example output:</p>
8635
- <div class="highlight"><pre><span></span><code><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a>PONG
8348
+ <details class="example">
8349
+ <summary>Example Redis check output</summary>
8350
+ <div class="highlight"><span class="filename">redis-cli ping output</span><pre><span></span><code><a id="__codelineno-34-1" name="__codelineno-34-1" href="#__codelineno-34-1"></a>PONG
8636
8351
  </code></pre></div>
8352
+ </details>
8637
8353
  </div>
8638
8354
  <div class="tabbed-block">
8639
- <h3 id="start-redis">Start Redis<a class="headerlink" href="#start-redis" title="Permanent link">&para;</a></h3>
8355
+ <p><h3>Start Redis</h3></p>
8640
8356
  <p>Start the service and enable it to run at system startup:</p>
8641
- <div class="highlight"><pre><span></span><code><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a>sudo systemctl enable --now redis
8357
+ <div class="highlight"><span class="filename">Enable Redis to start on boot and start Redis now</span><pre><span></span><code><a id="__codelineno-35-1" name="__codelineno-35-1" href="#__codelineno-35-1"></a>sudo systemctl enable --now redis
8642
8358
  </code></pre></div>
8643
- <h3 id="verify-redis-service-status">Verify Redis Service Status<a class="headerlink" href="#verify-redis-service-status" title="Permanent link">&para;</a></h3>
8359
+ <p><h3>Verify Redis Service Status</h3></p>
8644
8360
  <p>Use the <code>redis-cli</code> utility to ensure the Redis service is functional:</p>
8645
- <div class="highlight"><pre><span></span><code><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a>redis-cli ping
8361
+ <div class="highlight"><span class="filename">Test Redis connection</span><pre><span></span><code><a id="__codelineno-36-1" name="__codelineno-36-1" href="#__codelineno-36-1"></a>redis-cli ping
8646
8362
  </code></pre></div>
8647
- <p>Example output:</p>
8648
- <div class="highlight"><pre><span></span><code><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a>PONG
8363
+ <details class="example">
8364
+ <summary>Example Redis check output</summary>
8365
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-37-1" name="__codelineno-37-1" href="#__codelineno-37-1"></a>PONG
8649
8366
  </code></pre></div>
8367
+ </details>
8650
8368
  </div>
8651
8369
  </div>
8652
8370
  </div>
@@ -8669,6 +8387,8 @@ is done with the following commands.</p>
8669
8387
  </div>
8670
8388
 
8671
8389
 
8390
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var tab,labels=set.querySelector(".tabbed-labels");for(tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
8391
+
8672
8392
  <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
8673
8393
  </div>
8674
8394
 
@@ -8681,7 +8401,7 @@ is done with the following commands.</p>
8681
8401
  <nav class="md-footer__inner md-grid" aria-label="Footer" >
8682
8402
 
8683
8403
 
8684
- <a href="index.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: Prerequisites">
8404
+ <a href="index.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: Getting Started">
8685
8405
  <div class="md-footer__button md-icon">
8686
8406
 
8687
8407
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
@@ -8691,7 +8411,7 @@ is done with the following commands.</p>
8691
8411
  Previous
8692
8412
  </span>
8693
8413
  <div class="md-ellipsis">
8694
- Prerequisites
8414
+ Getting Started
8695
8415
  </div>
8696
8416
  </div>
8697
8417
  </a>
@@ -8746,7 +8466,7 @@ is done with the following commands.</p>
8746
8466
 
8747
8467
 
8748
8468
  <a href="https://blog.networktocode.com/blog/tags/nautobot" target="_blank" rel="noopener" title="Network to Code Blog" class="md-social__link">
8749
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M0 64c0-17.7 14.3-32 32-32 229.8 0 416 186.2 416 416 0 17.7-14.3 32-32 32s-32-14.3-32-32C384 253.6 226.4 96 32 96 14.3 96 0 81.7 0 64zm0 352a64 64 0 1 1 128 0 64 64 0 1 1-128 0zm32-256c159.1 0 288 128.9 288 288 0 17.7-14.3 32-32 32s-32-14.3-32-32c0-123.7-100.3-224-224-224-17.7 0-32-14.3-32-32s14.3-32 32-32z"/></svg>
8469
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M0 64c0-17.7 14.3-32 32-32 229.8 0 416 186.2 416 416 0 17.7-14.3 32-32 32s-32-14.3-32-32C384 253.6 226.4 96 32 96 14.3 96 0 81.7 0 64zm0 352a64 64 0 1 1 128 0 64 64 0 1 1-128 0zm32-256c159.1 0 288 128.9 288 288 0 17.7-14.3 32-32 32s-32-14.3-32-32c0-123.7-100.3-224-224-224-17.7 0-32-14.3-32-32s14.3-32 32-32z"/></svg>
8750
8470
  </a>
8751
8471
 
8752
8472
 
@@ -8754,7 +8474,7 @@ is done with the following commands.</p>
8754
8474
 
8755
8475
 
8756
8476
  <a href="https://www.youtube.com/playlist?list=PLjA0bhxgryJ2Ts4GJMDA-tPzVWEncv4pb" target="_blank" rel="noopener" title="Nautobot Videos" class="md-social__link">
8757
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M549.655 124.083c-6.281-23.65-24.787-42.276-48.284-48.597C458.781 64 288 64 288 64S117.22 64 74.629 75.486c-23.497 6.322-42.003 24.947-48.284 48.597-11.412 42.867-11.412 132.305-11.412 132.305s0 89.438 11.412 132.305c6.281 23.65 24.787 41.5 48.284 47.821C117.22 448 288 448 288 448s170.78 0 213.371-11.486c23.497-6.321 42.003-24.171 48.284-47.821 11.412-42.867 11.412-132.305 11.412-132.305s0-89.438-11.412-132.305zm-317.51 213.508V175.185l142.739 81.205-142.739 81.201z"/></svg>
8477
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M549.655 124.083c-6.281-23.65-24.787-42.276-48.284-48.597C458.781 64 288 64 288 64S117.22 64 74.629 75.486c-23.497 6.322-42.003 24.947-48.284 48.597-11.412 42.867-11.412 132.305-11.412 132.305s0 89.438 11.412 132.305c6.281 23.65 24.787 41.5 48.284 47.821C117.22 448 288 448 288 448s170.78 0 213.371-11.486c23.497-6.321 42.003-24.171 48.284-47.821 11.412-42.867 11.412-132.305 11.412-132.305s0-89.438-11.412-132.305zm-317.51 213.508V175.185l142.739 81.205-142.739 81.201z"/></svg>
8758
8478
  </a>
8759
8479
 
8760
8480
 
@@ -8762,7 +8482,7 @@ is done with the following commands.</p>
8762
8482
 
8763
8483
 
8764
8484
  <a href="https://www.networktocode.com/community/" target="_blank" rel="noopener" title="Network to Code Community" class="md-social__link">
8765
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M94.12 315.1c0 25.9-21.16 47.06-47.06 47.06S0 341 0 315.1c0-25.9 21.16-47.06 47.06-47.06h47.06v47.06zm23.72 0c0-25.9 21.16-47.06 47.06-47.06s47.06 21.16 47.06 47.06v117.84c0 25.9-21.16 47.06-47.06 47.06s-47.06-21.16-47.06-47.06V315.1zm47.06-188.98c-25.9 0-47.06-21.16-47.06-47.06S139 32 164.9 32s47.06 21.16 47.06 47.06v47.06H164.9zm0 23.72c25.9 0 47.06 21.16 47.06 47.06s-21.16 47.06-47.06 47.06H47.06C21.16 243.96 0 222.8 0 196.9s21.16-47.06 47.06-47.06H164.9zm188.98 47.06c0-25.9 21.16-47.06 47.06-47.06 25.9 0 47.06 21.16 47.06 47.06s-21.16 47.06-47.06 47.06h-47.06V196.9zm-23.72 0c0 25.9-21.16 47.06-47.06 47.06-25.9 0-47.06-21.16-47.06-47.06V79.06c0-25.9 21.16-47.06 47.06-47.06 25.9 0 47.06 21.16 47.06 47.06V196.9zM283.1 385.88c25.9 0 47.06 21.16 47.06 47.06 0 25.9-21.16 47.06-47.06 47.06-25.9 0-47.06-21.16-47.06-47.06v-47.06h47.06zm0-23.72c-25.9 0-47.06-21.16-47.06-47.06 0-25.9 21.16-47.06 47.06-47.06h117.84c25.9 0 47.06 21.16 47.06 47.06 0 25.9-21.16 47.06-47.06 47.06H283.1z"/></svg>
8485
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M94.12 315.1c0 25.9-21.16 47.06-47.06 47.06S0 341 0 315.1c0-25.9 21.16-47.06 47.06-47.06h47.06v47.06zm23.72 0c0-25.9 21.16-47.06 47.06-47.06s47.06 21.16 47.06 47.06v117.84c0 25.9-21.16 47.06-47.06 47.06s-47.06-21.16-47.06-47.06V315.1zm47.06-188.98c-25.9 0-47.06-21.16-47.06-47.06S139 32 164.9 32s47.06 21.16 47.06 47.06v47.06H164.9zm0 23.72c25.9 0 47.06 21.16 47.06 47.06s-21.16 47.06-47.06 47.06H47.06C21.16 243.96 0 222.8 0 196.9s21.16-47.06 47.06-47.06H164.9zm188.98 47.06c0-25.9 21.16-47.06 47.06-47.06 25.9 0 47.06 21.16 47.06 47.06s-21.16 47.06-47.06 47.06h-47.06V196.9zm-23.72 0c0 25.9-21.16 47.06-47.06 47.06-25.9 0-47.06-21.16-47.06-47.06V79.06c0-25.9 21.16-47.06 47.06-47.06 25.9 0 47.06 21.16 47.06 47.06V196.9zM283.1 385.88c25.9 0 47.06 21.16 47.06 47.06 0 25.9-21.16 47.06-47.06 47.06-25.9 0-47.06-21.16-47.06-47.06v-47.06h47.06zm0-23.72c-25.9 0-47.06-21.16-47.06-47.06 0-25.9 21.16-47.06 47.06-47.06h117.84c25.9 0 47.06 21.16 47.06 47.06 0 25.9-21.16 47.06-47.06 47.06H283.1z"/></svg>
8766
8486
  </a>
8767
8487
 
8768
8488
 
@@ -8770,7 +8490,7 @@ is done with the following commands.</p>
8770
8490
 
8771
8491
 
8772
8492
  <a href="https://github.com/nautobot/nautobot" target="_blank" rel="noopener" title="GitHub Repo" class="md-social__link">
8773
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
8493
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
8774
8494
  </a>
8775
8495
 
8776
8496
 
@@ -8778,7 +8498,7 @@ is done with the following commands.</p>
8778
8498
 
8779
8499
 
8780
8500
  <a href="https://twitter.com/networktocode" target="_blank" rel="noopener" title="Network to Code Twitter" class="md-social__link">
8781
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
8501
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
8782
8502
  </a>
8783
8503
 
8784
8504
  </div>
@@ -8793,10 +8513,10 @@ is done with the following commands.</p>
8793
8513
  </div>
8794
8514
 
8795
8515
 
8796
- <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.copy", "navigation.footer", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "search.highlight", "search.share", "search.suggest"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
8516
+ <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.copy", "content.tabs.link", "navigation.footer", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "search.highlight", "search.share", "search.suggest"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
8797
8517
 
8798
8518
 
8799
- <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
8519
+ <script src="../../../assets/javascripts/bundle.3220b9d7.min.js"></script>
8800
8520
 
8801
8521
  <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
8802
8522