nautobot 2.4.14__py3-none-any.whl → 2.4.15__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 (433) hide show
  1. nautobot/apps/choices.py +8 -0
  2. nautobot/apps/ui.py +14 -0
  3. nautobot/core/api/views.py +2 -0
  4. nautobot/core/choices.py +4 -0
  5. nautobot/core/filters.py +21 -41
  6. nautobot/core/management/commands/check_job_approval_status.py +47 -0
  7. nautobot/core/management/commands/generate_test_data.py +1 -1
  8. nautobot/core/management/commands/migrate.py +1 -1
  9. nautobot/core/models/tree_queries.py +17 -0
  10. nautobot/core/settings.py +2 -2
  11. nautobot/core/tables.py +25 -2
  12. nautobot/core/templates/base_django.html +1 -1
  13. nautobot/core/templates/components/panel/header_extra_content_table.html +1 -1
  14. nautobot/core/templates/generic/object_list.html +17 -20
  15. nautobot/core/templates/inc/breadcrumbs.html +14 -0
  16. nautobot/core/templatetags/buttons.py +2 -4
  17. nautobot/core/templatetags/helpers.py +29 -6
  18. nautobot/core/templatetags/ui_framework.py +21 -0
  19. nautobot/core/testing/filters.py +20 -3
  20. nautobot/core/testing/forms.py +1 -1
  21. nautobot/core/tests/integration/test_filters.py +2 -2
  22. nautobot/core/tests/test_breadcrumbs.py +366 -0
  23. nautobot/core/tests/test_commands.py +40 -0
  24. nautobot/core/tests/test_filters.py +51 -1
  25. nautobot/core/tests/test_forms.py +1 -1
  26. nautobot/core/tests/test_graphql.py +4 -4
  27. nautobot/core/tests/test_titles.py +183 -0
  28. nautobot/core/tests/test_tree_queries.py +30 -0
  29. nautobot/core/tests/test_views.py +2 -2
  30. nautobot/core/tests/test_views_utils.py +1 -1
  31. nautobot/core/ui/breadcrumbs.py +538 -0
  32. nautobot/core/ui/bulk_buttons.py +53 -0
  33. nautobot/core/ui/object_detail.py +31 -8
  34. nautobot/core/ui/titles.py +127 -0
  35. nautobot/core/ui/utils.py +25 -0
  36. nautobot/core/utils/migrations.py +1 -1
  37. nautobot/core/views/__init__.py +1 -1
  38. nautobot/core/views/mixins.py +26 -1
  39. nautobot/core/views/renderers.py +20 -2
  40. nautobot/core/views/utils.py +13 -12
  41. nautobot/dcim/api/serializers.py +9 -0
  42. nautobot/dcim/choices.py +53 -0
  43. nautobot/dcim/filters/__init__.py +15 -3
  44. nautobot/dcim/forms.py +120 -7
  45. nautobot/dcim/management/commands/trace_paths.py +1 -1
  46. nautobot/dcim/migrations/0072_alter_powerfeed_options_and_more.py +97 -0
  47. nautobot/dcim/models/device_component_templates.py +8 -0
  48. nautobot/dcim/models/device_components.py +31 -12
  49. nautobot/dcim/models/devices.py +1 -1
  50. nautobot/dcim/models/power.py +171 -10
  51. nautobot/dcim/models/racks.py +7 -4
  52. nautobot/dcim/tables/devices.py +2 -0
  53. nautobot/dcim/tables/devicetypes.py +1 -0
  54. nautobot/dcim/tables/power.py +30 -2
  55. nautobot/dcim/templates/dcim/device.html +2 -2
  56. nautobot/dcim/templates/dcim/devicetype_retrieve.html +1 -214
  57. nautobot/dcim/templates/dcim/location_retrieve.html +2 -2
  58. nautobot/dcim/templates/dcim/powerfeed_edit.html +8 -0
  59. nautobot/dcim/templates/dcim/powerfeed_retrieve.html +1 -1
  60. nautobot/dcim/tests/integration/test_device_bulk_operations.py +61 -0
  61. nautobot/dcim/tests/test_api.py +24 -4
  62. nautobot/dcim/tests/test_filters.py +91 -13
  63. nautobot/dcim/tests/test_models.py +262 -0
  64. nautobot/dcim/tests/test_views.py +20 -12
  65. nautobot/dcim/utils.py +9 -0
  66. nautobot/dcim/views.py +390 -77
  67. nautobot/extras/factory.py +19 -20
  68. nautobot/extras/filters/__init__.py +3 -2
  69. nautobot/extras/filters/mixins.py +15 -1
  70. nautobot/extras/forms/__init__.py +2 -1
  71. nautobot/extras/forms/forms.py +62 -0
  72. nautobot/extras/managers.py +4 -1
  73. nautobot/extras/migrations/0125_jobresult_date_started.py +18 -0
  74. nautobot/extras/models/customfields.py +1 -2
  75. nautobot/extras/models/datasources.py +1 -2
  76. nautobot/extras/models/jobs.py +7 -3
  77. nautobot/extras/plugins/views.py +24 -1
  78. nautobot/extras/secrets/__init__.py +1 -1
  79. nautobot/extras/tables.py +9 -0
  80. nautobot/extras/templates/extras/customfield.html +2 -129
  81. nautobot/extras/templates/extras/customfield_edit.html +2 -108
  82. nautobot/extras/templates/extras/customfield_retrieve.html +129 -0
  83. nautobot/extras/templates/extras/customfield_update.html +108 -0
  84. nautobot/extras/templates/extras/inc/jobresult.html +7 -3
  85. nautobot/extras/templates/extras/jobresult.html +2 -155
  86. nautobot/extras/templates/extras/jobresult_retrieve.html +155 -0
  87. nautobot/extras/templates/extras/marketplace.html +5 -6
  88. nautobot/extras/templates/extras/note.html +2 -53
  89. nautobot/extras/templates/extras/note_retrieve.html +53 -0
  90. nautobot/extras/templates/extras/plugins_list.html +5 -6
  91. nautobot/extras/templatetags/custom_links.py +2 -2
  92. nautobot/extras/templatetags/job_buttons.py +1 -1
  93. nautobot/extras/templatetags/plugins.py +1 -1
  94. nautobot/extras/tests/integration/test_computedfields.py +2 -2
  95. nautobot/extras/tests/integration/test_customfields.py +14 -11
  96. nautobot/extras/tests/integration/test_dynamicgroups.py +1 -1
  97. nautobot/extras/tests/integration/test_notes.py +1 -1
  98. nautobot/extras/tests/integration/test_plugins.py +6 -6
  99. nautobot/extras/tests/integration/test_relationships.py +2 -2
  100. nautobot/extras/tests/test_filters.py +9 -0
  101. nautobot/extras/tests/test_forms.py +2 -2
  102. nautobot/extras/tests/test_plugins.py +2 -3
  103. nautobot/extras/tests/test_relationships.py +7 -7
  104. nautobot/extras/tests/test_views.py +172 -1
  105. nautobot/extras/urls.py +3 -59
  106. nautobot/extras/utils.py +1 -1
  107. nautobot/extras/views.py +77 -178
  108. nautobot/ipam/tables.py +8 -15
  109. nautobot/ipam/tests/migration/test_migrations.py +8 -8
  110. nautobot/ipam/tests/test_api.py +2 -2
  111. nautobot/ipam/tests/test_models.py +1 -1
  112. nautobot/project-static/docs/404.html +23 -0
  113. nautobot/project-static/docs/apps/index.html +23 -0
  114. nautobot/project-static/docs/apps/nautobot-apps.html +23 -0
  115. nautobot/project-static/docs/assets/_mkdocstrings.css +44 -6
  116. nautobot/project-static/docs/code-reference/nautobot/apps/__init__.html +28 -0
  117. nautobot/project-static/docs/code-reference/nautobot/apps/admin.html +25 -0
  118. nautobot/project-static/docs/code-reference/nautobot/apps/api.html +128 -20
  119. nautobot/project-static/docs/code-reference/nautobot/apps/change_logging.html +37 -4
  120. nautobot/project-static/docs/code-reference/nautobot/apps/choices.html +39 -6
  121. nautobot/project-static/docs/code-reference/nautobot/apps/config.html +25 -0
  122. nautobot/project-static/docs/code-reference/nautobot/apps/constants.html +24 -0
  123. nautobot/project-static/docs/code-reference/nautobot/apps/datasources.html +32 -5
  124. nautobot/project-static/docs/code-reference/nautobot/apps/events.html +41 -8
  125. nautobot/project-static/docs/code-reference/nautobot/apps/exceptions.html +39 -7
  126. nautobot/project-static/docs/code-reference/nautobot/apps/factory.html +43 -10
  127. nautobot/project-static/docs/code-reference/nautobot/apps/filters.html +74 -59
  128. nautobot/project-static/docs/code-reference/nautobot/apps/forms.html +143 -28
  129. nautobot/project-static/docs/code-reference/nautobot/apps/graphql.html +43 -12
  130. nautobot/project-static/docs/code-reference/nautobot/apps/jobs.html +135 -53
  131. nautobot/project-static/docs/code-reference/nautobot/apps/models.html +229 -36
  132. nautobot/project-static/docs/code-reference/nautobot/apps/querysets.html +27 -1
  133. nautobot/project-static/docs/code-reference/nautobot/apps/secrets.html +30 -1
  134. nautobot/project-static/docs/code-reference/nautobot/apps/tables.html +162 -18
  135. nautobot/project-static/docs/code-reference/nautobot/apps/testing.html +258 -51
  136. nautobot/project-static/docs/code-reference/nautobot/apps/ui.html +5987 -2620
  137. nautobot/project-static/docs/code-reference/nautobot/apps/urls.html +25 -0
  138. nautobot/project-static/docs/code-reference/nautobot/apps/utils.html +154 -55
  139. nautobot/project-static/docs/code-reference/nautobot/apps/views.html +150 -35
  140. nautobot/project-static/docs/development/apps/api/configuration-view.html +23 -0
  141. nautobot/project-static/docs/development/apps/api/database-backend-config.html +23 -0
  142. nautobot/project-static/docs/development/apps/api/models/django-admin.html +23 -0
  143. nautobot/project-static/docs/development/apps/api/models/global-search.html +23 -0
  144. nautobot/project-static/docs/development/apps/api/models/graphql.html +23 -0
  145. nautobot/project-static/docs/development/apps/api/models/index.html +23 -0
  146. nautobot/project-static/docs/development/apps/api/nautobot-app-config.html +23 -0
  147. nautobot/project-static/docs/development/apps/api/platform-features/custom-validators.html +23 -0
  148. nautobot/project-static/docs/development/apps/api/platform-features/filter-extensions.html +23 -0
  149. nautobot/project-static/docs/development/apps/api/platform-features/git-repository-content.html +23 -0
  150. nautobot/project-static/docs/development/apps/api/platform-features/index.html +23 -0
  151. nautobot/project-static/docs/development/apps/api/platform-features/jinja2-filters.html +23 -0
  152. nautobot/project-static/docs/development/apps/api/platform-features/jobs.html +23 -0
  153. nautobot/project-static/docs/development/apps/api/platform-features/populating-extensibility-features.html +23 -0
  154. nautobot/project-static/docs/development/apps/api/platform-features/secrets-providers.html +23 -0
  155. nautobot/project-static/docs/development/apps/api/platform-features/table-extensions.html +23 -0
  156. nautobot/project-static/docs/development/apps/api/platform-features/uniquely-identify-objects.html +23 -0
  157. nautobot/project-static/docs/development/apps/api/prometheus.html +23 -0
  158. nautobot/project-static/docs/development/apps/api/setup.html +23 -0
  159. nautobot/project-static/docs/development/apps/api/testing.html +23 -0
  160. nautobot/project-static/docs/development/apps/api/ui-extensions/banners.html +23 -0
  161. nautobot/project-static/docs/development/apps/api/ui-extensions/home-page.html +23 -0
  162. nautobot/project-static/docs/development/apps/api/ui-extensions/index.html +23 -0
  163. nautobot/project-static/docs/development/apps/api/ui-extensions/navigation.html +23 -0
  164. nautobot/project-static/docs/development/apps/api/ui-extensions/object-views.html +23 -0
  165. nautobot/project-static/docs/development/apps/api/views/base-template.html +23 -0
  166. nautobot/project-static/docs/development/apps/api/views/core-view-overrides.html +23 -0
  167. nautobot/project-static/docs/development/apps/api/views/django-generic-views.html +23 -0
  168. nautobot/project-static/docs/development/apps/api/views/help-documentation.html +23 -0
  169. nautobot/project-static/docs/development/apps/api/views/index.html +23 -0
  170. nautobot/project-static/docs/development/apps/api/views/nautobot-generic-views.html +23 -0
  171. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewset.html +31 -2
  172. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewsetrouter.html +23 -0
  173. nautobot/project-static/docs/development/apps/api/views/notes.html +23 -0
  174. nautobot/project-static/docs/development/apps/api/views/rest-api.html +23 -0
  175. nautobot/project-static/docs/development/apps/api/views/urls.html +23 -0
  176. nautobot/project-static/docs/development/apps/index.html +23 -0
  177. nautobot/project-static/docs/development/apps/migration/code-updates.html +23 -0
  178. nautobot/project-static/docs/development/apps/migration/dependency-updates.html +23 -0
  179. nautobot/project-static/docs/development/apps/migration/from-v1.html +23 -0
  180. nautobot/project-static/docs/development/apps/migration/model-updates/dcim.html +23 -0
  181. nautobot/project-static/docs/development/apps/migration/model-updates/extras.html +23 -0
  182. nautobot/project-static/docs/development/apps/migration/model-updates/global.html +23 -0
  183. nautobot/project-static/docs/development/apps/migration/model-updates/ipam.html +23 -0
  184. nautobot/project-static/docs/development/apps/migration/ui-component-framework/best-practices.html +26 -3
  185. nautobot/project-static/docs/development/apps/migration/ui-component-framework/breadcrumbs-titles.html +10544 -0
  186. nautobot/project-static/docs/development/apps/migration/ui-component-framework/custom-content.html +23 -0
  187. nautobot/project-static/docs/development/apps/migration/ui-component-framework/index.html +23 -0
  188. nautobot/project-static/docs/development/apps/migration/ui-component-framework/migration-steps.html +23 -0
  189. nautobot/project-static/docs/development/apps/porting-from-netbox.html +26 -3
  190. nautobot/project-static/docs/development/core/application-registry.html +23 -0
  191. nautobot/project-static/docs/development/core/best-practices.html +23 -0
  192. nautobot/project-static/docs/development/core/bootstrap-ui.html +23 -0
  193. nautobot/project-static/docs/development/core/caching.html +23 -0
  194. nautobot/project-static/docs/development/core/controllers.html +23 -0
  195. nautobot/project-static/docs/development/core/docker-compose-advanced-use-cases.html +23 -0
  196. nautobot/project-static/docs/development/core/generic-views.html +23 -0
  197. nautobot/project-static/docs/development/core/getting-started.html +23 -0
  198. nautobot/project-static/docs/development/core/homepage.html +23 -0
  199. nautobot/project-static/docs/development/core/index.html +23 -0
  200. nautobot/project-static/docs/development/core/minikube-dev-environment-for-k8s-jobs.html +23 -0
  201. nautobot/project-static/docs/development/core/model-checklist.html +23 -0
  202. nautobot/project-static/docs/development/core/model-features.html +23 -0
  203. nautobot/project-static/docs/development/core/natural-keys.html +23 -0
  204. nautobot/project-static/docs/development/core/navigation-menu.html +23 -0
  205. nautobot/project-static/docs/development/core/release-checklist.html +23 -0
  206. nautobot/project-static/docs/development/core/role-internals.html +23 -0
  207. nautobot/project-static/docs/development/core/settings.html +23 -0
  208. nautobot/project-static/docs/development/core/style-guide.html +23 -0
  209. nautobot/project-static/docs/development/core/templates.html +23 -0
  210. nautobot/project-static/docs/development/core/testing.html +23 -0
  211. nautobot/project-static/docs/development/core/ui-component-framework.html +713 -255
  212. nautobot/project-static/docs/development/core/user-preferences.html +23 -0
  213. nautobot/project-static/docs/development/index.html +23 -0
  214. nautobot/project-static/docs/development/jobs/getting-started.html +23 -0
  215. nautobot/project-static/docs/development/jobs/index.html +23 -0
  216. nautobot/project-static/docs/development/jobs/installation.html +23 -0
  217. nautobot/project-static/docs/development/jobs/job-extensions.html +23 -0
  218. nautobot/project-static/docs/development/jobs/job-logging.html +23 -0
  219. nautobot/project-static/docs/development/jobs/job-patterns.html +23 -0
  220. nautobot/project-static/docs/development/jobs/job-structure.html +23 -0
  221. nautobot/project-static/docs/development/jobs/migration/from-v1.html +23 -0
  222. nautobot/project-static/docs/development/jobs/testing.html +23 -0
  223. nautobot/project-static/docs/index.html +23 -0
  224. nautobot/project-static/docs/media/development/core/ui-component-framework/breadcrumbs-titles-data-flow.png +0 -0
  225. nautobot/project-static/docs/media/power_distribution.png +0 -0
  226. nautobot/project-static/docs/objects.inv +0 -0
  227. nautobot/project-static/docs/overview/application_stack.html +23 -0
  228. nautobot/project-static/docs/overview/design_philosophy.html +23 -0
  229. nautobot/project-static/docs/release-notes/index.html +23 -0
  230. nautobot/project-static/docs/release-notes/version-1.0.html +23 -0
  231. nautobot/project-static/docs/release-notes/version-1.1.html +23 -0
  232. nautobot/project-static/docs/release-notes/version-1.2.html +23 -0
  233. nautobot/project-static/docs/release-notes/version-1.3.html +23 -0
  234. nautobot/project-static/docs/release-notes/version-1.4.html +23 -0
  235. nautobot/project-static/docs/release-notes/version-1.5.html +23 -0
  236. nautobot/project-static/docs/release-notes/version-1.6.html +23 -0
  237. nautobot/project-static/docs/release-notes/version-2.0.html +23 -0
  238. nautobot/project-static/docs/release-notes/version-2.1.html +23 -0
  239. nautobot/project-static/docs/release-notes/version-2.2.html +23 -0
  240. nautobot/project-static/docs/release-notes/version-2.3.html +23 -0
  241. nautobot/project-static/docs/release-notes/version-2.4.html +231 -0
  242. nautobot/project-static/docs/requirements.txt +2 -2
  243. nautobot/project-static/docs/search/search_index.json +1 -1
  244. nautobot/project-static/docs/sitemap.xml +303 -299
  245. nautobot/project-static/docs/sitemap.xml.gz +0 -0
  246. nautobot/project-static/docs/user-guide/administration/configuration/authentication/ldap.html +23 -0
  247. nautobot/project-static/docs/user-guide/administration/configuration/authentication/remote.html +23 -0
  248. nautobot/project-static/docs/user-guide/administration/configuration/authentication/sso.html +23 -0
  249. nautobot/project-static/docs/user-guide/administration/configuration/index.html +23 -0
  250. nautobot/project-static/docs/user-guide/administration/configuration/redis.html +23 -0
  251. nautobot/project-static/docs/user-guide/administration/configuration/settings.html +23 -0
  252. nautobot/project-static/docs/user-guide/administration/configuration/time-zones.html +23 -0
  253. nautobot/project-static/docs/user-guide/administration/guides/celery-queues.html +23 -0
  254. nautobot/project-static/docs/user-guide/administration/guides/docker.html +23 -0
  255. nautobot/project-static/docs/user-guide/administration/guides/health-checks.html +23 -0
  256. nautobot/project-static/docs/user-guide/administration/guides/permissions.html +23 -0
  257. nautobot/project-static/docs/user-guide/administration/guides/prometheus-metrics.html +23 -0
  258. nautobot/project-static/docs/user-guide/administration/guides/replicating-nautobot.html +23 -0
  259. nautobot/project-static/docs/user-guide/administration/guides/request-profiling.html +23 -0
  260. nautobot/project-static/docs/user-guide/administration/guides/s3-django-storage.html +23 -0
  261. nautobot/project-static/docs/user-guide/administration/guides/selinux-troubleshooting.html +23 -0
  262. nautobot/project-static/docs/user-guide/administration/installation/app-install.html +23 -0
  263. nautobot/project-static/docs/user-guide/administration/installation/external-authentication.html +23 -0
  264. nautobot/project-static/docs/user-guide/administration/installation/http-server.html +23 -0
  265. nautobot/project-static/docs/user-guide/administration/installation/index.html +23 -0
  266. nautobot/project-static/docs/user-guide/administration/installation/install_system.html +23 -0
  267. nautobot/project-static/docs/user-guide/administration/installation/nautobot.html +23 -0
  268. nautobot/project-static/docs/user-guide/administration/installation/services.html +23 -0
  269. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-netbox.html +23 -0
  270. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-postgresql.html +23 -0
  271. nautobot/project-static/docs/user-guide/administration/security/index.html +23 -0
  272. nautobot/project-static/docs/user-guide/administration/security/notices.html +23 -0
  273. nautobot/project-static/docs/user-guide/administration/tools/nautobot-server.html +284 -219
  274. nautobot/project-static/docs/user-guide/administration/tools/nautobot-shell.html +23 -0
  275. nautobot/project-static/docs/user-guide/administration/upgrading/database-backup.html +23 -0
  276. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/after-you-upgrade.html +23 -0
  277. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/before-you-upgrade.html +23 -0
  278. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/for-developers.html +23 -0
  279. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/index.html +23 -0
  280. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/whats-changed.html +23 -0
  281. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/region-and-site-data-migration-guide.html +23 -0
  282. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/upgrading-from-nautobot-v1.html +23 -0
  283. nautobot/project-static/docs/user-guide/administration/upgrading/upgrading.html +23 -0
  284. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuit.html +23 -0
  285. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittermination.html +23 -0
  286. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittype.html +23 -0
  287. nautobot/project-static/docs/user-guide/core-data-model/circuits/provider.html +23 -0
  288. nautobot/project-static/docs/user-guide/core-data-model/circuits/providernetwork.html +23 -0
  289. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloud.html +23 -0
  290. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudaccount.html +23 -0
  291. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudnetwork.html +23 -0
  292. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudnetworkprefixassignment.html +23 -0
  293. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudresourcetype.html +23 -0
  294. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudservice.html +23 -0
  295. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudservicenetworkassignment.html +23 -0
  296. nautobot/project-static/docs/user-guide/core-data-model/dcim/cable.html +23 -0
  297. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleport.html +23 -0
  298. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleporttemplate.html +23 -0
  299. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverport.html +23 -0
  300. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverporttemplate.html +23 -0
  301. nautobot/project-static/docs/user-guide/core-data-model/dcim/controller.html +23 -0
  302. nautobot/project-static/docs/user-guide/core-data-model/dcim/controllermanageddevicegroup.html +23 -0
  303. nautobot/project-static/docs/user-guide/core-data-model/dcim/device.html +23 -0
  304. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebay.html +23 -0
  305. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebaytemplate.html +23 -0
  306. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicefamily.html +23 -0
  307. nautobot/project-static/docs/user-guide/core-data-model/dcim/deviceredundancygroup.html +23 -0
  308. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicetype.html +23 -0
  309. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontport.html +23 -0
  310. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontporttemplate.html +23 -0
  311. nautobot/project-static/docs/user-guide/core-data-model/dcim/interface.html +23 -0
  312. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfaceredundancygroup.html +23 -0
  313. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfacetemplate.html +23 -0
  314. nautobot/project-static/docs/user-guide/core-data-model/dcim/inventoryitem.html +23 -0
  315. nautobot/project-static/docs/user-guide/core-data-model/dcim/location.html +23 -0
  316. nautobot/project-static/docs/user-guide/core-data-model/dcim/locationtype.html +23 -0
  317. nautobot/project-static/docs/user-guide/core-data-model/dcim/manufacturer.html +23 -0
  318. nautobot/project-static/docs/user-guide/core-data-model/dcim/module.html +23 -0
  319. nautobot/project-static/docs/user-guide/core-data-model/dcim/modulebay.html +23 -0
  320. nautobot/project-static/docs/user-guide/core-data-model/dcim/modulebaytemplate.html +23 -0
  321. nautobot/project-static/docs/user-guide/core-data-model/dcim/modulefamily.html +23 -0
  322. nautobot/project-static/docs/user-guide/core-data-model/dcim/moduletype.html +23 -0
  323. nautobot/project-static/docs/user-guide/core-data-model/dcim/platform.html +23 -0
  324. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerfeed.html +305 -5
  325. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlet.html +24 -1
  326. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlettemplate.html +23 -0
  327. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerpanel.html +136 -3
  328. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerport.html +41 -1
  329. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerporttemplate.html +40 -0
  330. nautobot/project-static/docs/user-guide/core-data-model/dcim/rack.html +23 -0
  331. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackgroup.html +23 -0
  332. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackreservation.html +23 -0
  333. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearport.html +23 -0
  334. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearporttemplate.html +23 -0
  335. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareimagefile.html +23 -0
  336. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareversion.html +23 -0
  337. nautobot/project-static/docs/user-guide/core-data-model/dcim/virtualchassis.html +23 -0
  338. nautobot/project-static/docs/user-guide/core-data-model/dcim/virtualdevicecontext.html +23 -0
  339. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontext.html +23 -0
  340. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontextschema.html +23 -0
  341. nautobot/project-static/docs/user-guide/core-data-model/extras/contact.html +23 -0
  342. nautobot/project-static/docs/user-guide/core-data-model/extras/team.html +23 -0
  343. nautobot/project-static/docs/user-guide/core-data-model/ipam/ipaddress.html +23 -0
  344. nautobot/project-static/docs/user-guide/core-data-model/ipam/namespace.html +23 -0
  345. nautobot/project-static/docs/user-guide/core-data-model/ipam/prefix.html +23 -0
  346. nautobot/project-static/docs/user-guide/core-data-model/ipam/rir.html +23 -0
  347. nautobot/project-static/docs/user-guide/core-data-model/ipam/routetarget.html +23 -0
  348. nautobot/project-static/docs/user-guide/core-data-model/ipam/service.html +23 -0
  349. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlan.html +23 -0
  350. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlangroup.html +23 -0
  351. nautobot/project-static/docs/user-guide/core-data-model/ipam/vrf.html +23 -0
  352. nautobot/project-static/docs/user-guide/core-data-model/overview/introduction.html +23 -0
  353. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenant.html +23 -0
  354. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenantgroup.html +23 -0
  355. nautobot/project-static/docs/user-guide/core-data-model/virtualization/cluster.html +23 -0
  356. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustergroup.html +23 -0
  357. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustertype.html +23 -0
  358. nautobot/project-static/docs/user-guide/core-data-model/virtualization/virtualmachine.html +23 -0
  359. nautobot/project-static/docs/user-guide/core-data-model/virtualization/vminterface.html +23 -0
  360. nautobot/project-static/docs/user-guide/core-data-model/wireless/index.html +23 -0
  361. nautobot/project-static/docs/user-guide/core-data-model/wireless/radioprofile.html +23 -0
  362. nautobot/project-static/docs/user-guide/core-data-model/wireless/supporteddatarate.html +23 -0
  363. nautobot/project-static/docs/user-guide/core-data-model/wireless/wirelessnetwork.html +23 -0
  364. nautobot/project-static/docs/user-guide/feature-guides/contacts-and-teams.html +23 -0
  365. nautobot/project-static/docs/user-guide/feature-guides/custom-fields.html +23 -0
  366. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-devices.html +23 -0
  367. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-location-types-and-locations.html +23 -0
  368. nautobot/project-static/docs/user-guide/feature-guides/getting-started/index.html +23 -0
  369. nautobot/project-static/docs/user-guide/feature-guides/getting-started/interfaces.html +23 -0
  370. nautobot/project-static/docs/user-guide/feature-guides/getting-started/ipam.html +23 -0
  371. nautobot/project-static/docs/user-guide/feature-guides/getting-started/platforms.html +23 -0
  372. nautobot/project-static/docs/user-guide/feature-guides/getting-started/search-bar.html +23 -0
  373. nautobot/project-static/docs/user-guide/feature-guides/getting-started/tenants.html +23 -0
  374. nautobot/project-static/docs/user-guide/feature-guides/getting-started/vlans-and-vlan-groups.html +23 -0
  375. nautobot/project-static/docs/user-guide/feature-guides/git-data-source.html +23 -0
  376. nautobot/project-static/docs/user-guide/feature-guides/graphql.html +23 -0
  377. nautobot/project-static/docs/user-guide/feature-guides/ip-address-merge-tool.html +23 -0
  378. nautobot/project-static/docs/user-guide/feature-guides/relationships.html +23 -0
  379. nautobot/project-static/docs/user-guide/feature-guides/software-image-files-and-versions.html +23 -0
  380. nautobot/project-static/docs/user-guide/feature-guides/wireless-networks-and-controllers.html +23 -0
  381. nautobot/project-static/docs/user-guide/index.html +23 -0
  382. nautobot/project-static/docs/user-guide/platform-functionality/change-logging.html +23 -0
  383. nautobot/project-static/docs/user-guide/platform-functionality/computedfield.html +23 -0
  384. nautobot/project-static/docs/user-guide/platform-functionality/customfield.html +23 -0
  385. nautobot/project-static/docs/user-guide/platform-functionality/customlink.html +23 -0
  386. nautobot/project-static/docs/user-guide/platform-functionality/dynamicgroup.html +23 -0
  387. nautobot/project-static/docs/user-guide/platform-functionality/events.html +23 -0
  388. nautobot/project-static/docs/user-guide/platform-functionality/exporttemplate.html +23 -0
  389. nautobot/project-static/docs/user-guide/platform-functionality/externalintegration.html +23 -0
  390. nautobot/project-static/docs/user-guide/platform-functionality/gitrepository.html +23 -0
  391. nautobot/project-static/docs/user-guide/platform-functionality/graphql.html +23 -0
  392. nautobot/project-static/docs/user-guide/platform-functionality/graphqlquery.html +23 -0
  393. nautobot/project-static/docs/user-guide/platform-functionality/imageattachment.html +23 -0
  394. nautobot/project-static/docs/user-guide/platform-functionality/jobs/index.html +23 -0
  395. nautobot/project-static/docs/user-guide/platform-functionality/jobs/job-scheduling-and-approvals.html +24 -1
  396. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobbutton.html +23 -0
  397. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobhook.html +23 -0
  398. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobqueue.html +23 -0
  399. nautobot/project-static/docs/user-guide/platform-functionality/jobs/kubernetes-job-support.html +23 -0
  400. nautobot/project-static/docs/user-guide/platform-functionality/jobs/managing-jobs.html +23 -0
  401. nautobot/project-static/docs/user-guide/platform-functionality/jobs/models.html +23 -0
  402. nautobot/project-static/docs/user-guide/platform-functionality/napalm.html +23 -0
  403. nautobot/project-static/docs/user-guide/platform-functionality/note.html +23 -0
  404. nautobot/project-static/docs/user-guide/platform-functionality/objectmetadata.html +23 -0
  405. nautobot/project-static/docs/user-guide/platform-functionality/relationship.html +23 -0
  406. nautobot/project-static/docs/user-guide/platform-functionality/rendering-jinja-templates.html +23 -0
  407. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/authentication.html +23 -0
  408. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/filtering.html +23 -0
  409. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/overview.html +23 -0
  410. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/ui-related-endpoints.html +23 -0
  411. nautobot/project-static/docs/user-guide/platform-functionality/role.html +23 -0
  412. nautobot/project-static/docs/user-guide/platform-functionality/savedview.html +23 -0
  413. nautobot/project-static/docs/user-guide/platform-functionality/secret.html +23 -0
  414. nautobot/project-static/docs/user-guide/platform-functionality/staticgroupassociation.html +23 -0
  415. nautobot/project-static/docs/user-guide/platform-functionality/status.html +23 -0
  416. nautobot/project-static/docs/user-guide/platform-functionality/tag.html +23 -0
  417. nautobot/project-static/docs/user-guide/platform-functionality/template-filters.html +23 -0
  418. nautobot/project-static/docs/user-guide/platform-functionality/users/objectpermission.html +23 -0
  419. nautobot/project-static/docs/user-guide/platform-functionality/users/token.html +23 -0
  420. nautobot/project-static/docs/user-guide/platform-functionality/webhook.html +23 -0
  421. nautobot/users/tests/test_api.py +2 -2
  422. nautobot/virtualization/templates/virtualization/virtualmachine.html +2 -252
  423. nautobot/virtualization/templates/virtualization/virtualmachine_edit.html +2 -75
  424. nautobot/virtualization/templates/virtualization/virtualmachine_retrieve.html +252 -0
  425. nautobot/virtualization/templates/virtualization/virtualmachine_update.html +75 -0
  426. nautobot/virtualization/urls.py +3 -61
  427. nautobot/virtualization/views.py +48 -72
  428. {nautobot-2.4.14.dist-info → nautobot-2.4.15.dist-info}/METADATA +24 -24
  429. {nautobot-2.4.14.dist-info → nautobot-2.4.15.dist-info}/RECORD +433 -416
  430. {nautobot-2.4.14.dist-info → nautobot-2.4.15.dist-info}/LICENSE.txt +0 -0
  431. {nautobot-2.4.14.dist-info → nautobot-2.4.15.dist-info}/NOTICE +0 -0
  432. {nautobot-2.4.14.dist-info → nautobot-2.4.15.dist-info}/WHEEL +0 -0
  433. {nautobot-2.4.14.dist-info → nautobot-2.4.15.dist-info}/entry_points.txt +0 -0
