DYNAGEN(1) | General Commands Manual | DYNAGEN(1) |
dynagen - command line interface to dynamips Cisco 7200 Emulator
dynagen [options] configuration file
Dynagen is a text-based front end for Dynamips, that
uses the hypervisor mode for communication with Dynamips.
Dynagen simplifies building and working with virtual networks.
Dynagen uses a simple and easy to understand configuration file for
specifying virtual router hardware configurations. Configuration file has a
simple syntax for interconnecting routers, bridges, frame-relay and ATM
switches. No need to deal with NetIO's. Dynagen provides a management
CLI for listing devices, starting, stopping, reloading, suspending and
resuming virtual routers.
Dynagen can work in a client server mode, with dynagen running
on your Workstation communicating to dynamips servers running ona
back-end server. Dynagen can also control multiple dynamips
servers simultaneously for distributing large virtual networks across
several machines.
Before running dynagen you need to start dynamips:
nice dynamips -H 7200 &
This program follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.
Empty lines or lines starting with a hash ('#') are ignored.
Configuration file, in other documentation also called network file,
knows three sections: global section, server section which starts with [...]
and device section which start with [[...]]. Server section and device
section can have multiple occurrencies.
Server Section: [<ip-address|hostname>]
Device Section: [[7200|ROUTER|FRSW|ATMSW|ETHSW <name>]] The 7200
section specifies defaults for all 7200 routers on this Dynamips server.
Everything in this section is optional, and defaults to whatever the default
is in Dynamips
image <path/file> (Default: None)
Full path to 7200 IOS image file. This is the fully qualified path
relative to the system running dynamips.
ram <integer> (Default: None) Amount of Virtual RAM to
allocate to each router instance.
rom <integer> (Default: None)
Size of ROM.
nvram <integer> (Default: None)
Size of NVRAM.
disk0 <integer> (Default: None)
Set size of PCMCIA ATA disk0
disk1 <integer> (Default: None)
Set size of PCMCIA ATA disk1
cnfg <path/file> (Default: None)
Configuration file to import. This is the fully qualified path relative to
the system running dynamips.
confreg <hex> (Default: 0x2102) 0x210X where X=0,1,2
Set the configuration register
idlepc <string> (Default: None)
Set the Idle PC value. Include a description here.
exec_area <string> (Default: None)
Set the exec area size.
clock <integer> (Default: None)
Clock divisor (should no longer been needed as of dynamips 0.2.5 RC1)
npe <npe-100|150|175|200|225|300|400> (Default: None)
NPE type.
midplane <std|vxr> (Default: None)
Midplane, either "std" or "vxr"
mmap <binary> (Default: True)
Set to false to use real memory rather than a disk file for router vitural
memory. Conserves RAM at the expense of performance.
<local interface> = <remote interface>
Interface specification. Can take the following forms:
f1/0 = R2 f1/0 # Connect to f1/0 on device R2
f2/0 = LAN 1 # Connect to bridged LAN 1
s3/0 = R2 s3/0 # Connect to s3/0 on device R2
s3/1 = F1 1 # Connect to port 1 on device "F1" (a frame relay
switch)
s3/2 = F2 1
a4/0 = A1 1 # Connect to port 1 on device "A1" (an ATM switch)
f5/0 = NIO_linux_eth:eth0 # manually specify an NIO
[[ROUTER R2]]
# Interface f1/0 will automatically be created because the interface was
referenced in R1's config
f2/0 = LAN 1 # Connect to bridged LAN 1
s4/0 = F1 2
s4/1 = F2 2
s4/2 = F1 3
a5/0 = A1 2
[[router R3]] # Case is not significant
# Examples of other manually specified NIOs
f1/0 = NIO_gen_eth:\Device\NPF_{B00A38DD-F10B-43B4-99F4-B4A078484487}
f2/0 = NIO_udp:10000:172.0.0.1:10001
f3/0 = NIO_tap:tap0
f4/0 = NIO_unix:/tmp/local:/tmp/remote
f5/0 = NIO_vde:foo:bar
[[FRSW F2]]
1:102 = 2:201
See /usr/share/doc/dynagen/examples directory
Take a look at the Bug tracking system.
Please send bug reports to http://www.ipflow.utc.fr/bts/
http://www.ipflow.utc.fr/index.php/
http://www.ipflow.utc.fr/blog/
http://dyna-gen.sourceforge.net/
http://hacki.at/7200emu/index.php
dynagen was written by Greg Anuzelli (dynagen@gmail.com)
This manual page was written by Erik Wenzel <erik@debian.org> for the
Debian GNU/Linux system (but may be used by others).
August 29, 2006 |