UNetLab Common Issues

Posted by

These are the common issues I encountered in setting up UNetLab and how I fixed these issues. I’m sharing this so UNetLab users will benefit from it. I will constantly update this list as I progress.

Issue 1: UNetLab is complaining about – Neither intel VT-X or AMD-V found.
Solution: Find the .vmx file for the UNetLab and add this line at the end.

vhv.enable = "TRUE".

Issue 2: After UNetLab install, running apt-get update and apt-get upgrade won’t update the UNetLab package.
Solution: I had to force update using these commands.

apt-get update
apt-get -o Dpkg::Options::="--force-overwrite" install unetlab unetlab-qemu

Issue 3: Image not showing on the UNetLab web interface.
Solution: Should follow folder naming convention.

Below is the reference node in UNetLab, file path is /opt/unetlab/html/includes/init.php.

                'a10'                   =>      'A10 vThunder',
                'clearpass'             =>      'Aruba ClearPass',
                'timos'                 =>      'Alcatel 7750 SR',
                'veos'                  =>      'Arista vEOS',
                'brocadevadx'   =>      'Brocade vADX',
                'cpsg'                  =>      'CheckPoint Security Gateway VE',
                'acs'                   =>      'Cisco ACS',
                'asa'                   =>      'Cisco ASA',
                'asav'                  =>      'Cisco ASAv',
                'cda'                   =>      'Cisco Context Directory Agent',
                'csr1000v'              =>      'Cisco CSR 1000V',
                'cips'                  =>      'Cisco IPS',
                'ise'                   =>      'Cisco ISE',
                'c1710'                 =>      'Cisco IOS 1710 (Dynamips)',
                'c3725'                 =>      'Cisco IOS 3725 (Dynamips)',
                'c7200'                 =>      'Cisco IOS 7206VXR (Dynamips)',
                'iol'                   =>      'Cisco IOL',
                'titanium'              =>      'Cisco NX-OSv (Titanium)',
                'sourcefire'    =>      'Cisco Sourcefire',
                'vios'                  =>      'Cisco vIOS',
                'viosl2'                =>      'Cisco vIOS L2',
                'vnam'                  =>      'Cisco vNAM',
                'vwlc'                  =>      'Cisco vWLC',
                //'vwaas'               =>      'Cisco vWAAS',
                'coeus'                 =>      'Cisco Web Security Appliance',
                'xrv'                   =>      'Cisco XRv',
                'nsvpx'                 =>      'Citrix Netscaler',
                'cumulus'               =>      'Cumulus VX',
                'extremexos'    =>      'ExtremeXOS',
                'bigip'                 =>      'F5 BIG-IP LTM VE',
                'fortinet'              =>      'Fortinet FortiGate',
                'hpvsr'                 =>      'HP VSR1000',
                'olive'                 =>      'Juniper Olive',
                'vmx'                   =>      'Juniper vMX',
                'vsrx'                  =>      'Juniper vSRX',
                'linux'                 =>      'Linux',
                'mikrotik'              =>      'MikroTik RouterOS',
                'ostinato'              =>      'Ostinato',
                'paloalto'              =>      'Palo Alto VM-100 Firewall',
                'vyos'                  =>      'VyOS',
                //'esxi'                =>      'VMware ESXi',
                'win'                   =>      'Windows'

For example, if you are adding a new ASAv image then the folder should start with asav.

Issue 4: How to add users in UNetLab.

Install sqlite.

apt-get update
apt-get install sqlite

Open the UNetLab sqlite database, file path is /opt/unetlab/data/database.sdb.

sqlite> .open database.sdb
sqlite> .databases
seq  name             file                                                      
---  ---------------  ----------------------------------------------------------
0    main             /opt/unetlab/data/database.sdb            
sqlite> .tables
pods   users
sqlite> INSERT INTO users (username, password) VALUES ("newadmin1","5bb73905f7fc00b2d5510785f625003a95d35f7d8ce423abf7ba3528be43ff2d");

Note that the password string is SHA256 hash. Search over the internet for SHA256 hash generator.

Issue 5: vIOS/ASAv and any other VMs will not start.
Solution: Make sure nested virtualisation is supported otherwise VMs wont start. Refer to solution for issue 1.

Issue 6: IOU/IOL device starts but after few seconds stops. From the wrapper logs, I received these errors.

