1.1. Installazione manuale

Avvertimento

La procedura descritta in questa pagina e' stata testata su Debian 12 Bullseye.

Contenuti

• Installazione manuale

  • Configurazione preliminare

  • Installazione manuale

    • Scaricare i sorgenti

    • Virtual Env

    • Aggiornare PYTHON PIP/SETUPTOOLS

    • sanet-libsnmp

      • Requirements

        • Netsnmp tools

      • Installazione

    • sanet-common

      • Installazione

    • sanet-poller

      • Requirements

        • Python Curl Library

      • Install

    • entables

      • Install

    • Sanet 3 Server

      • Requirements

        • Redis

        • Postgres

        • RRDTools

        • Python Cairo e rSVG

        • Python Image Library (Pillow)

        • Apache Server

      • Scaricare i sorgenti

      • Verificare e installare le dipendenze

    • Configurare il sistema

    • Possibili Errori durante l'installazione

      • Postgress

1.1.1. Configurazione preliminare

Installare i package di sistema usati dalla procedura di installazione

apt-get install python3 python3-dev  python3-venv subversion git unzip tar

1.1.2. Installazione manuale

1.1.2.1. Scaricare i sorgenti

Creare la directory dove posizionare i sorgenti:

cd /usr/local/src/

wget https://sanet.labs.it/download/sanet3-ose.tar.gz

tar -xzvf sanet3-ose.tar.gz

mv sanet3-ose sanet-src

1.1.2.2. Virtual Env

# Creazione VIRTUALENV
cd /usr/local/
python3 -m venv sanet-env

1.1.2.3. Aggiornare PYTHON PIP/SETUPTOOLS

Aggiornare Pip/setuptools:

# Aggiornamento pacchetti base del virtualenv
source sanet-env/bin/activate
pip install --upgrade pip==22.1.2 setuptools wheel
deactivate

1.1.2.4. sanet-libsnmp

1.1.2.4.1. Requirements

1.1.2.4.1.1. Netsnmp tools

Server NETSNMP:

apt-get install snmp snmpd

Pacchetti base:

# Installazione librerie di sviluppo
apt-get install git gcc python3-dev libsnmp-dev

1.1.2.4.2. Installazione

Scaricament sorgenti:

# Attivazione virtualenv
source /usr/local/sanet-env/bin/activate

# Posizionarsi nella directory dei sorgenti
cd /usr/local/src/sanet-src
cd sanet-libsnmp

Installazione

pip install . -r requirements.txt

# Disattivazione
deactivate

Per verificare l'installazione:

/usr/local/sanet-env/bin/python3 -c 'import sanet_libsnmp' && echo "OK"

1.1.2.5. sanet-common

1.1.2.5.1. Installazione

Scaricare i sorgenti:

source /usr/local/sanet-env/bin/activate

# Posizionarsi nella directory dei sorgenti
cd /usr/local/src/sanet-src/sanet-common

Installare:

# Instalazione dipendenze
pip install -r requirements.txt

# Installazione pacchetto
pip install .

deactivate

Per verificare l'installazione:

/usr/local/sanet-env/bin/python3 -c 'import sanet_common' && echo "OK"

1.1.2.6. sanet-poller

1.1.2.6.1. Requirements

1.1.2.6.1.1. Python Curl Library

Installazione pacchetti binari

apt-get install libcurl4-gnutls-dev libgnutls28-dev

1.1.2.6.2. Install

Scaricare i sorgenti:

source /usr/local/sanet-env/bin/activate

cd /usr/local/src/sanet-src/sanet-poller

Installare:

pip install -r requirements.txt

pip install .

deactivate

Per verificare l'installazione:

/usr/local/sanet-env/bin/python3 -c 'import sanet_poller' && echo "OK"

1.1.2.7. entables

1.1.2.7.1. Install

Scaricare i sogenti:

source /usr/local/sanet-env/bin/activate

cd /usr/local/src/sanet-src/entables

Installare:

pip install -r requirements.txt

pip install .

deactivate

Per verificare l'installazione:

/usr/local/sanet-env/bin/python3 -c 'import entables' && echo "OK"

1.1.2.8. Sanet 3 Server

1.1.2.8.1. Requirements

1.1.2.8.1.1. Redis

Pacchetto Redis:

apt-get install redis-server

Per configurare corrrettamente redis fare riferimento a Configurare Redis Server.

1.1.2.8.1.2. Postgres

Pericolo

E' necessario installare postgresql 9 or superiore.

Installare dipendenze moduli:

apt install libpq-dev

Installare il server:

apt-get install postgresql

1.1.2.8.1.3. RRDTools

Binari:

apt-get install rrdtool librrd-dev

1.1.2.8.1.4. Python Cairo e rSVG

Pacchetti binari:

apt-get install libcairo2-dev
apt-get install libvips42

1.1.2.8.1.5. Python Image Library (Pillow)

Installare librerie binarie di sviluppo:

# necessaria per il corretto supporto di pillow
apt-get install libpng-dev libjpeg-dev

1.1.2.8.1.6. Apache Server

SANET needs Apache 2.x with mod_wsgi installed, and has been tested in mpm mode (not in prefork mode).

apt-get install apache2 libapache2-mod-wsgi-py3

Enable modules:

a2enmod wsgi
a2enmod ssl

systemctl restart apache2

1.1.2.8.2. Scaricare i sorgenti

ln -s /usr/local/src/sanet-src/sanet  /usr/local/sanet

1.1.2.8.3. Verificare e installare le dipendenze

Procedere nell'installazione lanciando i seguenti comandi:

source /usr/local/sanet-env/bin/activate

cd /usr/local/src/sanet-src/sanet

Installazione dipendenze:

pip install -r ./install/requirements.txt

deactivate

Avvertimento

questa procedura potrebbe non completare con successo se alcuni moduli python richiedono librerie di tool/sviluppo necessarie ma che il sistema non riesce ad installare (generando poi errori di compilazione/installazione).

1.1.2.9. Configurare il sistema

Si rimanda alla sezione Configurare.

1.1.2.10. Possibili Errori durante l'installazione

1.1.2.10.1. Postgress

Durante l'installazione si e' verificato il seguente errore:

Setting up postgresql-9.1 (9.1.9-1) ...
Error: The locale requested by the environment is invalid.
Error: could not create default cluster. Please create it manually with

Per risolvere ho dato il comando:

pg_createcluster  9.1  main  --start