| 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.\\ |
| \\ |
| \\ |
