Advertisem*nt
Today I am preparing step by step instructions on how to install and run IOU IOL images on EVE-NG. This article will guide you on each step you should take run Cisco IOU/IOL images with iourc license file. IOL or IOU are images that run on Linux/Unix.
Table of Contents
Steps to install IOU IOL images on EVE-NG
Download and upload IOL/IOU image
1. In the very beginning you need to download the IOU IOL images on EVE-NG server. Please use this LINK to download the images. Password is of the archive is “www.certcollection.org”.
Ads
2. Next, upload IOL image to EVE-NG you want to run. You can use tool like WINSCP access EVE-NG directories in graphical manner.
3. Open the WINSCP and access the EVE-NG server directory as below. The default Username is root and password eve.
Once authentication is done you will see below window where left side is your local PC directory and right side is EVE-NG directory.
4. The IOU/IOL images must end with .bin extension. Now upload the IOU/IOL images to EVE-NG under location /opt/unetlab/addons/iol/bin/.
Fix IOU image Permission
5. Further, open cli access to EVE-NG using tool like Putty and fix the permission of the images you just have uploaded in order for them to work using cli command as below.
root@EVE-NG:~# /opt/unetlab/wrappers/unl_wrapper -a fixpermissionsroot@ EVE-NG:~#
6. On cli, change the directory using below command and check the images are uploaded
root@EVE-NG:~# cd /opt/unetlab/addons/iol/bin/root@EVE-NG:/opt/unetlab/addons/iol/bin# ls -ltotal 180436-rwxr-xr-x 1 root root 184759244 Dec 22 2018 i86bi_LinuxL3-AdvEnterpriseK9-M2_157_3_May_2018.bin
Create IOU Licence Key
7. Now, we need to add the IOU licence under the EVE-NG to run the IOU/IOL image.
8. Download the IOU licence key generator named CiscoIOUKeygen3f.py from here. If not able to download copy and save below python code with same filename.
! /usr/bin/python3print("*")print("Cisco IOU License Generator - Kal 2011, python port of 2006 C version")import osimport socketimport hashlibimport structget the host id and host name to calculate the hostkeyhostid=os.popen("hostid").read().strip()hostname = socket.gethostname()ioukey=int(hostid,16)for x in hostname:ioukey = ioukey + ord(x)print("hostid=" + hostid +", hostname="+ hostname + ", ioukey=" + hex(ioukey)[2:])create the license using md5sumiouPad1 = b'\x4B\x58\x21\x81\x56\x7B\x0D\xF3\x21\x43\x9B\x7E\xAC\x1D\xE6\x8A'iouPad2 = b'\x80' + 39*b'\0'md5input=iouPad1 + iouPad2 + struct.pack('!i', ioukey) + iouPad1iouLicense=hashlib.md5(md5input).hexdigest()[:16]print("\nAdd the following text to ~/.iourc:")print("[license]\n" + hostname + " = " + iouLicense + ";\n")with open("iourc.txt", "wt") as out_file:out_file.write("[license]\n" + hostname + " = " + iouLicense + ";\n")print("^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\nAlready copy to the file iourc.txt\n ")print("You can disable the phone home feature with something like:")print(" echo '127.0.0.127 xml.cisco.com' >> /etc/hosts\n")
9. Once download, again upload this licence file to EVE-NG directory “/opt/unetlab/addons/iol/bin/.”
10. Verify licence file is uploaded as below.
root@EVE-NG:/opt/unetlab/addons/iol/bin# ls -ltotal 180440-rw-r--r-- 1 root root 1201 Jun 7 12:07 CiscoIOUKeygen3f.py-rwxr-xr-x 1 root root 184759244 Dec 22 2018 i86bi_LinuxL3-AdvEnterpriseK9-M2_157_3_May_2018.binroot@EVE-NG:/opt/unetlab/addons/iol/bin#
11. No need to fix the permission of the license file as we will run this file using the python program. Run command “python3 CiscoIOUKeygen3f.py“
root@EVE-NG:/opt/unetlab/addons/iol/bin# python3 CiscoIOUKeygen3f.pyCisco IOU License Generator - Kal 2011, python port of 2006 C versionhostid=007f0101, hostname=EVE-NG, ioukey=7f04dfAdd the following text to ~/.iourc:[license]EVE-NG = 03f19d8883694bb3; >>>>>>>>>>>> Licence key is genereated^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^Already copy to the file iourc.txtYou can disable the phone home feature with something like:echo '127.0.0.127 xml.cisco.com' >> /etc/hostsroot@EVE-NG:/opt/unetlab/addons/iol/bin#
12. Now we need to copy this license Key and create a new file named iourc and save the below license text which is generated in step 11.
[license]EVE-NG = 03f19d8883694bb3;
Create iourc file to save licence key in it
13. Follow below steps to create file.
a. Create file using below command
touch iourc
b. Edit the file using nano editor. Type
nano iourc
The below window will open where you need to pass the license text mentioned in step 12. Save the lines using CTL+O, then hit ENTER and CTL+X to exit.
Verify Image on EVE-NG
14. Finally, now add the Node under the EVE-NG graphical and run the IOL image.
21,641
Advertisem*nt