@@ -1630,6 +1630,15 @@
1630
1630
  </span>
1631
1631
  </a>
1632
1632
 
1633
+ </li>
1634
+
1635
+ <li class="md-nav__item">
1636
+ <a href="#check_job_approval_status" class="md-nav__link">
1637
+ <span class="md-ellipsis">
1638
+ check_job_approval_status
1639
+ </span>
1640
+ </a>
1641
+
1633
1642
  </li>
1634
1643
 
1635
1644
  <li class="md-nav__item">
@@ -9004,6 +9013,29 @@
9004
9013
 
9005
9014
 
9006
9015
 
9016
+
9017
+
9018
+
9019
+
9020
+
9021
+
9022
+ <li class="md-nav__item">
9023
+ <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
9024
+
9025
+
9026
+
9027
+ <span class="md-ellipsis">
9028
+ Breadcrumbs and titles
9029
+
9030
+ </span>
9031
+
9032
+
9033
+ </a>
9034
+ </li>
9035
+
9036
+
9037
+
9038
+
9007
9039
  </ul>
9008
9040
  </nav>
9009
9041
 
@@ -10444,6 +10476,15 @@
10444
10476
  </span>
10445
10477
  </a>
10446
10478
 
10479
+ </li>
10480
+
10481
+ <li class="md-nav__item">
10482
+ <a href="#check_job_approval_status" class="md-nav__link">
10483
+ <span class="md-ellipsis">
10484
+ check_job_approval_status
10485
+ </span>
10486
+ </a>
10487
+
10447
10488
  </li>
