1.2. Configurare

1.2.1. Configurazioni preliminari

1.2.1.1. BIN tools

Assicurarsi che la directory "bin" di SANET sia nel vostro PATH.

Configurazione a livello di /etc/profile.d

cat >> /etc/profile.d/sanet.sh <<ENDOFFILE
PATH=$PATH:/usr/local/sanet/bin
ENDOFFILE
export PATH=$PATH:/usr/local/sanet/bin

1.2.1.2. Configurare Redis Server

Le impostazioni di default di Redis non richiedono variazioni.

1.2.1.3. Configurare gli RRDTOOLS

Il pacchetto base di RRDTools non richiede configurazioni particolari.

1.2.2. Configurazione di Sanet

1.2.2.1. Creare il database

Creare un utente (role) sanet e un database sanet3:

# Impersoniamo utente postgres
su postgres

# Creiamo il DB
cat /usr/local/sanet/install/create_db.sql | psql

# usciamo dalla sessione con utente postgres (torniamo root)
exit

1.2.2.2. Creare il file di configurazione

Il file di configurazione di Sanet puo' essere creato manualmente utilizzando il file "di default" fornito con l'installazione:

cd /usr/local/sanet

cd conf

cp settings.py.dist settings.py

Nota

Se si sta usando un database personalizzato, bisogna modificare il file in modo che i parametri di accesso al database siano coerenti con l'installazione:

DATABASES = {
    'default': {
        'ENGINE': DEFAULT_DATABASE_BACKEND,

        'HOST'    : 'localhost',
        'PORT'    : '5432',

        'NAME'    : 'sanet3',                <------------ modificare
        'USER'    : 'sanet',                 <------------ modificare
        'PASSWORD': 'sanet',                 <------------ modificare
    }
}

1.2.2.3. Inizializzazione del sistema

Inizializzare il database:

cd /usr/local/sanet

sanet-manage sanetdata

La procedura chiedera' due cose:

  • Password dell'utente "admin" per accedere via web.

    • NOTA: E' possibile cambiarla anche in seguito.

  • Il nome (codice) del "tenant" principale.

    • Per iniziare specificate come codice: "site"

Se si commettono errori si puo' rilanciare il comando piu' volte.

Al termine di questa procedura il database e le directory di Sanet dovrebbero essere state create correttamente.

Verificare:

echo "show info" | sanet-cli

1.2.3. Configurazioni finali

1.2.3.1. Netsnmp

Avvertimento

Questa configurazione e' puramente dimostrativa e non dovrebbe essere applicata in ambienti di produzione

Configurare Snmpd:

echo "rocommunity public" > /etc/snmp/snmpd.conf

Riavviare il servizio:

systemctl restart snmpd

Verificare che l'agente SNMPD risponda:

snmpget -v 1 -c public localhost 1.3.6.1.2.1.1.1.0

1.2.3.2. Apache2

1.2.3.2.1. Installazione moduli

Installare il modulo di apache WSGI:

apt-get install libapache2-mod-wsgi-py3

Abilitare il modulo:

a2enmod wsgi
a2enmod ssl

Nota

Il modulo puo' essere abilitato anche manualmente:

cd /etc/apache2/mods-enabled
ln -s ../mods-available/wsgi.* .

1.2.3.2.2. Configurare il virtual host di apache

Configurazione da aggiungere ad Apache all'interno del virtualhost desiderato:

cp  /usr/local/sanet/etc/apache2/sites-available/sanet.conf.dist  etc/apache2/sites-available/sanet.conf

Aggiungere al file:

/etc/apache2/sites-available/default-ssl.conf

Dentro la sezione del virtualhost la riga:

# SANET: interfaccia web
Include  /usr/local/sanet/etc/apache2/sites-available/sanet.conf

Esempio di default-ssl.conf:

<IfModule mod_ssl.c>
        <VirtualHost _default_:443>
                ...
                ...
                # SANET: interfaccia web
                Include /usr/local/sanet/etc/apache2/sites-available/sanet.conf
                ...
                ...
                ...
        </VirtualHost>
</IfModule>

Abilitare il site SSL:

a2ensite default-ssl

apache2ctl restart

1.2.3.3. Crontab

Nella directory di sanet trovate un file di configurazione per crontab gia' pronto per essere utilizzato:

cd /usr/local/sanet

cp etc/cron.d/sanet3.dist /etc/cron.d/sanet3

Avvertimento

Controllate le variabili d'ambiente impostate all'interno del file ed assicuratevi che siano compatibili con la vostra installazione.

1.2.4. Setup basic di test

Importazione template di base:

cat share/library/10-xform/xform-interface.cli | sanet-cli -c
cat share/library/20-datagroup/01-library.it           | sanet-cli -c -l
cat share/library/20-datagroup/12-library-interface.it | sanet-cli -c -l
cat share/library/20-datagroup/08-library-storage.it   | sanet-cli -c -l

Configurazione nodo localhost

cat | sanet-cli -c -T <<EOF

node localhost

    datagroup icmp-reachability
    exit

    datagroup cpu-hr
    exit

    interface eth0 distinguisher enp0s3 xform ifname

        datagroup iface-status
        exit

        datagroup iface-traffic
        exit

    exit

    storage root distinguisher / xform storagedescr

        datagroup storage
        exit

    exit
exit


# Configurazione per "taggare" il nodo nella tag/cartella "Global"
tagtree geo
        tag Global
                node localhost
                exit
        exit
exit


EOF

Avvio di Sanet:

/usr/local/sanet/scripts/server/sanet3.sh start