Differenze

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

@@ Linea 1: / Linea 1: @@
+====== GwResourceDeployer - Eseguibile ======
+===== Versione 1.5.0 =====
+=== ReleaseNote ===
+  * **issue #2** il deployer Keycloak ora dispiega tutti i client il cui file .json è presente nella folder **gw_package/keycloak** (in precedenza veniva gestito un solo client tramite la property //keycloak.clientRepresentationFile//, ora rimossa). Vedi la sezione [[gwUserManual:gw_resources_deployer_folder_structure_1_5_0#folder keycloak|Folder keycloak]] della guida alla struttura risorse per i dettagli.
+Si tratta di un eseguibile a riga di comando, che prende in ingresso dei parametri
+Questa guida è da intendersi come passo successivo a alla procedura di setting-up delle risorse da dispiegare, trattata [[gwUserManual:gw_resources_deployer_folder_structure_1_5_0|qui]].
+===== Procedura =====
+  * procurarsi la folder //gw_package//, contenente le risorse da dispiegare, e posizionarla al path desiderato. Esempio: <code>C:\gw_package</code>
+  * scaricare {{custom:gwresourcesdeployer-1.5.0-bin.zip|gwresourcesdeployer-1.5.0-bin.zip}} e scompattarlo al path desiderato. Ad esempio in:<code>C:\gwResourcesDeployer-1.5.0-bin</code>
+  * aprire una console con (in Windows: run => cmd)
+  * posizionarsi al path dell'eseguibile. Esempio: <code>cd C:\gwResourcesDeployer-1.5.0-bin</code>
+  * eseguire il <color #22b14c>**gwdeploy.bat**</color> con, **in ordine**, i parametri descritti. Template: <code batch>gwdeploy [gw_package folder] [spring active profiles]</code>. Ogni parametro va separato dal precedente con uno spazio bianco. Dettaglio dei parametri, in ordine:
+    * <color #22b14c>**gw_package folder**</color>: path alla //folder gw_package//. Esempio: <code>C:\gw_package</code>Se il path contiene //spazi bianchi//, racchiudere tutto fra doppi apici. Esempio: <code>"C:\path to\gw_package"</code>
+    * <color #22b14c>**spring active profiles**</color>: gli //Spring active profiles// relativi database. Valori ammessi ['//**oracle**//','//**postgres**//','//**sqlserver**//']. Esempio: <code>postgres</code>
+===== Esempi codice a riga di comando =====
+Ecco alcuni esempi di sequenze di comandi da eseguire da riga di comando, in base alle situazioni
+Esempio 1, assunto che:
+  * //C:\gwResourcesDeployer// sia il path dell'eseguibile
+  * //C:\gw_package// sia il path delle risorse
+  * database //postgres//
+<code batch>
+cd C:\gwResourcesDeployer-1.5.0-bin
+gwdeploy C:\gw_package postgres
+</code>
+Esempio 2, assunto che:
+  * //C:\gwResourcesDeployer// sia il path dell'eseguibile
+  * //C:\path to\gw_package// sia il path delle risorse
+  * database //oracle//
+<code batch>
+cd C:\gwResourcesDeployer-1.5.0-bin
+gwdeploy "C:\path to\gw_package" oracle
+</code>
+===== Note =====
+==== Sistemi con JVM precedente alla Java 9 ====
+Per questi sistemi bisogna utilizzare il **gwdeploy_prejava9.bat** specifico disponibile dentro l'archivio dell'eseguibile.
+=== Note ===
+Naturalmente bisogna modificare coerentemente il comando da lanciare.
+Esempio JVM precedente alla Java 9, assunto che:
+  * //C:\gwResourcesDeployer// sia il path dell'eseguibile
+  * //C:\path to\gw_package// sia il path delle risorse
+  * database //oracle//
+<code batch>
+cd C:\gwResourcesDeployer-1.5.0-bin
+gwdeploy_prejava9 "C:\path to\gw_package" oracle
+</code>
+==== Mapguide ====
+Ci sono meccanismi noti, che **consigliano fortemente di far girare l'eseguibile dalla stessa macchina di installazione dell'applicativo**:
+  * l'eseguibile fallisce se eseguito da macchine che non hanno l'opportuna configurazione di sistema (.dll mapguide in classPath e variabile di sistema impostata). Tipicamente, nelle macchine predisposte dai sistemisti per il rilascio, dove è previsto MapGuide, tali configurazioni iniziali sono sempre già state fatte al momento del deploy delle risorse. Si potrebbe però far girare l'eseguibile dalla propria macchina la folder //gw_package// disponibile come percorso di rete. In questo caso, in mancanza della configurazione, può essere generato l'errore in fase di dispiegamento:<code batch>
+------------------------------------------------------------------------------------------------
+-11-2021 18:09:35,483 [main] GEOWEB INFO
+GwDeployer - deployMapguideResources()
+Adjusting path with file name..
+adjusted path: I:\projects\CDE35\gw_package\mapguide\webconfig.ini
+Configured path refers to an existing file
+Initializing MapGuide with the file: I:\projects\CDE35\gw_package\mapguide\webconfig.ini
+------------------------------------------------------------------------------------------------
+-11-24 18:09:35.612 ERROR 9556 --- [           main] o.s.boot.SpringApplication               : Application run failed
+java.lang.UnsatisfiedLinkError: no MapGuideJavaApi in java.library.path
+        at java.lang.ClassLoader.loadLibrary(Unknown Source) ~[na:1.8.0_281]
+        at java.lang.Runtime.loadLibrary0(Unknown Source) ~[na:1.8.0_281]
+        at java.lang.System.loadLibrary(Unknown Source) ~[na:1.8.0_281]
+        at org.osgeo.mapguide.MapGuideJavaApiJNI.<clinit>(MapGuideJavaApiJNI.java:2957) ~[mapguide-3.1.1.9378.jar:na]
+        at org.osgeo.mapguide.MapGuideJavaApi.MgInitializeWebTier(MapGuideJavaApi.java:14) ~[mapguide-3.1.1.9378.jar:na]
+        at com.geowebframework.gwResourcesDeployer.service.MapguideDeployerService.deploy(MapguideDeployerService.java:260) ~[gwResourcesDeployer-1.2.0.jar:1.2.0]
+        at com.geowebframework.gwResourcesDeployer.GwDeployer.deployMapguideResources(GwDeployer.java:277) [gwResourcesDeployer-1.2.0.jar:1.2.0]
+        at com.geowebframework.gwResourcesDeployer.GwDeployer.run(GwDeployer.java:138) [gwResourcesDeployer-1.2.0.jar:1.2.0]
+        at org.springframework.boot.SpringApplication.callRunner(SpringApplication.java:819) [spring-boot-2.4.5.jar:2.4.5]
+        at org.springframework.boot.SpringApplication.callRunners(SpringApplication.java:803) [spring-boot-2.4.5.jar:2.4.5]
+        at org.springframework.boot.SpringApplication.run(SpringApplication.java:346) [spring-boot-2.4.5.jar:2.4.5]
+        at org.springframework.boot.SpringApplication.run(SpringApplication.java:1340) [spring-boot-2.4.5.jar:2.4.5]
+        at org.springframework.boot.SpringApplication.run(SpringApplication.java:1329) [spring-boot-2.4.5.jar:2.4.5]
+        at com.geowebframework.gwResourcesDeployer.GwDeployer.main(GwDeployer.java:94) [gwResourcesDeployer-1.2.0.jar:1.2.0]
+</code>