WikiUp

Installazione di WebUP


L'installazione di WebUP si riassume in tre attività principali:

1 - Installazione/configurazione software di terze parti (contesto: Application server, Windows/Linux, Java)

2 - Installazione/configurazione software SmeUP (contesto: SmeUP Provider)

Per tale installazione si rimanda a:
Sme.UP Provider: Set and play

3 - Configurazione connessione/login (contesto: WebUP / SmeUP ERP / Windows / Linux)

Allo stato attuale WebUP può essere installato su macchine Windows o Linux, SmeUP Provider invece solo su macchine Windows.
E' possibile far coesistere installazioni WebUP e SmeUP Provider sulla medesima macchina o su due macchine differenti (e/o con diversi sistemi OS).
Dati i benefici della scalabilità è utile virtualizzare le macchine.

Prima dell'installazione, verificare con il committente tutti i requisiti. Nel documento seguente è riportata la checklist da verificare:



Requisiti minimi software


- Java JDK1.8 a 64bit
E' scaricabile dal sito della Oracle.
https://www.oracle.com/java
La versione a 32 bit può usare al massimo 1024Mb di ram, pertanto può essere utilizzata solamente in ambito di test o con pochissime connessioni (meno di 5). In un ambiente di produzione la mancanza di memoria porta a crash dell'applicazione.
E' possibile effettuare un'installazione standalone della jvm nel caso non si voglia utilizzare la jvm di sistema. Per effettuare questa operazione si rimanda al documento:


