Versions this guide is based on:

Recommended IOL image versions:

Note: The older IOL versions might not work. Avoid using IOL L3 15.5.2T (it has serious freeze console bug after some time of running)

Type	EVE Image Name	Version	NVRAM	RAM
L2/L3 Switch	i86bi_linux_l2-adventerprisek9-ms.SSA.high_iron_20190423.bin	Cisco IOS Software, Linux Software (I86BI_LINUXL2-ADVENTERPRISEK9-M), Version 15.2(CML_NIGHTLY_20190423)	1024	1024
L2/L3 Switch	i86bi_LinuxL2-AdvEnterpriseK9-M_152_May_2018.bin	Cisco IOS Software, Linux Software (I86BI_LINUXL2-ADVENTERPRISEK9-M), Version 15.2(CML_NIG HTLY_20180510)FLO_DSGS7	1024	1024
L3 router	i86bi_LinuxL3-AdvEnterpriseK9-M2_157_3_May_2018.bin	Cisco IOS Software, Linux Software (I86BI_LINUX-ADVENTERPRISEK9-M), Version 15.7(3)M2, Compiled Wed 28-Mar-18 11:18 by prod_rel_team	1024	1024
L3 Router	L3-ADVENTERPRISEK9-M-15.4-2T.bin	Cisco IOS Software, Linux Software (I86BI_LINUX-ADVENTERPRISEK9-M), Version 15.4(2)T4, Compiled Thu 08-Oct-15 21:21 by prod_rel_team	1024	1024
L3 XE Router	x86_64_crb_linux-adventerprisek9-ms.bin	IOL XE Router Cisco IOS Software [Dublin], Linux Software (X86_64BI_LINUX-ADVENTERPRISEK9-M), Version 17.12.1, RELEASE SOFTWARE (fc5)	1024	1024
L2/L3 XE Switch	x86_64_crb_linux_l2-adventerprisek9-ms.bin	IOL XE Switch Cisco IOS Software [Dublin], Linux Software (X86_64BI_LINUX_L2-ADVENTERPRISEK9-M), Ve rsion 17.12.1, RELEASE SOFTWARE (fc5)	1024	1024

Instructions
The newest IOL XE IOS from 2024 original filename does not have extension .bin which is required for EVE-NG. Simply rename your original IOL XE image, adding extension .bin and it is ready to upload in the EVE. x86_64_crb_linux_l2-adventerprisek9-ms rename it to: x86_64_crb_linux_l2-adventerprisek9-ms.bin x86_64_crb_linux-adventerprisek9-ms rename it to: x86_64_crb_linux-adventerprisek9-ms.bin 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 IOL images must end with the “.bin” extension and must be executable. EVE-NG Pro has not required to generate iourc license. License must be stored under the same path. IOU/IOL license is bound to the hostname and domain name of the server. A test should be made to check if IOU/IOL images can run properly. Google for how to create iourc license file. Bellow is an EXAMPLE how it should look like: cat /opt/unetlab/addons/iol/bin/iourc [license] unl01 = 0123456789abcdef; Testing Cisco IOU/IOL Images: 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 If the IOL/IOU instance doesn’t start, then you won’t be able to use IOL/IOU nodes inside EVE.

Instructions

The newest IOL XE IOS from 2024 original filename does not have extension .bin which is required for EVE-NG. Simply rename your original IOL XE image, adding extension .bin and it is ready to upload in the EVE.

x86_64_crb_linux_l2-adventerprisek9-ms rename it to: x86_64_crb_linux_l2-adventerprisek9-ms.bin

x86_64_crb_linux-adventerprisek9-ms rename it to: x86_64_crb_linux-adventerprisek9-ms.bin

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

IOL images must end with the “.bin” extension and must be executable. EVE-NG Pro has not required to generate iourc license.

License must be stored under the same path. IOU/IOL license is bound to the hostname and domain name of the server. A test should be made to check if IOU/IOL images can run properly.

Google for how to create iourc license file. Bellow is an EXAMPLE how it should look like:

cat /opt/unetlab/addons/iol/bin/iourc
[license]
unl01 = 0123456789abcdef;

Testing Cisco IOU/IOL Images:

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

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