# System Configuration

The `nv unset` commands remove the configuration you set with the equivalent `nv set` commands. This guide only describes an `nv unset` command if it differs from the `nv set` command.

## nv set system cli pagination state

Enables or disables the CLI pager (pagination) state. The CLI pager enables you to view the contents of a large file or the output of an NVUE command one page at a time in the terminal window, using the up and down arrow keys or the space bar.

You can set the pager state to `enabled` or `disabled`. The default value is `disabled`.

### Version History

Introduced in Cumulus Linux 5.9.0

### Example

    cumulus@switch:~$ nv set system cli pagination state enabled

## nv set system cli pagination pager

Configures the CLI pager settings. You can set the pager options to `more`, `less`, or `vim`. The default value is `less`.

### Version History

Introduced in Cumulus Linux 5.9.0

### Example

    cumulus@switch:~$ nv set system cli pagination pager more

## nv set system cli inactive-timeout

Configures the CLI session timeout. The timeout reduces the window of opportunity for unauthorized user access to an unattended CLI sessions on the switch, or ends an inactive session and releases the resources associated with it. You can specify a value between 0 and 86400 minutes. The default value is 0 (disabled).

### Version History

Introduced in Cumulus Linux 5.9.0

### Example

    cumulus@switch:~$ nv set system cli inactive-timeout 300

## nv set system config

Configures system configuration settings.

## nv set system config apply

Configures how NVUE performs `config apply` operations.

## nv set system config apply ignore <ignore-id>

Configures NVUE to ignore a specific underlying Linux file when applying configuration changes. For example, if you push certain configuration to the switch using Ansible and Jinja2 file templates or you want to use custom configuration for a particular service such as PTP, you can ensure that NVUE never writes to those configuration files.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set system config apply ignore /etc/ptp4l.conf

## nv set system config apply overwrite

Configures which files NVUE overwrites during `nv config apply`. You can specify:

- `all` to overwrite all files. If you modified a file locally, you see a warning when you try to apply the configuration and you can stop the apply before NVUE overwrites the local modification. This is the default setting.
- `controlled` overwrites only the files that NVUE most recently changed. If you changed a file locally, you see a warning but NVUE does not overwrite the file.

### Version History

Introduced in Cumulus Linux 5.4.0

### Example

    cumulus@switch:~$ nv set system config apply overwrite controlled

## nv set system config auto-save state

Enables and disables auto save. The auto save option lets you save the pending configuration to the startup configuration file automatically when you run `nv config apply` so that you do not have to run the `nv config save` command.

- In Cumulus Linux 5.9 and later, auto save is `on` by default.
- In Cumulus Linux 5.8 and earlier, auto save is `off` by default.
- In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Version History

Introduced in Cumulus Linux 5.4.0

### Example

    cumulus@switch:~$ nv set system config auto-save state enabled

## nv set system control-plane policer <policer-id> burst

Configures the Committed Burst Rate (CBR) for the trap group. The burst rate is the number of packets or kilobytes (KB) allowed to arrive sequentially after the CIR rate is exceeded. You can specify a value between 10 and 10000.

### Command Syntax

Syntax | Description
--- | ---
`<policer-id>` | The policer ID.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system control-plane policer bgp burst 1000

## nv set system control-plane policer <policer-id> rate

Configures the Committed Information Rate (CIR), which is the allowed incoming rate for the trap group. The incoming rate is the maximum rate in packets per second. You can specify a value between 10 and 50000.

### Command Syntax

Syntax | Description
--- | ---
`<policer-id>` | The trap group. You can specify: `arp`, `bfd`, `pim-ospf-rip`, `bgp`, `clag`, `icmp-def`, `dhcp-ptp`, `igmp`, `ssh`, `icmp6-neigh`, `icmp6-def-mld`, `lacp`, `lldp`, `rpvst`, `eapol`, `ip2me`, `acl-log`, `nat`, `stp`, `l3-local`, `span-cpu`, `catch-all`, or `NONE`.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system control-plane policer acl-log rate 5000

## nv set system control-plane policer <policer-id> state

Enables and disables the specified control plane policer.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<policer-id>` | The trap group. You can specify: `arp`, `bfd`, `pim-ospf-rip`, `bgp`, `clag`, `icmp-def`, `dhcp-ptp`, `igmp`, `ssh`, `icmp6-neigh`, `icmp6-def-mld`, `lacp`, `lldp`, `rpvst`, `eapol`, `ip2me`, `acl-log`, `nat`, `stp`, `l3-local`, `span-cpu`, `catch-all`, or `NONE`.

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system control-plane policer acl-log state enabled

## nv set system control-plane trap <trap-id>

Configures control plane traps.

## nv set system control-plane trap <trap-id> state

Enables and disables the specified control plane trap.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<trap-id>` | The trap ID.

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system control-plane trap l3-mtu-err state enabled

## nv set system counter rates load-interval

Configures the interface rates calculation interval, in seconds. You can specify a value between 1 and 600. The default value is 60.

### Version History

Introduced in Cumulus Linux 5.12.0

### Example

    cumulus@switch:~$ nv set system counter rates load-interval 100

## nv set system counter polling-interval logical-interface

Configures the system counter polling interval in seconds for logical interfaces. You can set a value between 1 and 30.

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system counter polling-interval logical-interface 20

## nv set system counter polling-interval physical-interface

Configures the system counter polling interval in seconds for physical interfaces. You can set a value between 1 and 10.

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system counter polling-interval physical-interface 5

## nv set system global anycast-id

