Lorix One Guide

Supported models¶

As of March 2019, this guide targets the LORIX One model listed at the official LORIX One website.

Download¶

Frequency plan	Download Link
EU 863-870	Download

Notes¶

The gateway is not internet ready by default. This guide will help you connect your gateway to your LAN and to the internet. Once you have internet access on your gateway, you can download the Basestation Client for the gateway.

The first thing to do, is accessing your gateway. The preferred solution is connecting via the serial port over the gateway, but as a cable doesn't come with your package, you might want to connect via SSH instead.

The default IP address of your gateway is 192.168.1.50. Configure your PC to get a static IP address within the following range: 192.168.1.2 - 192.168.1.49. Connect now via SSH to your gateway. If you're on windows the fastest way is probably using Putty. Connect to 192.168.1.50, port 22, default credentials are username: admin password: lorix4u

Now that you're connected via SSH, we're going to manually edit the network configuration of your gateway or you can refer to follow Lorix's guide instead.

Static IP address¶

Skip this part if you want to connect to a DHCP client.

If you want to assign a static IP to your gateway change the address and netmask fields.

sudo nano /etc/network/interfaces

Replace the following:

auto eth0
iface eth0 inet static
address 192.168.1.50
netmask 255.255.255.0
gateway 192.168.1.1
dns-nameservers 192.168.1.1

With:

auto eth0
iface eth0 inet static
address [new_ip]
netmask [network_mask]
gateway [network_router]
dns-nameservers [network_router]

Press CTRL+X, save and reboot. Please note your SSH connection will be lost.

sudo  reboot

After the gateway has rebooted, you can now open an SSH connection to the IP you entered in the configuration file.

DHCP¶

Skip this part if you have already setup a static IP address for your gateway.

If you have a DHCP server over your network you can configure your gateway to obtain an IP address automatically. First backup your network configuration file:

sudo mv /etc/network/interfaces /etc/network/interfaces.back

Then create a new empty configuration file:

sudo nano /etc/network/interfaces

Make it look as the following:

# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

# The loopback interface
auto lo
iface lo inet loopback

# Wired interface
auto eth0
iface eth0 inet dhcp

Press CTRL+X, save and reboot. Please note your SSH connection will be lost.

sudo reboot

After the gateway has rebooted, you have to find out what IP address has been assigned to your gateway. You can go over your router page and see the new device IP or, if you're on windows, you can try to use a third party software to find a new IP owned by the Lorix One on your network.

You can now open an SSH connection to your newly assigned IP.

VPN¶

If you wish to install the OpenVPN Client over your Lorix gateway, run the following commands once connected to the internet:

sudo opkg update
sudo opkg install openvpn

Now create the openvpn configuration folder

sudo mkdir /etc/openvpn

Finally copy your .conf certificate given by ResIOT to the /etc/openvpn folder and finally restart your OpenVPN service:

sudo /etc/init.d/openvpn restart

If everything worked fine, you should now see a 10.8.0.X interface after running the command

sudo ifconfig

Finally, register the openvpn service to start at boot.

sudo update-rc.d openvpn defaults 95 30

From now on, if the ResIOT server is running a OpenVPN server as well, you can connect to 10.8.0.1 instead of its public address when you'll configure the ResIOT Basestation Client.

Installation¶

Download the right version for your gateway and copy the archive to FAT or FAT32 formatted USB flash drive.

The archive is now on your gateway. Head to your Home directory, and extract your archive.

cd /home/admin/
wget https://update.resiot.io/bsclient/resiot-basestation-client-lrxone-EU_863_870.tar.gz
tar -xzvf *.tar.gz
chmod +x ./installer.sh
sudo ./installer.sh

Wait for the setup to finish, if everything went well the gateway should now be running your Basestation Client.

Update¶

If you want to manually upgrade to the latest version, be sure to be connected to the internet, delete any previous downloaded version file and run the following -- making sure you download the correct national version for your gateway:

cd /home/admin/
wget https://update.resiot.io/bsclient/resiot-basestation-client-lrxone-EU_863_870.tar.gz
tar -xzvf *.tar.gz
chmod +x ./update.sh
sudo ./update.sh

Updating

If you're updating a really old version (v9 or less) you're probably going to lose your settings and you will need to reconfigure your client. This won't happen on v9 or later distributions.

Removal¶

Shall you want to uninstall the Client, just run the following command:

sudo opkg remove resiot-basestation-client

Running¶

Your ResIOT™ BaseStation Gateway Client is now installed. Refer to the official ResIOT website for instructions.