User Tools

Site Tools


x64-server

Ubuntu Server x64

Installation

Important: Before proceeding with command-line installation, it is assumed that you are already familiar on how to install an operating system into your machine.

Please follow the steps to build your coin operated wifi hotspot using Ubuntu Server x64:

1. Command Line Installation

Command line installation is used when software image is not available for your board/machine. First, you need to have access to the command line of your board/machine. In this guide, we will use Ubuntu Server 16.04/18.04.

Follow the step by step guide on how to install an Ubuntu server to x64 pc/machine: https://ubuntu.com/tutorials/install-ubuntu-server

Given you already installed the ubuntu server OS, now connect your LAN cable, keyboard, monitor and USB to LAN adapter(optional) to your x64 machine. Then power on your board and login to the command line.

Execute the following commands line by line (much easier if you remote ssh your server and just copy paste the commands):

sudo apt-get update && sudo apt-get upgrade -y

sudo apt-get install curl -y

curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -

sudo apt-get install -y nodejs python nginx bind9 isc-dhcp-server

sudo apt-get install -y hostapd dmidecode build-essential openssh-server python-pip unzip bridge-utils

wget -O adopisoft-4.2.1-amd64-node-v12.18.3.deb https://github.com/AdoPiSoft/Releases/releases/download/4.2.0/adopisoft-4.2.1-amd64-node-v12.18.3.deb

sudo apt-get install ./adopisoft-4.2.1-amd64-node-v12.18.3.deb

Other versions available here: https://github.com/AdoPiSoft/Releases/releases

Now, enable and start adopisoft service

sudo systemctl enable adopisoft
sudo systemctl start adopisoft

Next proceed to Initial Setup section.

2. Initial Setup

Installation Wizard

Find your board/machine's IP address. In your board/machine's screen, just type:

ip addr

On windows, you can install network scanner on your PC to scan for your board/machine's IP.

Once you have identified your board/machine's IP address, open your browser on your PC and type the url to your board/machine's IP address.

Example:

http://192.168.1.123

Setup Account

  1. Type your password
  2. Confirm your password
  3. Click Save Changes button

Select Board

  1. Choose your board/machine type
  2. Click Save Changes

Setup WAN

  1. Select your WAN network interface. The system will automatically recommend the interface connected to your network.
  2. Click Set as WAN Interface button
  3. Configure your WAN interface (Dynamic IP or Static IP). If not sure, check Obtain IP from DHCP server.
  4. Click Save Changes button

Setup LAN

Important: Make sure your board/machine has two network interface. For boards without wifi interface, you have to insert the USB to LAN adapter first.

  1. Choose the network interface for your LAN. It can be the wifi interface (wlan0 or wlpsxxx) or any ethernet interface.
  2. Check Enable Captive Portal
  3. Set alias to LAN Interface or Built-in WiFi (or anything you like)
  4. Uncheck Obtain IP from DCHP server
  5. Set Statc IP Address to 10.0.0.1
  6. Set Network Prefix to 20
  7. Check Use System DNS Server
  8. Check Enable DHCP Server on this interface
  9. Set DHCP Pool Start to 10.0.0.10
  10. Set DHCP Pool End to 10.0.15.254
  11. Click Save Changes button
  12. Click Done or Finish button.

3. Database Settings

Note: The default database used is sqlite because it's the only database that can be package into the debian file. But we highly advice to change the database to postgresql after you have successfully setup the admin.

Run the command below line by line to create postgresql account:

wget -O ado-psql-script.sh https://gist.githubusercontent.com/alenteria/791dbe32175a01d1f1b602b25489ad22/raw/9a5aa879ac70d24bd9a7dd7f8ed97d7fe2c2f597/ado-psql-script.sh 

sudo chmod a+x ./ado-psql-script.sh

sudo ./ado-psql-script.sh

--- if the above command failed, try the following: ---
bash ./ado-psql-script.sh

Then in the admin “Security → Database Connection” settings, change the config to:

Database Type: postgres
Host/IP: localhost
Port Number:
Database Name: adopisoft
Username: adopisoft
Password: adopisoft

Restart machine and go back to “Security → Database Connection” after boot and click “Run migrations”.

IMPORTANT: After the successful setup, update the software to latest version. Go to SystemDevice page and click Check Updates.

4. Setup Payment Portal

For payment portal, you can use any of the following:

x64-server.txt · Last modified: 2020/12/02 09:14 by admin