Image of Cortney & Jeremy


by Jeremy L. Gaddis on January 18, 2011 · 90 comments

in Networking

I’ve received a lot of blog comments and e-mails since I first posted about Cisco IOU, so I have put together this comprehensive list of frequently asked questions to help alleviate some of that.


This list of frequently asked questions has been compiled in response to an overwhelming number of requests for information about Cisco IOS-on-UNIX (IOU). It is not intended to be comprehensive or complete and will be updated from time to time.

If you wish to share or link to the FAQ, please use this permanent URL:

Most of the information in this FAQ has been gathered from documentation that is several years old. Some of it has been discovered on my own or contributed by other users of IOU (thank you!). I make no assurances as to the accuracy of any of the information herein. Your mileage may vary, void where prohibited, for a limited time only. All sales are final.

Table of Contents

  • An Introduction to IOU
  • Legal Warnings
  • Supported Features
  • Downloading IOU
  • Installing IOU
  • IOU Licensing
  • Using Cisco IOU
  • Connecting IOU to Physical Networks
  • Error Messages
  • How to Help

An Introduction to IOU

What is IOU?

From the Cisco Engineering Education Web Site (a long time ago):

Cisco IOS on UNIX (IOU) is a fully working version of IOS that runs as a user mode UNIX (Solaris) process. IOU is built as a native Solaris image and run just like any other program. IOU supports all platform independent protocols and features.

With regard to functionality, it is very similar to GNS3 but it does not require nearly the resources that several virtual routers running under dynamips does.

IOU allows you to build out a network topology on a single PC without the need for physical routers. This is useful for validating network designs, proof-of-concept testing, and certification self-study.

What operating systems does IOU run on?

It is my understanding that, initially, IOU was Solaris (SPARC) only. Nowadays, however, there are also builds for Linux and OS X (though I’m not sure the OS X builds are still maintained).

The versions of IOU that have been available via BitTorrent are all Linux only, I believe.

While the images should run on any 32- or 64-bit (x86/amd64) Linux host, I highly recommend using Debian GNU/Linux. Any examples that I provide in this FAQ will be based upon Cisco IOU running on Debian.

What skills do I need to run IOU?

Dynamips, dynagen, and GNS3 are all cross-platform and can be run on Windows, Linux, and OS X. A graphical installer allows pretty much anyone capable of clicking “Next” to get the software up and running.

This is not the case with IOU. To successfully install and run Cisco IOU, you will need to be familiar with the UNIX command line. Knowledge of vi (or other UNIX text editors) and basic shell scripting would be useful.

If you have never used a UNIX CLI before, you probably want GNS3 instead.

Legal Warnings

Is it legal to use Cisco IOU?

If you are not an authorized Cisco employee (or trusted partner), usage of Cisco IOU is potentially a legal gray area. From an old, internal-only Cisco web page:

Cisco IOS on Unix is a tool intended for internal use only. Distribution of IOU images to customers or external persons, or discussion of IOU with customers or external persons, is prohibited. Don’t do it or we’ll have to come and kill you.

Is it legal to distribute Cisco IOU?

If you have to ask, you’re probably not one of the few persons at Cisco authorized to distribute it, so no. I have managed to acquire copies of several versions but I have not, do not, and will not distribute them.

Cisco IOU, just like IOS, is copyrighted software that belongs to cisco Systems, Inc. Distribution of copyrighted software is a federal crime in the United States. I cannot speak regarding the laws of other countries.


In addition, any requests for Cisco IOU images in the comments section of this blog will be deleted, regardless if distribution is legal in your country.

Can I be tracked if I’m using IOU?

Potentially, yes.

At startup, Cisco IOU attempts to make an HTTP POST of some XML data to a host at The data includes your (short) hostname (e.g. not the FQDN), the (UNIX) username of the user running IOU, the version of IOU in use, etc.

At the time of this writing, port 80/TCP on is not reachable from the Internet, however, so the connection (and submission of identifying data) will not be successful. That could change at any time in the future, however, so you may want to do run the following command (as root) on the host running IOU:

# echo '' >> /etc/hosts

This will redirect any traffic for the host to localhost.

Supported Features

What features does IOU support

