UNetLab Common Issues


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

Rejohn Ronald Cuares

He is Network Engineer working in one of the Managed Service Providers in Brisbane, Australia. His role as an engineer spans across multiple technologies like Unified Communications, Security, Wireless and Routing/Switching. He loves learning new things that makes his job fun and interesting.

Latest posts by Rejohn Ronald Cuares (see all)

16 comments to UNetLab Common Issues

  • Jack


    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 ..

  • Jack

    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 ..

  • hello

    Hi when I enter the ip address in the web browser, nothing shows up, how can I fix it please?

  • Dude that solution 1 is Godlike. Fixed my ASAv issue.

    keep it up with this list !!!

  • Daniel

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

  • Vgp

    When i right click on a router and select start it errors as:-failed to start(12)

  • 8Th

    Hi Rejohn, these bindings absolutely wondeful.Thank you so much.

  • roger

    Hi Rejohn

    I had the router start / stop issue you made my day. Thanks

  • 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

  • Moha

    Hi Rejohn
    Im not able to telnet via port nomber 32769.
    What will be the reason???

  • Prit

    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.

  • maryam

    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

  • Ethem

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

    “Failed to start node (12)”

    any idea, Plz advise

  • 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

  • Chittaranjan Rout


    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 !!


  • Dei

    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}

Leave a Reply

You can use these HTML tags

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>