Differenze
Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
| Entrambe le parti precedenti la revisione Revisione precedente Prossima revisione | Revisione precedente | ||
|
gwusermanual:gw_resources_deployer_executable [2021/11/18 12:45] giorgio.scali [Procedura] |
gwusermanual:gw_resources_deployer_executable [2022/11/02 09:16] (versione attuale) giorgio.scali |
||
|---|---|---|---|
| Linea 1: | Linea 1: | ||
| ====== GwResourceDeployer - Eseguibile ====== | ====== GwResourceDeployer - Eseguibile ====== | ||
| - | Questa guida è da intendersi come passo successivo a quello della creazione secondo una struttura convenzionale, trattata [[gwusermanual:gw_resources_deployer_folder_structure|qui]]. | + | ===== Versione 1.2.0 ===== |
| + | |||
| + | === ReleaseNote === | ||
| + | |||
| + | * **issues #801** il deployer non valutava correttamente gli spazi presenti nel path della folder gw_package. La problematica si manifestava nella parte Flyway (FlywayConfigurationProperties) | ||
| + | * **issues #795** eseguendo gwdeploy_prejava9.bat in ambienti con JVM pre java 9, con il nuovo set di librerie 4.6.0, veniva generata l'eccezione: java.lang.NoClassDefFoundError: javax/el/ExpressionFactory | ||
| + | * **issues #589** il deployer utilizza il nuovo set di librerie aggiornate (in comune con geowebframework versione 4.6.0) | ||
| + | |||
| + | 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_2_0|qui]]. | ||
| ===== Procedura ===== | ===== Procedura ===== | ||
| - | * procurarsi la folder //gw_package// e posizionarla al path desiderato. Esempio: <code>C:\gw_package</code> | + | * 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.0.0-bin.zip|gwresourcesdeployer-1.0.0-bin.zip}} e scompattarlo al path desiderato. Ad esempio in:<code>C:\gwResourcesDeployer-1.0.0-bin</code> | + | * scaricare {{custom:gwresourcesdeployer-1.2.0-bin.zip|gwresourcesdeployer-1.2.0-bin.zip}} e scompattarlo al path desiderato. Ad esempio in:<code>C:\gwResourcesDeployer-1.2.0-bin</code> |
| * aprire una console con (in Windows: run => cmd) | * aprire una console con (in Windows: run => cmd) | ||
| - | * posizionarsi al path dell'eseguibile. Esempio: <code>cd C:\gwResourcesDeployer-1.0.0-bin</code> | + | * posizionarsi al path dell'eseguibile. Esempio: <code>cd C:\gwResourcesDeployer-1.2.0-bin</code> |
| - | * eseguire il **gwdeploy.bat** con, **in ordine**, i parametri descritti. Template: <code>gwdeploy.bat [gw_package folder] [spring active profiles]</code>. Ogni parametro va separato dal precedente con uno spazio bianco. Dettaglio dei parametri, in ordine: | + | * 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: |
| - | * **gw_package folder**: 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>**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> |
| - | * **spring active profiles**: gli //Spring active profiles// relativi database. Valori ammessi ['//**oracle**//','//**postgres**//','//**sqlserver**//']. Esempio: <code>postgres</code> Se utilizzato, aggiungere anche il profile '//**workflow**//', separato da virgola ','. Esempio: <code>"postgres,workflow"</code> | + | * <color #22b14c>**spring active profiles**</color>: gli //Spring active profiles// relativi database. Valori ammessi ['//**oracle**//','//**postgres**//','//**sqlserver**//']. Esempio: <code>postgres</code> |
| - | ===== Esempi riga di comando ===== | + | ===== Esempi codice a riga di comando ===== |
| Ecco alcuni esempi di sequenze di comandi da eseguire da riga di comando, in base alle situazioni | Ecco alcuni esempi di sequenze di comandi da eseguire da riga di comando, in base alle situazioni | ||
| Linea 18: | Linea 28: | ||
| * //C:\gwResourcesDeployer// sia il path dell'eseguibile | * //C:\gwResourcesDeployer// sia il path dell'eseguibile | ||
| * //C:\gw_package// sia il path delle risorse | * //C:\gw_package// sia il path delle risorse | ||
| - | * database //postgres//, senza //workflow// | + | * database //postgres// |
| - | <code> | + | <code batch> |
| - | cd C:\gwResourcesDeployer-1.0.0-bin | + | cd C:\gwResourcesDeployer-1.2.0-bin |
| gwdeploy C:\gw_package postgres | gwdeploy C:\gw_package postgres | ||
| </code> | </code> | ||
| Linea 27: | Linea 37: | ||
| * //C:\gwResourcesDeployer// sia il path dell'eseguibile | * //C:\gwResourcesDeployer// sia il path dell'eseguibile | ||
| * //C:\path to\gw_package// sia il path delle risorse | * //C:\path to\gw_package// sia il path delle risorse | ||
| - | * database //oracle//, con//workflow// | + | * database //oracle// |
| - | <code> | + | <code batch> |
| - | cd C:\gwResourcesDeployer-1.0.0-bin | + | cd C:\gwResourcesDeployer-1.2.0-bin |
| - | gwdeploy "C:\path to\gw_package" "oracle,workflow" | + | gwdeploy "C:\path to\gw_package" oracle |
| </code> | </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.2.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> | ||
| + | ------------------------------------------------------------------------------------------------ | ||
| + | 24-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 | ||
| + | ------------------------------------------------------------------------------------------------ | ||
| + | |||
| + | 2021-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> | ||
| + | |||
| + | |||