Pretty much everything I’ve tested is supported by IOU, depending on the image that you’re using (e.g. IP Base versus Advanced Enterprise Services). The “L2IOU” images have some limitations and do not support certain features, such as voice, QoS, or Etherchannel.

What version of IOS is IOU based on?

As I understand it, IOU images are built for each version of IOS. The images that are available via BitTorrent are the “ipbase” and “adventerprisek9″ 12.4 featuresets. In addition, I personally have version 15.x (Linux) images that I have acquired, as well as older Solaris and OS X IOU images.

Are there pagent images?

Yes, in addition to the “regular” IOU images, there are also “pagent” images in existence that support the traffic generation (and other) features.

Downloading and Installing IOU

Where can I download IOU?

As mentioned in the “Legal Warnings” section above, Cisco IOU is copyrighted software and in the United States at least, distributing it is a federal crime and I don’t do it.

I am told that the software is available via BitTorrent, however you will have to find those torrents on your own.

Are there VMware images of IOU or Live CDs?

I am aware of both IOU Live CDs as well as pre-built VMware virtual machine images that contain a complete environment for running and using Cisco IOU software. I have not used any of them, however, and cannot speak to their quality.

I have been told that these are available via BitTorrent as well.

Okay, I’ve got the files, how do I use them?

Once you have obtained the Cisco IOU images, you will need to transfer them to the Linux host that you wish to run them on (if you haven’t already). The method that you use will depend on what services your host provides (e.g. FTP, SSHd, etc.).

I recommend creating a new directory just to contain the IOU images and related files, for example a directory named “iou” inside your home directory:

$ cd $HOME
$ mkdir iou
$ cd iou

Put your IOU images in this directory.

Where’s the installation program?

There is no installation program for Cisco IOU. Installation is simply a matter of transferring the files to your Linux host that you wish to run them on.

IOU Licensing

Do I need a license to use IOU?


Older IOU images apparently do not need a license key to work, such as the older Solaris images that I have.

Newer images, however, including the ones I’ve seen that are available via BitTorrent, do require a valid license key in order to run them.

While I was teaching higher-ed networking courses, I made a video showing why these basic checks are often not enough to adequately “protect” software. This video is available on the Cisco IOU Licensing page on Free CCNA Labs, another website of mine.

Where is your Perl script to patch the IOU images?

At the end of the above video, I mentioned a Perl script that would patch the IOU images so that a valid license key was not necessary. In the interest of not violating the DMCA and staying out of prison, however, I ultimately decided to never share it.

Someone else has posted a quick way to patch the IOU binaries to bypass the license key check from the Linux command-line, however.

Where do I get a license key?

Valid license keys can be obtained via an internal-only web page at Cisco. License keys are specific to a host, based upon its hostname and IP address. This means that a license key obtained from someone else will likely not work on your PC.

Various third parties, however, have reverse engineered the Cisco IOU software and created their own license generators, such as iougen.

Using Cisco IOU

Is my system compatible with IOU?

You will need to be running the operating system that your IOU image was built for, obviously. In most cases, this will be the Linux operating system. The software will run on both 32-bit and 64-bit platforms and do not have any special requirements (for the most part).

Cisco IOU is not CPU-intensive like GNS3 is. A several-years-old PC will run Cisco IOU just fine.

Besides the IOU images, what else do I need?

You’ll obviously need the IOU software images in order to use IOU, but you’ll also need an IOURC file and a NETMAP file (see below).

What’s the IOURC file?

The IOURC file is a configuration file for Cisco IOU. Cisco IOU looks in this file for your license key at startup.

Where do I put the IOURC file?

There are a few different places that IOU will look for its configuration. Any of the following are valid locations:

  • a file named “iourc” in the current working directory
  • a file named “.iourc” in the user’s home directory
  • a file pointed to by the IOURC environment variable

Because I use different topologies and often switch back and forth between them, I prefer to create a separate directory for each topology and store the IOURC file and NETMAP file (see below) in each topology’s directory.

What is the format of the IOURC file?

While there is other information that can be contained in the IOURC file, we’ll use it mainly for storing our license key. In this case, the license stanza of your IOURC file should resemble the following:

hostname = 4242424242424242;

In this example, replace “hostname” with the actual hostname of your machine and the rest with your actual license key.