1:1 ERR: Operation not permitted (5).
1:1 ERR: Operation not permitted (5).
1:1 ERR: Operation not permitted (5).
1:1 ERR: Operation not permitted (5).
1:1 ERR: No such file or directory (2).
1:1 ERR: Cannot open AF_UNIX sockets (2).
1:1 ERR: failed to create AF_UNIX socket file (2).
1:1 ERR: child is no more running.

Solution: Make sure /tmp directory has proper permissions. If not, apply the following commands.

chmod 777 /tmp
chmod g+t /tmp


  1. Hi,

    Am getting Issue 1 – the solution is Find the .vmx file for the UNetLab and add this line at the end. vhv.enable = “TRUE”

    I have lab called Test.unf but I can’t find any file with *.vmx can please elborate .. do I have to create this file

    I also search for *.vmx (i.e. find / -type -f -name “*.vmx” and I can’t seem this file can please elaborate ..

  2. Please ignore my request, I found my problem I was using a virtualbox suppose to be using vmware 9 above which support nested VT-VT ..

  3. I already tried to use solution at issue 6. But i still facing the same issue.
    Any one can help me?

  4. Nice blog right here! Additionally your site a lot up very
    fast! What web host are you using? Can I
    get your affiliate hyperlink to your host? I want my web site loaded up
    as quickly as yours lol

  5. I also tried solution 6 but still facing same issue. Router starts and stops within seconds. Please help what else could be done to fix this issue.

  6. hi , i have a problem with my unetlab it has delay forexample when i create new lab it doesnt create it aftar many times logout it creats … what should i do? plz help me

  7. Hi!
    IOL images won’t start up and keep receiving this error.

    “Failed to start node (12)”

    any idea, Plz advise

  8. Hi All,

    i am facing the issue 6. gave the full permission to /tem folder.

    but still i face the issue

    #the command which i used gave permission.

    chmod 777 /tmp
    chmod g+t /tmp

  9. Hi,

    I’m facing issue related nodes (like Cisco IOU devices and NXOS) start and stop immediately and console not coming.

    I have done all the troubleshooting fix this issue but failed. is there anyone to help me out.

    Much appreciated in advance !!


  10. I am facing this error (Slim Application Error )anytime I try to start a node.

    0 /opt/unetlab/html/includes/api_nodes.php(832): Slim\Slim::handleErrors(8, ‘Undefined offse…’, ‘/opt/unetlab/ht…’, 832, Array)
    #1 /opt/unetlab/html/api.php(669): apiStartLabNode(Object(Lab), ‘2’, ‘0’)
    #2 [internal function]: {closure}(Array)
    #3 /opt/unetlab/html/includes/Slim/Route.php(468): call_user_func_array(Object(Closure), Array)
    #4 /opt/unetlab/html/includes/Slim/Slim.php(1357): Slim\Route->dispatch()
    #5 /opt/unetlab/html/includes/Slim/Middleware/Flash.php(85): Slim\Slim->call()
    #6 /opt/unetlab/html/includes/Slim/Middleware/MethodOverride.php(92): Slim\Middleware\Flash->call()
    #7 /opt/unetlab/html/includes/Slim/Middleware/PrettyExceptions.php(67): Slim\Middleware\MethodOverride->call()
    #8 /opt/unetlab/html/includes/Slim/Slim.php(1302): Slim\Middleware\PrettyExceptions->call()
    #9 /opt/unetlab/html/api.php(1585): Slim\Slim->run()
    #10 {main}

  11. Any one able to find the solution around devices getting stopped after few seconds, I tried step 6 but it didn’t work for me.

  12. Hi to all.
    I have the same issue. iol nodes starts and then stops after few seconds. I tried all the steps but no effect. Anyone faced this issue please help me to resolve this issue.


  13. i’m not able to ping palo alto ip. palo alto is added in eve ng. i have assigned an ip to palo alto from the range of my laptop. please help me

  14. Guys! IOL start and stop, fixed that issued.
    follow below one

    cd /opt/unetlab/addons/iol/bin
    touch NETMAP
    LD_LIBRARY_PATH=/opt/unetlab/addons/iol/lib /opt/unetlab/addons/iol/bin/ 1

  15. man, this blog is fire!!! thank you.

    I had issue 6. I tried the chmod 777 /tmp and chmod g+t /tmp. still didn’t work
    I had to edit my .vmx file to get my ASAv device to work

    so yeah, of you have issue 6, use both solution 1 and 6

  16. Have you applied the IOL license.
    Use eve-ng community version.?
    If above is Yes go for step 1.


Leave a Reply

Your email address will not be published. Required fields are marked *