19 Feb 09 Ubuntu Dynamips And Dynagen Starter Guide

This is a slimmed down version of a combination of the Dynamips / Dynagen Tutorial and a few other Ubuntu specific sources. In fact, you could call it a quick and dirty guide to get you up and running. I reccommend using the Dynamips / Dynagen Tutorial once you have finished here picking up at the Running Sample Lab #1 section. I couldn’t write this better than it is there.

Installation

Dynamips and Dynagen are both in the Ubuntu repository so installation is as simple as an apt-get install. To this end run the following:

sudo apt-get install dynamips dynagen

Congratulations. That’s it for installation.

IOS Image

You’ll need to get yourself a Cisco IOS image for use with the emulator. Once you have one it’s generally a good idea to uncompress the image before using it as it will speed up the boot process. Use this command to do so:

unzip -p c7200-jk9s-mz.124-13b.bin > c7200-jk9s-mz.124-13b.image

Note that this will throw an error but you can safely ignore it.

Configuring Your Telnet Client

Your telnet client should be correctly configured upon install. You can find the config file for this in /etc/dynagen.ini if your curious. You’ll find a line like the below uncommented which is your telnet configuration.

telnet = xterm -T %d -e telnet %h %p > /dev/null 2>&1 &

Configuration File

You will need a configuration file for your router(s). You can find an example one (we’ll use this example config for the rest of this guide) in /usr/share/doc/dynagen/examples/sample_labs/simple1/. We’ll use the sample1.net file from here for this guide so copy this file to wherever you have your “working directory”.

The .net file will look like this:

[localhost]
    [[7200]]
    image = /opt/7200-images/c7200-jk9o3s-mz.124-7a.image
    npe = npe-400
    ram = 160
    [[ROUTER R1]]
    s1/0 = R2 s1/0
    [[router R2]]
    # No need to specify an adapter here, it is taken care of
    # by the interface specification under Router R1

So, according to the config we are running this router instance on localhost, and defines all the defaults that will be applied to any 7200 router instance we create. This makes things easy, by allowing us to specify common things like RAM size and IOS image only once.

Each of our router instances is going use an NPE-400, and be allocated 160 MB of RAM .
We are defining a virtual router instance with the ROUTER keyword. The string following this keyword is the name we are assigning to this router, in this case “R1”. This name is just the name that is used by Dynamips / Dynagen. It has nothing to do with the hostname that you assign in IOS to the router.

The s1/0 = R2 s1/0 line states that we are going to take R1’s Serial 1/0 interface, and connect it to R2’s Serial 1/0 interface (via virtual back-to-back serial cable). Dynagen automatically “installs” a PA-8T adapter in Port 1 to accommodate this connection on both R1 and R2.

We also create a 2^nd router named R2. This is the same R2 that is referenced in the line above that connects R1 and R2’s serial interfaces. As the comment says we don’t need to specify an adapter here as it is taken care of by the interface specification under Router R1.

The only change we need to make to the .net file above is to change the value of “image=” to the path of your IOS image. For instance:

image = /home/$USER/ios/7200/c7200-jk9s-mz.124-13b.image

That’s all the configuration we’ll need for the moment.

Starting The Server And Management Console

Before you start the server cd into your working directory where you plan to store the information about your router(s). There are a lot of files created when starting both the server (dynamips) and console (dynagen) so best to be aware of this as they will be created in your working directory wherever you are.

To run the server (-H 7200 means on port 7200) in the background use:

dynamips –H 7200 &

You can now start your console with the command:

dynagen sample.net

Using The Console

At this point you are best of continuing from the Running Simple Lab #1 section of the Dynamips / Dynagen Tutorial. Good luck!