Skip to main content

Basic ITOSS Installation on Ubuntu Server 22.04 LTS"

This basic installation guide covers all essential functions installed on one server, intended for demonstrations, testing, or small environments with up to 100 managed components (orientative number for standard operation).

This guide includes the installation of the following functions and/or software packages:

  • Database - Postgresql 14 + Timescale 2.15
  • Web Server - Nginx
  • ITOSS Manager
  • ITOSS Collector
  • ITOSS Reporting

Hardware Requirements​

The minimum hardware requirements to run all central functions of ITOSS on a virtual server are:

  • 4 CPUs
  • 8 GB RAM
  • 50 GB of disk space.

Operating System​

This guide is oriented and tested on Ubuntu Server 22.04 LTS, a dedicated server for ITOSS on a clean installation is recommended.

Previous Steps​

Installation of Postgres + TimeScaleDB​

Follow the vendor instructions for an updated installation, the following instructions may not be updated: https://docs.timescale.com/self-hosted/latest/install/installation-linux/

  1. At the command prompt, as root, add the PostgreSQL third party repository to get the latest PostgreSQL packages:
sudo apt install gnupg postgresql-common apt-transport-https lsb-release wget
  1. Run the PostgreSQL repository setup script:
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh
  1. Add the TimescaleDB third party repository:
sudo echo "deb https://packagecloud.io/timescale/timescaledb/ubuntu/ $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/timescaledb.list
  1. Install TimescaleDB GPG key
sudo wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg
  1. Update your local repository list:
sudo apt update
  1. Install TimescaleDB:
sudo apt-get install timescaledb-2-postgresql-14
  1. Tunning Timescaledb:
sudo timescaledb-tune --yes
  1. In the file /etc/postgresql/14/main/pg_hba.conf edit the line:
local all all peer

Replace "peer" with "trust"

  1. Restart the postgresql service:
sudo systemctl restart postgresql

Installation WEB Server (NGINX)​

For more information: https://nginx.org/en/linux_packages.html#Ubuntu

  1. Install required packages
sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
  1. Import nginx official key
sudo curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
  1. Verify key (optional)
sudo gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
  1. Configure stable version repository.
sudo echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" | sudo tee /etc/apt/sources.list.d/nginx.list
  1. Configure nginx package priority
sudo echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" | sudo tee /etc/apt/preferences.d/99nginx
  1. Install nginx
sudo apt update
sudo apt install nginx

ITOSS Installation and Configuration​

Installing ITOSS​

Follow these steps as root:

  1. Download the software to the "/" directory

Go to Resources

  1. Unzip the itoss-v7.tar.gz archive
cd /
tar xvf itoss-v7.tar.gz
  1. Configure nginx
sudo cp -rf /app/setup/default.conf /etc/nginx/conf.d/default.conf 2>/dev/null
sudo systemctl enable nginx
sudo systemctl start nginx
  1. Create the database and load the initial data.
sudo su - postgres
psql
CREATE USER itoss WITH PASSWORD 'admin';
CREATE DATABASE itossdb;
\c itossdb;
ALTER DATABASE itossdb OWNER TO itoss;
ALTER SCHEMA public OWNER TO itoss;
CREATE EXTENSION IF NOT EXISTS timescaledb;
SELECT timescaledb_pre_restore();
\q
psql -d itossdb -f /app/setup/itossdb-initial.sql
psql
\c itossdb
SELECT timescaledb_post_restore();
\q
  1. Create ITOSS services and start the application
sudo cp /app/setup/*.service /etc/systemd/system/
sudo systemctl enable itoss-manager.service
sudo systemctl enable itoss-collector.service
sudo systemctl enable itoss-reporting.service
sudo systemctl start itoss-manager
sudo systemctl start itoss-collector.service
sudo systemctl start itoss-reporting.service