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 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 (.bin at the end): x86_64_crb_linux_l2-adventerprisek9-ms.bin x86_64_crb_linux-adventerprisek9-ms rename it to (.bin at the end): 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; 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 (.bin at the end): x86_64_crb_linux_l2-adventerprisek9-ms.bin

x86_64_crb_linux-adventerprisek9-ms rename it to (.bin at the end): 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;

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