====== 1. Procedura per installare l'immagine SolarStretch su RaspberryPi® ======

{{  :img_123s:raspberry.jpg?nolink&400x279  |raspberry.jpg}}

<WRAP box leftt round 200px >

<WRAP centeralign>Rev. 21/05/2018 21.00</WRAP>

</WRAP>

===== 1.1. Premessa =====


Vediamo in questa guida come installare correttamente l'immagine preconfigurata SolarStretch per il monitoraggio energetico con Raspberry.\\ 
L'immagine è basata sulla distribuzione Debian per Raspberry "Stretch lite" e contiene già i software [[http://www.curtronics.com/Solar/AuroraData.html|Aurora]], [[http://123solar.org/|123Solar]] e [[http://www.123solar.org/metern/|MeterN]] oltre ad altri software e utility.\\ 
\\
I vari software necessari per un completo monitoraggio energetico sono quindi già presenti all'interno dell'immagine SolarStretch e, come vedremo nelle successive guide, sarà possibile abilitarli o disabilitarli a seconda delle necessità.\\ 
\\
Per creare l'immagine è necessario utilizzare:

  * [[http://sourceforge.net/projects/win32diskimager/|win32diskimager]]
  * [[http://www.7-zip.org/|7-zip]]

Ovviamente potete usare i software che preferite ma questi sono quelli che personalmente utilizzo per clonare l'immagine e ripristinarla.

Le password impostate di default sono:

//**Raspberry**  //

  * User = pi
  * password = raspberry

  * User = root
  * password = raspberry

//**123Solar**  //

  * User = admin
  * password = admin

//**MeterN**  //

  * User = admin
  * password = admin

//**Web menù Solastretch**  //
  * password = 123456

si consiglia di modificarle immediatamente appena installata l'immagine come di seguito indicato.

===== 1.2. Preparare la SD card =====

<WRAP center round info 100%>
Potete trovare le varie versioni dell'immagine SolarStretch nel [[http://www.flanesi.it/listing/SolarStretch/|Repository]]\\ 
Questo il [[http://www.flanesi.it/listing/SolarStretch/Changelog.txt|Changelog]] delle varie versioni.
</WRAP>


  * Decomprimere l'immagine scaricata utilizzando 7-zip sul vostro PC
  * Inserire una SD card (__minimo 8 GB classe 10__) in un lettore di schede del PC
  * Scrivere l'immagine sulla SD card usando:
      * per Windows ⇒ [[https://sourceforge.net/projects/win32diskimager/|win32diskimager]]
      * per Linux ⇒ Gdiskdump

se serve aiuto consultare:
  * [[http://elinux.org/RPi_Easy_SD_Card_Setup|RPi_Easy_SD_Card_Setup]]
  * [[http://www.vemp.org/raspberrypi/preparare-una-card-sd-con-raspbian/|Raspberry Pi: preparare una card SD con il sistema operativo]]

==== 1.2.1 Preparazione SD card - Windows ====

{{page>sd_preparazione}}

===== 1.3. Setup iniziale del sistema operativo nel rpy =====

Il sistema operativo è già settato di default per la localizzazione italiana e con un overclock "Moderate" quindi non richiede nessuna impostazione.

Per iniziare basta quindi:

  * Inserire la scheda nello slot del RPI
  * Alimentare il RPI

Nel caso usiate una SD di capacità superiore o vogliate modificare qualche parametro come:

  * Espandere la partizione a tutta la SD per utilizzare tutta la capacità della card (se intendete fare una SD con installazione pulita per poi fare un'immagine da copiare su altre SD meglio non fare questa operazione per rendere l'immagine compatibile con più tagli di SD, espandere comunque la partizione subito dopo aver salvato l'immagine per avere più spazio a disposizione)
  * Modificare le impostazioni locali
  * Modificare l'overclok​

Digitare:

<code>
sudo raspi-config
</code>

Effettuate tutte le configurazioni e al termine riavviate il Raspberry con il comando:

<code>
sudo shutdown -r now
</code>

===== 1.4. Aggiornamento del sistema =====

A seconda di quanto tempo è trascorso dalla creazione dell'immagine, potrebbe essere necessario effettuare un aggiornamento del sistema. In tal caso prima di procedere è meglio eseguire un aggiornamento altrimenti potete saltare i passaggi successivi e passare alla configurazione di base.

==== 1.4.1. Aggiornamento firmware ====

Per eseguire l'aggiornamento del firmware digitare in sequenza i seguenti comandi, attendere che ogni comando finisca l'elaborazione controllando che il sistema non risponda con degli errori

<code>
sudo -s
cd /..
​rpi-update
shutdown -r now
</code>

==== 1.4.2. Aggiornamento della distribuzione ====

Per eseguire l'aggiornamento della distribuzione digitare in sequenza i seguenti comandi

<code>
sudo -s
apt-get update
apt-get upgrade
apt-get dist-upgrade
apt-get autoremove
apt-get purge
apt-get clean
</code>

riavviare il sistema per rendere attive le modifiche

<code>
sudo shutdown -r now
</code>

===== 1.5. Configurazione di base =====

==== 1.5.1. Modifica delle password del raspberry ====

=== Utente pi ===


Digitare il seguente codice e controllare che tutte le operazioni vadano a buon fine senza errori

<code>
sudo -s
cd /..
raspi-config
</code>

Selezionare la voce n° 2 "Change User Password", vi verrà chiesto di inserire una nuova password e per sicurezza di digitarla di nuovo (quando digitate le password il testo sarà invisibile), al termine uscire

=== Utente root ===

Sull'immagine [[solarStretch|SolarStretch]] risulta abilitato di default anche l'utente root.\\
**E' pertanto ASSOLUTAMENTE INDISPENSABILE modificare la password di default**

<code>
sudo passwd
</code>
e digitare di seguito due volte la nuova password per l'utente root.

==== 1.5.2. Modificare la password di 123solar ====

Per modificare la password di 123Solar procedere nel seguente modo:

<code>
sudo -s
cd /var/www/123solar/config
htpasswd -c .htpasswd admin
</code>

Verrà chiesto di digitare la nuova password e di ridigitarla per sicurezza

<WRAP info round>

Chi non usa 123Solar può disabilitare l'avvio automatico che risulta abilitato di default, disabilitando 123Solar dalla pagina di amministrazione e digitando quanto segue:

<code>
sudo -s
cd /..
systemctl disable 123solar
</code>

</WRAP>

==== 1.5.3. Modificare la password di MeterN ====

Per modificare la password di MeterN procedere nel seguente modo:

<code>
sudo -s
cd /var/www/metern/config
htpasswd -c .htpasswd admin
</code>

Verrà chiesto di digitare la nuova password e di ridigitarla per sicurezza

<WRAP info round>

Chi non usa MeterN può disabilitare l'avvio automatico che risulta abilitato di default, disabilitando MeterN dalla pagina di amministrazione e digitando quanto segue:

<code>
sudo -s
cd /..
systemctl disable metern
</code>

</WRAP>

==== 1.5.4. Configurare PHP ====

Passiamo ora a configurare php, per far cio si dovranno modificare alcuni parametri nel filephp.ini

<code>
sudo-s
nano /etc/php/7.0/apache2/php.ini
</code>

Si apre il file in modifica, scorrere fino ai settori evidenziati e modificare con i vostri dati le due righe evidenziate:

<box 100% round #ffff99 #d2d2d2 #d2d2d2 #ffff99| file: php.ini>

<nowiki>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;</nowiki> \\ Module Settings \\ ​<nowiki>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;</nowiki> \\ <nowiki>;</nowiki> \\ <nowiki>;</nowiki> \\ <nowiki>;</nowiki> \\ date.default_latitude= xx.xxxx <wrap indent>#(la vostra latitudine)</wrap> \\ date.default_longitude=yy.yyyy <wrap indent>#(la vostra longitudine)</wrap> \\ <nowiki>;</nowiki>

</box | ctrl+O per salvare e ctrl+X per uscire>

Riavviare il web server

<code>
service apache2 restart
</code>

==== 1.5.5. Configurare il programma per invio posta ====

editare il file di configurazione

<code>
sudo -s
cd /etc
nano msmtprc
</code>

modificare quindi le righe relative al vostro account (righe: user,password e from) con i vostri dati:

<box 100% round #ffff99 #d2d2d2 #d2d2d2 #ffff99 | file: msmtprc> \\ # Impostazioni account

 \\ defaults \\ tls on \\ tls_starttls on \\ tls_trust_file /etc/ssl/certs/ca-certificates.crt

account default \\ host smtp.gmail.com \\ port 587 \\ auth on \\ user youraccount@gmail.com \\ password password \\ from youraccount@gmail.com \\ #logfile /var/log/msmtp.log \\ ​</box | ctrl+O per salvare e ctrl+X per uscire>

<WRAP center round important>
Per poter utilizzare questo servizio di invio posta tramite Gmail è NECESSARIO abilitare sul vostro account Gmail l'**accesso alle App meno sicure**. [[https://support.google.com/accounts/answer/6010255?hl=it|QUI]] potete trovare una guida a come abilitarlo.
</WRAP>


Testare l'invio digitando sulla finestra del terminale il seguente comando:

<code>
cd /..
echo -e “Subject: Test Mail\r\n\r\nThis is a test mail” |msmtp --from=default -t username@gmail.com
</code>

Fare attenzione a ciò che viene restituito sulla riga di comando, eventuali errori vengono segnalati, se non appare nulla significa che l'invio è andato a buon fine

==== 1.5.6. Configurare 123solar ====

Aprite un browser su un pc della stessa rete e digitate <WRAP centeralign> [[http://192.168.x.xx/123solar/admin/|http://192.168.x.xx/123solar/admin/]] </WRAP> verrà chiesto il login a cui risponderete con admin e password che avete scelto in precedenza, si aprirà il menù di configurazione di 123solar. {{  :img_123s:admin_1.6.7.3.png?nolink&500x345  }}

potete ora configurare a piacere.
<WRAP center round info 80%>
Per approfondimenti in merito cliccate [[123solar#configurazione_con_immagine_solarstretch|QUI]]
</WRAP>


==== 1.5.7. Configurare MeterN ====

Aprite un browser su un pc della stessa rete e digitate

<WRAP centeralign> [[http://192.168.x.xx/123solar/admin/|http://192.168.x.xx/metern/admin/]] </WRAP>

verrà chiesto il login a cui risponderete con admin e password che avete scelto in precedenza, si aprirà il menù di configurazione di MeterN. {{  :img_metern:metern_admin.png?nolink&500x360  }}

potete ora configurare a piacere.
<WRAP center round info 80%>
Per approfondimenti in merito cliccate [[metern|QUI]]
</WRAP>