Scribd
Upload
588 views

How To Run IOL Images

This document provides steps to add Cisco IOS on Unix (IOU) and IOS on Linux (IOL) images to Unetlab including downloading required files, using WinSCP to transfer the files to the Unetlab VM, generating a license, and testing the images. Key steps include using WinSCP to copy IOL image and license files to the VM, running a Python script to generate a license, editing the license file, and testing the images.

Uploaded by

afanbaloch1596
Copyright
© © All Rights Reserved
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
588 views

How To Run IOL Images

This document provides steps to add Cisco IOS on Unix (IOU) and IOS on Linux (IOL) images to Unetlab including downloading required files, using WinSCP to transfer the files to the Unetlab VM, generating a license, and testing the images. Key steps include using WinSCP to copy IOL image and license files to the VM, running a Python script to generate a license, editing the license file, and testing the images.

Uploaded by

afanbaloch1596
Copyright
© © All Rights Reserved
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
You are on page 1/ 6

Considering you followed the previous Introduction post, we will now add Cisco IOU/IOL image in Unetlab.

We are going to need following tools for this:

1. WinSCP
2. L2 IOL image : i86bi-linux-l2-ipbasek9-15.1g.bin
3. L3 IOL image : i86bi-linux-l3-adventerprisek9-15.4.1T.bin
4. CiscoKeyGen.py

Download these softwares as well as bin files

Steps

1. Install WinSCP and Start it.

File protocol: SFTP


Hostname : Address of your Unetlab VM.
Username : root
Password : unl

WinSCP is used to log into your VM and to copy files from your local machine to Unetlab VM.
2. Move both IOL files from Desktop to Unetlab VM

As shown below, Left side window is your local machine and Right side is the Unetlab VM
On left side navigate to IOL images path.
On right side navigate to /opt/unetlab/addons/iol/bin
Copy both bin files to this location in VM

3. Now we need to fix permissions for newly added bin files.

In Unetlab VM hit the following command

/opt/unetlab/wrappers/unl_wrapper -a fixpermissions
4. We need iourc file(contains license) for our bin files. So here is where python code comes into picture.

Download CiscoKeyGen.py python code, move it into Unetlab VM’s root directory (using WinSCP) and execute it.
As you can see license number is generated starting with “be60*******”
5. Creating license file

Now create new file “iourc” under /opt/unetlab/addons/iol/bin/ path.


Do not use any file extension.
Put following text in iourc file.

[license]
(none) = be60********;

Use license number generated on your VM. In my case be60…..blah blah blah
Here “(none)” is the username of VM.
7- TESTING CISCO IOU/IOL IMAGES

IOU/IOL license is bound to the hostname and domain name. A test should be made to check if IOU/IOL
images can run properly:

cd /opt/unetlab/addons/iol/bin
touch NETMAP
LD_LIBRARY_PATH=/opt/unetlab/addons/iol/lib /opt/unetlab/addons/iol/bin/L3-
ADVENTERPRISEK9_IVS-M-15.3-0.9T.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

If the IOL/IOU instance doen’t start, then you won’t be able to use IOL/IOU nodes inside UNetLab.

6. That is it.
You are ready to go.
Open Unetlab in browser and add a node in Lab.
Select template as Cisco IOL.
As you can see 2 bin images have appeared.
Select L3 image for router.
7. Start the node and click on Router icon to get CLI

Posted in Unetlab.
Post navigation

You might also like