This documentation is for an older version of the software. If you are using the current version of Cumulus Linux, this content may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Cumulus Linux Quagga Commands

Using the vtysh modal CLI is the primary way to configure Quagga in Cumulus Linux. However, an alternative exists in the form of a non-modal CLI containing a suite of Cumulus Linux-specific commands, structured similar to the Linux ip command. The available commands are as follows:

Command

Description

cl-bgp

BGP commands. See man cl-bgp for details.

cl-ospf

OSPFv2 commands. For example:
cumulus@switch:~$ sudo cl-ospf area 0.0.0.1 range 10.10.10.0/24

cl-ospf6

OSPFv3 commands.

cl-ra

Route advertisement commands. See man cl-ra for details.

cl-rctl

Zebra and non-routing protocol-specific commands. See man cl-rctl for details.

Comparing vtysh and Cumulus Linux Commands

This section describes how you can use the various Cumulus Linux CLI commands to configure Quagga, without using vtysh.

Displaying the Routing Table

To display the routing table under Quagga, you would run:

switch# show ip route

To display the routing table with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-rctl route

Creating a New Neighbor

To create a new neighbor under Quagga, you would run:

switch(config)# router bgp 65002
switch(config-router)# neighbor 14.0.0.22 remote-as 65007

To create a new neighbor with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-bgp as 65002 neighbor add 14.0.0.22 remote-as 65007

Redistributing Routing Information

To redistribute routing information from static route entries into RIP tables under Quagga, you would run:

switch(config)# router bgp 65002
switch(config-router)# redistribute static

To redistribute routing information from static route entries into RIP tables with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-bgp as 65002 redistribute add static

Defining a Static Route

If you intend to use static routes, you only need to enable the zebra daemon.

To define a static route under Quagga, you would run:

switch(config)# ip route 155.1.2.20/24 br2 45

To define a static route with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-rctl ip route add 175.0.0.0/28 interface br1 distance 25

Configuring an IPv6 Interface

To configure an IPv6 address under Quagga, you would run:

switch(config)# int br3
switch(config-if)# ipv6 address  3002:2123:1234:1abc::21/64

To configure an IPv6 address with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-rctl interface add swp3 ipv6 address 3002:2123:abcd:2120::41/64

Enabling PTM

To enable topology checking (PTM) under Quagga, you would run:

switch(config)# ptm-enable

To enable topology checking (PTM) with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-rctl ptm-enable set

Configuring MTU in IPv6 Network Discovery

To configure MTU in IPv6 network discovery for an interface under Quagga, you would run:

switch(config)# int swp3
switch(config-if)# ipv6 nd mtu 9000

To configure MTU in IPv6 network discovery for an interface with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-ra interface swp3 set mtu 9000

Logging OSPF Adjacency Changes

To log adjacency of OSPF changes under Quagga, you would run:

switch(config)# router ospf
switch(config-router)# router-id 2.0.0.21
switch(config-router)# log-adjacency-changes

To log adjacency changes of OSPF with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-ospf log-adjacency-changes set
cumulus@switch:~$ sudo cl-ospf router-id set 3.0.0.21

Setting OSPF Interface Priority

To set the OSPF interface priority under Quagga, you would run:

switch(config)# int swp3
switch(config-if)# ip ospf priority  120

To set the OSPF interface priority with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-ospf interface set swp3 priority 120

Configuring Timing for OSPF SPF Calculations

To configure timing for OSPF SPF calculations under Quagga, you would run:

switch(config)# router ospf6
switch(config-ospf6)# timer throttle spf 40 50 60

To configure timing for OSPF SPF calculations with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-ospf6 timer add throttle spf 40 50 60

Configuring Hello Packet Intervals

To configure the OSPF Hello packet interval in number of seconds for an interface under Quagga, you would run:

switch(config)# int swp4
switch(config-if)# ipv6 ospf6 hello-interval  60

To configure the OSPF Hello packet interval in number of seconds for an interface with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-ospf6 interface set swp4 hello-interval 60

Displaying OSPF Debugging Status

To display OSPF debugging status under Quagga, you would run:

switch# show debugging ospf

To display OSPF debugging status with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-ospf debug show

Displaying BGP Information

To display BGP information under Quagga, you would run:

switch# show ip bgp summary

To display BGP information with the Cumulus Linux CLI, run:

cumulus@switch:~$ sudo cl-bgp summary