Configures the global system anycast ID for VXLAN active-active mode. Cumulus Linux derives the MAC address from the ID. You can specify a number between 1 and 65535. Cumulus Linux adds the number to the MAC address 44:38:39:ff:00:00 in hex. For example, if you specify 225, the anycast MAC address is 44:38:39:ff:00:FF.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system global anycast-id 255

## nv set system global anycast-mac

Configures the global anycast MAC address for VXLAN active-active mode. You can set the anycast MAC address to a value in the reserved range between 44:38:39:ff:00:00 and 44:38:39:ff:ff:ff. Be sure to use an address in this reserved range to prevent MAC address conflicts with other interfaces in the same bridged network.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system global anycast-mac 44:38:39:ff:00:ff

## nv set system global fabric-id

Configures the fabric ID from which Cumulus Linux derives the MAC address. You can specify a number between 1 and 225. Cumulus Linux adds the number to the MAC address 00:00:5E:00:01:00 in hex. For example, if you specify 225, the VRR MAC address is 00:00:5E:00:01:FF.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set system global fabric-id 255

## nv set system global fabric-mac

Configures the VRR MAC address globally on the switch. The default fabric MAC address is 00:00:5E:00:01:01, which the switch derives from a fabric ID setting of 1.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set system global fabric-mac 00:00:5E:00:01:FF

## nv set system global reserved

Configures reserved system settings, such as the reserved routing table ranges and reserved VLAN ranges.

## nv set system global reserved routing-table

Configures the reserved routing table ranges.

## nv set system global reserved routing-table pbr

Configures the PBR reserved routing table ranges.

## nv set system global reserved routing-table pbr begin

Configures the PBR reserved routing table start range. You can set a value between 10000 and 4294966272.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system global reserved routing-table pbr begin 10000

## nv set system global reserved routing-table pbr end

Configures the PBR reserved routing table end range. You can set a value between 10000 and 4294966272.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system global reserved routing-table pbr end 4294966272

## nv set system global reserved vlan

Configures the reserved VLAN range.

## nv set system global reserved vlan internal

Configures the internal reserved VLAN range.

## nv set system global reserved vlan internal range

Configures the reserved VLAN range. You can set a value between 4064 and 4094.

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system global reserved vlan internal range 4064-4094

## nv set system global reserved vlan l3-vni-vlan

Configures the reserved VLANs to use with layer 3 VNIs.

## nv set system global reserved vlan l3-vni-vlan begin

Configures the reserved VLAN start range to use with layer 3 VNIs. You can set a value between 1 and 4093.

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system global reserved vlan l3-vni-vlan begin 1

## nv set system global reserved vlan l3-vni-vlan end

Configures the reserved VLAN end range to use with layer 3 VNIs. You can set a value between 2 and 4093.

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system global reserved vlan l3-vni-vlan begin 4093

## nv set system global system-mac

Configures the global system MAC address.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system global system-mac 44:38:39:ff:00:ff

## nv set system hostname

Configures the hostname of the switch.

### Version History

Introduced in Cumulus Linux 5.0.0

### Example

    cumulus@switch:~$ nv set system hostname leaf01

## nv set system message

Configures the message you want users of the switch to see before and after they log in.

## nv set system message post-login

Configures the message you want users to see after they log into the switch. If the message contains more than one word, you must enclose it in quotes (").

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system message post-login "This switch is being used for testing"

## nv set system message pre-login

Configures the message you want users to see before they log in to the switch. If the message contains more than one word, you must enclose it in quotes (").

### Version History

Introduced in Cumulus Linux 5.3.0

### Example

    cumulus@switch:~$ nv set system message pre-login "This switch is under maintenance"

## nv set system reboot mode

Configures the restart mode for the switch. You can restart the switch in one of the following modes.

- `cold` restarts the system and resets all the hardware devices on the switch (including the switching ASIC).
- `fast` restarts the system more efficiently with minimal impact to traffic by reloading the kernel and software stack without a hard reset of the hardware. During a fast restart, the system decouples from the network to the extent possible using existing protocol extensions before recovering to the operational mode of the system. The restart process maintains the forwarding entries of the switching ASIC and the data plane is not affected. Traffic outage is much lower in this mode as there is a momentary interruption after reboot, after switchd restarts.
- `warm` restarts the system with minimal impact to traffic and without affecting the data plane. Warm mode diverts traffic from itself and restarts the system without a hardware reset of the switch ASIC. While this process does not affect the data plane, the control plane is absent during restart and is unable to process routing updates. However, if no alternate paths exist, the switch continues forwarding with the existing entries with no interruptions.

- Cumulus Linux 5.15 no longer supports this command.
- Cumulus Linux 5.7 and earlier supports fast mode for all protocols and warm boot for layer 2 forwarding, and layer 3 forwarding with BGP and static routing.
- Cumulus Linux 5.8 supports fast mode for all protocols and warm mode for 802.1X, layer 2 forwarding, layer 3 forwarding with BGP, and static routing. Warm mode for VXLAN routing with EVPN is available for beta and open to customer feedback. Cumulus Linux does not support warm boot with EVPN MLAG or EVPN multihoming.

### Version History

Introduced in Cumulus Linux 5.5.0

### Example

    cumulus@switch:~$ nv set system reboot mode fast

## nv set system serial-console sysrq-capabilities

Enables and disables serial console SysRq key capabilities. You can specify `enabled` or `disabled`. The default value is `disabled`.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system serial-console sysrq-capabilities enabled

## nv set system date-time timezone

Configures the switch time zone.

To see all the available time zones, run `nv set system date-time timezone` and press the Tab key.

In Cumulus Linux 5.14 and earlier, this command is `nv show system timezone`.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv set system date-time timezone US/Eastern