How To Add Cisco IOU/IOL To Eve-ng

· >

Cisco IOU/IOL images are L2/L3 images of Switches and routers which helps you to practice for L3 devices with same features and functions which original devices has. Cisco IOU/IOL images were released for Architecture and testing purposes but today Cisco IOU/IOL images are used for CCIE routig and switching practice for CCIE routing and switching.

Eve-ng is one of the best emulator to Practice with Cisco IOU/IOL images, where you can imports the image  in eve-ng and access it via GUI. You can setup your own lab and practice as much as you want.
To install Eve-ng on you desktop check below Post-
How to install Eve-ng on Vmware.

We will explain you step by step process – how to add IOU/IOL images in Eve-ng and how to license them.

1 You can check how to install Eve-ng in windows
2 Download Cisco IOU/IOL Images.
3 Uploading Cisco IOU/IOL images to Eve-ng.
4 How to generate license for Cisco IOU/IOL images.
5 Testing Cisco IOU/IOL images.

if you want to practice Cisco ASA or Cisco IOS Dyanamip  on eve-ng for your certification or knowledge then check below posts-

How to add Cisco ASAv to Eve-ng
How to add Cisco IOS (Dynamips Images) to Eve-ng


Basically Eve-ng support all the Cisco IOU/IOL images but below are recommended one.

Type EVE Image Name Version vRAM
L2 L2-ADVENTERPRISEK9-M-15.1-20130726.bin I86BI_LINUXL2-ADVENTERPRISEK9-M 15.1(20130726:213425) 192

2. Download Cisco IOU/IOL Images Eve-ng

Images provided below are strictly for education purpose and are not hosted on networkhunt.com server. We are just indexing the links fond on internet for education purpose only.

You can download Cisco IOU/IOL images from below links.
1. Download Cisco IOU/IOL Images.

3. Add Cisco IOU/IOL images to Eve-ng

IOL or IOS On Linux, also called IOU or IOS On Unix. IOL, is a simulator available for Cisco internal use only. IOL refers to the Linux version, compiled for i386 architecture. IOU refers to the Unix (Solaris) version compiled for Sparc architecture. The term IOU usually refers to IOL too.

Because IOL is an internal IOS version, IOL can be used by Cisco employees or by authorized customers only.

Upload the downloaded image to the EVE using for example FileZilla or WinSCP to:  /opt/unetlab/addons/iol/bin

Type following command to fix permissions:

/opt/unetlab/wrappers/unl_wrapper -a fixpermissions

3. License for Cisco IOU/IOL images.

#! /usr/bin/python
print("Cisco IOU License Generator - Kal 2011, python port of 2006 C version")
print("Modified to work with python3 by c_d 2014")
import os
import socket
import hashlib
import struct

# get the host id and host name to calculate the hostkey
hostname = socket.gethostname()
for x in hostname:
 ioukey = ioukey + ord(x)
print("hostid=" + hostid +", hostname="+ hostname + ", ioukey=" + hex(ioukey)[2:])

# create the license using md5sum
iouPad1 = b'x4Bx58x21x81x56x7Bx0DxF3x21x43x9Bx7ExACx1DxE6x8A'
iouPad2 = b'x80' + 39*b''
md5input=iouPad1 + iouPad2 + struct.pack('!i', ioukey) + iouPad1

print("nAdd the following text to ~/.iourc:")
print("[license]n" + hostname + " = " + iouLicense + ";n")
print("You can disable the phone home feature with something like:")
print(" echo ' xml.cisco.com' >> /etc/hostsn")

Copy above text and create a text file and save as with name IOUkeygen.py
After creating license python script, upload it to Eve-ng directory –/opt/unetlab/addons/iol/bin/

After uploading the script go the directory by using below command-
cd /opt/unetlab/addons/iol/bin/

Check the directory content by below command-
ls -l

you will be able to see file with name – IOUkeygen.py

Now run the python script by using below command-
python2 IOUkeygen.py

it will give you some like below output

root@eve-ng:/opt/unetlab/addons/iol/bin# python2 ioukeygen.py
Cisco IOU License Generator - Kal 2011, python port of 2006 C version
Modified to work with python3 by c_d 2014
hostid=007f0101, hostname=eve-ng, ioukey=7f0343

Add the following text to ~/.iourc:
eve-ng = 972f30267ef51616;

Now, we will create license for IOU/IOL images

nano - c iourc

paste the license and press ctrl+x to save

eve-ng = 972f30267ef51616;

We have successfully added the Cisco IOU/IOL images to eve-ng with license.

5. Testing Cisco IOU/IOL images in Eve-ng

cd /opt/unetlab/addons/iol/bin
touch NETMAP
LD_LIBRARY_PATH=/opt/unetlab/addons/iol/lib /opt/unetlab/addons/iol/bin/<iosname.bin> 1
IOS On Unix - Cisco Systems confidential, internal use only
Under no circumstances is this software to be provided to any
non Cisco staff or customers.  To do so is likely to result
in disciplinary action. Please refer to the IOU Usage policy at
wwwin-iou.cisco.com for more information.

              Restricted Rights Legend

Use, duplication, or disclosure by the Government is
subject to restrictions as set forth in subparagraph
(c) of the Commercial Computer Software - Restricted
Rights clause at FAR sec. 52.227-19 and subparagraph
(c) (1) (ii) of the Rights in Technical Data and Computer
Software clause at DFARS sec. 252.227-7013.

           cisco Systems, Inc.
           170 West Tasman Drive
           San Jose, California 95134-1706
Notify of
Inline Feedbacks
View all comments