10448
10489
 
10449
10490
  <li class="md-nav__item">
@@ -10809,17 +10850,41 @@
10809
10850
  <p class="admonition-title">Note</p>
10810
10851
  <p>This is a built-in Django command. Please see the <a href="https://docs.djangoproject.com/en/stable/ref/django-admin/#collectstatic">official documentation on <code>collectstatic</code></a> for more information.</p>
10811
10852
  </div>
10853
+ <h3 id="check_job_approval_status"><code>check_job_approval_status</code><a class="headerlink" href="#check_job_approval_status" title="Permanent link">&para;</a></h3>
10854
+ <p><code>nautobot-server check_job_approval_status</code></p>
10855
+ <p>Checks for scheduled jobs and jobs that require approval.</p>
10856
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>nautobot-server check_job_approval_status
10857
+ </code></pre></div>
10858
+ <p>Output (when failed):</p>
10859
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>nautobot.core.management.commands.check_job_approval_status.ApprovalRequiredScheduledJobsError: These need to be approved (and run) or denied before upgrading to Nautobot v3, as the introduction of the approval workflows feature means that future scheduled-job approvals will be handled differently.
10860
+ <a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>Refer to the documentation: https://docs.nautobot.com/projects/core/en/stable/user-guide/platform-functionality/jobs/job-scheduling-and-approvals/#approval-via-the-ui
10861
+ <a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>Below is a list of affected scheduled jobs:
10862
+ <a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a> - ID: 0f8a0670-459b-430f-8c5e-a631888509d4, Name: test2
10863
+ </code></pre></div>
10864
+ <p>Output (with warning):</p>
10865
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>Following jobs still have `approval_required=True`.
10866
+ <a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>These jobs will no longer trigger approval automatically.
10867
+ <a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>After upgrading to Nautobot 3.x, you should add an approval workflow definition(s) covering these jobs.
10868
+ <a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a>Refer to the documentation: https://docs.nautobot.com/projects/core/en/next/user-guide/platform-functionality/approval-workflow/
10869
+ <a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a>Affected jobs (Names):
10870
+ <a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a> - ExampleDryRunJob
10871
+ <a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a> - Example Job of Everything
10872
+ <a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a> - Export Object List
10873
+ </code></pre></div>
10874
+ <p>Output (when pass):</p>
10875
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>No approval_required jobs or scheduled jobs found.
10876
+ </code></pre></div>
10812
10877
  <h3 id="createsuperuser"><code>createsuperuser</code><a class="headerlink" href="#createsuperuser" title="Permanent link">&para;</a></h3>
10813
10878
  <p><code>nautobot-server createsuperuser</code></p>
10814
10879
  <p>Creates a superuser account that has all permissions.</p>
10815
- <div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>nautobot-server createsuperuser
10880
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>nautobot-server createsuperuser
10816
10881
  </code></pre></div>
10817
10882
  <p>This provides the following output:</p>
