########################################################################
Installazione manuale 
########################################################################


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


.. contents:: Contenuti


Configurazione preliminare
==========================================================================================


Installare i package di sistema usati dalla procedura di installazione

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



Installazione manuale
==========================================================================================

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



.. _virtual-env:

Virtual Env
----------------------------------------------

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


.. _upgrade-pip:

Aggiornare PYTHON PIP/SETUPTOOLS 
----------------------------------------------

.. important: la versione di PIP di riferimento e' la 22.1.2. Se non si riesce ad installarla contattate gli sviluppatori!

Aggiornare Pip/setuptools:

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



.. _install-sanet-libsnmp:

sanet-libsnmp
----------------------------------------------

Requirements
~~~~~~~~~~~~~~

Netsnmp tools
++++++++++++++++++


Server NETSNMP:

	::
		
		apt-get install snmp snmpd 

Pacchetti base:

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


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"




.. _install-sanet-common:

sanet-common
----------------------------------------------


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"




















.. _install-sanet-poller:


sanet-poller 
-------------------------------------------------

.. _sanet-poller-requirements:

Requirements
~~~~~~~~~~~~~~~~~~~~~~~~~


Python Curl Library
++++++++++++++++++++

Installazione pacchetti binari

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


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"























.. _install-sanet-entables:

entables 
--------------------------------------------------


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"













Sanet 3 Server
------------------------------------------------------------------------

Requirements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. _install-redis:

Redis
++++++++++++++++++++++++++++++++

Pacchetto Redis:

	::
		
		apt-get install redis-server 



Per configurare corrrettamente redis fare riferimento a :ref:`configuration-redis`.



Postgres
++++++++++++

.. danger:: E' necessario installare postgresql 9 or superiore.


Installare dipendenze moduli:

	::
		
		apt install libpq-dev


Installare il server:

	::
		
		apt-get install postgresql 


RRDTools
++++++++++++++++

Binari:

	::
		
		apt-get install rrdtool librrd-dev



Python Cairo e rSVG
++++++++++++++++++++

Pacchetti binari:

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


Python Image Library (Pillow)
+++++++++++++++++++++++++++++++

Installare librerie binarie di sviluppo:

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














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









Scaricare i sorgenti
~~~~~~~~~~~~~~~~~~~~~~~~~


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


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


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







Configurare il sistema
------------------------------------------

Si rimanda alla sezione :ref:`sanet-system-configuration`. 




Possibili Errori durante l'installazione
------------------------------------------------------------------------

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