Bug ID 1016621: VLAN name validation changes

Last Modified: May 29, 2024

Affected Product(s):
F5OS Install/Upgrade, Velos(all modules)

Known Affected Versions:
F5OS-C 1.1.2, F5OS-C 1.1.3, F5OS-C 1.1.4

Fixed In:
F5OS-A 1.0.0

Opened: May 06, 2021

Severity: 3-Major

Related Article: K64400840

Symptoms

Previously, the /vlans/vlan/config/name was a free-format string. Now, the name has the following constraints: -- May start with just a letter -- Cannot exceed 56 characters in length -- May contain alpha characters, numbers from 0 through 9, period (.), hyphen (-), and underscore (_) -- Must be unique among VLAN names

Impact

Previous configuration with /vlans/vlan/config/name strings that do not meet the new validation rules will not load. Previous configuration scripts with /vlans/vlan/config/name strings that do not meet the new validation rules will fail.

Conditions

When you configure /vlans/vlan/config/name leaf, which is an optional leaf.

Workaround

Before upgrading (ideally) or after upgrading and before saving the configuration or exercising scripts, adjust all /vlans/vlan/config/names so they meet the validation requirements.

Fix Information

Additional validations were added to VLAN names. You must adjust existing configuration's /vlans/vlan/config/name strings and scripts to meet the new validation rules.

Behavior Change

Previously, the /vlans/vlan/config/name was a free-format string. Now, the name has the following constraints: -- May start with just a letter -- Cannot exceed 56 characters in length -- May contain alpha characters, numbers from 0 through 9, period (.), hyphen (-), and underscore (_) -- Must be unique among VLAN names

Guides & references

K10134038: F5 Bug Tracker Filter Names and Tips