At line 1 added 114 lines |
%%(display:none) |
{{{ |
WikiUp |
}}} |
/% |
[{TableOfContents }]\\ |
!!! Installazione di WebUP standalone con Sme.UP Provider\\ |
\\ |
NOTA: Si fa presente che la nuova e consigliata modalità di installazione di webup è tramite smartkit-web. Richiedere l'apposita documentazione a riguardo.\\ |
\\ |
L'installazione di WebUP standalone con Sme.UP Provider 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|MBDOC-LOCBAS_SPI]\\ |
\\ |
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:\\ |
[|MBDOC-WEBASE_07]\\ |
\\ |
\\ |
!!! 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:\\ |
[|MBDOC-WEBASE_012]\\ |
\\ |
- 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]\\ |
\\ |
[{Image src='immagini/MBDOC-WEBASE_01/WEBASE_001.png' caption='' width='100%' style='max-width: 100%;'}]\\ |
!!! 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:\\ |
# È preferibile creare un utente dedicato (es. payara)\\ |
# Installare Java JDK1.8 (è possibile anche puntare ad un'installazione jdk dedicata, qualora si vogliano far coesistere più installazioni jdk.)\\ |
# Decomprimere l'archivio (unzip o tar -xzvf) di payara.zip/tar.gz in una folder del server con permessi di lettura/scrittura.\\ |
# 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\\ |
# Una volta avviato l'interprete dei comandi, è possibile conoscere la versione dell'application server digitando la keyword: __version__\\ |
# 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.\\ |
\\ |
\\ |