If you are unsure of the proper value to use for the hostname, simply run the following command on the command-line and use the value that it returns:

# hostname -s

What is the NETMAP file?

The network topology map, or NETMAP, file describes the topology of your virtual network. It is used for controlling the layout of the “virtual cabling”. If you have used dynagen, this is the equivalent of the .net file.

Where does the NETMAP file go?

Like the IOURC file, your NETMAP file can exist in several locations. Any of the following are valid locations:

  • a file named “NETMAP” in the current working directory
  • a file named “.NETMAP” in the user’s home directory
  • a file pointed to by the NETIO_NETMAP environment variable

Because I use different topologies and often switch back and forth between them, I prefer to create a separate directory for each topology and store the IOURC file (see above) and NETMAP file in each topology’s directory.

What is the format of the NETMAP file?

I’ve posted an example Cisco IOU topology that you should refer to. It includes a network diagram, the corresponding NETMAP file, and shows how to define point-to-point serial and “multipoint” Ethernet connections between routers.

You may also wish to refer to the Free CCNA Labs Topology that I use on that website. That article shows the network diagram being used for the topology and also has links to the NETMAP file being used (with lots of frame-relay, serial, and Ethernet connections) as well as the configuration for the frame-relay switch.

Between these two, you should be able to discern how to create NETMAP files corresponding to network topologies of your own design.

How do I run Cisco IOU?

Once you have the software images in place and your IOURC and NETMAP files created, you’re ready to fire up your routers!

The usage and available parameters you can pass to the IOU binaries are shown here:

Usage: <image> [options] <application id>
<image>: unix-js-m | unix-is-m | unix-i-m | ...
<application id>: instance identifier (0 < id <= 1024)
-e <n>          Number of Ethernet interfaces (default 2)
-s <n>          Number of Serial interfaces (default 2)
-n <n>          Size of nvram in Kb (default 16K)
-c <name>       Configuration file name
-d              Generate debug information
-t              Netio message trace
-q              Suppress informational messages
-h              Display this help
-C              Turn off use of host clock
-m <n>          Megabytes of router memory (default 64)
-L              Disable local console, use remote console
-u <n>          UDP port base for distributed networks

The simplest method to start up an IOU instance is to simply run the binary and pass in an “application id” (a number between 1 and 1024), for example:

$ ./i86bi_linux-adventerprisek9_ivs-ms.151-4 42

How do I stop a router in IOU?

Simply press CTRL-C and the process will exit.

What is the “wrapper”?

When you start up an IOU router from the command-line, it will stay in the foreground and you’ll be connected to the “console”. This may not always be the desired behavior, especially if you wish to telnet to the console from another host on the network (similar to dynamips).

The wrapper program can be used to redirect a TCP port to the “console” of the router so that you can do exactly this.

How do I use the wrapper?

$ ./wrapper
Usage: ./wrapper [-v] -m<image name> -p<port number> -- [iou options] <router ID>
	where <port number> is in the range <1024-65550>
	all options after the '--' are passed to iou
	[-v] Display version

For example, instead of just running ./imagename <application id>, you would use something like this:

$ ./wrapper -m ./imagename -p 2000 -- -e0 -s1 -m 64 100

This would instruct the wrapper to startup the IOU image named ./imagename and listen on TCP port 2000. Any options after the double-hyphen (“–”) are passed off to the IOU image so, in this case, our IOU instance would start up with zero Ethernet interfaces (“-e0″), one serial interface (“-s1″) — which actually means four serial interfaces in newer images, due to a feature called “Wide Port Adapters” — and 64 MB of RAM (“-m 64″). The “application ID”, which we’ll use to refer to this instance in the NETMAP file (see above), is 100.

The wrapper is most useful in a shell script to start up and background a number of IOU instances at once. For a complete example showing a NETMAP file and a corresponding shell script to startup all IOU instances, see my article “, an IOUlive replacement”.

How do I stop IOU when using the wrapper?

If you are using the wrapper and have background the IOU instances, you’ll need to find the process ID of the instance you want to stop and use the kill command.

To see all of your running IOU instances, use this command:

$ ps -ef | grep [w]rapper

Find the instance you want to stop and pass the corresponding process IDs to the kill command.

To stop all running IOU instances in a single fell swoop, use the following:

$ ps -ef | grep [w]rapper | awk '{ print $2 }' | xargs kill

Connecting IOU to Physical Networks

What is IOUlive?

IOUlive is a separate application that allows one to bridge an IOU instance to a physical network, similar to what can be done with dynamips and GNS3 using dynagen’s NIO_linux_eth descriptor.

By connecting an IOU instance to IOUlive, your virtual routers can talk to devices on your physical network, as shown in this example Cisco IOU topology.

Where can I download IOUlive?

Unfortunately, binaries of IOUlive are not quite as available as the IOU images themselves. Like IOU itself, IOUlive is copyrighted software belonging to Cisco.

Are there alternatives for IOUlive?

I am aware of at least two individuals who have reverse engineered IOUlive and created their own applications that provide the same functionality. (Note that both require root privileges to run, by default.)

The first application,, is a Perl script written by “einval” that bridges an IOU instance with the physical network. The scripts itself as well as instructions for using it are available on the Internetworkpro wiki. In addition, my example Cisco IOU topology includes a NETMAP file and a shell script showing how to use

Downoad link: Connect IOU with real networks or dynamips.

Another application, an x86 binary named “ioulive86″, was written by a CCIE whose identify I will not reveal. He claims that it offers greater performance and higher forwarding throughput than He was going to publish the source code to the application but, unfortunately, that was lost when he deleted a virtual machine without backing up the code first! Because it requires root privileges, run it at your own risk.

Download link: ioulive86.

Cisco IOU Error Messages

What does “UNIX ERR:tcgetattr:Invalid argument” mean?

I’m not sure, honestly, but it doesn’t seem to hurt anything or cause any loss of functionality. It appears that it can be safely ignored.

./i86bi_linux_adventerprisek9-ms: No such file or directory

You’re probably running a 64-bit version of Linux. On Debian and Ubuntu, installing the ia32-libs package will fix this for you (for other distros, you’re on your own):

$ sudo apt-get install ia32-libs

./i86bi_linux_adventerprisek9-ms: error while loading shared libraries: cannot open shared object file: No such file or directory

You either do not have libssl installed or your version is much newer than what Cisco has linked against when building the IOU images.

First, ensure that libssl is installed. On Debian and Ubuntu:

$ sudo apt-get install libssl0.9.8

Next, you’ll need to make a symbolic link pointing to the file that IOU is looking for.

On 32-bit hosts:

$ sudo ln -s /usr/lib/ /usr/lib/

On 64-bit hosts:

$ sudo ln -s /usr/lib32/ /usr/lib32/

I’m getting a “host not found in iourc file” error message.

Use the correct hostname in your IOURC file. See above.

How can I add an NM-16ESW module?

You can’t.

Oh, come on! There must be some way to add ATM or NM-16ESW modules!


When running “./wrapper-linux -m i86bi_linux-adventerprisek9-ms …”, I get a “No such file or directory” error message.

Provide the correct path to the IOU image as the “-m” option. If it is in the current directory, refer to it as “./i86bi_linux-adventerprisek9-ms”, for example.

I’ve tried everything and I can’t get it to work. What should I do?

Use GNS3 instead.

Will you send me a copy of … ?

No. In addition, if you post any comments below asking for or offering IOU images, they will be deleted whenever I see them.

If I e-mail you will you help me?

Not unless you pay me first.

How to Help

If you have corrections, additional information, tips or tricks, topologies that you’d like to share, etc., please shoot me an e-mail. I’ll be happy to add your contributions to the FAQ. Thanks!

Last updated: 01 November 2011

{ 80 comments… read them below or add one }

Anonymous January 20, 2011 at 1:23 am

l0l Thanks ;)


Darkkmaul January 25, 2011 at 3:08 pm



Kevin January 26, 2011 at 10:51 am

Hi Jeremy, I am testing cisco-iou-livecd-v1.0 and I have run in to a problem saving any config changes. When I reload the VMware session running cisco-iou-livecd-v1.0 each router is back at the initial config yes/no menu. I know how busy you must be but I was wondering if you have run in to the same issue?


jlgaddis October 15, 2012 at 11:38 pm

