Installation

This section outlines how to install and do basic configuration of infoset-ng.

Dependencies

infoset-ng has the following requirements:

  • python >= 3.5
  • python3-pip
  • MySQL >= 5.7 OR MariaDB >= 10.0

It will not work with lower versions.

Ubuntu / Debian / Mint

The commands for installing the dependencies are:

$ sudo apt-get -y install python3 python3-pip python3-dev memcached

Select either of these commands to install MySQL server or MariaDB server

$ sudo apt-get -y install mysql-server
$ sudo apt-get -y install mariadb-server

Centos / Fedora

The commands for installing the dependencies are:

$ sudo dnf -y install python3 python3-pip python3-dev memcached

Select either of these commands to install MySQL server or MariaDB server

$ sudo dnf -y install mysql-server
$ sudo dnf -y install mariadb-server

Installation

Installation is simple. There are three basic steps.

  1. Clone the Repository
  2. Setup the Database
  3. Run the Installation Script

This will now be explained in more detail.

Clone the Repository

Now clone the repository and copy the sample configuration file to its final location.

$ git clone https://github.com/PalisadoesFoundation/infoset-ng
$ cd infoset-ng

Setup the Database

Next create the MySQL or MariaDB database. Make sure the database server is running.

$ mysql -u root -p
password:
mysql> create database infoset_ng;
mysql> grant all privileges on infoset_ng.* to infoset_ng@"localhost" identified by 'PASSWORD';
mysql> flush privileges;
mysql> exit;

Note Remember the value you select for PASSWORD. It will be required when you edit the infoset-ng configuration file later.

Run Installation Script

Run the installation script. There are two alternatives:

Installing as a regular user

There are some things to keep in mind when installing switchmap-ng as a regular user.

  1. Use this method if you don’t have root access to your system.
  2. The switchmap-ng daemons will not automatically restart on reboot using this method.

To make switchmap-ng run with your username, then execute this command:

$ maintenance/install.py

Installing as the “root” user

There are some things to keep in mind when installing switchmap-ng as the root user.

  1. The switchmap-ng daemons will automatically restart on reboot using this installation method.
  2. Note: Do not run setup using sudo. Use sudo to become the root user first.

To install switchmap-ng as the root user execute this command:

# maintenance/install.py

Next Steps

It is now time to review the various configuration options.