Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added a section on trying basic commands and reorganized the info on the page

After you have configured the Cumulus VX instances, use the wider Cumulus Linux documentation suite to configure and test features, and fine tune the network topology. This section provides some additional configuration options specific to Cumulus VX , and additional and shows some basic commands you can try to get started with Cumulus Linux. Additional resources for further reading and more advanced configuration are also provided.

Contents

Table of Contents
maxLevel3
excludeContents
title(Click to expand)

...

Perform Additional Configuration

To provide easier access in video-focused hypervisors (such as VirtualBox), Cumulus VX is configured by default to redirect the grub menu and the kernel output to the video console by default. This section provides Follow the steps required below to send both the grub menu and the kernel output back to the serial console, either before or after you log into the VM.

Before Logging into the VM

If the VM has not been booted, follow the steps below to enable the serial console:

  1. Interrupt the boot process at the GRUB prompt.

  2. Modify the Linux command line directly, removing all references to the console entries:

    Original Version:

    Configured Version:

    Note
    The example images above are for the ONIE-RESCUE entry, not the standard boot entry. The configuration process is the same for both entries.
  3. Start the VM.

After Logging into the VM

To enable the serial console from a running VM 

If the VM is already running:

  1. Run the following commands as the sudo user:

    Code Block
    cumulus@switch:~$ sed -i 's/^#//' /etc/default/grub.d/00-installer-defaults.cfg
    cumulus@switch:~$ sed -r -i '/^GRUB_CMDLINE_LINUX=/ s/(console=ttyS0,115200n8) (console=tty0)/\2 \1/' /etc/default/grub
    cumulus@switch:~$ update-grub 
  2. Restart the VM to implement the change.

Try Basic Commands

After you have configured the Cumulus VX instances and performed additional configuration, use the wider Cumulus Linux documentation suite to help you configure and test features, and fine tune the network topology.

This section provides some basic commands to get you started. You can run the commands on each VM to see system information, as well as interface and LLDP details and to change the hostname of a switch.

To get information about the switch itself, run the net show system command:

Code Block
languagetext
cumulus@switch:~$ net show system
Cumulus VX
Cumulus Linux 3.5.0
Build: Cumulus Linux 3.5.0
Uptime: 4:29:09.270000

 

To show every available interface that is physically UP, run the net show interface command:

Code Block
languagetext
cumulus@switch:~$ net show interface
       Name    Master    Speed    MTU    Mode           Remote Host       Remote Port    Summary
-----  ------  --------  -------  -----  -------------  ----------------  -------------  -------------------------------------
UP     lo                N/A      65536  Loopback                                        IP: 127.0.0.1/8, 10.2.1.1/32, ::1/128
UP     eth0              1G       1500   Mgmt                                            IP: 10.0.2.15/24(DHCP)
UP     swp1              1G       1500   Interface/L3   CumulusVX-spine1  swp1           IP: 10.2.1.1/32
UP     swp2              1G       1500   Interface/L3   CumulusVX-spine2  swp1           IP: 10.2.1.1/32
UP     swp3              1G       1500   Interface/L3                                    IP: 10.4.1.1/24
ADMDN  swp4              N/A      1500   NotConfigured
ADMDN  swp5              N/A      1500   NotConfigured
ADMDN  swp6              N/A      1500   NotConfigured
ADMDN  swp7              N/A      1500   NotConfigured 

 

To get topology verification, run the net show lldp command.

The example output below shows the two-leaf/two-spine Cumulus VX network topology from CumulusVX-leaf1, where local port swp1 is connected to remote port swp1 on CumulusVX-spine1 and local port swp2 is connected to remote port swp1 on CumulusVX-spine2.

Code Block
languagetext
cumulus@switch:~$ net show lldp
LocalPort    Speed    Mode          RemotePort    RemoteHost        Summary
-----------  -------  ------------  ------------  ----------------  ---------------
swp1         1G       Interface/L3  swp1          CumulusVX-spine1  IP: 10.2.1.1/32
swp2         1G       Interface/L3  swp1          CumulusVX-spine2  IP: 10.2.1.1/32

 

To change the hostname, run the net add hostname command. 

This command updates both the /etc/hostname and /etc/hosts files.

Code Block
languagetext
cumulus@switch:~$ net add hostname <hostname>

Further Information

Check out these community articles and the rest of the Cumulus Linux documentation:

...