Wow, sorry for taking so long to respond to your comment, Kevin. Unfortunately, I’ve never used the LiveCD so I haven’t run into the issue. It would make sense, though, if it’s a LiveCD that all your changes would be wiped out when you restart the VM — unless it somehow sets up persistent storage for your configs (but I doubt that).


crypt January 26, 2011 at 5:18 pm

I’ve digged a little bit topic about connection to real network. May be someone is interested.


luis January 27, 2011 at 1:40 am

the only thing that I don’t like is that it doesn’t support fasethernet cards


Thulani Maphosa February 5, 2011 at 1:05 pm

On Ubuntu server 64bit

  1. If you get this error: “-bash: ./i86bi_linux-adventerprisek9-ms: No such file or directory”

sudo apt-get install ia32-libs

  1. Then you get error: “./i86bi_linux-adventerprisek9-ms: error while loading shared libraries: cannot open shared object file: No such file or directory”

sudo ln -s /usr/lib32/ /usr/lib32/

Good Luck !!!!!


Jody Lemoine February 7, 2011 at 11:10 am

Thanks for the great information, Jeremy.

I’ve been doing some more playing with the idea of connecting IOU to a physical network and found the following very useful link for those who don’t have access to ioulive:

Further reading/testing indicates that there’s no need to do the math for the NETMAP file either. Using process:slot/interface works just as well and is much easier to work with.


Jody Lemoine February 7, 2011 at 11:12 am

It looks like that URL got mangled in the post. There should be underscored between each word in the final element of the path.


saam February 21, 2011 at 2:33 am

when i save my config, the nvram located in the same folder as application (ex : /iou).
can i put my nvram to another folder (ex: iou/labconfig)?


Dnetcrawler March 19, 2011 at 11:05 pm

I keep getting “Segmentation Fault” any ideas?


Crrimson February 25, 2012 at 2:05 am

I was getting Segmentation Fault after hex-editing IOU executable in windows and then copying to VMWare.  Hex-editing the file directly in Linux resolved this for me.


Zoidberg April 28, 2011 at 8:05 pm

Managed to get the linux version of IOU running via Linux binary compatibility mode using emulators/linux_base-f10 under FreeBSD 9.0-current AMD64 without a hitch :)


jlgaddis October 15, 2012 at 11:29 pm

Nice! I wanted to try running it under Linux emulation on FreeBSD but just never got around to it — nice to know that it works!


david May 5, 2011 at 6:30 am

It is possible to simulate 3560 features with the Cisco IOU?


Thomas McLean May 5, 2011 at 3:03 pm


I’ve installed Cisco IOU 2.0 – do you know if you can save your configs and after you reload your VMware instance the configs will be backed up and loaded on boot?




Azamat June 7, 2011 at 1:40 am

Hi All,
Does Cisco IOU support VOICE feature?


Jeremy L. Gaddis July 14, 2011 at 2:39 am


Cisco IOU does not support voice features.


renos June 25, 2011 at 6:04 pm

i think i found a handy way to create “vlans”. Since there is no switch available and no 16 ethernet module like dynamips then the only solution is the following:
lets say we have three routers connected
1:0/0 2:0/0 3:0/0
iou treats them as connected in the same switch. The first solution would be to just create different subnets then in layer three we would have “vlan” but still the routers would be in the same broadcast domain. The second and better solution is to create subinteraces.
for example
int e 0/0
no ip address
no shut
int e0/0.12
encapsulation dot1q 12
ip address
now only subinterfaces with the same dot1q can ping the
can anyone assure us that now the subinterfaces are in a different broadcast domain ?


yuqq August 8, 2011 at 7:07 am

thanks much


wingnut August 20, 2011 at 12:50 pm

Got both the L2 and L3 ( the switch and the router ) working really well, and connecting to the real world. but one thing a just cannot seem to master is getting it all to start when my linux OS starts. i’ve written a script to start a couple of instances and attach them to my nic card

