Troubleshooting

Here are some tips on how to resolve any problems that might arise.

antHill activation - Can't find antsle

Here is a series of videos for trouble shooting anthill activation.

1. Basic connectivity

Are you plugged into the correct ethernet port? The default ethernet port is 'br0' and is the only port enabled when new out of the box.

2. antHill, enter SN# and password

The SN# can be found on the bottom of your antsle.

3. Verify the root password



4. Check anthilld service and internet connectivity

Cannot access myantsle.local from a browser

Power LED off
Please check if the power adapter is firmly plugged into antsle's DC power connector and that the power button has been pressed to turn your antsle on.
myantsle.local gives DNS error
If using Windows to access antman: Please install iTunes. See why.
myantsle.local gives google search results instead of antman
Make sure you use http://myantsle.local, including the leading http://. Please delete all browser caches!
Cannot connect to the antsle using myantsle.local
It is possible you’re not in the same subnet as the antsle, or you’re using a device without mDNS support (most likely Windows without iTunes See why.).
Try using port 3000

http://myantsle.local:3000

or using the IP address of the antsle, if you know it. Substitute your IP address in the following example

http://192.168.1.10:3000

You can also try modifying your local hosts file

I cannot SSH into my antsle

I don't know how to ssh from my Mac or Linux machine.
Simply start a termial window. On macOS, you can use Terminal.app. Then, type ssh root@myantsle.local. Use the default password (antsle) when prompted for the password.
I don't know how to ssh from my Windows PC.
Install an ssh client on your PC, such as PuTTY or MobaXterm. Then, start a new ssh session, enter myantsle.local as the host, root as the user name and antsle as the password. You can leave the port at the default setting (22).

I cannot access my antlets

http://antlet10.local does not show the antlet.

You first need to install something in your antlet, e.g. Apache. See FreedomCasts.com

Some antlets can take considerable time to start up, especially KVM antlets. So please wait a few minutes and try again.

I cannot SSH into my antlet.

Please make sure you've started the antlet and it is shown as Running in antman. Some antlets can take considerable time to start up, especially KVM antlets. So please wait a few minutes and try again.

Try to SSH into antsle first, and from there into your antlet.

Please make sure you're using the correct port number.

If you have configured a virtual NIC on an antlet, using 'ssh -p 22xxx...' no longer works. This is a known issue. The good news is ssh will work directly to the IP address configured on the virtual NIC.

I get a 502 Bad Gateway error when connecting to an antlet?
If you are trying to connect to an antlet according to the instructions in 'Access antlets Locally' e.g. http://antlet10.local , you must have some web server software installed and running on that antlet.

Importing VM files error

Wrong number of args (0) passed to: core/juxt
This error will occur if you delete all the templates from 'Manage templates'
Getting error: Server responded with 0 code
If running antsleOS version below 0.4.0 and antman 0.7.0, there is a 16GB limitation if you use http://myantsle.local URL.
Look up your Private IP in antman, say it is 192.168.0.103. Then navigate to http://192.168.0.103:3000 to access antman. With that URL, you should be able to import templates bigger than 16GB.

antlets will not start

Error: Requested operation is not valid: network 'bblv' is not active.
Try to start the 'bblv' network from the antlse's command line:

virsh net-start bblv

If you get an error referencing 'tun', run the following command:

echo 'modules="tun"' >> /etc/conf.d/modules

Reboot.
You can check the status of the internal networks with:

virsh net-list --all

All the networks listed should be active

Vnc Console

Mouse cursor not in sync with the display

If the antlet was running during the last upgrade, then you just need to Stop->Wait->Start the antlet; please note that clicking Reboot will not suffice, as it would just trigger Operating System level reboot and it won't reload any changes done on the domain definition.

There are many issues with IE, not recommended.

You can also try clearing your browser cache.

If the antlet was imported you may need to make a change to the xml definition
First ssh to the antsle and run:

EDITOR=nano virsh edit ANTLET_NAME

and add:

<input type='tablet' bus='usb'></input>

Before the </devices> tag near the bottom.

Ethernet port layout and names

antsle one, antsle one Pro, antsle one Ultra

antsle one ethernet port numbers
Ethernet portBridge nameInterface nameSpeed
Port 0br0enp0s20f010M/100M/1G
Port 1br1enp0s20f110M/100M/1G
Port 2br2enp0s20f210M/100M/1G
Port 3br3enp0s20f310M/100M/1G



antsle one XD, antsle one XD Pro, antsle one XD Ultra

antsle one XD ethernet port numbers
Ethernet portBridge nameInterface nameSpeed
Port 0br0eno110M/100M/1G
Port 1br1eno210M/100M/1G
Port 2br2eno31G/10G
Port 3br3eno41G/10G



antsle one XD

antsle one XD ethernet port numbers
Ethernet portBridge nameInterface nameSpeed
Port 0br0eno31G/10G
Port 1br1eno41G/10G

Hosts file

Modifying the local 'hosts' file can be useful for testing nginx domain name forwarding or if your machine is not working well with mDNS (resolving myantsle.local).

The 'hosts' file on your local machine works like a local DNS. Your local machine will first check the local 'hosts' file to resolve a URL before making a DNS request. If the URL is found in the local 'hosts' file the IP address configured will be used and no DNS request will be made.

You can manually enter IP address to host name mappings in this file.

10.0.103.42     x.mycompany.com                     # company db server
192.168.1.74    ulab.mycompany.com     ulab         # test server
192.168.1.253   router2.mycompany.com  router2  r2  # internal router
192.168.1.4     myantsle.local         myantsle     # antsle
192.168.1.4     myantlet.com           myantlet     # antlet on antsle

The first column contains the IP address of the host.
The second column contains the primary host name.
The following columns are aliases.
Anything following a '#' sign on a line is ignored (a comment).

On Windows, right click the icon to lauch NotePad and choose 'Run as Administrator'. Then open and edit the 'hosts' file which is located in

C:\Windows\System32\Drivers\etc\hosts

On Mac open a terminal and run nano with elevated privileges

sudo nano /private/etc/hosts

On Linux open a terminal and use nano or vi with elevated privileges

sudo nano /etc/hosts

In case you have any questions or comments, please email us. Don’t hesitate, we’re friendly.