Linux Networking Cookbook

6.9. Using Quagga's Command Line

Problem

You like to run commands from a command shell, and not always have to edit configuration files. How do you do this with Quagga?

Solution

Quagga comes with its own command shell, the Virtual TeletYpe shell vtysh. With vtysh, you can interact with all Quagga daemons on the local machine. You may also communicate directly with each routing daemon with telnet.

First, you need to edit or create /etc/quagga/vtysh.conf:

	!/etc/quagga/vtysh.conf
	hostname router1
	username root nopassword

On Debian, add this line to /etc/environment:

	VTYSH_PAGER=more

Now, open up a new terminal, and fire it up as the root user:

	root@xena:~# vtysh

	Hello, this is Quagga (version 0.99.4).
	Copyright 1996-2005 Kunihiro Ishiguro, et al.

	router1#

vtysh has two modes: normal and enable. In normal mode, you can view system status; in enable mode, you can edit configurations and run commands. vtysh opens in normal mode. These two commands show both sets of available commands:

	router1# ?
	router1# list

You can view all current configurations with one command:

	router1# write terminal

To run any routing commands, or to change configurations, change to configure mode:

	router1# configure terminal
	router1(config)#

The same commands display all the available commands:

	router1(config)# ?
	router1(config)# list

exit closes each session in turn. vtysh will run even when no Quagga daemons are running.

A second option is to use telnet. telnet can talkto only one daemon at a time, like this example for ...