../iou/wrapper -m  ../iou/i86bi_linux-adventerprisek9-ms -p 3000 — -e1 -s1 1 &../iou/wrapper -m  ../iou/i86bi_linux-adventerprisek9-ms -p 3001 — -e1 -s1 2 &../iou/wrapper -m  ../iou/i86bi_linux-adventerprisek9-ms -p 3002 — -e1 -s1 3 &../iou/wrapper -m  ../iou/i86bi_linux-adventerprisek9-ms -p 3003 — -e1 -s1 4 &../iou/wrapper -m  ../iou/i86bi_linux-adventerprisek9-ms -p 3004 — -e1 -s1 5 &../iou/wrapper -m  ../iou/i86bi_linux-adventerprisek9-ms -p 3006 — -e1 -s1 6 &# ../iou/wrapper -m  ../iou/i86bi_linux-adventerprisek9-ms -p 3005 — -e1 -s1 105 &sleep 10
../iou/ -i eth0 -p 200 &../iou/ -i eth0 -p 201 &# ../iou/ -i eth0 -p 202 &# ../iou/ -i eth0 -p 203 &
I’ve added another  script to /etc/init.d/
which should get the whole thing going at bootup.

# !/bin/shcd /iou/bin/bash -c “/iou/”
#cd /iou/L2IOU# ./ &

My routers start briefly when my Linux OS starts but then they stop again ( i think after the 10 second delay in my script.


Waytoccie September 19, 2011 at 9:34 pm

i am trying to use Web – IOU i am getting following error

connect to localhost failed (Connection refused) no (more) retries!
failed in require at /home/webiou/WebIOL/web-iou.cgi line 2.

help me 


Mario December 10, 2011 at 12:45 pm

I am also running into the same issue, does anybody know why this error? Please Help!!


Free Aaa August 24, 2011 at 12:36 pm

How to dump traffic between instances to the file for packet analyzing?


jojo September 3, 2011 at 2:28 am

is the ios of IOU  the same with the ios of GNS3?


Sfsdk September 17, 2011 at 8:20 pm

 i am trying to use Web – IOU i am getting following error

web-iou.cgi: connect to localhost failed (Connection refused) no (more) retries!
Compilation failed in require at /home/webiou/WebIOL/web-iou.cgi line 2.

anyone help me


Jonathan Major November 3, 2011 at 9:54 am

%AMDP2_FE-6-EXCESSCOLL. I know this is caused by collisions, and is a duplex issue, just
wondering if anyone has found a way to get around this and the crippling
effects if has on L2IOU? I mean, in switching labs, switches can’t ping each
other’s SVIs (haven’t really tried no switchport interfaces). L2IOU gave me
some glimmer of hope I wouldn’t have to build out a physical lab or rent rack
time (at least not as much) while prepping for the big IE… I feel as though
that hope is diminished.


Lee June 21, 2012 at 10:33 pm

There is probably no fix. I saw the same thing on the CCIE troubleshooting lab.


kirill August 9, 2013 at 12:22 am

Hello, Jonathan!
I had the same issue, in addition packets was lost.
I solved it. Just put all your ports “duplex auto”, and after it reload all topology.


us vpn November 11, 2011 at 2:03 am

Great guide you answered all my questions. Thanks


Calin112 November 11, 2011 at 5:25 pm

Can you run IOU or IOL natively on Mac OS?


jlgaddis October 15, 2012 at 11:28 pm

I have a couple of old versions of IOU built for Mac but they were compiled for PPC and won’t run on Intel Macs. I’m not sure if those (old) versions are floating around out there anywhere or not.

You can always install VirtualBox (free) and run a Linux VM inside VirtualBox so that you can run IOU.


swclab_2006 December 18, 2011 at 10:42 pm

Dear friends,

i rebuild ioul2 with debian OS on my vmware machine ,
when i run that i0u with 8 routers(core switch+distributed switch+access switch) and make ACL+VLAN Lab,my lab has successed and can ping each other.
but why sometimes i had segmentation fault on my core switch?
can u help me?


Arefin January 9, 2012 at 4:14 am


I have configured IOU v2 and v3 image. But there is no configuration. Can anyone please tell me where can I get those? 

How can I configure mpls and Frame-Relay on cisco IOU?




jlgaddis October 15, 2012 at 11:35 pm

You have to create your own network topologies. I believe this is addressed in the FAQ above.


CiscoisHard January 31, 2012 at 4:33 pm

Hello are you online at the momment?


Bob February 3, 2012 at 7:01 am

When running “./wrapper-linux -m i86bi_linux-adventerprisek9-ms …”, I get a “No such file or directory” error message.Provide the correct path to the IOU image as the “-m” option. If it is in the current directory, refer to it as “./i86bi_linux-adventerprisek9-ms”, for example.Had this problem – seems like you need a 32 bit system – if you execute the wrapper or the i86…images on a 64bit system it throws an exception hissy fit.


itsbrett February 3, 2012 at 7:56 pm

Looks like endless fun on tap.


Annamalaipon February 9, 2012 at 4:44 pm

Hi Friends
Pls Help me!!!! I am not able to connect IOU Router via Putty
I am geeting an error msg “Network Error: Connection Refused”


Earl August 11, 2013 at 9:03 am

I have this issue also

have you been able to resolve it ?


Lee February 10, 2012 at 7:39 pm

Using Ubuntu 11.10, I keep getting an error: “undefined symbol: MD5_init”. Has anyone else seen this error, and were you able to fix it?


nico June 21, 2012 at 11:14 am

I have the same issue. How do you solved it?
thanks a lot for your help


Lee June 21, 2012 at 10:35 pm

I did not. I found a pre built vm that runs on Debian.


jlgaddis October 15, 2012 at 11:34 pm

This is easily fixed by installing a specific package but at this moment I can’t remember which package it is. If anyone is still having this issue, shoot me an e-mail or ping me on Twitter and I’ll set up IOU again and figure out which one it is.


nanonimous May 10, 2013 at 3:27 am

That’s because it does not link properly created /usr/lib/
since it is precisely in the directory “/usr/lib/lib/″ and I think the link you already named and ready :)



