Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- prodmonitor:start [2022-09-22 16:36] – creata federico
+++ prodmonitor:start [2022-09-22 18:45] (versione attuale) – [Docker] federico
@@ Linea 6: / Linea 6: @@
   * Server fisico virtuale, 8/16 GiB di RAM e 128 GiB di spazio su disco minimo.
+  * [[https://ubuntu.com/download/server|Ubuntu Server]] -- usare la versione LTS più recente [[https://learn.microsoft.com/en-us/sql/linux/quickstart-install-connect-ubuntu?view=sql-server-ver15|supportata da SQL Server per Linux]] di Microsoft nel caso, consigliato, si intenda usare un database riservato sullo stesso server.
+  * Nessun altro servizio sul server che utilizzi le porte TCP/IP 80, 443 e 10000.
+  * Una connessione internet veloce.
+  * Nel caso si voglia esporre i servizi di ProdMonitor sulla rete pubblica, la connessione internet veloce dovrà essere a IP fisso, con almeno un indirizzo disponibile da riservare a questo scopo. La configurazione di rete, gateway, router, firewall eccetera NON è descritta in queste note.
-  * [[https://ubuntu.com/download/server|Ubuntu Server]] -- usare la versione LTS più recente [[https://learn.microsoft.com/en-us/sql/linux/quickstart-install-connect-ubuntu?view=sql-server-ver15|supportata da SQL Server per Linux]] di Microsoft nel caso, consiglato, si intenda usare un database riservato sullo stesso server.
+==== SQL Server ====
-  * Nessun altro servizio sul server che utilizzi le porte TCP/IP 80, 443 e 10000.
+Microsoft SQL Server può essere installato sullo stesso server dove risiede ProdMonitor, oppure su un'altro server della rete locale nel caso sia già presente per qaltri scopi.
+È importante verificare che l'istanza consente l'autenticazione nativa di SQL Server e la connettività via TCP/IP -- queste opzioni non sempre sono attive se configurato su server e reti Windows.
+L'account di amministrazione di SQL Server in caso di autenticazione nativa è tipicamente ''sa''. È bene avere a disposizione la password di accesso di questa utenza, sia che si installi il server //ex-novo// sia che si utilizzi un motore di database esistente.
+Si consiglia di creare un'utenza di accesso per l'uso con ProdMonitor, ad esempio ''pmon'', alla quale si dovranno concedere i permessi di amministrazione dei database. Il nome utente e la password dovranno essere riportati nella configurazione di ProdMonitor.
+Questo può essere fatto utilizzando il linguaggio T-SQL connettendosi al motore come amministratore utilizzando il comando ''SQLCMD'' (oppure SQL Server Management Studio da un PC Windows):
+<code SQL>
+CREATE LOGIN [pmon] WITH PASSWORD 'password-complicata';
+GO
+</code>
+//(nota: per impostazione predefinita, la password deve essere lunga almeno 8 caratteri e deve contenere almeno tre delle seguenti categorie: lettere maiuscole, lettere minuscole, cifre numeriche, simboli)//
+Il passo successivo è creare i due database necessari nel motore (è sufficiente crearli vuoti: ProdMonitor stesso provvederà a creare le tabelle necessarie alla prima connessione):
+<code SQL>
+CREATE DATABASE [identity_db];
+CREATE DATABASE [monitor_db];
+GO
+</code>
+A questo punto, //per ognuno dei due database//, si deve creare l'utenza "di database" collegata all'utenza "di accesso" e concedergli il controllo del database stesso:
+<code SQL>
+USE [identity_db];
+CREATE USER [pmon] FROM LOGIN [pmon];
+GRANT CONTROL TO [pmon]
+GO
+USE [monitor_db];
+CREATE USER [pmon] FROM LOGIN [pmon];
+GRANT CONTROL TO [pmon]
+GO
+</code>
+==== Docker ====
+Sul server dovrà essere installato il software di containerizzazione "docker". È preferibile utilizzare gli strumenti del sistema operativo (''apt'' o ''apt-get''). Le note di installazione sono comunque disponibili sul [[https://docs.docker.com/engine/install/ubuntu/|sito di documentazione di docker stesso]].
+Per poter installare e aggiornare ProdMonitor, dovranno essere fornite a docker le credenziali per accedere al servizio di distribuzione delle "immagini", con accesso -- preferibilmente in sola lettura((è possibile utilizzare uno o più c.d. "token", anche se una soluzione ottimale è ancora allo studio)) -- all'area riservata di Multidata S.r.l.
-  * Nel caso si voglia esporre i servizi di ProdMonitor sulla rete pubblica, una connessione internet veloce con a IP fisso, con almeno un indirizzo disponibile da riservare a questo scopo. La configurazione di rete, gateway, router, firewall eccetera NON è descritto in queste note.
+Potrebbe essere utile installare un front-end web per tenere sotto controllo i containers in esecuzione. Data la semplicità dell'infrastruttura, la [[https://docs.portainer.io/start/install|versione community di Portainer]] dovrebbe essere sufficiente.
+Nel resto della documentazione si assumerà, in ogni caso, che vengano utilizzati i comandi "manuali" per le operazioni richieste.