Introduction

Note: These steps can be dangerous and should only be followed if explicitly requested by a member of the TetherX support team.

This process allows performing operating-system-level changes to your unit and should not be required under normal circumstances. Following these steps risks potentially damaging the firmware of the TetherBox, which can only be repaired by returning the unit back to TetherX.

Gaining Emergency Login

1. Reboot the TetherBox

2. Keep pressing the down arrow on your keyboard until will see the "GRUB" menu

GRUB menu

3. Press the down arrow on your keyboard to highlight "Advanced options" followed by the "enter" key. You will see the following sub-menu:

4. Press the down arrow on your keyboard once more to highlight a row that contains the words "recovery mode", press "enter" to select it.

5. After booting the system, you will see a window listing the recovery mode options.

6. Using the arrows on your keyboard, select the option root (Drop to root shell prompt), press "enter" to select it

7. At the bottom of the screen, an inscription will appear asking you for a password (Give root password for maintenance).

Note: Write to TetherX Support Team and provide the serial number of the box so that we can send you this password. This password is unique for every unit.

8. You are now in the terminal.

Manually Connecting to the Network

Introduction:

Once you are logged into the unit, you will be able to make certain manual changes. For example, forcing it to connect to the network.

Try to ping your router:

If you see this message then your device does not have an IP address assigned.

If you see 100% packet loss, then your device has an IP address but is on different networks with your router.

If you see such a message and all packets have been received, then this means that your device has an IP address and is on the same network as the router.

Warning: All examples use the enp0s3 interface, but your interface may differ from this. Please replace the enp0s3 interface in all commands with yours.

Warning: The examples use IP addresses and their ranges, which may be different from yours. You should replace the IP addresses and their masks with those available on your network.

Please make any changes carefully.

How to get an IP address from a DHCP server

1. An example when the interface does not have an IP address:

To find out which interface your device is using, enter the ifconfig command.

You will see several interfaces, select the one that should be used as the main interface for Internet access (This is usually the first interface).

2. To get an IP address from your DHCP server:

Enter the dhclient -v enp0s3 command to have your device send a request to your DHCP server for an IP address.

Note: Usually, the DHCP server is a router, make sure the router is turned on and working and the TetherBox is connected.

3. TetherBox got IP address from DHCP server:

Now you can see the inet line and the IP address that was assigned to your unit in the interface information. To view this information, use the ifconfig command.

Note: If the unit was unable to obtain an IP address from your DHCP server for some reason, you can still try to configure it manually. Please contact support so we can help you with the configuring.

How to set a manual IP if needed

1. Assigning an IP address to an interface manually:

Enter the command:
ifconfig enp0s3 192.168.2.70 netmask 255.255.255.0 up
to assign an IP address and subnet mask to the interface.

Enter the command:
route add default gw 192.168.2.1
to set the default gateway.

Note: Replace the interface in the example with the one you see in your unit. Also, replace the IP address, gateway and subnet mask with those available on your network.

2. Set up a DNS server for internet access:

Enter the command:
echo "nameserver 8.8.8.8" > /etc/resolv.conf

to set up Google DNS Server.

Enter the command:
cat /etc/resolv.conf

to check your resolv.conf file (It should have the "nameserver 8.8.8.8" line that we just added).

Check ifconfig:

How to set a Static IP

1. Use vi /etc/netplan/enp0s3.yaml to open interface config file:

2. You'll see the standard config. Example:

3. Using the arrows on the keyboard, you can navigate the text file, to enter the editing mode, press Insert (-- INSERT -- will appear at the bottom). Press Esc to exit edit mode.

4. Edit the config as follows:

5. Save the changes by pressing Esc, then put the double character ":" and write "wq":

6. Apply new configuration

Enter the command:
netplan try
to check your edited config file. If you see that everything is working well and the timer is running press "Enter" to accept the changes.

Note: If the command was executed with an error and the timer was not started, then you made a mistake in the configuration file.

The information that is displayed after the command will point you to the place of the error:

Correct the mistake and try again.

How to check if the unit gets IP and access the Internet

Use ifconfig for check that the TetherBox has an IP address:

Use ping -c4 google.com for check that the TetherBox has access to the Internet:

All packages must be received and 0% packet loss.

If you are not able to bring the unit online, please fill in the form on our support page providing screenshots of the above for a member of our support team to assist further.

Did this answer your question?