Matthew Gillespie November 16, 2013 at 1:17 pm

Great write-up Jeremy, I can’t believe I didn’t realize IOU existed until last night.

The MD5_init problem can be fixed with what user “Jesus” suggests 4/13/2013. Instead of symlinking /usr/lib/* to, try symlinking /usr/lib/i386-linux-gnu/ (I’m doing this on a 32 bit Debian Wheezy system.

Anyone having the MD5_init issue should poke around a little bit, most likely you’re symlinking to the wrong shared object.

Thanks again for a great resource.


Don February 23, 2012 at 3:10 pm


After executing ‘ $ sudo ln -s /usr/lib32/ /usr/lib32/′, Im getting an error ‘
cannot read file data:Error 21′. could anyone help me out?


Hardaway March 20, 2012 at 5:57 am

I want to work router and switch ios both. But i can’t. How to work  both router and switch ios?
This is very important to me. Because i work for ccie lab exam. Please help…


Tonyfacadas May 8, 2012 at 1:58 pm

“web-iou.cgi: connect to localhost failed (Connection refused)web-iou.cgi: connect to localhost failedweb-iou.cgi: connect to localhost failed (Connection refused) no (more) retries!Compilation failed in require at /home/webiou/WebIOL/web-iou.cgi line 2.”
Can someone help???  Thank you in advance


Whois9 May 11, 2012 at 9:22 am

Can I have a copy if your IOU with the license file please?

so this will get deleted ha ha


Guest June 30, 2012 at 5:16 am

Just wondering how to kill TCP frozen session, tried TCPKILL but it doesn’t work as there is no traffic to intercept.


Andy Davidson July 13, 2012 at 2:33 pm

Has anyone seen IOU do this ?

Refcount on freed chunk is non-zero
*Jul 13 18:30:25.647: %SYS-2-CHUNKBADREFCOUNT: Bad chunk reference count, chunk 9E8838E8 data 9E89356C refcount 9E alloc pc 87199CA. -Process= “BGP Router”, ipl= 0, pid= 205, -Traceback= 0xA709C8Ez 0x87B9E7Az 0x87B8328z 0x8708774z 0x8714188z 0x8707C3Cz

I am simulating a full table with exabgp, which is running on a Linux host (Virtualbox), and connected to the IOU host via a iou2net tap interface. When the BGP session comes up, the SYS-2-CHUNKBADREFCOUNT error appears few seconds.


Bogus August 3, 2012 at 8:04 pm

 Is there a way to make packet capture on the links in IOU ?


Zohirsouam August 15, 2012 at 12:40 pm

can you tell us how we change the ethernet interface to fastethernet.


jlgaddis October 15, 2012 at 11:29 pm

You don’t.


vishi September 18, 2012 at 4:17 am

I m able to install iou on ubuntu, can u tel me How to use it


Praveen October 1, 2012 at 1:26 pm

how many ports does iou support i tried not more than 9 what u say……………….


jlgaddis October 15, 2012 at 11:29 pm

If I remember correctly, I ran an instance with 8 ethernet and 8 serial interfaces at one point. I’m not sure if I ever tried any more than that or not.


Ruben Farias March 4, 2013 at 3:39 am

IOU-WEB’m testing, but when I’m doing a lab all works, no particular error. The only COASA happens is that with the topologies that I think half an hour after the routers / sw off.
Is there any timeout timer or you have to configure?

Thank you.


hanson March 12, 2013 at 10:28 pm

HI :
I have a question , when i start vm and open web page , start all device and wait to green , then i click telnet client (CRT) , telnet client just stop in “welcome to terminal server ” , and I hit enter buttom , the telnet client will be close and device turn to red , can you help me to fine the problem ?


Angel May 7, 2013 at 11:28 pm

I have the same problem
How do I fix it? help!


sunnypilot March 24, 2013 at 10:40 am

If I shut an ethernet port on a switch, the line protocol does not go down on the connected neighbor switch. Due to this, I can not test STP convergence properly. Also there is no support for UDLD in IOU. Is there any other method by which I can make the protocol on the opposite switch go down?


jesus April 21, 2013 at 6:12 pm

I just want to leave a record, I have an issue with the library libcrypto, I followed the instructions, I install the libssl created the symbolic link and I didn’t work, so after looking someone said install libssldev and didn’t work. So I started looking for the symbolic link and finded that I didn’t have the libcrypto in /usr/lib, but I installed on the packages needed.

So I ran on the terminal find / -iname ‘libcrypto*’, to find out that I have the library on another place, this is the output:

$ find / -iname ‘libcrypto*’

And did the symbolic link

ln -s /usr/lib/i386-linux-gnu/ /usr/lib/

after did, the cisco iou worked.

I running 3.2.0-40-generic-pae #64-Ubuntu, Ubuntu 12.04.2 LTS, hope this can help.


Jeremy L. Gaddis May 1, 2013 at 11:56 am

Yeah, it’s been a few years since the FAQ was originally written and there’s been several releases of Ubuntu since that time so I’m not surprised that things have changed significantly since then. Thank you very much, Jesus!


Alexandr June 14, 2013 at 9:11 am

Thank you for pointing that !!!
This advice saved me a lot of time


Angel May 7, 2013 at 11:29 pm

HI :
I have a question , when i start vm and open web page , start all device and wait to green , then i click telnet client (CRT) , telnet client just stop in “welcome to terminal server ” , and I hit enter buttom , the telnet client will be close and device turn to red , can you help me to fine the problem ?


vishi May 24, 2013 at 4:58 am

How to run ios-xr. It run on linux 64bit.
What are the library’s need to run ios xr on linux


noobie August 28, 2013 at 9:57 am


I am only able to see partial configuration, I am not able to see interface configuration when I do a show run, but if I do a show run int, I am able to see the config.

Any idea why so?


Shani September 24, 2013 at 1:32 pm

Hi Guys,

I am sure you will know about it. Is there an IOU for IOS-XR. and is it available for Enduser.

Would really appreciate if someone can comment on this.


ashok sharma September 27, 2013 at 4:17 pm

if you know linux its well and good but while writing a tutorial make sure that it is easily understood by every one. my problem is i have the image of IOU and debian7.1+fxce 1cd and i dont know how to get around. so please for non linux user explain every detail or record and vedio step by step how to work with IOU.
DO YOU GET ME EVIL !!!!!!!!!!!!!!!!!!!!


amer October 4, 2013 at 9:58 am

i’m using IOU and make tow connection wtih
1-gns3 router 2961
2-with win XP on virtualbox install cisco voip software
with router connetion work well and I can see it by cdp neighbors and other port i see the software in the same commend
show cdp neighbors
but I can’t ping the router from the XP or get IP from the router and I configuret well
all the configuration is good but i thing ther is extra commend for IOU to forword packet over it


Leave a Comment

{ 10 trackbacks }

Previous post:

Next post: