.. _sanet-system-configuration:


##########################################################################################
Configurare
##########################################################################################

.. contents:: Contenuti




Configurazioni preliminari
==========================================================================================


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
        



.. _configuration-redis:

Configurare Redis Server
-----------------------------------------------------------------------------------------------

Le impostazioni di default di Redis non richiedono variazioni.



.. _configuration-rrdtools:

Configurare gli RRDTOOLS
-----------------------------------------------------------------------------------------------

Il pacchetto base di RRDTools non richiede configurazioni particolari.


Configurazione di Sanet
==========================================================================================

.. _configuration-postgres:

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


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


.. note:: 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
		    }
		}


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


Configurare il log del tenant
------------------------------------------------------


Configurazioni finali
=============================================================================================

Netsnmp
--------------------------------------------------

.. warning:: 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


Apache2
--------------------------------------------------

Installazione moduli
~~~~~~~~~~~~~~~~~~~~~~~~~

Installare il modulo di apache WSGI: 

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

Abilitare il modulo: 

	::
		
		a2enmod wsgi
		a2enmod ssl

.. note:: Il modulo puo' essere abilitato anche manualmente:
	::
		
		cd /etc/apache2/mods-enabled
		ln -s ../mods-available/wsgi.* .


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
     


















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

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





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