10818
- <div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>Username (leave blank to use &#39;jathan&#39;): example
10819
- <a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>Email address: example@localhost
10820
- <a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>Password:
10821
- <a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a>Password (again):
10822
- <a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a>Superuser created successfully.
10883
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>Username (leave blank to use &#39;jathan&#39;): example
10884
+ <a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>Email address: example@localhost
10885
+ <a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>Password:
10886
+ <a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a>Password (again):
10887
+ <a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a>Superuser created successfully.
10823
10888
  </code></pre></div>
10824
10889
  <div class="admonition note">
10825
10890
  <p class="admonition-title">Note</p>
@@ -10832,17 +10897,17 @@
10832
10897
  <p class="admonition-title">Danger</p>
10833
10898
  <p>This is an advanced feature that gives you direct access to run raw SQL queries. Use this very cautiously as you can cause irreparable damage to your Nautobot installation.</p>
10834
10899
  </div>
10835
- <div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>nautobot-server dbshell
10900
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>nautobot-server dbshell
10836
10901
  </code></pre></div>
10837
10902
  <p>Output:</p>
10838
- <div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>psql (12.6 (Ubuntu 12.6-0ubuntu0.20.04.1))
10839
- <a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
10840
- <a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>Type &quot;help&quot; for help.
10841
- <a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>
10842
- <a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a>nautobot=&gt; \conninfo
10843
- <a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a>You are connected to database &quot;nautobot&quot; as user &quot;nautobot&quot; on host &quot;localhost&quot; (address &quot;::1&quot;) at port &quot;5432&quot;.
10844
- <a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
10845
- <a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a>nautobot=&gt; \q
10903
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>psql (12.6 (Ubuntu 12.6-0ubuntu0.20.04.1))
10904
+ <a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
10905
+ <a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a>Type &quot;help&quot; for help.
10906
+ <a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a>
10907
+ <a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a>nautobot=&gt; \conninfo
10908
+ <a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a>You are connected to database &quot;nautobot&quot; as user &quot;nautobot&quot; on host &quot;localhost&quot; (address &quot;::1&quot;) at port &quot;5432&quot;.
10909
+ <a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a>SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
10910
+ <a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a>nautobot=&gt; \q
10846
10911
  </code></pre></div>
10847
10912
  <div class="admonition note">
10848
10913
  <p class="admonition-title">Note</p>
@@ -10863,12 +10928,12 @@
10863
10928
  <li><code>django_rq</code> is no longer part of Nautobot's dependencies and so no longer needs to be explicitly excluded.</li>
10864
10929
  </ul>
10865
10930
  </details>
10866
- <div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>nautobot-server dumpdata \
10867
- <a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a> --exclude auth.permission \
10868
- <a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a> --format json \
10869
- <a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a> --indent 2 \
10870
- <a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a> --traceback \
10871
- <a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a> &gt; nautobot_dump.json
10931
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>nautobot-server dumpdata \
10932
+ <a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a> --exclude auth.permission \
10933
+ <a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a> --format json \
10934
+ <a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a> --indent 2 \
10935
+ <a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a> --traceback \
10936
+ <a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a> &gt; nautobot_dump.json
10872
10937
  </code></pre></div>
10873
10938
  <p>Use this command to generate a JSON dump of the database contents.</p>
10874
10939
  <p>One example of using this command would be to <a href="../migration/migrating-from-postgresql.html#export-data-from-postgresql">export data from PostgreSQL</a> and then <a href="../migration/migrating-from-postgresql.html#import-the-database-dump-into-mysql">import the data dump into MySQL</a>.</p>
@@ -10879,32 +10944,32 @@
10879
10944
  <h3 id="fix_custom_fields"><code>fix_custom_fields</code><a class="headerlink" href="#fix_custom_fields" title="Permanent link">&para;</a></h3>
10880
10945
  <p><code>nautobot-server fix_custom_fields [app_label.ModelName [app_label.ModelName ...]]</code></p>
10881
10946
  <p>Adds/Removes any custom fields which should or should not exist on an object. This command should not be run unless a custom fields jobs has failed:</p>
10882
- <div class="highlight"><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>nautobot-server fix_custom_fields
10947
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>nautobot-server fix_custom_fields
10883
10948
  </code></pre></div>
10884
10949
  <p>Example output:</p>
10885
- <div class="highlight"><pre><span></span><code><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>Processing ContentType dcim | device
10886
- <a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a>Processing ContentType dcim | location
10887
- <a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a>Processing ContentType dcim | rack
10888
- <a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a>Processing ContentType dcim | cable
10889
- <a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a>Processing ContentType dcim | power feed
10890
- <a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a>Processing ContentType circuits | circuit
10891
- <a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a>Processing ContentType ipam | prefix
10892
- <a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a>... (truncated for brevity of documentation) ...
10950
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>Processing ContentType dcim | device
10951
+ <a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a>Processing ContentType dcim | location
10952
+ <a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a>Processing ContentType dcim | rack
10953
+ <a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a>Processing ContentType dcim | cable
10954
+ <a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a>Processing ContentType dcim | power feed
10955
+ <a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a>Processing ContentType circuits | circuit
10956
+ <a id="__codelineno-22-7" name="__codelineno-22-7" href="#__codelineno-22-7"></a>Processing ContentType ipam | prefix
10957
+ <a id="__codelineno-22-8" name="__codelineno-22-8" href="#__codelineno-22-8"></a>... (truncated for brevity of documentation) ...
10893
10958
  </code></pre></div>
10894
10959
  <p>You may optionally specify one or more specific models (each prefixed with its app_label) to fix:</p>
10895
- <div class="highlight"><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>nautobot-server fix_custom_fields circuits.Circuit dcim.Location
10960
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>nautobot-server fix_custom_fields circuits.Circuit dcim.Location
10896
10961
  </code></pre></div>
10897
10962
  <p>Example output:</p>
10898
- <div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>Processing ContentType circuits | circuit
10899
- <a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a>Processing ContentType dcim | location
10963
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>Processing ContentType circuits | circuit
10964
+ <a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a>Processing ContentType dcim | location
10900
10965
  </code></pre></div>
10901
10966
  <h3 id="generate_secret_key"><code>generate_secret_key</code><a class="headerlink" href="#generate_secret_key" title="Permanent link">&para;</a></h3>
10902
10967
  <p><code>nautobot-server generate_secret_key</code></p>
10903
10968
  <p>Generates a new <a href="../configuration/settings.html#secret_key"><code>SECRET_KEY</code></a> that can be used in your <code>nautobot_config.py</code>:</p>
10904
- <div class="highlight"><pre><span></span><code><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>nautobot-server generate_secret_key
10969
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>nautobot-server generate_secret_key
10905
10970
  </code></pre></div>
10906
10971
  <p>Output:</p>
10907
- <div class="highlight"><pre><span></span><code><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>e!j=vrlhz-!wl8p_3+q5s5cph29nzj$xm81eap-!&amp;n!_9^du09
10972
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a>e!j=vrlhz-!wl8p_3+q5s5cph29nzj$xm81eap-!&amp;n!_9^du09
10908
10973
  </code></pre></div>
10909
10974
  <h3 id="generate_test_data"><code>generate_test_data</code><a class="headerlink" href="#generate_test_data" title="Permanent link">&para;</a></h3>
10910
10975
  <p><code>nautobot-server generate_test_data [--flush] --seed SEED</code></p>
@@ -10917,45 +10982,45 @@ Flush any existing data from the database before generating new data.</p>
10917
10982
  </div>
10918
10983
  <p><code>--seed SEED</code><br />
10919
10984
  String to use as a random generator seed for reproducible results.</p>
10920
- <div class="highlight"><pre><span></span><code><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>nautobot-server generate_test_data --flush --seed &quot;Nautobot&quot;
10985
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>nautobot-server generate_test_data --flush --seed &quot;Nautobot&quot;
10921
10986
  </code></pre></div>
10922
10987
  <p>Sample output:</p>
10923
- <div class="highlight"><pre><span></span><code><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>Flushing all existing data from the database...
10924
- <a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a>Seeding the pseudo-random number generator with seed &quot;Nautobot&quot;...
10925
- <a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a>Creating Statuses...
10926
- <a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a>Creating TenantGroups...
10927
- <a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a>Creating Tenants...
10928
- <a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a>Creating RIRs...
10929
- <a id="__codelineno-24-7" name="__codelineno-24-7" href="#__codelineno-24-7"></a>Creating RouteTargets...
10930
- <a id="__codelineno-24-8" name="__codelineno-24-8" href="#__codelineno-24-8"></a>Creating VRFs...
10931
- <a id="__codelineno-24-9" name="__codelineno-24-9" href="#__codelineno-24-9"></a>Creating IP/VLAN Roles...
10932
- <a id="__codelineno-24-10" name="__codelineno-24-10" href="#__codelineno-24-10"></a>Creating VLANGroups...
10933
- <a id="__codelineno-24-11" name="__codelineno-24-11" href="#__codelineno-24-11"></a>Creating VLANs...
10934
- <a id="__codelineno-24-12" name="__codelineno-24-12" href="#__codelineno-24-12"></a>Database populated successfully!
10988
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a>Flushing all existing data from the database...
10989
+ <a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a>Seeding the pseudo-random number generator with seed &quot;Nautobot&quot;...
10990
+ <a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a>Creating Statuses...
10991
+ <a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a>Creating TenantGroups...
10992
+ <a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a>Creating Tenants...
10993
+ <a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a>Creating RIRs...
10994
+ <a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a>Creating RouteTargets...
10995
+ <a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a>Creating VRFs...
10996
+ <a id="__codelineno-28-9" name="__codelineno-28-9" href="#__codelineno-28-9"></a>Creating IP/VLAN Roles...
10997
+ <a id="__codelineno-28-10" name="__codelineno-28-10" href="#__codelineno-28-10"></a>Creating VLANGroups...
10998
+ <a id="__codelineno-28-11" name="__codelineno-28-11" href="#__codelineno-28-11"></a>Creating VLANs...
10999
+ <a id="__codelineno-28-12" name="__codelineno-28-12" href="#__codelineno-28-12"></a>Database populated successfully!
10935
11000
  </code></pre></div>
10936
11001
  <h3 id="health_check"><code>health_check</code><a class="headerlink" href="#health_check" title="Permanent link">&para;</a></h3>
10937
11002
  <p><code>nautobot-server health_check</code></p>
10938
11003
  <p>Run health checks and exit 0 if everything went well.</p>
10939
- <div class="highlight"><pre><span></span><code><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>nautobot-server health_check
11004
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a>nautobot-server health_check
10940
11005
  </code></pre></div>
10941
11006
  <p>Output</p>
10942
- <div class="highlight"><pre><span></span><code><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a>DatabaseBackend ... working
10943
- <a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a>DefaultFileStorageHealthCheck ... working
10944
- <a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a>RedisBackend ... working
11007
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a>DatabaseBackend ... working
11008
+ <a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a>DefaultFileStorageHealthCheck ... working
11009
+ <a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a>RedisBackend ... working
10945
11010
  </code></pre></div>
10946
11011
  <p>Please see the <a href="../guides/health-checks.html">health-checks documentation</a> for more information.</p>
10947
11012
  <h3 id="init"><code>init</code><a class="headerlink" href="#init" title="Permanent link">&para;</a></h3>
10948
11013
  <p><code>nautobot-server init [--disable-installation-metrics] [config_path]</code></p>
10949
11014
  <p>Generates a new configuration with all of the default settings provided for you, and will also generate a unique <a href="../configuration/settings.html#secret_key"><code>SECRET_KEY</code></a>.</p>
10950
11015
  <p>By default the file will be created at <code>$HOME/.nautobot/nautobot_config.py</code>:</p>
10951
- <div class="highlight"><pre><span></span><code><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>nautobot-server init
11016
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a>nautobot-server init
10952
11017
  </code></pre></div>
10953
11018
  <p>Output:</p>
10954
- <div class="highlight"><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a>Nautobot would like to send anonymized installation metrics to the project&#39;s maintainers.
10955
- <a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a>These metrics include the installed Nautobot version, the Python version in use, an anonymous &quot;deployment ID&quot;, and a list of one-way-hashed names of enabled Nautobot Apps and their versions.
10956
- <a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a>Allow Nautobot to send these metrics? [y/n]: y
10957
- <a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a>Installation metrics will be sent when running &#39;nautobot-server post_upgrade&#39;. Thank you!
10958
- <a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a>Configuration file created at /home/example/.nautobot/nautobot_config.py
11019
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a>Nautobot would like to send anonymized installation metrics to the project&#39;s maintainers.
11020
+ <a id="__codelineno-32-2" name="__codelineno-32-2" href="#__codelineno-32-2"></a>These metrics include the installed Nautobot version, the Python version in use, an anonymous &quot;deployment ID&quot;, and a list of one-way-hashed names of enabled Nautobot Apps and their versions.
11021
+ <a id="__codelineno-32-3" name="__codelineno-32-3" href="#__codelineno-32-3"></a>Allow Nautobot to send these metrics? [y/n]: y
11022
+ <a id="__codelineno-32-4" name="__codelineno-32-4" href="#__codelineno-32-4"></a>Installation metrics will be sent when running &#39;nautobot-server post_upgrade&#39;. Thank you!
11023
+ <a id="__codelineno-32-5" name="__codelineno-32-5" href="#__codelineno-32-5"></a>Configuration file created at /home/example/.nautobot/nautobot_config.py
10959
11024
  </code></pre></div>
10960
11025
  <p>For more information on configuring Nautobot for the first time or on more advanced configuration patterns, please see the guide on <a href="../configuration/index.html">Nautobot Configuration</a>.</p>
10961
11026
  <h3 id="loaddata"><code>loaddata</code><a class="headerlink" href="#loaddata" title="Permanent link">&para;</a></h3>
@@ -10969,20 +11034,20 @@ String to use as a random generator seed for reproducible results.</p>
10969
11034
  <h3 id="migrate"><code>migrate</code><a class="headerlink" href="#migrate" title="Permanent link">&para;</a></h3>
10970
11035
  <p><code>nautobot-server migrate [app_label] [migration_name]</code></p>
10971
11036
  <p>Initialize a new database or run any pending database migrations to an existing database.</p>
10972
- <div class="highlight"><pre><span></span><code><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a>nautobot-server migrate
11037
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a>nautobot-server migrate
10973
11038
  </code></pre></div>
10974
11039
  <p>Output:</p>
10975
- <div class="highlight"><pre><span></span><code><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a>Wrapping model clean methods for custom validators failed because the ContentType table was not available or populated. This is normal during the execution of the migration command for the first time.
10976
- <a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a>Operations to perform:
10977
- <a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a> Apply all migrations: admin, auth, circuits, contenttypes, dcim, extras, ipam, sessions, taggit, tenancy, users, virtualization
10978
- <a id="__codelineno-30-4" name="__codelineno-30-4" href="#__codelineno-30-4"></a>Running migrations:
10979
- <a id="__codelineno-30-5" name="__codelineno-30-5" href="#__codelineno-30-5"></a> Applying ipam.0050_vlangroup_range... OK ( 0.1s)
10980
- <a id="__codelineno-30-6" name="__codelineno-30-6" href="#__codelineno-30-6"></a> Affected ipam.vlangroup 20 rows 0.003s/record
10981
- <a id="__codelineno-30-7" name="__codelineno-30-7" href="#__codelineno-30-7"></a> Applying dcim.0063_interfacevdcassignment_virtualdevicecont... OK ( 0.2s)
10982
- <a id="__codelineno-30-8" name="__codelineno-30-8" href="#__codelineno-30-8"></a> Affected dcim.interfacevdcassignment 0 rows
10983
- <a id="__codelineno-30-9" name="__codelineno-30-9" href="#__codelineno-30-9"></a> Affected dcim.virtualdevicecontext 0 rows
10984
- <a id="__codelineno-30-10" name="__codelineno-30-10" href="#__codelineno-30-10"></a> Applying dcim.0064_virtualdevicecontext_status_data_migrati...
10985
- <a id="__codelineno-30-11" name="__codelineno-30-11" href="#__codelineno-30-11"></a>... (truncated for brevity of documentation) ...
11040
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-34-1" name="__codelineno-34-1" href="#__codelineno-34-1"></a>Wrapping model clean methods for custom validators failed because the ContentType table was not available or populated. This is normal during the execution of the migration command for the first time.
11041
+ <a id="__codelineno-34-2" name="__codelineno-34-2" href="#__codelineno-34-2"></a>Operations to perform:
11042
+ <a id="__codelineno-34-3" name="__codelineno-34-3" href="#__codelineno-34-3"></a> Apply all migrations: admin, auth, circuits, contenttypes, dcim, extras, ipam, sessions, taggit, tenancy, users, virtualization
11043
+ <a id="__codelineno-34-4" name="__codelineno-34-4" href="#__codelineno-34-4"></a>Running migrations:
11044
+ <a id="__codelineno-34-5" name="__codelineno-34-5" href="#__codelineno-34-5"></a> Applying ipam.0050_vlangroup_range... OK ( 0.1s)
11045
+ <a id="__codelineno-34-6" name="__codelineno-34-6" href="#__codelineno-34-6"></a> Affected ipam.vlangroup 20 rows 0.003s/record
11046
+ <a id="__codelineno-34-7" name="__codelineno-34-7" href="#__codelineno-34-7"></a> Applying dcim.0063_interfacevdcassignment_virtualdevicecont... OK ( 0.2s)
11047
+ <a id="__codelineno-34-8" name="__codelineno-34-8" href="#__codelineno-34-8"></a> Affected dcim.interfacevdcassignment 0 rows
11048
+ <a id="__codelineno-34-9" name="__codelineno-34-9" href="#__codelineno-34-9"></a> Affected dcim.virtualdevicecontext 0 rows
11049
+ <a id="__codelineno-34-10" name="__codelineno-34-10" href="#__codelineno-34-10"></a> Applying dcim.0064_virtualdevicecontext_status_data_migrati...
11050
+ <a id="__codelineno-34-11" name="__codelineno-34-11" href="#__codelineno-34-11"></a>... (truncated for brevity of documentation) ...
10986
11051
  </code></pre></div>
10987
11052
  <div class="admonition note">
10988
11053
  <p class="admonition-title">Note</p>
@@ -10995,26 +11060,26 @@ String to use as a random generator seed for reproducible results.</p>
10995
11060
  <p class="admonition-title">Danger</p>
10996
11061
  <p>This is an advanced feature that gives you direct access to the Django database models. Use this very cautiously as you can cause irreparable damage to your Nautobot installation.</p>
10997
11062
  </div>
10998
- <div class="highlight"><pre><span></span><code><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a>nautobot-server nbshell
11063
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-35-1" name="__codelineno-35-1" href="#__codelineno-35-1"></a>nautobot-server nbshell
10999
11064
  </code></pre></div>
11000
11065
  <p>Prompt provided:</p>
11001
- <div class="highlight"><pre><span></span><code><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a># Shell Plus Model Imports
11002
- <a id="__codelineno-32-2" name="__codelineno-32-2" href="#__codelineno-32-2"></a>from constance.models import Constance
11003
- <a id="__codelineno-32-3" name="__codelineno-32-3" href="#__codelineno-32-3"></a>from django.contrib.admin.models import LogEntry
11004
- <a id="__codelineno-32-4" name="__codelineno-32-4" href="#__codelineno-32-4"></a>from django.contrib.auth.models import Group, Permission
11005
- <a id="__codelineno-32-5" name="__codelineno-32-5" href="#__codelineno-32-5"></a>...
11006
- <a id="__codelineno-32-6" name="__codelineno-32-6" href="#__codelineno-32-6"></a># Shell Plus Django Imports
11007
- <a id="__codelineno-32-7" name="__codelineno-32-7" href="#__codelineno-32-7"></a>from django.core.cache import cache
11008
- <a id="__codelineno-32-8" name="__codelineno-32-8" href="#__codelineno-32-8"></a>from django.conf import settings
11009
- <a id="__codelineno-32-9" name="__codelineno-32-9" href="#__codelineno-32-9"></a>from django.contrib.auth import get_user_model
11010
- <a id="__codelineno-32-10" name="__codelineno-32-10" href="#__codelineno-32-10"></a>...
11011
- <a id="__codelineno-32-11" name="__codelineno-32-11" href="#__codelineno-32-11"></a># Django version 4.2.15
11012
- <a id="__codelineno-32-12" name="__codelineno-32-12" href="#__codelineno-32-12"></a># Nautobot version 2.3.3b1
11013
- <a id="__codelineno-32-13" name="__codelineno-32-13" href="#__codelineno-32-13"></a>...
11014
- <a id="__codelineno-32-14" name="__codelineno-32-14" href="#__codelineno-32-14"></a>Python 3.12.6 (main, Sep 12 2024, 21:12:08) [GCC 12.2.0] on linux
11015
- <a id="__codelineno-32-15" name="__codelineno-32-15" href="#__codelineno-32-15"></a>Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.
11016
- <a id="__codelineno-32-16" name="__codelineno-32-16" href="#__codelineno-32-16"></a>(InteractiveConsole)
11017
- <a id="__codelineno-32-17" name="__codelineno-32-17" href="#__codelineno-32-17"></a>&gt;&gt;&gt;
11066
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-36-1" name="__codelineno-36-1" href="#__codelineno-36-1"></a># Shell Plus Model Imports
11067
+ <a id="__codelineno-36-2" name="__codelineno-36-2" href="#__codelineno-36-2"></a>from constance.models import Constance
11068
+ <a id="__codelineno-36-3" name="__codelineno-36-3" href="#__codelineno-36-3"></a>from django.contrib.admin.models import LogEntry
11069
+ <a id="__codelineno-36-4" name="__codelineno-36-4" href="#__codelineno-36-4"></a>from django.contrib.auth.models import Group, Permission
11070
+ <a id="__codelineno-36-5" name="__codelineno-36-5" href="#__codelineno-36-5"></a>...
11071
+ <a id="__codelineno-36-6" name="__codelineno-36-6" href="#__codelineno-36-6"></a># Shell Plus Django Imports
11072
+ <a id="__codelineno-36-7" name="__codelineno-36-7" href="#__codelineno-36-7"></a>from django.core.cache import cache
11073
+ <a id="__codelineno-36-8" name="__codelineno-36-8" href="#__codelineno-36-8"></a>from django.conf import settings
11074
+ <a id="__codelineno-36-9" name="__codelineno-36-9" href="#__codelineno-36-9"></a>from django.contrib.auth import get_user_model
11075
+ <a id="__codelineno-36-10" name="__codelineno-36-10" href="#__codelineno-36-10"></a>...
11076
+ <a id="__codelineno-36-11" name="__codelineno-36-11" href="#__codelineno-36-11"></a># Django version 4.2.15
11077
+ <a id="__codelineno-36-12" name="__codelineno-36-12" href="#__codelineno-36-12"></a># Nautobot version 2.3.3b1
11078
+ <a id="__codelineno-36-13" name="__codelineno-36-13" href="#__codelineno-36-13"></a>...
11079
+ <a id="__codelineno-36-14" name="__codelineno-36-14" href="#__codelineno-36-14"></a>Python 3.12.6 (main, Sep 12 2024, 21:12:08) [GCC 12.2.0] on linux
11080
+ <a id="__codelineno-36-15" name="__codelineno-36-15" href="#__codelineno-36-15"></a>Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.
11081
+ <a id="__codelineno-36-16" name="__codelineno-36-16" href="#__codelineno-36-16"></a>(InteractiveConsole)
11082
+ <a id="__codelineno-36-17" name="__codelineno-36-17" href="#__codelineno-36-17"></a>&gt;&gt;&gt;
11018
11083
  </code></pre></div>
11019
11084
  <p>Please see the dedicated guide on the <a href="nautobot-shell.html">Nautobot Shell</a> for more information.</p>
11020
11085
  <h3 id="pre_migrate"><code>pre_migrate</code><a class="headerlink" href="#pre_migrate" title="Permanent link">&para;</a></h3>
@@ -11075,32 +11140,32 @@ Do not automatically generate missing cable paths.</p>
11075
11140
  Do not automatically refresh the content type cache.</p>
11076
11141
  <p><code>--no-refresh-dynamic-group-member-caches</code><br />
11077
11142
  Do not automatically refresh the dynamic group member lists.</p>
11078
- <div class="highlight"><pre><span></span><code><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a>nautobot-server post_upgrade
11143
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-37-1" name="__codelineno-37-1" href="#__codelineno-37-1"></a>nautobot-server post_upgrade
11079
11144
  </code></pre></div>
11080
11145
  <p>Example Output:</p>
11081
- <div class="highlight"><pre><span></span><code><a id="__codelineno-34-1" name="__codelineno-34-1" href="#__codelineno-34-1"></a>Performing database migrations...
11082
- <a id="__codelineno-34-2" name="__codelineno-34-2" href="#__codelineno-34-2"></a>Operations to perform:
11083
- <a id="__codelineno-34-3" name="__codelineno-34-3" href="#__codelineno-34-3"></a> Apply all migrations: admin, auth, circuits, contenttypes, dcim, extras, ipam, sessions, taggit, tenancy, users, virtualization
11084
- <a id="__codelineno-34-4" name="__codelineno-34-4" href="#__codelineno-34-4"></a>Running migrations:
11085
- <a id="__codelineno-34-5" name="__codelineno-34-5" href="#__codelineno-34-5"></a> No migrations to apply.
11086
- <a id="__codelineno-34-6" name="__codelineno-34-6" href="#__codelineno-34-6"></a>
11087
- <a id="__codelineno-34-7" name="__codelineno-34-7" href="#__codelineno-34-7"></a>Generating cable paths...
11088
- <a id="__codelineno-34-8" name="__codelineno-34-8" href="#__codelineno-34-8"></a>Found no missing circuit termination paths; skipping
11089
- <a id="__codelineno-34-9" name="__codelineno-34-9" href="#__codelineno-34-9"></a>Found no missing console port paths; skipping
11090
- <a id="__codelineno-34-10" name="__codelineno-34-10" href="#__codelineno-34-10"></a>Found no missing console server port paths; skipping
11091
- <a id="__codelineno-34-11" name="__codelineno-34-11" href="#__codelineno-34-11"></a>Found no missing interface paths; skipping
11092
- <a id="__codelineno-34-12" name="__codelineno-34-12" href="#__codelineno-34-12"></a>Found no missing power feed paths; skipping
11093
- <a id="__codelineno-34-13" name="__codelineno-34-13" href="#__codelineno-34-13"></a>Found no missing power outlet paths; skipping
11094
- <a id="__codelineno-34-14" name="__codelineno-34-14" href="#__codelineno-34-14"></a>Found no missing power port paths; skipping
11095
- <a id="__codelineno-34-15" name="__codelineno-34-15" href="#__codelineno-34-15"></a>Finished.
11096
- <a id="__codelineno-34-16" name="__codelineno-34-16" href="#__codelineno-34-16"></a>
11097
- <a id="__codelineno-34-17" name="__codelineno-34-17" href="#__codelineno-34-17"></a>Collecting static files...
11098
- <a id="__codelineno-34-18" name="__codelineno-34-18" href="#__codelineno-34-18"></a>
11099
- <a id="__codelineno-34-19" name="__codelineno-34-19" href="#__codelineno-34-19"></a>0 static files copied to &#39;/opt/nautobot/static&#39;, 965 unmodified.
11100
- <a id="__codelineno-34-20" name="__codelineno-34-20" href="#__codelineno-34-20"></a>
11101
- <a id="__codelineno-34-21" name="__codelineno-34-21" href="#__codelineno-34-21"></a>Removing stale content types...
11102
- <a id="__codelineno-34-22" name="__codelineno-34-22" href="#__codelineno-34-22"></a>
11103
- <a id="__codelineno-34-23" name="__codelineno-34-23" href="#__codelineno-34-23"></a>Removing expired sessions...
11146
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-38-1" name="__codelineno-38-1" href="#__codelineno-38-1"></a>Performing database migrations...
11147
+ <a id="__codelineno-38-2" name="__codelineno-38-2" href="#__codelineno-38-2"></a>Operations to perform:
11148
+ <a id="__codelineno-38-3" name="__codelineno-38-3" href="#__codelineno-38-3"></a> Apply all migrations: admin, auth, circuits, contenttypes, dcim, extras, ipam, sessions, taggit, tenancy, users, virtualization
11149
+ <a id="__codelineno-38-4" name="__codelineno-38-4" href="#__codelineno-38-4"></a>Running migrations:
11150
+ <a id="__codelineno-38-5" name="__codelineno-38-5" href="#__codelineno-38-5"></a> No migrations to apply.
11151
+ <a id="__codelineno-38-6" name="__codelineno-38-6" href="#__codelineno-38-6"></a>
11152
+ <a id="__codelineno-38-7" name="__codelineno-38-7" href="#__codelineno-38-7"></a>Generating cable paths...
11153
+ <a id="__codelineno-38-8" name="__codelineno-38-8" href="#__codelineno-38-8"></a>Found no missing circuit termination paths; skipping
11154
+ <a id="__codelineno-38-9" name="__codelineno-38-9" href="#__codelineno-38-9"></a>Found no missing console port paths; skipping
11155
+ <a id="__codelineno-38-10" name="__codelineno-38-10" href="#__codelineno-38-10"></a>Found no missing console server port paths; skipping
11156
+ <a id="__codelineno-38-11" name="__codelineno-38-11" href="#__codelineno-38-11"></a>Found no missing interface paths; skipping
11157
+ <a id="__codelineno-38-12" name="__codelineno-38-12" href="#__codelineno-38-12"></a>Found no missing power feed paths; skipping
11158
+ <a id="__codelineno-38-13" name="__codelineno-38-13" href="#__codelineno-38-13"></a>Found no missing power outlet paths; skipping
11159
+ <a id="__codelineno-38-14" name="__codelineno-38-14" href="#__codelineno-38-14"></a>Found no missing power port paths; skipping
11160
+ <a id="__codelineno-38-15" name="__codelineno-38-15" href="#__codelineno-38-15"></a>Finished.
11161
+ <a id="__codelineno-38-16" name="__codelineno-38-16" href="#__codelineno-38-16"></a>
11162
+ <a id="__codelineno-38-17" name="__codelineno-38-17" href="#__codelineno-38-17"></a>Collecting static files...
11163
+ <a id="__codelineno-38-18" name="__codelineno-38-18" href="#__codelineno-38-18"></a>
11164
+ <a id="__codelineno-38-19" name="__codelineno-38-19" href="#__codelineno-38-19"></a>0 static files copied to &#39;/opt/nautobot/static&#39;, 965 unmodified.
11165
+ <a id="__codelineno-38-20" name="__codelineno-38-20" href="#__codelineno-38-20"></a>
11166
+ <a id="__codelineno-38-21" name="__codelineno-38-21" href="#__codelineno-38-21"></a>Removing stale content types...
11167
+ <a id="__codelineno-38-22" name="__codelineno-38-22" href="#__codelineno-38-22"></a>
11168
+ <a id="__codelineno-38-23" name="__codelineno-38-23" href="#__codelineno-38-23"></a>Removing expired sessions...
11104
11169
  </code></pre></div>
11105
11170
  <h3 id="refresh_dynamic_group_member_caches"><code>refresh_dynamic_group_member_caches</code><a class="headerlink" href="#refresh_dynamic_group_member_caches" title="Permanent link">&para;</a></h3>
11106
11171
  <p><code>nautobot-server refresh_dynamic_group_member_caches</code></p>
@@ -11115,52 +11180,52 @@ Do not automatically refresh the dynamic group member lists.</p>
11115
11180
  <p><code>nautobot-server renaturalize [app_label.ModelName [app_label.ModelName ...]]</code></p>
11116
11181
  <p>Recalculate natural ordering values for the specified models.</p>
11117
11182
  <p>This defaults to recalculating natural ordering on all models which have one or more fields of type <code>NaturalOrderingField</code>:</p>
11118
- <div class="highlight"><pre><span></span><code><a id="__codelineno-35-1" name="__codelineno-35-1" href="#__codelineno-35-1"></a>nautobot-server renaturalize
11183
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-39-1" name="__codelineno-39-1" href="#__codelineno-39-1"></a>nautobot-server renaturalize
11119
11184
  </code></pre></div>
11120
11185
  <p>Example output:</p>
11121
- <div class="highlight"><pre><span></span><code><a id="__codelineno-36-1" name="__codelineno-36-1" href="#__codelineno-36-1"></a>Renaturalizing 21 models.
11122
- <a id="__codelineno-36-2" name="__codelineno-36-2" href="#__codelineno-36-2"></a>dcim.ConsolePort.name (_name)... 196
11123
- <a id="__codelineno-36-3" name="__codelineno-36-3" href="#__codelineno-36-3"></a>dcim.ConsoleServerPort.name (_name)... 0
11124
- <a id="__codelineno-36-4" name="__codelineno-36-4" href="#__codelineno-36-4"></a>dcim.PowerPort.name (_name)... 392
11125
- <a id="__codelineno-36-5" name="__codelineno-36-5" href="#__codelineno-36-5"></a>dcim.PowerOutlet.name (_name)... 0
11126
- <a id="__codelineno-36-6" name="__codelineno-36-6" href="#__codelineno-36-6"></a>dcim.Interface.name (_name)... 7161
11127
- <a id="__codelineno-36-7" name="__codelineno-36-7" href="#__codelineno-36-7"></a>dcim.FrontPort.name (_name)... 0
11128
- <a id="__codelineno-36-8" name="__codelineno-36-8" href="#__codelineno-36-8"></a>dcim.RearPort.name (_name)... 0
11129
- <a id="__codelineno-36-9" name="__codelineno-36-9" href="#__codelineno-36-9"></a>dcim.DeviceBay.name (_name)... 0
11130
- <a id="__codelineno-36-10" name="__codelineno-36-10" href="#__codelineno-36-10"></a>dcim.InventoryItem.name (_name)... 1
11131
- <a id="__codelineno-36-11" name="__codelineno-36-11" href="#__codelineno-36-11"></a>dcim.Device.name (_name)... 208
11132
- <a id="__codelineno-36-12" name="__codelineno-36-12" href="#__codelineno-36-12"></a>dcim.ConsolePortTemplate.name (_name)... 2
11133
- <a id="__codelineno-36-13" name="__codelineno-36-13" href="#__codelineno-36-13"></a>dcim.ConsoleServerPortTemplate.name (_name)... 0
11134
- <a id="__codelineno-36-14" name="__codelineno-36-14" href="#__codelineno-36-14"></a>dcim.PowerPortTemplate.name (_name)... 4
11135
- <a id="__codelineno-36-15" name="__codelineno-36-15" href="#__codelineno-36-15"></a>dcim.PowerOutletTemplate.name (_name)... 0
11136
- <a id="__codelineno-36-16" name="__codelineno-36-16" href="#__codelineno-36-16"></a>dcim.InterfaceTemplate.name (_name)... 221
11137
- <a id="__codelineno-36-17" name="__codelineno-36-17" href="#__codelineno-36-17"></a>dcim.FrontPortTemplate.name (_name)... 0
11138
- <a id="__codelineno-36-18" name="__codelineno-36-18" href="#__codelineno-36-18"></a>dcim.RearPortTemplate.name (_name)... 0
11139
- <a id="__codelineno-36-19" name="__codelineno-36-19" href="#__codelineno-36-19"></a>dcim.DeviceBayTemplate.name (_name)... 0
11140
- <a id="__codelineno-36-20" name="__codelineno-36-20" href="#__codelineno-36-20"></a>dcim.Rack.name (_name)... 156
11141
- <a id="__codelineno-36-21" name="__codelineno-36-21" href="#__codelineno-36-21"></a>virtualization.VMInterface.name (_name)... 0
11142
- <a id="__codelineno-36-22" name="__codelineno-36-22" href="#__codelineno-36-22"></a>Done.
11186
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-40-1" name="__codelineno-40-1" href="#__codelineno-40-1"></a>Renaturalizing 21 models.
11187
+ <a id="__codelineno-40-2" name="__codelineno-40-2" href="#__codelineno-40-2"></a>dcim.ConsolePort.name (_name)... 196
11188
+ <a id="__codelineno-40-3" name="__codelineno-40-3" href="#__codelineno-40-3"></a>dcim.ConsoleServerPort.name (_name)... 0
11189
+ <a id="__codelineno-40-4" name="__codelineno-40-4" href="#__codelineno-40-4"></a>dcim.PowerPort.name (_name)... 392
11190
+ <a id="__codelineno-40-5" name="__codelineno-40-5" href="#__codelineno-40-5"></a>dcim.PowerOutlet.name (_name)... 0
11191
+ <a id="__codelineno-40-6" name="__codelineno-40-6" href="#__codelineno-40-6"></a>dcim.Interface.name (_name)... 7161
11192
+ <a id="__codelineno-40-7" name="__codelineno-40-7" href="#__codelineno-40-7"></a>dcim.FrontPort.name (_name)... 0
11193
+ <a id="__codelineno-40-8" name="__codelineno-40-8" href="#__codelineno-40-8"></a>dcim.RearPort.name (_name)... 0
11194
+ <a id="__codelineno-40-9" name="__codelineno-40-9" href="#__codelineno-40-9"></a>dcim.DeviceBay.name (_name)... 0
11195
+ <a id="__codelineno-40-10" name="__codelineno-40-10" href="#__codelineno-40-10"></a>dcim.InventoryItem.name (_name)... 1
11196
+ <a id="__codelineno-40-11" name="__codelineno-40-11" href="#__codelineno-40-11"></a>dcim.Device.name (_name)... 208
11197
+ <a id="__codelineno-40-12" name="__codelineno-40-12" href="#__codelineno-40-12"></a>dcim.ConsolePortTemplate.name (_name)... 2
11198
+ <a id="__codelineno-40-13" name="__codelineno-40-13" href="#__codelineno-40-13"></a>dcim.ConsoleServerPortTemplate.name (_name)... 0
11199
+ <a id="__codelineno-40-14" name="__codelineno-40-14" href="#__codelineno-40-14"></a>dcim.PowerPortTemplate.name (_name)... 4
11200
+ <a id="__codelineno-40-15" name="__codelineno-40-15" href="#__codelineno-40-15"></a>dcim.PowerOutletTemplate.name (_name)... 0
11201
+ <a id="__codelineno-40-16" name="__codelineno-40-16" href="#__codelineno-40-16"></a>dcim.InterfaceTemplate.name (_name)... 221
11202
+ <a id="__codelineno-40-17" name="__codelineno-40-17" href="#__codelineno-40-17"></a>dcim.FrontPortTemplate.name (_name)... 0
11203
+ <a id="__codelineno-40-18" name="__codelineno-40-18" href="#__codelineno-40-18"></a>dcim.RearPortTemplate.name (_name)... 0
11204
+ <a id="__codelineno-40-19" name="__codelineno-40-19" href="#__codelineno-40-19"></a>dcim.DeviceBayTemplate.name (_name)... 0
11205
+ <a id="__codelineno-40-20" name="__codelineno-40-20" href="#__codelineno-40-20"></a>dcim.Rack.name (_name)... 156
11206
+ <a id="__codelineno-40-21" name="__codelineno-40-21" href="#__codelineno-40-21"></a>virtualization.VMInterface.name (_name)... 0
11207
+ <a id="__codelineno-40-22" name="__codelineno-40-22" href="#__codelineno-40-22"></a>Done.
11143
11208
  </code></pre></div>
11144
11209
  <p>You may optionally specify or more specific models (each prefixed with its app_label) to renaturalize:</p>
11145
- <div class="highlight"><pre><span></span><code><a id="__codelineno-37-1" name="__codelineno-37-1" href="#__codelineno-37-1"></a>nautobot-server renaturalize dcim.Device
11210
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-41-1" name="__codelineno-41-1" href="#__codelineno-41-1"></a>nautobot-server renaturalize dcim.Device
11146
11211
  </code></pre></div>
11147
11212
  <p>Example output:</p>
11148
- <div class="highlight"><pre><span></span><code><a id="__codelineno-38-1" name="__codelineno-38-1" href="#__codelineno-38-1"></a>Renaturalizing 1 models.
11149
- <a id="__codelineno-38-2" name="__codelineno-38-2" href="#__codelineno-38-2"></a>dcim.Device.name (_name)... 208
11150
- <a id="__codelineno-38-3" name="__codelineno-38-3" href="#__codelineno-38-3"></a>Done.
11213
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-42-1" name="__codelineno-42-1" href="#__codelineno-42-1"></a>Renaturalizing 1 models.
11214
+ <a id="__codelineno-42-2" name="__codelineno-42-2" href="#__codelineno-42-2"></a>dcim.Device.name (_name)... 208
11215
+ <a id="__codelineno-42-3" name="__codelineno-42-3" href="#__codelineno-42-3"></a>Done.
11151
11216
  </code></pre></div>
11152
11217
  <h3 id="runjob"><code>runjob</code><a class="headerlink" href="#runjob" title="Permanent link">&para;</a></h3>
11153
11218
  <p><code>nautobot-server runjob --username &lt;username&gt; [--local] [--data &lt;data&gt;] &lt;job&gt;</code></p>
11154
11219
  <p>Run a job (script, report) to validate or update data in Nautobot. The Job name must be in the Python module form: <code>&lt;module_name&gt;.&lt;JobClassName&gt;</code>. You can find this under the Job's detail view on the "Class Path" row.</p>
11155
11220
  <p><code>--username &lt;username&gt;</code><br />
11156
11221
  User account to impersonate as the requester of this job.</p>
11157
- <div class="highlight"><pre><span></span><code><a id="__codelineno-39-1" name="__codelineno-39-1" href="#__codelineno-39-1"></a>nautobot-server runjob --username someuser example_app.jobs.MyJobWithNoVars
11222
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-43-1" name="__codelineno-43-1" href="#__codelineno-43-1"></a>nautobot-server runjob --username someuser example_app.jobs.MyJobWithNoVars
11158
11223
  </code></pre></div>
11159
11224
  <p><code>--local</code>
11160
11225
  Run the job on the local system and not on a worker.</p>
11161
11226
  <p><code>--data &lt;data&gt;</code>
11162
11227
  JSON string that populates the <code>data</code> variable of the job.</p>
11163
- <div class="highlight"><pre><span></span><code><a id="__codelineno-40-1" name="__codelineno-40-1" href="#__codelineno-40-1"></a>nautobot-server runjob --username someuser --local --data &#39;{&quot;my_boolvar&quot;: false}&#39; example_app.jobs.MyJobWithVars
11228
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-44-1" name="__codelineno-44-1" href="#__codelineno-44-1"></a>nautobot-server runjob --username someuser --local --data &#39;{&quot;my_boolvar&quot;: false}&#39; example_app.jobs.MyJobWithVars
11164
11229
  </code></pre></div>
11165
11230
  <p>Please see the <a href="../../platform-functionality/jobs/index.html">guide on Jobs</a> for more information on working with and running jobs.</p>
11166
11231
  <h3 id="send_installation_metrics"><code>send_installation_metrics</code><a class="headerlink" href="#send_installation_metrics" title="Permanent link">&para;</a></h3>
@@ -11168,15 +11233,15 @@ JSON string that populates the <code>data</code> variable of the job.</p>
11168
11233
  <p>Send anonymized installation metrics to the Nautobot maintainers. This management command is called by <a href="#post_upgrade"><code>post_upgrade</code></a> and is not intended to be run manually.</p>
11169
11234
  <p>If the <a href="../configuration/settings.html#installation_metrics_enabled"><code>INSTALLATION_METRICS_ENABLED</code></a> setting is <code>True</code>, this command will send a list of all installed <a href="../../../development/apps/index.html">Apps</a> and their versions, as well as the currently installed Nautobot and Python versions, to the Nautobot maintainers. A randomized UUID will be generated and saved in the <a href="../configuration/settings.html#deployment_id"><code>DEPLOYMENT_ID</code></a> setting to anonymously but uniquely identify this installation. The App names will be one-way hashed with SHA256 to further anonymize the data sent. This enables tracking the installation metrics of publicly released apps without disclosing the names of any private apps.</p>
11170
11235
  <p>The following is an example of the data that is sent:</p>
11171
- <div class="highlight"><pre><span></span><code><a id="__codelineno-41-1" name="__codelineno-41-1" href="#__codelineno-41-1"></a><span class="p">{</span>
11172
- <a id="__codelineno-41-2" name="__codelineno-41-2" href="#__codelineno-41-2"></a> <span class="s2">&quot;deployment_id&quot;</span><span class="p">:</span> <span class="s2">&quot;1de3dacf-f046-4a98-8d4a-17419080db79&quot;</span><span class="p">,</span>
11173
- <a id="__codelineno-41-3" name="__codelineno-41-3" href="#__codelineno-41-3"></a> <span class="s2">&quot;nautobot_version&quot;</span><span class="p">:</span> <span class="s2">&quot;2.1.2&quot;</span><span class="p">,</span>
11174
- <a id="__codelineno-41-4" name="__codelineno-41-4" href="#__codelineno-41-4"></a> <span class="s2">&quot;python_version&quot;</span><span class="p">:</span> <span class="s2">&quot;3.10.12&quot;</span><span class="p">,</span>
11175
- <a id="__codelineno-41-5" name="__codelineno-41-5" href="#__codelineno-41-5"></a> <span class="s2">&quot;installed_apps&quot;</span><span class="p">:</span> <span class="p">{</span>
11176
- <a id="__codelineno-41-6" name="__codelineno-41-6" href="#__codelineno-41-6"></a> <span class="c1"># &quot;example_app&quot; hashed by sha256</span>
11177
- <a id="__codelineno-41-7" name="__codelineno-41-7" href="#__codelineno-41-7"></a> <span class="s2">&quot;ded1fb19a53a47aa4fe26b72b4ab9297b631e4d4f852b03b3788d5dbc292ae8d&quot;</span><span class="p">:</span> <span class="s2">&quot;1.0.0&quot;</span>
11178
- <a id="__codelineno-41-8" name="__codelineno-41-8" href="#__codelineno-41-8"></a> <span class="p">}</span>
11179
- <a id="__codelineno-41-9" name="__codelineno-41-9" href="#__codelineno-41-9"></a><span class="p">}</span>
11236
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-45-1" name="__codelineno-45-1" href="#__codelineno-45-1"></a><span class="p">{</span>
11237
+ <a id="__codelineno-45-2" name="__codelineno-45-2" href="#__codelineno-45-2"></a> <span class="s2">&quot;deployment_id&quot;</span><span class="p">:</span> <span class="s2">&quot;1de3dacf-f046-4a98-8d4a-17419080db79&quot;</span><span class="p">,</span>
11238
+ <a id="__codelineno-45-3" name="__codelineno-45-3" href="#__codelineno-45-3"></a> <span class="s2">&quot;nautobot_version&quot;</span><span class="p">:</span> <span class="s2">&quot;2.1.2&quot;</span><span class="p">,</span>
11239
+ <a id="__codelineno-45-4" name="__codelineno-45-4" href="#__codelineno-45-4"></a> <span class="s2">&quot;python_version&quot;</span><span class="p">:</span> <span class="s2">&quot;3.10.12&quot;</span><span class="p">,</span>
11240
+ <a id="__codelineno-45-5" name="__codelineno-45-5" href="#__codelineno-45-5"></a> <span class="s2">&quot;installed_apps&quot;</span><span class="p">:</span> <span class="p">{</span>
11241
+ <a id="__codelineno-45-6" name="__codelineno-45-6" href="#__codelineno-45-6"></a> <span class="c1"># &quot;example_app&quot; hashed by sha256</span>
11242
+ <a id="__codelineno-45-7" name="__codelineno-45-7" href="#__codelineno-45-7"></a> <span class="s2">&quot;ded1fb19a53a47aa4fe26b72b4ab9297b631e4d4f852b03b3788d5dbc292ae8d&quot;</span><span class="p">:</span> <span class="s2">&quot;1.0.0&quot;</span>
11243
+ <a id="__codelineno-45-8" name="__codelineno-45-8" href="#__codelineno-45-8"></a> <span class="p">}</span>
11244
+ <a id="__codelineno-45-9" name="__codelineno-45-9" href="#__codelineno-45-9"></a><span class="p">}</span>
11180
11245
  </code></pre></div>
11181
11246
  <h3 id="start"><code>start</code><a class="headerlink" href="#start" title="Permanent link">&para;</a></h3>
11182
11247
  <p><code>nautobot-server start</code></p>
@@ -11185,43 +11250,43 @@ JSON string that populates the <code>data</code> variable of the job.</p>
11185
11250
  <p class="admonition-title">Note</p>
11186
11251
  <p>uWSGI offers an overwhelming amount of command-line arguments that could not possibly be covered here. Please see the <a href="https://uwsgi-docs.readthedocs.io/en/latest/Options.html">official uWSGI Options guide</a> for more information.</p>
11187
11252
  </div>
11188
- <div class="highlight"><pre><span></span><code><a id="__codelineno-42-1" name="__codelineno-42-1" href="#__codelineno-42-1"></a>nautobot-server start --ini ./uwsgi.ini
11253
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a>nautobot-server start --ini ./uwsgi.ini
11189
11254
  </code></pre></div>
11190
11255
  <p>Example output:</p>
11191
- <div class="highlight"><pre><span></span><code><a id="__codelineno-43-1" name="__codelineno-43-1" href="#__codelineno-43-1"></a>[uWSGI] getting INI configuration from ./uwsgi.ini
11192
- <a id="__codelineno-43-2" name="__codelineno-43-2" href="#__codelineno-43-2"></a>[uwsgi-static] added mapping for /static =&gt; /opt/nautobot/static
11193
- <a id="__codelineno-43-3" name="__codelineno-43-3" href="#__codelineno-43-3"></a>*** Starting uWSGI 2.0.19.1 (64bit) on [Thu Mar 11 21:13:22 2021] ***
11194
- <a id="__codelineno-43-4" name="__codelineno-43-4" href="#__codelineno-43-4"></a>compiled with version: 8.3.1 20190311 (Red Hat 8.3.1-3) on 23 September 2020 02:39:40
11195
- <a id="__codelineno-43-5" name="__codelineno-43-5" href="#__codelineno-43-5"></a>os: Linux-5.4.0-52-generic #57-Ubuntu SMP Thu Oct 15 10:57:00 UTC 2020
11196
- <a id="__codelineno-43-6" name="__codelineno-43-6" href="#__codelineno-43-6"></a>nodename: jathan-nautobot-testing
11197
- <a id="__codelineno-43-7" name="__codelineno-43-7" href="#__codelineno-43-7"></a>machine: x86_64
11198
- <a id="__codelineno-43-8" name="__codelineno-43-8" href="#__codelineno-43-8"></a>clock source: unix
11199
- <a id="__codelineno-43-9" name="__codelineno-43-9" href="#__codelineno-43-9"></a>pcre jit disabled
11200
- <a id="__codelineno-43-10" name="__codelineno-43-10" href="#__codelineno-43-10"></a>detected number of CPU cores: 48
11201
- <a id="__codelineno-43-11" name="__codelineno-43-11" href="#__codelineno-43-11"></a>current working directory: /opt/nautobot
11202
- <a id="__codelineno-43-12" name="__codelineno-43-12" href="#__codelineno-43-12"></a>detected binary path: /usr/bin/python3.8
11203
- <a id="__codelineno-43-13" name="__codelineno-43-13" href="#__codelineno-43-13"></a>your processes number limit is 256070
11204
- <a id="__codelineno-43-14" name="__codelineno-43-14" href="#__codelineno-43-14"></a>your memory page size is 4096 bytes
11205
- <a id="__codelineno-43-15" name="__codelineno-43-15" href="#__codelineno-43-15"></a>detected max file descriptor number: 1024
11206
- <a id="__codelineno-43-16" name="__codelineno-43-16" href="#__codelineno-43-16"></a>building mime-types dictionary from file /etc/mime.types...567 entry found
11207
- <a id="__codelineno-43-17" name="__codelineno-43-17" href="#__codelineno-43-17"></a>lock engine: pthread robust mutexes
11208
- <a id="__codelineno-43-18" name="__codelineno-43-18" href="#__codelineno-43-18"></a>thunder lock: disabled (you can enable it with --thunder-lock)
11209
- <a id="__codelineno-43-19" name="__codelineno-43-19" href="#__codelineno-43-19"></a>uwsgi socket 0 bound to TCP address 0.0.0.0:9191 fd 7
11210
- <a id="__codelineno-43-20" name="__codelineno-43-20" href="#__codelineno-43-20"></a>Python version: 3.8.5 (default, Jan 27 2021, 15:41:15) [GCC 9.3.0]
11211
- <a id="__codelineno-43-21" name="__codelineno-43-21" href="#__codelineno-43-21"></a>--- Python VM already initialized ---
11212
- <a id="__codelineno-43-22" name="__codelineno-43-22" href="#__codelineno-43-22"></a>Python main interpreter initialized at 0x2573e30
11213
- <a id="__codelineno-43-23" name="__codelineno-43-23" href="#__codelineno-43-23"></a>python threads support enabled
11214
- <a id="__codelineno-43-24" name="__codelineno-43-24" href="#__codelineno-43-24"></a>your server socket listen backlog is limited to 1024 connections
11215
- <a id="__codelineno-43-25" name="__codelineno-43-25" href="#__codelineno-43-25"></a>your mercy for graceful operations on workers is 60 seconds
11216
- <a id="__codelineno-43-26" name="__codelineno-43-26" href="#__codelineno-43-26"></a>mapped 636432 bytes (621 KB) for 15 cores
11217
- <a id="__codelineno-43-27" name="__codelineno-43-27" href="#__codelineno-43-27"></a>*** Operational MODE: preforking+threaded ***
11218
- <a id="__codelineno-43-28" name="__codelineno-43-28" href="#__codelineno-43-28"></a>WSGI app 0 (mountpoint=&#39;&#39;) ready in 0 seconds on interpreter 0x2573e30 pid: 112153 (default app)
11219
- <a id="__codelineno-43-29" name="__codelineno-43-29" href="#__codelineno-43-29"></a>spawned uWSGI master process (pid: 112153)
11220
- <a id="__codelineno-43-30" name="__codelineno-43-30" href="#__codelineno-43-30"></a>spawned uWSGI worker 1 (pid: 112159, cores: 3)
11221
- <a id="__codelineno-43-31" name="__codelineno-43-31" href="#__codelineno-43-31"></a>spawned uWSGI worker 2 (pid: 112162, cores: 3)
11222
- <a id="__codelineno-43-32" name="__codelineno-43-32" href="#__codelineno-43-32"></a>spawned uWSGI worker 3 (pid: 112165, cores: 3)
11223
- <a id="__codelineno-43-33" name="__codelineno-43-33" href="#__codelineno-43-33"></a>spawned uWSGI worker 4 (pid: 112168, cores: 3)
11224
- <a id="__codelineno-43-34" name="__codelineno-43-34" href="#__codelineno-43-34"></a>spawned uWSGI worker 5 (pid: 112171, cores: 3)
11256
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-47-1" name="__codelineno-47-1" href="#__codelineno-47-1"></a>[uWSGI] getting INI configuration from ./uwsgi.ini
11257
+ <a id="__codelineno-47-2" name="__codelineno-47-2" href="#__codelineno-47-2"></a>[uwsgi-static] added mapping for /static =&gt; /opt/nautobot/static
11258
+ <a id="__codelineno-47-3" name="__codelineno-47-3" href="#__codelineno-47-3"></a>*** Starting uWSGI 2.0.19.1 (64bit) on [Thu Mar 11 21:13:22 2021] ***
11259
+ <a id="__codelineno-47-4" name="__codelineno-47-4" href="#__codelineno-47-4"></a>compiled with version: 8.3.1 20190311 (Red Hat 8.3.1-3) on 23 September 2020 02:39:40
11260
+ <a id="__codelineno-47-5" name="__codelineno-47-5" href="#__codelineno-47-5"></a>os: Linux-5.4.0-52-generic #57-Ubuntu SMP Thu Oct 15 10:57:00 UTC 2020
11261
+ <a id="__codelineno-47-6" name="__codelineno-47-6" href="#__codelineno-47-6"></a>nodename: jathan-nautobot-testing
11262
+ <a id="__codelineno-47-7" name="__codelineno-47-7" href="#__codelineno-47-7"></a>machine: x86_64
11263
+ <a id="__codelineno-47-8" name="__codelineno-47-8" href="#__codelineno-47-8"></a>clock source: unix
11264
+ <a id="__codelineno-47-9" name="__codelineno-47-9" href="#__codelineno-47-9"></a>pcre jit disabled
11265
+ <a id="__codelineno-47-10" name="__codelineno-47-10" href="#__codelineno-47-10"></a>detected number of CPU cores: 48
11266
+ <a id="__codelineno-47-11" name="__codelineno-47-11" href="#__codelineno-47-11"></a>current working directory: /opt/nautobot
11267
+ <a id="__codelineno-47-12" name="__codelineno-47-12" href="#__codelineno-47-12"></a>detected binary path: /usr/bin/python3.8
11268
+ <a id="__codelineno-47-13" name="__codelineno-47-13" href="#__codelineno-47-13"></a>your processes number limit is 256070
11269
+ <a id="__codelineno-47-14" name="__codelineno-47-14" href="#__codelineno-47-14"></a>your memory page size is 4096 bytes
11270
+ <a id="__codelineno-47-15" name="__codelineno-47-15" href="#__codelineno-47-15"></a>detected max file descriptor number: 1024
11271
+ <a id="__codelineno-47-16" name="__codelineno-47-16" href="#__codelineno-47-16"></a>building mime-types dictionary from file /etc/mime.types...567 entry found
11272
+ <a id="__codelineno-47-17" name="__codelineno-47-17" href="#__codelineno-47-17"></a>lock engine: pthread robust mutexes
11273
+ <a id="__codelineno-47-18" name="__codelineno-47-18" href="#__codelineno-47-18"></a>thunder lock: disabled (you can enable it with --thunder-lock)
11274
+ <a id="__codelineno-47-19" name="__codelineno-47-19" href="#__codelineno-47-19"></a>uwsgi socket 0 bound to TCP address 0.0.0.0:9191 fd 7
11275
+ <a id="__codelineno-47-20" name="__codelineno-47-20" href="#__codelineno-47-20"></a>Python version: 3.8.5 (default, Jan 27 2021, 15:41:15) [GCC 9.3.0]
11276
+ <a id="__codelineno-47-21" name="__codelineno-47-21" href="#__codelineno-47-21"></a>--- Python VM already initialized ---
11277
+ <a id="__codelineno-47-22" name="__codelineno-47-22" href="#__codelineno-47-22"></a>Python main interpreter initialized at 0x2573e30
11278
+ <a id="__codelineno-47-23" name="__codelineno-47-23" href="#__codelineno-47-23"></a>python threads support enabled
11279
+ <a id="__codelineno-47-24" name="__codelineno-47-24" href="#__codelineno-47-24"></a>your server socket listen backlog is limited to 1024 connections
11280
+ <a id="__codelineno-47-25" name="__codelineno-47-25" href="#__codelineno-47-25"></a>your mercy for graceful operations on workers is 60 seconds
11281
+ <a id="__codelineno-47-26" name="__codelineno-47-26" href="#__codelineno-47-26"></a>mapped 636432 bytes (621 KB) for 15 cores
11282
+ <a id="__codelineno-47-27" name="__codelineno-47-27" href="#__codelineno-47-27"></a>*** Operational MODE: preforking+threaded ***
11283
+ <a id="__codelineno-47-28" name="__codelineno-47-28" href="#__codelineno-47-28"></a>WSGI app 0 (mountpoint=&#39;&#39;) ready in 0 seconds on interpreter 0x2573e30 pid: 112153 (default app)
11284
+ <a id="__codelineno-47-29" name="__codelineno-47-29" href="#__codelineno-47-29"></a>spawned uWSGI master process (pid: 112153)
11285
+ <a id="__codelineno-47-30" name="__codelineno-47-30" href="#__codelineno-47-30"></a>spawned uWSGI worker 1 (pid: 112159, cores: 3)
11286
+ <a id="__codelineno-47-31" name="__codelineno-47-31" href="#__codelineno-47-31"></a>spawned uWSGI worker 2 (pid: 112162, cores: 3)
11287
+ <a id="__codelineno-47-32" name="__codelineno-47-32" href="#__codelineno-47-32"></a>spawned uWSGI worker 3 (pid: 112165, cores: 3)
11288
+ <a id="__codelineno-47-33" name="__codelineno-47-33" href="#__codelineno-47-33"></a>spawned uWSGI worker 4 (pid: 112168, cores: 3)
11289
+ <a id="__codelineno-47-34" name="__codelineno-47-34" href="#__codelineno-47-34"></a>spawned uWSGI worker 5 (pid: 112171, cores: 3)
11225
11290
  </code></pre></div>
11226
11291
  <p>Please see the guide on <a href="../installation/services.html">Deploying Nautobot Services</a> for our recommended configuration for use with uWSGI.</p>
11227
11292
  <h3 id="trace_paths"><code>trace_paths</code><a class="headerlink" href="#trace_paths" title="Permanent link">&para;</a></h3>
@@ -11232,17 +11297,17 @@ JSON string that populates the <code>data</code> variable of the job.</p>
11232
11297
  Force recalculation of all existing cable paths.</p>
11233
11298
  <p><code>--no-input</code><br />
11234
11299
  Do not prompt user for any input/confirmation.</p>
11235
- <div class="highlight"><pre><span></span><code><a id="__codelineno-44-1" name="__codelineno-44-1" href="#__codelineno-44-1"></a>nautobot-server trace_paths
11300
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-48-1" name="__codelineno-48-1" href="#__codelineno-48-1"></a>nautobot-server trace_paths
11236
11301
  </code></pre></div>
11237
11302
  <p>Example output:</p>
11238
- <div class="highlight"><pre><span></span><code><a id="__codelineno-45-1" name="__codelineno-45-1" href="#__codelineno-45-1"></a>Found no missing circuit termination paths; skipping
11239
- <a id="__codelineno-45-2" name="__codelineno-45-2" href="#__codelineno-45-2"></a>Found no missing console port paths; skipping
11240
- <a id="__codelineno-45-3" name="__codelineno-45-3" href="#__codelineno-45-3"></a>Found no missing console server port paths; skipping
11241
- <a id="__codelineno-45-4" name="__codelineno-45-4" href="#__codelineno-45-4"></a>Found no missing interface paths; skipping
11242
- <a id="__codelineno-45-5" name="__codelineno-45-5" href="#__codelineno-45-5"></a>Found no missing power feed paths; skipping
11243
- <a id="__codelineno-45-6" name="__codelineno-45-6" href="#__codelineno-45-6"></a>Found no missing power outlet paths; skipping
11244
- <a id="__codelineno-45-7" name="__codelineno-45-7" href="#__codelineno-45-7"></a>Found no missing power port paths; skipping
11245
- <a id="__codelineno-45-8" name="__codelineno-45-8" href="#__codelineno-45-8"></a>Finished.
11303
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-49-1" name="__codelineno-49-1" href="#__codelineno-49-1"></a>Found no missing circuit termination paths; skipping
11304
+ <a id="__codelineno-49-2" name="__codelineno-49-2" href="#__codelineno-49-2"></a>Found no missing console port paths; skipping
11305
+ <a id="__codelineno-49-3" name="__codelineno-49-3" href="#__codelineno-49-3"></a>Found no missing console server port paths; skipping
11306
+ <a id="__codelineno-49-4" name="__codelineno-49-4" href="#__codelineno-49-4"></a>Found no missing interface paths; skipping
11307
+ <a id="__codelineno-49-5" name="__codelineno-49-5" href="#__codelineno-49-5"></a>Found no missing power feed paths; skipping
11308
+ <a id="__codelineno-49-6" name="__codelineno-49-6" href="#__codelineno-49-6"></a>Found no missing power outlet paths; skipping
11309
+ <a id="__codelineno-49-7" name="__codelineno-49-7" href="#__codelineno-49-7"></a>Found no missing power port paths; skipping
11310
+ <a id="__codelineno-49-8" name="__codelineno-49-8" href="#__codelineno-49-8"></a>Finished.
11246
11311
  </code></pre></div>
11247
11312
  <div class="admonition note">
11248
11313
  <p class="admonition-title">Note</p>
@@ -11255,42 +11320,42 @@ Do not prompt user for any input/confirmation.</p>
11255
11320
  <p class="admonition-title">Warning</p>
11256
11321
  <p>Depending on the number of records in your database, this may take a long time to run.</p>
11257
11322
  </div>
11258
- <div class="highlight"><pre><span></span><code><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a>nautobot-server validate_models
11323
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-50-1" name="__codelineno-50-1" href="#__codelineno-50-1"></a>nautobot-server validate_models
11259
11324
  </code></pre></div>
11260
11325
  <p>Example output:</p>
11261
- <div class="highlight"><pre><span></span><code><a id="__codelineno-47-1" name="__codelineno-47-1" href="#__codelineno-47-1"></a>Validating 171 models.
11262
- <a id="__codelineno-47-2" name="__codelineno-47-2" href="#__codelineno-47-2"></a>auth.Permission
11263
- <a id="__codelineno-47-3" name="__codelineno-47-3" href="#__codelineno-47-3"></a>circuits.ProviderNetwork
11264
- <a id="__codelineno-47-4" name="__codelineno-47-4" href="#__codelineno-47-4"></a>circuits.Provider
11265
- <a id="__codelineno-47-5" name="__codelineno-47-5" href="#__codelineno-47-5"></a>circuits.CircuitType
11266
- <a id="__codelineno-47-6" name="__codelineno-47-6" href="#__codelineno-47-6"></a>circuits.Circuit
11267
- <a id="__codelineno-47-7" name="__codelineno-47-7" href="#__codelineno-47-7"></a>circuits.CircuitTermination
11268
- <a id="__codelineno-47-8" name="__codelineno-47-8" href="#__codelineno-47-8"></a>dcim.Interface
11269
- <a id="__codelineno-47-9" name="__codelineno-47-9" href="#__codelineno-47-9"></a>dcim.Manufacturer
11270
- <a id="__codelineno-47-10" name="__codelineno-47-10" href="#__codelineno-47-10"></a>dcim.DeviceFamily
11271
- <a id="__codelineno-47-11" name="__codelineno-47-11" href="#__codelineno-47-11"></a>dcim.DeviceTypeToSoftwareImageFile
11272
- <a id="__codelineno-47-12" name="__codelineno-47-12" href="#__codelineno-47-12"></a>dcim.DeviceType
11273
- <a id="__codelineno-47-13" name="__codelineno-47-13" href="#__codelineno-47-13"></a>dcim.Platform
11274
- <a id="__codelineno-47-14" name="__codelineno-47-14" href="#__codelineno-47-14"></a>&lt;omitted for brevity&gt;
11326
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-51-1" name="__codelineno-51-1" href="#__codelineno-51-1"></a>Validating 171 models.
11327
+ <a id="__codelineno-51-2" name="__codelineno-51-2" href="#__codelineno-51-2"></a>auth.Permission
11328
+ <a id="__codelineno-51-3" name="__codelineno-51-3" href="#__codelineno-51-3"></a>circuits.ProviderNetwork
11329
+ <a id="__codelineno-51-4" name="__codelineno-51-4" href="#__codelineno-51-4"></a>circuits.Provider
11330
+ <a id="__codelineno-51-5" name="__codelineno-51-5" href="#__codelineno-51-5"></a>circuits.CircuitType
11331
+ <a id="__codelineno-51-6" name="__codelineno-51-6" href="#__codelineno-51-6"></a>circuits.Circuit
11332
+ <a id="__codelineno-51-7" name="__codelineno-51-7" href="#__codelineno-51-7"></a>circuits.CircuitTermination
11333
+ <a id="__codelineno-51-8" name="__codelineno-51-8" href="#__codelineno-51-8"></a>dcim.Interface
11334
+ <a id="__codelineno-51-9" name="__codelineno-51-9" href="#__codelineno-51-9"></a>dcim.Manufacturer
11335
+ <a id="__codelineno-51-10" name="__codelineno-51-10" href="#__codelineno-51-10"></a>dcim.DeviceFamily
11336
+ <a id="__codelineno-51-11" name="__codelineno-51-11" href="#__codelineno-51-11"></a>dcim.DeviceTypeToSoftwareImageFile
11337
+ <a id="__codelineno-51-12" name="__codelineno-51-12" href="#__codelineno-51-12"></a>dcim.DeviceType
11338
+ <a id="__codelineno-51-13" name="__codelineno-51-13" href="#__codelineno-51-13"></a>dcim.Platform
11339
+ <a id="__codelineno-51-14" name="__codelineno-51-14" href="#__codelineno-51-14"></a>&lt;omitted for brevity&gt;
11275
11340
  </code></pre></div>
11276
11341
  <p>You can validate a specific subset of models by providing a space separated list of models as shown here:</p>
11277
- <div class="highlight"><pre><span></span><code><a id="__codelineno-48-1" name="__codelineno-48-1" href="#__codelineno-48-1"></a>nautobot-server validate_models dcim.Manufacturer dcim.Device
11342
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-52-1" name="__codelineno-52-1" href="#__codelineno-52-1"></a>nautobot-server validate_models dcim.Manufacturer dcim.Device
11278
11343
  </code></pre></div>
11279
- <div class="highlight"><pre><span></span><code><a id="__codelineno-49-1" name="__codelineno-49-1" href="#__codelineno-49-1"></a>Validating 2 models.
11280
- <a id="__codelineno-49-2" name="__codelineno-49-2" href="#__codelineno-49-2"></a>dcim.Manufacturer
11281
- <a id="__codelineno-49-3" name="__codelineno-49-3" href="#__codelineno-49-3"></a>dcim.Device
11344
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-53-1" name="__codelineno-53-1" href="#__codelineno-53-1"></a>Validating 2 models.
11345
+ <a id="__codelineno-53-2" name="__codelineno-53-2" href="#__codelineno-53-2"></a>dcim.Manufacturer
11346
+ <a id="__codelineno-53-3" name="__codelineno-53-3" href="#__codelineno-53-3"></a>dcim.Device
11282
11347
  </code></pre></div>
11283
11348
  <p><code>--save</code><br />
11284
11349
  Run <code>validated_save()</code> instead of <code>full_clean()</code> for slower but more thorough data validation.</p>
11285
11350
  <h3 id="version"><code>version</code><a class="headerlink" href="#version" title="Permanent link">&para;</a></h3>
11286
11351
  <p><code>nautobot-server version</code></p>
11287
11352
  <p>Report the Nautobot version and Django version, as well as the current configuration file in use.</p>
11288
- <div class="highlight"><pre><span></span><code><a id="__codelineno-50-1" name="__codelineno-50-1" href="#__codelineno-50-1"></a>nautobot-server version
11353
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-54-1" name="__codelineno-54-1" href="#__codelineno-54-1"></a>nautobot-server version
11289
11354
  </code></pre></div>
11290
11355
  <p>Example output:</p>
11291
- <div class="highlight"><pre><span></span><code><a id="__codelineno-51-1" name="__codelineno-51-1" href="#__codelineno-51-1"></a>Nautobot version: 2.2.0a1
11292
- <a id="__codelineno-51-2" name="__codelineno-51-2" href="#__codelineno-51-2"></a>Django version: 3.2.24
11293
- <a id="__codelineno-51-3" name="__codelineno-51-3" href="#__codelineno-51-3"></a>Configuration file: /opt/nautobot/nautobot_config.py
11356
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-55-1" name="__codelineno-55-1" href="#__codelineno-55-1"></a>Nautobot version: 2.2.0a1
11357
+ <a id="__codelineno-55-2" name="__codelineno-55-2" href="#__codelineno-55-2"></a>Django version: 3.2.24
11358
+ <a id="__codelineno-55-3" name="__codelineno-55-3" href="#__codelineno-55-3"></a>Configuration file: /opt/nautobot/nautobot_config.py
11294
11359
  </code></pre></div>
11295
11360
  <h3 id="webhook_receiver"><code>webhook_receiver</code><a class="headerlink" href="#webhook_receiver" title="Permanent link">&para;</a></h3>
11296
11361
  <p><code>nautobot-server webhook_receiver</code></p>
@@ -11299,10 +11364,10 @@ Run <code>validated_save()</code> instead of <code>full_clean()</code> for slowe
11299
11364
  Optional port number (default: <code>9000</code>)</p>
11300
11365
  <p><code>--no-headers</code><br />
11301
11366
  Hide HTTP request headers.</p>
11302
- <div class="highlight"><pre><span></span><code><a id="__codelineno-52-1" name="__codelineno-52-1" href="#__codelineno-52-1"></a>nautobot-server webhook_receiver --port 9001 --no-headers
11367
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-56-1" name="__codelineno-56-1" href="#__codelineno-56-1"></a>nautobot-server webhook_receiver --port 9001 --no-headers
11303
11368
  </code></pre></div>
11304
11369
  <p>Example output:</p>
11305
- <div class="highlight"><pre><span></span><code><a id="__codelineno-53-1" name="__codelineno-53-1" href="#__codelineno-53-1"></a>Listening on port http://localhost:9000. Stop with CONTROL-C.
11370
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-57-1" name="__codelineno-57-1" href="#__codelineno-57-1"></a>Listening on port http://localhost:9000. Stop with CONTROL-C.
11306
11371
  </code></pre></div>
11307
11372
  <p>Please see the guide on <a href="../../platform-functionality/webhook.html#troubleshooting-webhooks">Troubleshooting Webhooks</a> for more information.</p>
11308
11373