2023-05-12 16:21:22 -04:00
# NetBox v3.6
2023-09-06 14:26:19 -04:00
## v3.6.2 (FUTURE)
2023-09-18 08:49:08 -04:00
### Enhancements
* [#13563 ](https://github.com/netbox-community/netbox/issues/13563 ) - Add support for other delimiting characters when using CSV import
2023-09-11 13:52:19 -04:00
### Bug Fixes
2023-09-18 08:49:08 -04:00
* [#11209 ](https://github.com/netbox-community/netbox/issues/11209 ) - Hide available IP/VLAN listing when sorting under a parent prefix or VLAN range
* [#12219 ](https://github.com/netbox-community/netbox/issues/12219 ) - Fix dashboard widget heading contrast under dark mode
2023-09-11 14:16:29 -04:00
* [#13701 ](https://github.com/netbox-community/netbox/issues/13701 ) - Correct display of power feed legs under device view
2023-09-11 14:13:55 -04:00
* [#13706 ](https://github.com/netbox-community/netbox/issues/13706 ) - Restore extra filters dropdown on device interfaces list
2023-09-11 13:52:19 -04:00
* [#13721 ](https://github.com/netbox-community/netbox/issues/13721 ) - Filter VLAN choices by selected site (if any) when creating a prefix
2023-09-18 08:49:08 -04:00
* [#13727 ](https://github.com/netbox-community/netbox/issues/13727 ) - Fix exception when viewing rendered config for VM without a role assigned
2023-09-18 11:12:27 -04:00
* [#13741 ](https://github.com/netbox-community/netbox/issues/13741 ) - Enforce unique names for inventory items with no parent item
* [#13745 ](https://github.com/netbox-community/netbox/issues/13745 ) - Optimize counter field migrations for large databases
* [#13756 ](https://github.com/netbox-community/netbox/issues/13756 ) - Fix exception when sorting module bay list by installed module status
2023-09-18 08:49:08 -04:00
* [#13767 ](https://github.com/netbox-community/netbox/issues/13767 ) - Fix support for comments when creating a new service via web UI
2023-09-18 11:12:27 -04:00
* [#13782 ](https://github.com/netbox-community/netbox/issues/13782 ) - Fix tag exclusion support for contact assignments
2023-09-18 08:49:08 -04:00
* [#13791 ](https://github.com/netbox-community/netbox/issues/13791 ) - Preserve whitespace in values when performing bulk rename of objects via web UI
2023-09-11 13:52:19 -04:00
2023-09-06 14:26:19 -04:00
---
2023-09-06 14:04:57 -04:00
## v3.6.1 (2023-09-06)
2023-08-30 14:57:16 -04:00
2023-08-31 12:23:59 -04:00
### Enhancements
2023-09-01 17:14:59 -04:00
* [#12870 ](https://github.com/netbox-community/netbox/issues/12870 ) - Support setting token expiration time using the provisioning API endpoint
* [#13444 ](https://github.com/netbox-community/netbox/issues/13444 ) - Add bulk rename functionality to the global device component lists
2023-08-31 12:23:59 -04:00
* [#13638 ](https://github.com/netbox-community/netbox/issues/13638 ) - Add optional `staff_only` attribute to MenuItem
2023-08-31 08:14:57 -04:00
### Bug Fixes
2023-09-06 14:04:57 -04:00
* [#12553 ](https://github.com/netbox-community/netbox/issues/12552 ) - Ensure `family` attribute is always returned when creating aggregates and prefixes via REST API
2023-08-31 12:23:59 -04:00
* [#13619 ](https://github.com/netbox-community/netbox/issues/13619 ) - Fix exception when viewing IP address assigned to a virtual machine
2023-09-01 17:14:59 -04:00
* [#13596 ](https://github.com/netbox-community/netbox/issues/13596 ) - Always display "render config" tab for devices and virtual machines
2023-08-31 12:23:59 -04:00
* [#13620 ](https://github.com/netbox-community/netbox/issues/13620 ) - Show admin menu items only for staff users
* [#13622 ](https://github.com/netbox-community/netbox/issues/13622 ) - Fix exception when viewing current config and no revisions have been created
2023-08-31 08:19:17 -04:00
* [#13626 ](https://github.com/netbox-community/netbox/issues/13626 ) - Correct filtering of recent activity list under user view
2023-08-31 12:23:59 -04:00
* [#13628 ](https://github.com/netbox-community/netbox/issues/13628 ) - Remove stale references to obsolete NAPALM integration
2023-08-31 08:14:57 -04:00
* [#13630 ](https://github.com/netbox-community/netbox/issues/13630 ) - Fix display of active status under user view
2023-08-31 12:23:59 -04:00
* [#13632 ](https://github.com/netbox-community/netbox/issues/13632 ) - Avoid raising exception when checking if FHRP group IP address is primary
2023-09-01 17:14:59 -04:00
* [#13642 ](https://github.com/netbox-community/netbox/issues/13642 ) - Suppress warning about unreflected model changes when applying migrations
* [#13657 ](https://github.com/netbox-community/netbox/issues/13657 ) - Fix decoding of data file content
2023-09-06 14:04:57 -04:00
* [#13674 ](https://github.com/netbox-community/netbox/issues/13674 ) - Fix retrieving individual report via REST API
* [#13682 ](https://github.com/netbox-community/netbox/issues/13682 ) - Fix error message returned when validation of custom field default value fails
2023-09-18 08:49:08 -04:00
* [#13684 ](https://github.com/netbox-community/netbox/issues/13684 ) - Enable modifying the configuration when maintenance mode is enabled
2023-08-31 08:14:57 -04:00
2023-08-30 14:57:16 -04:00
---
2023-08-30 14:27:07 -04:00
## v3.6.0 (2023-08-30)
2023-05-12 16:21:22 -04:00
2023-05-16 09:35:27 -04:00
### Breaking Changes
2023-08-02 13:30:08 -04:00
* PostgreSQL 11 is no longer supported (dropped in Django 4.2). NetBox v3.6 requires PostgreSQL 12 or later.
2023-09-01 13:22:07 -04:00
* The `boto3` and `dulwich` packages are no longer installed automatically. If needed for S3/git remote data backend support, add them to `local_requirements.txt` to ensure their installation.
2023-08-02 11:18:52 -04:00
* The `device_role` field on the Device model has been renamed to `role` . The `device_role` field has been temporarily retained on the REST API serializer for devices for backward compatibility, but is read-only.
* The `choices` array field has been removed from the CustomField model. Any defined choices are automatically migrated to CustomFieldChoiceSets, accessible via the new `choice_set` field on the CustomField model.
* The `napalm_driver` and `napalm_args` fields (which were deprecated in v3.5) have been removed from the Platform model.
2023-08-30 08:33:02 -05:00
* The `device` and `device_id` filter for interfaces will no longer include interfaces from virtual chassis peers. Two new filters, `virtual_chassis_member` and `virtual_chassis_member_id` , have been introduced to match all interfaces belonging to the specified device's virtual chassis (if any).
2023-08-09 15:38:03 -04:00
* Reports and scripts are now returned within a `results` list when fetched via the REST API, consistent with other models.
2023-08-16 10:28:33 -04:00
* Superusers can no longer retrieve API token keys via the web UI if [`ALLOW_TOKEN_RETRIEVAL` ](https://docs.netbox.dev/en/stable/configuration/security/#allow_token_retrieval ) is disabled. (The admin view has been removed per [#13044 ](https://github.com/netbox-community/netbox/issues/13044 ).)
2023-05-16 09:35:27 -04:00
2023-07-25 16:48:41 -04:00
### New Features
2023-08-30 14:27:07 -04:00
#### Relocated Admin UI Views ([#12589](https://github.com/netbox-community/netbox/issues/12589), [#12590](https://github.com/netbox-community/netbox/issues/12590), [#12591](https://github.com/netbox-community/netbox/issues/12591), [#13044](https://github.com/netbox-community/netbox/issues/13044))
2023-07-25 16:48:41 -04:00
Management views for the following object types, previously available only under the backend admin interface, have been relocated to the primary user interface:
* Users
* Groups
* Object permissions
* API tokens
* Configuration revisions
2023-08-02 13:30:08 -04:00
This migration provides a more consistent user experience and unlocks advanced functionality not feasible using Django's built-in views. The admin UI is scheduled for complete removal in NetBox v4.0.
2023-07-25 16:48:41 -04:00
2023-07-31 08:35:28 -04:00
#### Configurable Default Permissions ([#13038](https://github.com/netbox-community/netbox/issues/13038))
2023-08-02 13:30:08 -04:00
Administrators now have the option of configuring default permissions for _all_ users globally, regardless of explicit permission or group assignments granted in the database. This is accomplished by defining the `DEFAULT_PERMISSIONS` configuration parameter. By default, all users are granted permission to manage their own bookmarks and API tokens.
2023-07-31 08:35:28 -04:00
2023-07-25 16:48:41 -04:00
#### User Bookmarks ([#8248](https://github.com/netbox-community/netbox/issues/8248))
2023-08-02 13:30:08 -04:00
Users can now bookmark their favorite objects in NetBox. Bookmarks are accessible under each user's personal bookmarks list, and can also be added as a dashboard widget.
2023-07-25 16:48:41 -04:00
#### Custom Field Choice Sets ([#12988](https://github.com/netbox-community/netbox/issues/12988))
2023-08-02 13:30:08 -04:00
Selection and multi-select custom fields now employ discrete, reusable choice sets containing the valid options for each field. A choice set may be shared by multiple custom fields. Additionally, each choice within a set can now specify both a raw value and a human-friendly label (see [#13241 ](https://github.com/netbox-community/netbox/issues/13241 )). Pre-existing custom field choices are migrated to choice sets automatically during the upgrade process.
2023-07-31 08:35:28 -04:00
#### Pre-Defined Location Choices for Custom Fields ([#12194](https://github.com/netbox-community/netbox/issues/12194))
2023-08-02 13:30:08 -04:00
Users now have the option to employ one of several pre-defined sets of choices when creating a custom field. These include:
2023-07-31 08:35:28 -04:00
* IATA airport codes
* ISO 3166 country codes
2023-08-02 13:30:08 -04:00
* UN/LOCODE location identifiers
2023-07-31 08:35:28 -04:00
2023-08-02 13:30:08 -04:00
When defining a choice set, one of the above can be employed as the base set, with the option to define extra, custom choices as well.
2023-07-25 16:48:41 -04:00
#### Restrict Tag Usage by Object Type ([#11541](https://github.com/netbox-community/netbox/issues/11541))
Tags may now be restricted to use with designated object types. Tags that have no specific object types assigned may be used with any object that supports tag assignment.
2023-06-22 10:55:12 -04:00
### Enhancements
2023-07-25 16:48:41 -04:00
* [#6347 ](https://github.com/netbox-community/netbox/issues/6347 ) - Cache the number of assigned components for devices and virtual machines
* [#8137 ](https://github.com/netbox-community/netbox/issues/8137 ) - Add a field for designating the out-of-band (OOB) IP address for devices
* [#10197 ](https://github.com/netbox-community/netbox/issues/10197 ) - Cache the number of member devices on each virtual chassis
2023-06-22 10:55:12 -04:00
* [#11305 ](https://github.com/netbox-community/netbox/issues/11305 ) - Add GPS coordinate fields to the device model
2023-08-30 09:36:44 -04:00
* [#11478 ](https://github.com/netbox-community/netbox/issues/11478 ) - Introduce `virtual_chassis_member` filter for interfaces & restore default behavior for `device` filter
2023-08-02 11:18:52 -04:00
* [#11519 ](https://github.com/netbox-community/netbox/issues/11519 ) - Add a SQL index for IP address host values to optimize queries
2023-08-01 14:13:48 -04:00
* [#11732 ](https://github.com/netbox-community/netbox/issues/11732 ) - Prevent inadvertent overwriting of object attributes by competing users
* [#11936 ](https://github.com/netbox-community/netbox/issues/11936 ) - Introduce support for tags and custom fields on webhooks
2023-06-22 10:55:12 -04:00
* [#12175 ](https://github.com/netbox-community/netbox/issues/12175 ) - Permit racks to start numbering at values greater than one
2023-07-31 08:35:28 -04:00
* [#12210 ](https://github.com/netbox-community/netbox/issues/12210 ) - Add tenancy assignment for power feeds
2023-08-15 11:25:56 -04:00
* [#12461 ](https://github.com/netbox-community/netbox/issues/12461 ) - Add config template rendering for virtual machines
2023-08-09 15:38:03 -04:00
* [#12814 ](https://github.com/netbox-community/netbox/issues/12814 ) - Expose NetBox models within ConfigTemplate rendering context
2023-08-01 14:13:48 -04:00
* [#12882 ](https://github.com/netbox-community/netbox/issues/12882 ) - Add tag support for contact assignments
2023-08-09 15:38:03 -04:00
* [#13037 ](https://github.com/netbox-community/netbox/issues/13037 ) - Return reports & scripts within a `results` list when fetched via the REST API
2023-07-31 08:35:28 -04:00
* [#13170 ](https://github.com/netbox-community/netbox/issues/13170 ) - Add `rf_role` to InterfaceTemplate
2023-07-25 16:48:41 -04:00
* [#13269 ](https://github.com/netbox-community/netbox/issues/13269 ) - Cache the number of assigned component templates for device types
2023-06-22 10:55:12 -04:00
2023-08-30 14:27:07 -04:00
### Bug Fixes
* [#13513 ](https://github.com/netbox-community/netbox/issues/13513 ) - Prevent exception when rendering bookmarks widget for anonymous user
* [#13599 ](https://github.com/netbox-community/netbox/issues/13599 ) - Fix errant counter increments when editing device/VM components
* [#13605 ](https://github.com/netbox-community/netbox/issues/13605 ) - Optimize cached counter migrations to avoid excessive memory consumption
2023-05-12 16:21:22 -04:00
### Other Changes
2023-07-31 08:35:28 -04:00
* Work has begun on introducing translation and localization support in NetBox. This work is being performed in preparation for release 4.0.
2023-08-02 11:18:52 -04:00
* [#6391 ](https://github.com/netbox-community/netbox/issues/6391 ) - Rename the `device_role` field on Device to `role` for consistency with VirtualMachine
2023-06-22 10:55:12 -04:00
* [#9077 ](https://github.com/netbox-community/netbox/issues/9077 ) - Prevent the errant execution of dangerous instance methods in Django templates
2023-05-12 16:21:22 -04:00
* [#11766 ](https://github.com/netbox-community/netbox/issues/11766 ) - Remove obsolete custom `ChoiceField` and `MultipleChoiceField` classes
2023-06-22 10:55:12 -04:00
* [#12180 ](https://github.com/netbox-community/netbox/issues/12180 ) - All API endpoints for available objects (e.g. IP addresses) now inherit from a common parent view
2023-07-25 16:48:41 -04:00
* [#12237 ](https://github.com/netbox-community/netbox/issues/12237 ) - Upgrade Django to v4.2
2023-05-16 09:35:27 -04:00
* [#12320 ](https://github.com/netbox-community/netbox/issues/12320 ) - Remove obsolete fields `napalm_driver` and `napalm_args` from Platform
2023-09-01 13:22:07 -04:00
* [#12794 ](https://github.com/netbox-community/netbox/issues/12794 ) - Avoid direct imports of Django's stock user model
* [#12906 ](https://github.com/netbox-community/netbox/issues/12906 ) - The `boto3` (AWS) and `dulwich` (git) packages for remote data sources are now optional requirements
2023-07-25 16:48:41 -04:00
* [#12964 ](https://github.com/netbox-community/netbox/issues/12964 ) - Drop support for PostgreSQL 11
2023-08-01 14:13:48 -04:00
* [#13309 ](https://github.com/netbox-community/netbox/issues/13309 ) - User account-specific resources have been moved to a new `account` app for better organization
2023-08-02 11:18:52 -04:00
### REST API Changes
* Introduced the following endpoints:
* `/api/extras/bookmarks/`
* `/api/extras/custom-field-choice-sets/`
* Added the `/api/extras/custom-fields/{id}/choices/` endpoint for select and multi-select custom fields
* dcim.Device
* Renamed `device_role` to `device` . Added a read-only `device_role` field for limited backward compatibility.
* Added the `latitude` and `longitude` fields (for GPS coordinates)
* Added the `oob_ip` field for out-of-band IP address assignment
* dcim.DeviceType
* Added read-only counter fields for assigned component templates:
* `console_port_template_count`
* `console_server_port_template_count`
* `power_port_template_count`
* `power_outlet_template_count`
* `interface_template_count`
* `front_port_template_count`
* `rear_port_template_count`
* `device_bay_template_count`
* `module_bay_template_count`
* `inventory_item_template_count`
* dcim.InterfaceTemplate
* Added the `rf_role` field
* dcim.Platform
* Removed the `napalm_driver` and `napalm_args` fields
* dcim.PowerFeed
* Added the `tenant` field
* dcim.Rack
* Added the `starting_unit` field
* dcim.VirtualChassis
* Added the read-only `member_count` field
* extras.CustomField
* Removed the `choices` array field
* Added the `choice_set` foreign key field (to ChoiceSet)
2023-08-09 15:38:03 -04:00
* extras.Report
* Reports are now returned within a `results` list
* extras.Script
* Scripts are now returned within a `results` list
2023-08-02 11:18:52 -04:00
* extras.Tag
* Added the `object_types` field for optional restriction to specific object types
* extras.Webhook
* Added `custom_fields` and `tags` support
* tenancy.ContactAssignment
* Added `tags` support
* virtualization.VirtualMachine
* Added the `oob_ip` field for out-of-band IP address assignment