- Application Server Payara 5.2021.9
Dalla versione 1.18.7 WebUP è stato reso compatibile con Payara 5.2, in particolare con la versione 5.2021.9 di novembre 2021.
Le versioni di WebUP precedenti alla 1.18.7 richiedono invece una versione di Payara meno recente (in questi casi è consigliato l'Application Server Payara alla versione 4.1.1.171).
La versione 1.18.7 e successive rimangono comunque installabili sulla versione di riferimento delle precedenti (4.1.1.171), ma si consiglia l'installazione su Payara Server 5.2021.9.
Payara Server è scaricabile dal sito di Payara.
http://www.payara.fish

- WebUP all'ultima versione
Viene distribuito in un unico file "war", reperibile tramite il sito istituzionale, sezione download SmeUP ERP.
https://www.smeup.com/download/download-sme-erp

- SmeUP Provider all'ultima versione
E' reperibile tramite il sito istituzionale, sezione download SmeUP ERP.
https://www.smeup.com/download/download-sme-erp


Requisiti minimi server


- Windows Server 2012 / Ubuntu Server 14.04.2 LTS
- CPU Quad core
- 4GB RAM
- 40GB HDD

Le risorse di cui sopra variano in funzione all'utilizzo del server, quindi è consigliabile virtualizzare per usufruire dei vantagggi della scalabilità.

N.B: Per ovvie ragioni, se si opta per l'opzione Windows, è fortemente sconsigliato l'utilizzo di un os che non sia una release "server".

Incompatibilità note


E' stata rilevata un'incompatiblità di Glassfish 3.x e 4.1 con WebUP1.8.8. Il problema non sussiste invece con Glassfish 4.1.1.
Web.UP fino alla versione 1.16.7 potrebbe presentare dei problemi di visualizzazione del componente LAB utilizzando Payara Micro. Resta comunque fortemente consigliato l'utilizzo di Payara Server.
La versione 4.1.1.162 non e' compatibile con le funzionalita' di WebUP che si appoggiano ai servizi google.

Esempio di procedura di installazione dell'Application Server Payara (linux o windows)


Per la procedura aggiornata e per tutti i dettagli (ad esempio configurazione https) consultare il sito di payara:
http://www.payara.fish

Riportiamo un esempio di procedura di installazione da noi testata:
  1. È preferibile creare un utente dedicato (es. payara)
  2. Installare Java JDK1.8 (è possibile anche puntare ad un'installazione jdk dedicata, qualora si vogliano far coesistere più installazioni jdk.)
  3. Decomprimere l'archivio (unzip o tar -xzvf) di payara.zip/tar.gz in una folder del server con permessi di lettura/scrittura.
  4. Avviare Payara da riga comandi (prompt msdos / shell linux) mediante il comando: c:\Users\payara\.....\glassfish\bin\asadmin.bat oppure /home/payara/....../glassfish/bin/./asadmin.sh
  5. Una volta avviato l'interprete dei comandi, è possibile conoscere la versione dell'application server digitando la keyword: version
  6. Per avviare l'Application Server è sufficiente inserire il comando start-domain nell'interprete di comandi di payara
A questo punto dal browser si può verificare che l'Application Server sia attivo semplicemente puntando l'url: http://localhost:8080 e verificando che il server risponda running.
L'interfaccia grafica per la configurazione dello stesso risponde all'url: http://localhost:4848.
Anche mediante l'interfaccia grafica, posizionandosi sulla voce "server" del menu principale di sinistra, è possibile conoscere la versione dell'Application Server.

Ai fini di facilitare eventuali interventi da remoto, è utile abilitare un servizio ssh.

N.B: il default d'installazione di Payara prevede che l'interfaccia grafica sia disabilitata per gli accessi da remoto (cioè che non arrivino da "localhost").

Si rimanda alle documentazioni online di Payara e di Windows/Linux/Oracle relativamente a:
- ottimizzazioni (thread, memoria...)
- abilitazioni di funzionalità (cambio porte, accessi da remoto...)
- installazione servizi, avvii/spegnimenti schedulati
- modifica del jdk di default...

N.B: il default d'installazione di Payara prevede che la memoria allocata sia di 512MB, e che java sia avviato in modalità "client". E' bene quindi effettuare un tuning dell'application server per ottimizzarne le performance.
E' indispensabile configurare almeno i seguenti parametri (dipendenti dalle caratteristiche del server:
- parametro -server (di default è -client)
- memoria allocata all'avvio (parametro -Xms....m ) indicativamente 2GB, quindi -Xms2048m.
- memoria massima utilizzata (parametro -Xmx....m ) indicativamente 4GB, quindi -Xmx4096m.
I parametri di cui sopra sono configurabili accedendo alla console d'amministrazione tramite browser su porta 4848 (es. http://localhost:4848), nella sezione Configurations -> server-config -> JVM Settings.
Ovviamente la documentazione ufficiale di Payara rimane la più aggiornata ed esaustiva.

Deploy di WebUP


La vera e propria installazione di WebUP avviene mediante l'attività denominata "deploy", effettuata tramite Payara mediante interfaccia grafica, raggiungendo col browser l'indirizzo http://localhost:4848 e selezionando la voce "Applicazioni" e poi "deploy", selezionando l'opportuno file "war".

Avvio di WebUP


Se l'installazione (deploy) è andata a buon fine, puntando ad http://localhost:8080/<nome_contesto> si dovrà verificare che l'application server risponda con la pagina di login di WebUP.

Configurazione di WebUP


E' possibile configurare tramite interfaccia grafica una serie di proprietà globali dell'applicazione, così come le diverse modalità di connessione/autenticazione (moduli di login).

_h_N.B.
la configurazione dell'applicazione (file configuration.properties) ed i parametri di login (<nomemodoulo>.properties) vengono memorizzati su archivi di testo presenti sul server d'installazione all'indirizzario:
root/etc/webup/<nome_contesto> con root = directory utente. (es: c:\Users\payara\etc\webup\WebUP )


Configurazione dei Login

Web.UP supporta diverse modalità di login contemporaneamente, nella stessa applicazione.
E' possibile entrare in più ambienti e utilizzare diverse modalità di qualificazione. Per dettagli vedere:
Moduli di login

Configurazione di custom settings

Web.UP permette una grande libertà di personalizzazione a livello grafico e di configurazione a livello tecnico.
L'accesso ai settaggi è fornito dalla form Main Config (nel medesimo contesto dei moduli di login).

Add new attachment

Only authorized users are allowed to upload new attachments.
«