Tested on server Ubuntu 22 LTS and routers OpenWRT .
Table of Contents
Hahatay has an internal network set up to provide internet connectivity to the different project locations. Hahatay's intranet is a complex OpenWRT network, which distributes internet to both project workers and external parties.
OpenWisp is used to better manage the network in a centralised and more organised way. This repository focuses on the installation and configuration of this management layer.
To install openwisp in the server, the steps indicated in the documentation have been followed. It is installed by an ansible playbook.
Have an Ubuntu OS with
- 2 CPUs
- 2048 MB Memory
- 50 GB Disk space
In the local machine that you are run ansible, install the recommended packages from the official documentation. Follow the Install Ansible and Install this role sections.
Create a directory in your local machine to clone this repository.
Eg.
mkdir ~/openwisp-project
cd ~/openwisp-project
git clone https://github.com/aucoop/openwisp-hahatay.git
Go to openwisp2-ansible-playbook folder in the repository.
- playbook - used to define all the tasks to install Openwisp, Openwisp2-radius, openwisp2-network-topology and openwisp-monitoring (installed by default)
- hosts - in this file we have the hostname where the OpenWisp will be reachable.
- install - script that launch the command to deploy the playbook
In order to indicate to the network which is the IP of the openwisp hostname, we can use two options:
-
DNS Server: this is the easiest option if you have a DNS Server running in your network. The IP address of the server where you are going to deploy Openwisp has to be added to the DNS Server to reach the given hostname.
-
Individual device configuration: Otherwise, the IP address of the hostname has to be indicated to the local machine that will run the ansible playbook. Also in the future when adding a device (router) to openwisp, you will have to manually add the hostname IP. To do that, you have to access
/etc/hostsand add the following information:
Eg.
192.168.8.142 openwisp2.mydomain.com
Now, you are ready to run the install.sh file.
sh install.sh
If everything goes well, all the task has to be finished sucessfully and you can reach openwisp in the hostname given. The initial credentials to access Openwisp are admin for user and password.