Deploy OVF
Upload IOU File
Login EVE


I would like to share the installation steps of EVE-NG simulator. Comparing to GNS3, EVE (Emulated Virtual Environment) can be accessed by web browser to do labs without using client while GNS3 cannot. However, it is easier to setup compared to IOU-WEB and also comes with an user friendly interface. In this article, VMware ESXi is used for VM Host. You may use other VM environment such as Virtual Box.

Deploy OVF

Go to EVE-NG Webpage to download OVF file first. The community version is good enough for us. Then, import the OVF template. Normally, we do not need to change the default setting of the VM.

end-to-end delay

Turn on the VM and IP is obtained by DHCP.

end-to-end delay

Use web browser to access the IP address and you should see the following screen. We have some steps to do before login.

end-to-end delay

Upload IOU File

EVE-NG is a simulator only but do not comes with IOU files. You may Google keywords like i86bi-linux-l2-adventerprise-15.1b.bin (Switch) and i86bi-linux-l3-adventerprisek9-15.4.1T.bin (Router). Upload them to the path /opt/unetlab/addons/iol/bin/.

Run the following command:

/opt/unetlab/wrappers/unl_wrapper -a fixpermissions

It needs License Key to run the IOU. Search License Key Generator from Google by using Keyword: CiscoIOUKeygen. Upload to EVE Server. Then run the following command:

root@eve-ng:~# python

Cisco IOU License Generator - Kal 2011, python port of 2006 C version
hostid=007f0101, hostname=eve-ng, ioukey=7f0343

Create the license file $HOME/.iourc with this command:
 echo -e '[license]\neve-ng = 972f30267ef51616;' | tee $HOME/.iourc

The command adds the following text to $HOME/.iourc:
eve-ng = 972f30267ef51616;

Disable the phone home feature with this command:
 grep -q -F '' /etc/hosts || echo '' | sudo tee -a /etc/hosts

The command adds the following text to /etc/hosts:


Copy the License and paste it in the following file.

vi /opt/unetlab/addons/iol/bin/iourc

Then, run the following command to start IOU for testing. Press Ctrl-C to stop it after testing.

root@eve-ng:~# LD_LIBRARY_PATH=/opt/unetlab/addons/iol/lib /opt/unetlab/addons/iol/bin/i86bi-linux-l2-adventerprisek9-15.2d.bin 1
IOS On Unix - Cisco Systems confidential, internal use only

              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

Technical Support:

<--Output Omitted-->

Login EVE

We can login EVE now. The default Username and Password are admin/eve. Use Html5 Console when login. Click Add new lab to build the first lab.

end-to-end delay

Fill in some information of the lab.

end-to-end delay

Then, choose Add an object in the menu.

end-to-end delay

EVE supports many brands and models. But, we only uploaded IOU (aka Cisco IOL), only Cisco IOL can be chosen.

end-to-end delay

Choose L2 (Switch) or L3 (Router). Also type the name of the equipment and choose the icon.

end-to-end delay

The equipment are ready now.

end-to-end delay

Move the mouse on the equipment. There will be a plug icon. Drag to the other equipment and the connection menu will come out. Select the interfaces that you want to connect.

end-to-end delay

To turn on the equipment, right click and choose Start.

end-to-end delay

Finally, click on the equipment and the console will be prompted.

end-to-end delay