gwusermanual:configuration_4_6_x [GeowebFramework]

Di seguito vengono riportati dei templates di esempio relativi al lato client, che andranno opportunamente riconfigurati per la propria installazione. Occorre quindi tenere conto della struttura, ma revisionare tutti i singoli contenuti.

configuration.properties

#*****************************************************************
#                          C L I E N T   
#       C O N F I G U R A T I O N   P R O P E R T I E S     
#                       T E M P L A T E
#
# in order to configure you application, has to be changed the 
# sections between '<' and '>' characters
#*****************************************************************
 
 
##################################################################
#	L A N G
##################################################################
#force the Locale (2 char format). The default is the environment's one
lang=it
 
 
##################################################################
#    P L A T F O R M      A N D      M O D U L E
##################################################################
codPlatform=
codModule=
 
##################################################################
#	B A S E P A T H
##################################################################
basePath=file:///C:/Projects/<projectStaticFolder>/WEB/
 
 
##################################################################
#	T E M P P A T H
##################################################################
#used by umplugin, scene, report
tempPath=C:/Project/<projectStaticFolder>/WEB/
 
 
##################################################################
#	F I L E S   C O M P R E S S I O N
##################################################################
#useCompressed:  =false during development, =true when put in production
useCompressed=false
 
 
##################################################################
#	M E T A D A T A   C A C H E  ( W E B C L I E N T )
##################################################################
 
#timeToIdleSeconds keep 1 in configuration phase. Increase as wanted in production. tipycally 3600=1 hour
metadatacache.timeToIdleSeconds=1
#timeToLiveSecon keep 1 in configuration phase. Increase as wanted in production. tipycally 3600=1 hour
metadatacache.timeToLiveSeconds=1
 
 
##################################################################
#	P R O J E C T   I N D E X
##################################################################
applicationIndexTitle=Geoweb framework 4.4.0
#applicationIndexColor1=#00569F
applicationIndexColor1=#023B6E
applicationIndexColor2=white
applicationIndexColor3=#CECECE
 
##################################################################
#	G E N E R A L  S E T T I N G S
##################################################################
#hide default detail report (STAMPA SCHEDA) 
hideReportSingleView=true
 
 
##################################################################
#	M A P   G U I D E
##################################################################
mapguide.mgUsername=Administrator
mapguide.mgPassword=admin
#mapguide library path. used to update mapguide layers (destination use layer)
mapguide.library.path=Library://<projectStaticFolderName>
 
#mapguide.library.resourceId.scope
#Make variable the MapGuide library configured in webadmin for every gwMap. Useful for the delivery
#the part #{mapguide.library.resourceId.scope} is replaced with the value configured here (from 4.6.X)
#baseMgLibraryPath= @Deprecated, use mapguide.library.resourceId.scope instead
mapguide.library.resourceId.scope=
 
# webconfig.ini path
#	Geoweb tries to load webconfig.ini firstly from static contents, and secondarily from classPath. 
#	If all ways before fail, Geoweb uses this absolute path.
#	This is generally used in Geoweb deployments that involve Linux + WebLogic
pathTo.webconfig.ini=C:/Projects/<projectStaticFolder>/WEB/conf/webconfig.ini
 
#Next 4 parameters are used to dynamically overrides parameters set inside webconfig.ini. They works in independent way each others. Remove comment to override
#mapguide.webconfig.ini.AdministrativeConnectionProperties.Port=2810
#mapguide.webconfig.ini.ClientConnectionProperties.Port=2811
#mapguide.webconfig.ini.SiteConnectionProperties.Port=2812
#mapguide.webconfig.ini.SiteConnectionProperties.IpAddress=10.31.219.236
 
# resource package auto loading. Feature source
#Next 4, optional, parameters are used to auto configure feature source database parameters 
#during the procedure that applies resource package to all configured MapGuide servers
#if not configured here the existing values inside .mpg file will not to be overridden
#service often refers to the same machine in configured in jdbc.url, but here MUST to be expressed like an IPV4 format address. 
mapguide.resourcepackage.featuresource.service=<ip_address or server_name>
mapguide.resourcepackage.featuresource.username=<schema_username>
mapguide.resourcepackage.featuresource.password=<schema_password>
mapguide.resourcepackage.featuresource.datastore=<DB_name>
 
 
#@Deprecated from 4.4.0 (but supported yet)
#mgUsername=
#mgPassword=
#geowebalias=
#pathTo.webconfig.ini=
 
 
##################################################################
#	A U T O M A T I C   D E P L O Y
##################################################################
#geowebfolder contains resources to be automatically loaded during the server startup
geowebfolder=C:\\projects\\<projectStaticFolder>\\geowebfolder
 
 
##################################################################
#	K U B E R N E T E S
##################################################################
#used to perform the kubernetes readinessProbe
#set the version of the last (non repeatable) script, configured
#in gw_package folder, handled by the gw-resources-deployer
script.version=1.0.0.1
 
 
##################################################################
#	W O R K F L O W
##################################################################
#This flag, default false, force to deploy all Process Definition 
#inside Activiti at every server startup, even if already deployed.
#Usually all Activiti Process Definition, contained in one or more 
#.bpmn files, under the folder [geowebfolder]/activiti/ will to be 
#deployed inside Activiti, in a automatic way, during webapp initialization
#If the Process Definition results already deployed, the deploy is skipped
#This flag overrides this mechanism
workflow.activiti.forceDeploy.enabled=false
 
 
##################################################################
#	M A P
##################################################################
#Allowed range [0.001,1000] Ex: if map is in meter, but it had been loaded in mm, mapUnitFactor should be 1000
mapUnitFactor=1
 
#set the SRID used to handle spatial data from/to the database
#this parameter SHOULD NOT generally to be set.
#The SRID information is generally set inside MapGuide Maestro configuration
#and it's enough. But sometimes spatial data in DB are populated in aim 
#to be consumed by other systems.
#If omitted the default null SRID is used (change in base on DB vendor)
#If set, this is used globally to hadle all spatial data
#(but it can to be locally overridden using the gwAttribute xml parameter
# named 'persistSridToDB')
globalSRID=
 
 
##################################################################
#	U P L O A D   M A N A G E R
##################################################################
 
#when loading a CAD drawing, specify, when true, if a SDF file is created for background layer, otherwise put all vector entities in drawing_background relations
#useSDFForBackground=true
useSDF=true
 
# availablePackages=Bim\,PointCloud\,Plan\,BulkUp\,Views
uploadManager.availablePackages=Bim\,PointCloud\,BulkUp\,Plan\,Views
 
#projectType=building or model
uploadManager.projectType=building
 
# savingFileOn=db or alfresco (BulkUp - sperimentato su CDE)
uploadManager.savingFileOn=alfresco
#if alfresco -> set class, class attribute, code attribute, 
#column name of file name to search table record with the cmis widget
uploadManager.fileClass=cde_deliverable_upload_manager
uploadManager.fileAttribute=file_name
uploadManager.fileCodeColumn=cod_deliverable_full
uploadManager.fileName=cod_deliverable_full
 
 
# Modello 3d (Bim,PointCloud)
# saving IFC On=db or alfresco
uploadManager.savingModelOn=alfresco
uploadManager.modelClass=cde_deliverable_upload_manager
uploadManager.modelAttribute=file_name
uploadManager.modelCodeColumn=cod_deliverable_full
uploadManager.modelName=cod_deliverable_full
 
uploadManager.attachmentsAttribute=allegati_deliverable
 
 
##################################################################
#	G W   M A I L   C O N F
##################################################################
#from version 4.2.12 deprecates calendar.memoscheduler.* stuff
 
#email that will be shown as the sender by the email receiver. Used when 'from' is not passed to gwMailService.sendMail(..)
gwMailService.defaultSenderEmail=no-reply@geowebitalia.it
gwMailService.user=demo.facilityservice@gmail.com
gwMailService.password=demoFS2016
gwMailService.host=smtp.gmail.com
gwMailService.port=465
#mail.smtp.starttls.enable - boolean - If true, enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection before issuing any login commands. Note that an appropriate trust store must configured so that the client will trust the server's certificate. Defaults to false.
gwMailService.mailSmtpStarttlsEnable=false
#mail.smtp.auth - boolean - If true, attempt to authenticate the user using the AUTH command. Defaults to false.	                       
gwMailService.mailSmtpAuth=true
#mail.smtp.socketFactory.port - int - Specifies the port to connect to when using the specified socket factory. If not set, the default port will be used.
gwMailService.mailSmtpSocketFactoryPort=465
#mail.smtp.socketFactory.class - String - If set, specifies the name of a class that implements the javax.net.SocketFactory interface. This class will be used to create SMTP sockets.									
gwMailService.mailSmtpSocketFactoryClass=javax.net.ssl.SSLSocketFactory
#mail.smtp.socketFactory.fallback - boolean - If set to true, failure to create a socket using the specified socket factory class will cause the socket to be created using the java.net.Socket class. Defaults to true.
gwMailService.mailSmtpSocketFactoryFallback=false
#mail.smtp.quitwait - boolean - If set to false, the QUIT command is sent and the connection is immediately closed. If set to true (the default), causes the transport to wait for the response to the QUIT command.
gwMailService.mailSmtpQuitwait=false
#mail.debug	- boolean
gwMailService.mailDebug=true
#mail.smtp.ssl.enable - boolean - If set to true, use SSL to connect and use the SSL port by default. Defaults to false for the "smtp" protocol and true for the "smtps" protocol.
gwMailService.mailSmtpSslEnable=
#mail.smtp.ssl.trust - String - If set, and a socket factory hasn't been specified, enables use of a MailSSLSocketFactory. If set to "*", all hosts are trusted. If set to a whitespace separated list of hosts, those hosts are trusted. Otherwise, trust depends on the certificate the server presents.
gwMailService.mailSmtpSslTrust=*
#mail.smtp.ssl.protocols  - String - Specifies the SSL protocols that will be enabled for SSL connections. The property value is a whitespace separated list of tokens acceptable to the javax.net.ssl.SSLSocket.setEnabledProtocols method. (from gw version 4.4.17)
gwMailService.mailSmtpSslProtocols=
 
 
 
 
 
##################################################################
#	G W   S C H E D U L E R
##################################################################
 
#toggle the gwSchedluer execution, optional, default true
gwscheduler.enabled=false
#toggle the support for cluster environment , optional, default false
#is subordinate to the addition of the field 'lock_end_time' 
#to 'gw_sched_def' relation
gwscheduler.clusterMode.enabled=false
 
 
##################################################################
#	E V E N T   M E M O   S C H E D U L E R
##################################################################
 
#toggle memo scheduler. When omitted default is true
eventmemo.scheduler.enabled=false
 
#http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/crontrigger.html
#
#        Field Name     Allowed Values      Allowed Special Characters
#        Seconds        0-59                , - * /
#        Minutes        0-59                , - * /
#        Hours          0-23                , - * /
#        Day-of-month   1-31                , - * ? / L W
#        Month          1-12 or JAN-DEC     , - * /
#        Day-of-Week    1-7 or SUN-SAT      , - * ? / L #
#
#1 0 3 * * ? stand for every day at 3:00:01 am
#eventmemo.memoscheduler.cronExpression=1 0 3 * * ?
eventmemo.scheduler.cronExpression=1 0 3 * * ?
 
#deleteEventMemoOfExpiredEventAfterEndAlert
eventmemo.scheduler.deleteEventMemoOfExpiredEventAfterEndAlert=false
 
 
##################################################################
#	M O N I T O R I N G   S C H E D U L E R
##################################################################
 
#toggle monitoring scheduler. When omitted default is false
monitoring.scheduler.enabled=false
 
#http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/crontrigger.html
#
#        Field Name     Allowed Values      Allowed Special Characters
#        Seconds        0-59                , - * /
#        Minutes        0-59                , - * /
#        Hours          0-23                , - * /
#        Day-of-month   1-31                , - * ? / L W
#        Month          1-12 or JAN-DEC     , - * /
#        Day-of-Week    1-7 or SUN-SAT      , - * ? / L #
#
#1 0 3 * * ? stand for every day at 3:00:01 am
#monitoring.memoscheduler.cronExpression=1 0 3 * * ?
monitoring.scheduler.cronExpression=10 0 3 * * ?
 
 
##################################################################
#	P L A N N E D   A C T I V I T Y   S C H E D U L E R
##################################################################
 
#toggle memo scheduler. When omitted default is false
plannedActivity.scheduler.enabled=false
 
#http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/crontrigger.html
#
#        Field Name     Allowed Values      Allowed Special Characters
#        Seconds        0-59                , - * /
#        Minutes        0-59                , - * /
#        Hours          0-23                , - * /
#        Day-of-month   1-31                , - * ? / L W
#        Month          1-12 or JAN-DEC     , - * /
#        Day-of-Week    1-7 or SUN-SAT      , - * ? / L #
#
#1 0 3 * * ? stand for every day at 3:00:01 am
#plannedActivity.scheduler.cronExpression=1 0 3 * * ?
plannedActivity.scheduler.cronExpression=20 0 3 * * ?
 
 
##################################################################
#	A E C   A S S I G N M E N T   S C H E D U L E R
##################################################################
 
#toggle memo scheduler. When omitted default is false
calendar.aecAssignmentWS.enabled=false
 
#http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/crontrigger.html
#
#        Field Name     Allowed Values      Allowed Special Characters
#        Seconds        0-59                , - * /
#        Minutes        0-59                , - * /
#        Hours          0-23                , - * /
#        Day-of-month   1-31                , - * ? / L W
#        Month          1-12 or JAN-DEC     , - * /
#        Day-of-Week    1-7 or SUN-SAT      , - * ? / L #
#
#1 0 3 * * ? stand for every day at 3:00:01 am
#calendar.aecAssignmentWS.cronExpression=1 0 3 * * ?
calendar.aecAssignmentWS.cronExpression=1 0 22 * * ?
 
 
##################################################################
#	D A T A B A S E S
##################################################################
 
##################################################################
# database ORACLE
##################################################################
 
 
#jdbc.driverClassName=oracle.jdbc.driver.OracleDriver
#jdbc.url=jdbc:oracle:thin:@<ip_address or server_name>:<port>:<DB_name>
# es: jdbc.url=jdbc:oracle:thin:@ora11dev.gruppoesc.it:1521:ORA11DEV
#jdbc.username=<schemaData_username>
#jdbc.password=<schemaData_password>
#jdbc.maxActive=6
#jdbc.minIdle=2
#jdbc.maxIdle=6
#jdbc.validationQuery=select 1 from dual
 
#jdbcmetadata.driverClassName=oracle.jdbc.driver.OracleDriver
#jdbcmetadata.url=jdbc:oracle:thin:@<ip_address or server_name>:<port>:<DB_name>
#es: jdbcmetadata.url=jdbc:oracle:thin:@ora11dev.gruppoesc.it:1521:ORA11DEV
#jdbcmetadata.username=<schemaMetadata_username>
#jdbcmetadata.password=<schemaMetadata_password>
#jdbcmetadata.maxActive=6
#jdbcmetadata.minIdle=2
#jdbcmetadata.maxIdle=6
#jdbcmetadata.validationQuery=select 1 from dual
 
 
##################################################################
# database POSTGRES
##################################################################
 
jdbc.driverClassName=org.postgresql.Driver
jdbc.url=jdbc:postgresql://<ip_address or server_name>:<port>/<DB_name>
# es: jdbc.url=jdbc:postgresql://127.0.0.1:5432/TEST_GW44
jdbc.username=<schemaData_username>
jdbc.password=<schemaData_password>
jdbc.maxActive=6
jdbc.minIdle=2
jdbc.maxIdle=6
jdbc.validationQuery=select 1
 
jdbcmetadata.driverClassName=org.postgresql.Driver
jdbcmetadata.url=jdbc:postgresql://<ip_address or server_name>:<port>/<DB_name>
# es: jdbcmetadata.url=jdbc:postgresql://127.0.0.1:5432/TEST_GW44
jdbcmetadata.username=<schemaMetadata_username>
jdbcmetadata.password=<schemaMetadata_password>
jdbcmetadata.maxActive=6
jdbcmetadata.minIdle=2
jdbcmetadata.maxIdle=6
jdbcmetadata.validationQuery=select 1
 
 
##################################################################
# database SQLSERVER
##################################################################
 
#jdbc.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
#jdbc.url=jdbc:sqlserver://<ip_address or server_name>:<port>;databaseName=<DB_name>
# es: jdbc.url=jdbc:sqlserver://192.168.0.99:1433;databaseName=geoweb
#jdbc.username=<schemaData_username>
#jdbc.password=<schemaData_password>
#jdbc.maxActive=6
#jdbc.minIdle=2
#jdbc.maxIdle=6
#jdbc.validationQuery=select 1
#
#jdbcmetadata.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
#jdbcmetadata.url=jdbc:sqlserver://<ip_address or server_name>:<port>;databaseName=<DB_name>
# es: jdbcmetadata.url=jdbc:sqlserver://192.168.0.99:1433;databaseName=geoweb
#jdbcmetadata.username=<schemaData_username>
#jdbcmetadata.password=<schemaData_password>
#jdbcmetadata.maxActive=6
#jdbcmetadata.minIdle=2
#jdbcmetadata.maxIdle=6
#jdbcmetadata.validationQuery=select 1
 
##################################################################
#	M O N G O D B
################################################################## 
#	Convention: for each mongo.db_* use as value use this pattern: (since 4.4.0).
#		[DATABASE_NAME][SUFFIX]
#		available suffixes: [_BIM_MODELS,_CLASSIFICATION,_MNEMONIC_CODE]
#	
#	Example (if DATABASE_NAME=DB_NAME):
#		mongo.db_classification=DB_NAME_CLASSIFICATION
 
#enabling flag, default true
mongo.enabled=true
 
mongo.db_bim_models=<MongoDB_name>_BIM_MODELS
mongo.db_classification=<MongoDB_name>_CLASSIFICATION
mongo.db_mnemonic_code=<MongoDB_name>_MNEMONIC_CODE
 
#mongo credentials. optional parameters (since 4.4.0)
#	
#	mongo.authentication optional, default null, allowed values: [SCRAM-SHA-1,MONGODB-X509,MONGODB-CR,GSSAPI,PLAIN]
#	mongo.password optional, default null. Depending on mongo.authentication value, password can be required or forbidden
#			when mongo.authentication value is SCRAM-SHA-1 or MONGODB-CR or PLAIN => password must be always configured
#			when mongo.authentication value is GSSAPI or MONGODB-X509 => password must be always omitted
#	mongo.username is always required if credentials are enabled
#	mongo.source is always required if credentials are enabled
 
mongo.source=<MongoDB_name>
mongo.username=<schemaMongo_username>
mongo.password=<schemaMongo_username>
mongo.authentication=SCRAM-SHA-1
 
#mongo.uri
#	required, default null (since 4.6.0)
#	Inside mongo.uri can be specified multiple host, eventually each one with it's port (default is 27017)
#	Inside mongo.uri can be specified some credentials, database and others options. 
#	When credentials are explicit the credentials deriving from mongo.username/mongo.password are overridden.
#
#	mongo.uri pattern:
#		mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]
#
#	mongo.uri examples:
#		mongodb://localhost
#		mongodb://localhost1:27017
#		mongodb://localhost1:27018
#		mongodb://username:password@localhost:27017,localhost1,localhost2:27018
 
mongo.uri=mongodb://<ip_address or server_name>:<port>
 
 
#boolean, default true
#set to false to avoid the reload of classification on mongo (faster choice)
classification.reloadAtStartup.enabled=true
 
 
##################################################################
#	C M I S
##################################################################
 
#ALFRESCO
cmisUser=admin   
cmisPassword=<cmisAdminPassword>
cmisUrl=http://127.0.0.1:8081/alfresco/service/cmis
#when using alfresco 7.x, use a different cmisUrl
#cmisUrl=http://127.0.0.1:8081/alfresco/api/-default-/public/cmis/versions/1.1/atom
#la cartella su Alfresco va creata manualmente accedendo ad Alfresco e posizionandola sotto lo spazio 'Sites/Siti'
cmisBasePath=/Siti/Geoweb
cmisType=alfresco
enableCmisCache=false
 
 
#SHAREPOINT
#cmisUser=geowebitalia\\sharepoint
#cmisPassword=Shar3point$
#cmisUrl=http://winsharepoint/_vti_bin/cmis/rest?getRepositories
#cmisBasePath=/
#cmisType=sharepoint
 
 
##################################################################
#	C M S   A P I   R E S T   W I D G E T
##################################################################
cms.api.enabled=true
#cms.api.name options: [alfresco,sharepoint]
cms.api.name=alfresco
cms.api.user=admin
cms.api.password=<cmisAdminPassword>
cms.api.baseUrl=http://acs.k8s.gwcloud.it/alfresco
cms.api.rootPath=/Sites/TestSite/Documenti
 
############################################################
 
#	S E C U R I T Y  
##################################################################
 
# length of the time period (in days) for which password is valid - Periodo di validità delle password
gwSecurity.passwordLifeTimeDays=180
# threshold to prohibit reuse of password up to a previous date - Numero minimo di password differenti prima del riutilizzo
gwSecurity.passwordHistoricalCheckingCount=10
# threshold (in days) to prohibit the reuse of the password used from a date onwards
gwSecurity.passwordHistoricalCheckingPeriodDays=1800
# (Account lockout threshold) number of invalid login attempts that are allowed before an account is locked out. - Numero massimo di tentativi di accesso con password errata
gwSecurity.maxAttempts=10
# Account locked time 
gwSecurity.accountLockedTimeMinutes=30
# rest token lifetime for reset password ('forget me')
gwSecurity.tokenLifeTimeHours=24
 
# email forgot password - Subjet - password dimenticata 
gwSecurity.resetPasswordEmailSubjet=Ambiente di TEST GW4.4 - Impostazione/Ripristino Dati di Accesso
 
# email forgot password - text message - params: {0: userEmail, 1: username, 2: reset_token, 3: resetUrl}
# gwSecurity.resetPasswordEmailMessage=Gentile {1}\\,<br>per inserire una nuova password\\, clicca sul link sottostante:<br> {3} <br><br><br> Cordiali saluti\\, <br> Geowebitalia
gwSecurity.resetPasswordEmailMessage=Gentile {1}\\,<br>E stata inviata una richiesta di impostazione o ripristino della password per il tuo account sul sistema GW4.4 on CDE.<br><br>Puoi ora accedere cliccando sul seguente collegamento o copiandolo e incollandolo nel browser: <br><a href="{3}">{3}</a> <br><br>Questo collegamento puo essere utilizzato per accedere una sola volta\\, verrai indirizzato a una pagina dove potrai impostare la tua password. <br>Scade dopo un giorno e non succede nulla se non viene utilizzato. <br><br><br>Cordiali saluti
 
 
##################################################################
#	C L I E N T   P A S S W O R D   R E G E X 
##################################################################
#gwClientPasswordRegex: regex applied to dijit/form/ValidationTextBox widget
 
#Minimum eight characters, at least one uppercase letter, one lowercase letter, one number and one special character of #?!@$%^&-_
#gwClientPasswordRegex=^(?=.*?[A-Z])(?=.*?[a-z])(?=.*?[0-9])(?=.*?[#?!@$%^&*-_]).{8\\,}$
#Minimum eight characters, at least one uppercase letter, one lowercase letter, one number and one special character of $!%*?&
gwClientPasswordRegex=^(?=.*[a-z])(?=.*[A-Z])(?=.*\\\d)(?=.*[$@$!%*?&])[A-Za-z\\\d$@$!%*?&]{8\\,}
 
#gwClientPasswordRegexPromptMessage: Tooltip text that appears when the text box is empty and on focus
#gwClientPasswordRegexPromptMessage=La password deve contenere almeno 8 caratteri di cui almeno una lettera maiuscola\\, almeno una lettera minuscola\\, almeno un numero\\, almeno un carattere speciale fra: # ? ! @ $ % ^ & - _
gwClientPasswordRegexPromptMessage=La password deve contenere almeno 8 caratteri di cui almeno una lettera maiuscola\\, almeno una lettera minuscola\\, almeno un numero\\, almeno un carattere speciale fra: $ ! % * ? &
 
 
##################################################################
#	K E Y C L O A K
##################################################################
keycloak.serverUrl=https://kc.k8s.gwcloud.it
keycloak.realm=pnrr
keycloak.clientId=gw-client-credentials
keycloak.clientSecret=cx26yiwqZtL6RxTk38dN2Nvu9KfAgKzG
 
keycloak.executeActionsEmail.clientId=LLPP_PPM_id
#keycloak.executeActionsEmail.redirectUri="http://192.168.0.50:8081/webclient"
keycloak.executeActionsEmail.lifespan=12
 
##################################################################
#    A C C E S S P A G E   S C H E M A
##################################################################
# main platform schema with accesspage 
gwa.schema=
 
##################################################################
#    A C C E S S P A G E   S O L U T I O N C O D E
##################################################################
# platform solution code. This value will be made available in ACL and groovy by session variable gw_solutionCode
gw.solution.code=
 
##################################################################
#	U S E R   S E T T I N G S   M A N A G E M E N T
##################################################################
#hide the whole userSettings UI when true. default false
userSettings.management.disabled=false
#hide the change language UI when true. default false
userSettings.management.changeLanguage.disabled=false
#hide the change scopes UI when true. default false
userSettings.management.changeScopes.disabled=false
#hide the change group UI when true. default true
userSettings.management.changeGroup.disabled=true
#hide the restore defaults UI when true. default false
userSettings.management.restoreDefaults.disabled=false
#@Deprecated from 4.6.0, default false. It was misleading: changePassword and not resetPassword. Use userSettings.management.resetPassword.disabled instead
#resetPassword.disabled=false
#hide the change password UI when true. default false
userSettings.management.changePassword.disabled=false
#with gw-keycloak module added it's auto generated (ex: [server]/realms/[realm]/account/#/security/signingin), default null
userSettings.management.changePassword.url=
#hide the edit profile UI when true. default true
userSettings.management.editProfile.disabled=false
#with gw-keycloak module added it's auto generated (ex: [server]/realms/[realm]/account/#/personal-info), default null
userSettings.management.editProfile.url=
#@Deprecated from 4.6.0, default false. Use userSettings.management.logout.disabled instead
#logout.disabled=false
#hide the logout UI when true. default false
userSettings.management.logout.disabled=false
#@Deprecated from 4.6.0, default null. Included in userSettings.management.*. Use userSettings.management.logout.url instead
#logout_url=
#default '/gw_logout'. when using Keycloak, in general it's already pre-configured inside the Keycloak spring-security.xml
userSettings.management.logout.url=
 
 
##################################################################
#	I N F O   &   S U P P O R T   M A N A G E M E N T
##################################################################
#hide the whole infoAndSupport UI when true. default false
infoAndSupport.management.disabled=false
#hide the trainingCenter UI when true. default false
infoAndSupport.management.trainingCenter.disabled=false
#String, default null. If omitted system looks for the file WEB/trainingcenter/geoweb_trainingcenter.html
infoAndSupport.management.trainingCenter.url=
#hide the assistance UI when true. default false
infoAndSupport.management.assistance.disabled=false
#String, default null. If omitted system looks for the file WEB/assistance/geoweb_assistance.html
infoAndSupport.management.assistance.url=
#hide the trainingCenter UI when true. default true
infoAndSupport.management.infoLicence.disabled=true
#String, default null. If omitted system looks for the file WEB/aboutof/geoweb_aboutof.html
infoAndSupport.management.aboutOf.url=
#String, default null. If omitted system looks for the file WEB/termsandconditions/geoweb_termsandconditions.txt
infoAndSupport.management.termsAndConditions.url=
#hide the privacy UI when true. default true
infoAndSupport.management.privacy.disabled=false
#@Deprecated from 4.6.0, default null. Included in infoAndSupport.management.*. Use infoAndSupport.management.privacy.url instead
#gwPrivacyLink=
#String, default null. If omitted system looks for the file WEB/privacy/geoweb_privacy.txt
infoAndSupport.management.privacy.url=
 
 
##################################################################
#	N O T I F I C A T I O N S   M A N A G E M E N T
##################################################################
#hide the notifications UI when true. default false
notifications.management.disabled=true
 
 
##################################################################
#	H O M E   B U T T O N
##################################################################
#form 4.6.0 homeButton is the top left platform logo. Always visible
#default true. When false the button is disabled
homeButton.enabled=true
#platform logo is shown by default (retrieved from path: WEB/images/svg/platform_logo.svg)
#It can to be overridden with fa- css class (ex: 'fa-solid fa-house') or in [img_name].[ext] format
homeButton.iconName=
#url of the opened browser page. Default is the root '/'. It had to be configured when access-page module is used
homeButton.url=
#Window name to grant the home page to be opened in always in the same window. Default is 'gwindex'
homeButton.windowName=
 
 
##################################################################
#	FUNCTION SELECTOR
##################################################################
#hide the whole functionSelector UI when true. default false. It's a global param. GwProject xml configuration has the priority
functionSelector.disabled=false
 
 
##################################################################
#	OBJECT SELECTOR
##################################################################
#boolean, default false. NOT IMPLEMENTED YET
#By default, to select the working session object, it's used the old system (gwClass DACL + externalTable widget based)
#When true, it's not used the externalTable widget, but an UI similar to the functionSelector. gwClass DACL confs are stil applied
objectSelector.useAccessPageUI=false
#boolean, default false. NOT IMPLEMENTED YET
#When true, both the UI similar to the functionSelector and the new access page model are used (data inside gwa_fun_r_obj had to be kept aligned with the DACL configurations)
objectSelector.useAccessPageModel=false
 
 
##################################################################
#	P R O D U C T   I N F O
##################################################################
#String, default null
#It's shown on the top right corner. It should contains the product name and the version
product.info=PRODUCT 1.0
 
 
##################################################################
#	A U T H E N T I C A T I O N
##################################################################
 
#PRE AUTHENTICATION CREDENTIALS (optional)
#@Deprecated
#An explicit spring.security.xm configuration is needed
#Next two parameters, both optional, work in conjunction and maybe used to create a simplified authentication mechanism (if oauth2 is not possible, or not jet implemented, for example)
#Every call to server will be considered allowed if contains in its headers section a parameter called SM_USER properly populated.
#This parameter should be computed making the sha512 of the string resulting from the concatenation of preAuthUser and preAuthKey parameter, with a | character in the middle.
#Here the pseudo code:
#
#	var SM_USER = SHA512(preAuthUser+"|"+preAuthKey)
#
#	Ex:
#
#		SM_USER:	2ca0e5a3633f7c8306505d3c7edcdaac29c93ae689e0b1182c3da4bfdc763758745e7684926042b840d6beb193ffd4e11fa9d1d73d0bec43f42348cca4f2aedd	
#
#preAuthUser=ws_test
#preAuthKey=ws_test_1
 
#PRE AUTHENTICATED LOGOUT (optional)
#By default if an user click logout button, Geoweb redirect him to loginPage. 
#This behavior can to be overridden setting this variable, and de-commenting the spring.security.xml block
#	<logout success-handler-ref="customLogoutSuccessHandler" />
#As result the user will to be redirected at the set URL
#preAuthenticated_logout_url=https://loginatla.gse.it/AGLogout
 
 
 
##################################################################
#	A N O N Y M O U S   U S E R
##################################################################
#default false
anonymousUser.interoperabilityServicesAllowed=false
 
 
##################################################################
#	A P P R O V A L
##################################################################
#default true
gwApproval.exitOnFirstReject=true
 
 
##################################################################
#	IFC
##################################################################
#default true
ifc.xkt.convert=true
 
 
##################################################################
#	R A B B I T   P U B L I S H E R
##################################################################
gwRabbitQueueName=ifc.xkt.converter.queue
#default geoweb.exchange
gwRabbitPublisherExchangeName=geoweb.exchange
gwRabbitQueueHost=localhost
gwRabbitQueuePort=5672
gwRabbitQueueUser=geoweb
gwRabbitQueuePassword=G30w3b!
gwRabbitVirtualHost=
 
 
##################################################################
#	U S E R   P R O V I S I O N I N G
##################################################################
#default true, not implemented
#gwProvisioning.isAutoProvisioningEnabled=true
#default geow_users, not implemented
gwProvisioning.geowUsersClassName=geow_users;
gwProvisioning.geowUsersTableName=x
#default geow_user_groups, not implemented
#gwProvisioning.geowUserGroupClassName=geow_user_groups
gwProvisioning.geowUserGroupTableName=x
#default name_user
gwProvisioning.geowUsersNameColumn=name_user
#default surname_user
gwProvisioning.geowUsersSurnameColumn=surname_user
#default email
gwProvisioning.geowUsersEmailColumn=email
#default descr_user
gwProvisioning.geowUsersDescrUserColumn=descr_user
gwProvisioning.geowUsersInsertClassRecord=
#default false, not implemented
#gwProvisioning.macroroleIsEnabled=false
#default false
gwProvisioning.addDefaultGroup=false
#default guest
gwProvisioning.defaultGroup=guest
 
 
######################################################################
#    E L A S T I C   S E A R C H 
######################################################################
# These parameters are used for insert events in elasticSearch
elastic.search.url=http://elastic.k8s.gwcloud.it/
elastic.search.user=geoweb
elastic.search.password=<password>
elastic.search.index.name=<realm>
 
 
 
 
##################################################################
#	G E N E R A L
##################################################################
 
# DISPLAY DETAILED ERROR MESSAGES
# set true to throw the exception message
# set false to throw a general error message 
# default: true
display_detailed_error_messages=true
 
# dictionary: enabling flag
# default: true
gwm_dictionary.enabled=true
 
# custom dictionary: enabling flag
# default: true
gwm_dictionary_custom.enabled=true
 
# REPORT PERMISSION
report.permission.enable=false
 
#HIDE REPORT "Stampa Scheda"
hideReportSingleView=true
 
#UPLOAD DOCUMENT
# list of file extensions without point and separated by comma - add extensions considered potentially dangerous
#easy blacklist
#document.blacklist.extension=exe,dll,bat,ocx,so,html
#hard blacklist
document.blacklist.extension=html,exe,pif,application,gadget,msi,msp,com,scr,hta,cpl,msc,jar,bat,cmd,vb,vbs,vbe,js,jse,ws,wsf,wsc,wsh,ps1,ps1xml,ps2,ps2xml,psc1,psc2,msh,msh1,msh2,mshxml,msh1xml,msh2xml,scf,link,inf
 
#MNEMONIC CODE
# default: true
gwMnemonicCode.reloadAtStartup.enabled=true
 
 
##################################################################
#	C U S T O M I Z A T I O N
##################################################################
#use it for non standard confs

configuration.properties

#*****************************************************************
#                         A D M I N
#  C O N F I G U R A T I O N   P R O P E R T I E S     
#                       T E M P L A T E
#
# in order to configure you application, has to be changed the 
# sections between '<' and '>' characters
#*****************************************************************
 
##################################################################
#	B A S E P A T H
##################################################################
basePath=file:///C:/Projects/<projectStaticFolder>/WEB/
 
 
##################################################################
#	T E M P P A T H
##################################################################
#used by umplugin, scene, report
tempPath=C:/Project/<projectStaticFolder>/WEB/
 
 
##################################################################
#	F I L E S   C O M P R E S S I O N
##################################################################
#useCompressed:  =false during development, =true when put in production
useCompressed=true
 
 
##################################################################
#	M E T A D A T A   C A C H E (WEBADMIN)
##################################################################
 
#comma (,) separated client server address. Only one is the common case (no server cluster)
urlList=http://localhost/<projectStaticFolder>/
 
 
 
##################################################################
#	D A T A B A S E S
##################################################################
 
##################################################################
# database ORACLE
##################################################################
 
 
#jdbc.driverClassName=oracle.jdbc.driver.OracleDriver
#jdbc.url=jdbc:oracle:thin:@<ip_address or server_name>:<port>:<DB_name>
# es: jdbc.url=jdbc:oracle:thin:@ora11dev.gruppoesc.it:1521:ORA11DEV
#jdbc.username=<schemaData_username>
#jdbc.password=<schemaData_password>
#jdbc.maxActive=6
#jdbc.minIdle=2
#jdbc.maxIdle=6
#jdbc.validationQuery=select 1 from dual
 
#jdbcmetadata.driverClassName=oracle.jdbc.driver.OracleDriver
#jdbcmetadata.url=jdbc:oracle:thin:@<ip_address or server_name>:<port>:<DB_name>
#es: jdbcmetadata.url=jdbc:oracle:thin:@ora11dev.gruppoesc.it:1521:ORA11DEV
#jdbcmetadata.username=<schemaMetadata_username>
#jdbcmetadata.password=<schemaMetadata_password>
#jdbcmetadata.maxActive=6
#jdbcmetadata.minIdle=2
#jdbcmetadata.maxIdle=6
#jdbcmetadata.validationQuery=select 1 from dual
 
 
##################################################################
# database POSTGRES
##################################################################
 
jdbc.driverClassName=org.postgresql.Driver
jdbc.url=jdbc:postgresql://<ip_address or server_name>:<port>/<DB_name>
# es: jdbc.url=jdbc:postgresql://127.0.0.1:5432/TEST_GW44
jdbc.username=<schemaData_username>
jdbc.password=<schemaData_password>
jdbc.maxActive=6
jdbc.minIdle=2
jdbc.maxIdle=6
jdbc.validationQuery=select 1
 
jdbcmetadata.driverClassName=org.postgresql.Driver
jdbcmetadata.url=jdbc:postgresql://<ip_address or server_name>:<port>/<DB_name>
# es: jdbcmetadata.url=jdbc:postgresql://127.0.0.1:5432/TEST_GW44
jdbcmetadata.username=<schemaMetadata_username>
jdbcmetadata.password=<schemaMetadata_password>
jdbcmetadata.maxActive=6
jdbcmetadata.minIdle=2
jdbcmetadata.maxIdle=6
jdbcmetadata.validationQuery=select 1
 
 
##################################################################
# database SQLSERVER
##################################################################
 
#jdbc.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
#jdbc.url=jdbc:sqlserver://<ip_address or server_name>:<port>;databaseName=<DB_name>
# es: jdbc.url=jdbc:sqlserver://192.168.0.99:1433;databaseName=geoweb
#jdbc.username=<schemaData_username>
#jdbc.password=<schemaData_password>
#jdbc.maxActive=6
#jdbc.minIdle=2
#jdbc.maxIdle=6
#jdbc.validationQuery=select 1
#
#jdbcmetadata.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
#jdbcmetadata.url=jdbc:sqlserver://<ip_address or server_name>:<port>;databaseName=<DB_name>
# es: jdbcmetadata.url=jdbc:sqlserver://192.168.0.99:1433;databaseName=geoweb
#jdbcmetadata.username=<schemaData_username>
#jdbcmetadata.password=<schemaData_password>
#jdbcmetadata.maxActive=6
#jdbcmetadata.minIdle=2
#jdbcmetadata.maxIdle=6
#jdbcmetadata.validationQuery=select 1
 
 
##################################################################
#	M O N G O D B
################################################################## 
#disabling mongo stuff in webadmin
mongo.enabled=false
 
 
############################################################
#	S E C U R I T Y  
##################################################################
 
# length of the time period (in days) for which password is valid - Periodo di validità delle password
gwSecurity.passwordLifeTimeDays=180
# threshold to prohibit reuse of password up to a previous date - Numero minimo di password differenti prima del riutilizzo
gwSecurity.passwordHistoricalCheckingCount=10
# threshold (in days) to prohibit the reuse of the password used from a date onwards
gwSecurity.passwordHistoricalCheckingPeriodDays=1800
# (Account lockout threshold) number of invalid login attempts that are allowed before an account is locked out. - Numero massimo di tentativi di accesso con password errata
gwSecurity.maxAttempts=10
# Account locked time 
gwSecurity.accountLockedTimeMinutes=30
# rest token lifetime for reset password ('forget me')
gwSecurity.tokenLifeTimeHours=24
 
# email forgot password - Subjet - password dimenticata 
gwSecurity.resetPasswordEmailSubjet=Richiesta cambio password
 
# email forgot password - text message - params: {0: userEmail, 1: username, 2: reset_token, 3: resetUrl}
# gwSecurity.resetPasswordEmailMessage=Gentile {1}\\,<br>per inserire una nuova password\\, clicca sul link sottostante:<br> {3} <br><br><br> Cordiali saluti\\, <br> Geowebitalia
gwSecurity.resetPasswordEmailMessage=Gentile {1}\\,<br>E stata inviata una richiesta di impostazione o ripristino della password per il tuo account sul sistema GW4.<br><br>Puoi ora accedere cliccando sul seguente collegamento o copiandolo e incollandolo nel browser: <br><a href="{3}">{3}</a> <br><br>Questo collegamento puo essere utilizzato per accedere una sola volta\\, verrai indirizzato a una pagina dove potrai impostare la tua password. <br>Scade dopo un giorno e non succede nulla se non viene utilizzato. <br><br><br>Cordiali saluti
 
 
##################################################################
#	C L I E N T   P A S S W O R D   R E G E X
##################################################################
#gwClientPasswordRegex: regex applied to dijit/form/ValidationTextBox widget
 
#Minimum eight characters, at least one uppercase letter, one lowercase letter, one number and one special character of #?!@$%^&-_
#gwClientPasswordRegex=^(?=.*?[A-Z])(?=.*?[a-z])(?=.*?[0-9])(?=.*?[#?!@$%^&*-_]).{8\\,}$
#Minimum eight characters, at least one uppercase letter, one lowercase letter, one number and one special character of $!%*?&
gwClientPasswordRegex=^(?=.*[a-z])(?=.*[A-Z])(?=.*\\\d)(?=.*[$@$!%*?&])[A-Za-z\\\d$@$!%*?&]{8\\,}
 
#gwClientPasswordRegexPromptMessage: Tooltip text that appears when the text box is empty and on focus
#gwClientPasswordRegexPromptMessage=La password deve contenere almeno 8 caratteri di cui almeno una lettera maiuscola\\, almeno una lettera minuscola\\, almeno un numero\\, almeno un carattere speciale fra: # ? ! @ $ % ^ & - _
gwClientPasswordRegexPromptMessage=La password deve contenere almeno 8 caratteri di cui almeno una lettera maiuscola\\, almeno una lettera minuscola\\, almeno un numero\\, almeno un carattere speciale fra: $ ! % * ? &

Configurazione .xml rimossa

Dalla versione 4.6.x la configurazione di mongo DB è esclusivamente espletata tramite codice java. Tutta la configurazioni sono state rese di fatto manovrabili dal file configurationProperties/remapConfiguration.properties.

mongo.enabled

Dalla versione 4.6.x è presente il flag (default true per retrocompabilità) che permette, se posto a false, di disabilitare la creazione dei bean di Mongo. Si evitano quindi, in caso di configurazione errata/mancante, i relativi errori sul log in fase di avvio dell'applicativo. Se mongo.enabled è true, viene invece effettuata una validazione sulla correttezza degli altri parametri, e nel caso generato un errore non bloccante.

mongo.uri

Il parametro mongo.uri (gia disponibile dalla 4.4.x) dalla 4.6.x è l'unico parametro configurable, quindi required e non più opzionale. I parametri mongo.host e mongo.port NON SONO PIU VALUTATI. Nelle 4.4.x/4.5.x mongo.host e mongo.port, erano Deprecati ma ancora utilizzabili in alternativa a mongo.uri. Dentro mongo.uri si possono specificare più host, ognuno eventualmente corredato dalla propria porta (di default è 27017). Dentro mongo.uri possono essere specificate delle credenziali, database ed ulteriori opzioni, che saranno in gestite dal bean che effettua la connessione.

mongo.uri pattern:

mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

mongo.uri esempi:

mongodb://localhost
mongodb://localhost1:27017
mongodb://localhost1:27018
mongodb://username:password@localhost:27017,localhost1,localhost2:27018

Mongo Credentials

L'istanza del DB di Mongo può prevedere l'abilitazione di credenziali (assolutamente consigliato in produzione). Questo è il set di parametri, opzionali, che va eventualmente configurato:

mongo.authentication optional, default null, allowed values: [SCRAM-SHA-1,MONGODB-X509,MONGODB-CR,GSSAPI,PLAIN]
mongo.password optional, default null. Depending on mongo.authentication value, password can be required or forbidden:
- when mongo.authentication value is SCRAM-SHA-1 or MONGODB-CR or PLAIN ⇒ password must be always configured
- when mongo.authentication value is GSSAPI or MONGODB-X509 ⇒ password must be always omitted
mongo.username is always required if credentials are enabled
mongo.source is always required if credentials are enabled

L'utilizzo delle credenziali si considera attivato se almeno uno di questi parametri è configurato. Geoweb proverà ad utilizzarli per creare le credenziali per il bean mongoClientFactoryBean. Da notare che queste possono essere sovrascritte dalle credenziali eventualmente present dentro mongo.uri, se il flag mongo.forceToUseURICredentials è abilitato.

Mongo Database

Geoweb si aspetta esistere tre database, che vengono usati per persistere i dati riguardanti 3 macrocomponenti del framework:

Modelli BIM
Classificazione
Codici Mnemonici

Per convenzinone ogni proprietà mongo.db_* del configuration.properties va configurata seguendo questo pattern:

[DATABASE_NAME][SUFFIX]

Dove i suffissi disponibili sono:

'_BIM_MODELS'
'_CLASSIFICATION'
'_MNEMONIC_CODE'

Per esempio, se [DATABASE_NAME] vale 'DB_NAME':

mongo.db_classification=DB_NAME_CLASSIFICATION

CMIS

Alfresco 7

I parametri sono gli stessi usati per il vecchio Alfresco 5 tranne che per quanto riguarda il cmisUrl che è un po' diverso. Nel caso delle versioni precedenti di Alfresco, infatti, l'url era composto da:

indirizzo url del server di Alfresco +
stringa “alfresco/service/cmis”

esempio: cmisUrl=http://wintest:8081/alfresco/service/cmis

Nel caso di Alfresco 7, l'url è del tipo:

indirizzo url del server +
stringa “alfresco/api/-default-/public/cmis/versions/1.1/atom”

esempio: cmisUrl=http://acs.k8s.gwcloud.it/alfresco/api/-default-/public/cmis/versions/1.1/atom

CMS

Con la versione 4.6.0 è stata introdotta una nuova modalità di gestione dei documentali che non prevede l'utilizzo della libreria Java OpenCMIS (ormai deprecata). Per il funzionamento di questa nuova modalità, sono stati aggiunti 6 nuovi parametri al configuration.properties che iniziano con il prefisso cms.api.

Per l'abilitazione di questa nuova modalità va impostato il parametro cms.api.enabled a 'true' (ovviamente se impostato a 'false' verrà invece disabilitata). Il valore di default (cioè se il parametro non esiste nel configuration.properties) è 'false' per garantire la retro-compatibilità. Se questo parametro è uguale a 'true', allora tutti i successivi parametri devono esistere ed essere valorizzati, altrimenti si andrà incontro ad errori di connessione con il documentale.

Il parametro cms.api.name deve indicare il tipo di documentale utilizzato dall'applicativo. Attualmente possono essere gestite due tipologie di documentale, quindi le opzioni per questo parametro sono 'alfresco' oppure 'sharepoint'. Si noti che, per quanto riguarda alfresco, questa modalità può essere usata solo con versioni uguali o superiori alla 5.2.

Similmente ai parametri usati dal CMIS cmisUser e cmisPassword, devono essere configurati cms.api.user e cms.api.password con - rispettivamente - l'username e la password di accesso al documentale.

Il parametro cms.api.baseUrl deve contenere l'url che punta al documentale scelto. Alcuni esempi sono http://winsharepoint:1000/siti/test per sharepoint oppure http://acs.k8s.gwcloud.it/alfresco per alfresco 7.

Infine, il parametro cms.api.rootPath deve indicare il path della cartella iniziale su cui poi i widget andranno a creare altre cartelle, leggere i documenti, caricarli, modificarli, cancellarli, eccetera.

Di seguito il recap della nuova sezione di parametri:

##################################################################
#	C M S   A P I   R E S T   W I D G E T
##################################################################
cms.api.enabled=true
#cms.api.name options: [alfresco,sharepoint]
cms.api.name=alfresco
cms.api.user=admin
cms.api.password=<cmisAdminPassword>
cms.api.baseUrl=http://acs.k8s.gwcloud.it/alfresco
cms.api.rootPath=/Sites/TestSite/Documenti

MgInitializer

Service that initialize MapGuide WebTier using the provided webconfig.ini file.

Geoweb loading strategy

firstly is used the WEBCONFIG_INI_PATH absolute path configured inside the configuration.properties file (This is generally used in deployments where a dynamic behavior is needed, or that involves Linux + WebLogic, or Docker-like contexts)
secondarily from static contents
as last chance from classPath

Re-mapping

The remapConfiguration.properties mechanism that load properties from System Environment/Context variables is supported as well, and is often used when dynamic setting is needed.

So the path in WEBCONFIG_INI_PATH can be dynamically re-mapped to a System Environment/Context variable (configuring a mapping inside remapConfiguration.properties).

There is the possibility to dynamically override also the IpAddress and Port(s) properties set inside webconfig.ini file, using the appropriate configurations existing inside configuration.properties file (see all the mapguide.webconfig.ini.* properties below).

If at least one of the IpAddress and Port(s) properties is overridden. A new webconfig.ini file (named webconfig_mod.ini) will be created (at the same path) with the new configurations and given to be processed by the MapGuideJavaApi.MgInitializeWebTier(path) java API. The IpAddress is handled by MapGuide only in the IPV4 form, but it can come from configuration.properties/SystemEnvVariables as a IPV6 or a host name. In case of host name, it will be resolved using a DNS service, converted in a IPV4 format address. In case of IPV6 address, it will be converted in the equivalent IPV4, only when possible. In all cases the new IP address will be set into the new webconfig_mod.ini file in IPV4 format. IpAddress can be composed by more than one IP address, comma separated (','), in all the supported formats above. If more than one IP address is configured, all the invalid ones will be not used, logging the fact. MapGuide will be however initialized with the remaining valid IP addresses.

Automatic resource package load

Before version 4.4.0 it was possible to export/import inside MapguideServer the .mpg resources files only using MapGuide Maestro. Now there is an automatic procedure that look for all the packages with extension .mpg existing under this path [geowebfolder]/mapguide/ The [geowebfolder] is configurable under configuration.properties. If the file is found, GeoWeb try to load to all the available .mpg files to all the MapGuide servers. MapGuide servers list is retrieved from the IpAddress property inside section SiteConnectionProperties inside webconfig.ini file. If more than one is configured, Geoweb expects them as a comma separated (',') list. Each packages can contains one or more folder with a resources structure. There is a mechanism that ensures that a single .mpg file, if not modified subsequently, it will not to be reloaded on MapGuide on the next server startup (the md5 of file is saved to check if file has changed at the next time). To perform this check there an improper use of a MapGuide metadata: Symbol. We choose to use a MapGuide metadata, like Symbols, because they are easily accessible through Java API from all the eventual existing Geoweb instances, that share the use of the one(multiple) MapGuide server(s). All Symbols used to persist loading informations are stored under a support folder called '_gw_packages_info', under the main MapGuide Library folder. A Symbol is created for each .mpg file. As 'Name' is used the .mpg file, without extension. 'Description' field is populated concatenating [md5hex]+'_@@@_'+[true/false]. The final boolean is a flag used to persist the 'isLoading' status during the loading resources process. If a Geoweb instance finds this flag set to true, is notified that another Geoweb instance is taking care of loading that resource package, and it will not care about doing it.

Automatic resource package processing

For every loading resource .mpg packages deeper elaborations maybe performed. All files *.FeatureSource_CONTENT.xml may to be modified if as <Provider> declare one the the handled types:

King.Oracle
OSGeo.PostgreSQL
OSGeo.SQLServerSpatial

On all matching files inside .mpg package is performed a substitution regarding the content of these tags:

<Service>
<Username>
<Password>
<DataStore>

The new tag content is retrieved from some specific properties inside configuration.properties file with this radix:

mapguide.resourcepackage.featuresource.*

All these properties support the remapConfiguration.properties mechanism that load properties from System Environment/Context variables.

Note: is important to be sure that the .mpg file will not to be used by another process at the Geoweb server startup (7zip for example). In that case Geoweb will not to be able to process the file, and an exception will be thrown. The exception will not to be blocking. So in case of multiple .mpg files each loading process will continue independently.

Esempi Log

Ecco alcuni esempi del log riepilogativo che viene prodotto in fase di startup del server Geoweb.

Un solo IpAddress configurato; un file .mpg trovato; elaborazione .mpg terminata con successo; risorsa caricata con successo;

------------------------------------------------------------------------------------------------
15-10-2019 10:18:18,085 [localhost-startStop-1] GEOWEB INFO
 
MgInizializer - init()
Now Geoweb wil try to load the webconfig.ini. This is the loading priority. Geoweb firstly look for the property mapguide.pathTo.webconfig.ini inside configuration.properties. Secondarily, if missing, Geoweb looks for the file webconfig.ini under static contents folder.As last chance Geoweb looks for the file webconfig.ini under the classPath.
Property mapguide.pathTo.webconfig.ini had been found inside configuration.properties file with valorized S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
Configured path refers to an existing file
Initializing MapGuide with the file: S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
applyResourcePackageInAllMapGuideServer()
Checking if there is a resource package to apply to MapGuide Server..
Loooking for folder S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide..
Folder S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide exists
building all the resource package in folder: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide
building resource package named: cde_test_2.mgp
siteAddressList: [192.168.0.225]
applyResourcePackage() - resourcePackage: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide\cde_test_2.mgp
computeMd5Hex() - file: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide\cde_test_2.mgp
md5 computed in nanoseconds: 12289400
computed md5Hex: 19f5ddb761d9bb4dc3668e5a1df234df
  * nAddressLeft: 1
  * attemp number: 1
  * currentSiteAddress: 192.168.0.225
  * Resource package correctly applied to MapGuide site address: 192.168.0.225
done
------------------------------------------------------------------------------------------------

Due IpAddress configurati (uno esistente ed uno finto); un file .mpg trovato; elaborazione .mpg terminata con successo; risorsa caricata con successo solo su un MapGuide address;

------------------------------------------------------------------------------------------------
15-10-2019 10:18:18,085 [localhost-startStop-1] GEOWEB INFO
 
MgInizializer - init()
Now Geoweb wil try to load the webconfig.ini. This is the loading priority. Geoweb firstly look for the property mapguide.pathTo.webconfig.ini inside configuration.properties. Secondarily, if missing, Geoweb looks for the file webconfig.ini under static contents folder.As last chance Geoweb looks for the file webconfig.ini under the classPath.
Property mapguide.pathTo.webconfig.ini had been found inside configuration.properties file with valorized S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
Configured path refers to an existing file
Initializing MapGuide with the file: S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
applyResourcePackageInAllMapGuideServer()
Checking if there is a resource package to apply to MapGuide Server..
Loooking for folder S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide..
Folder S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide exists
building all the resource package in folder: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide
building resource package named: cde_test_2.mgp
siteAddressList: [192.168.0.225, 192.168.0.168]
applyResourcePackage() - resourcePackage: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide\cde_test_2.mgp
computeMd5Hex() - file: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide\cde_test_2.mgp
md5 computed in nanoseconds: 12289400
computed md5Hex: 19f5ddb761d9bb4dc3668e5a1df234df
  * nAddressLeft: 2
  * attemp number: 1
  * currentSiteAddress: 192.168.0.225
  * Resource package correctly applied to MapGuide site address: 192.168.0.225
  * nAddressLeft: 1
  * Resource package had not been updated on n 1 MapGuide address: [192.168.0.168]
done
------------------------------------------------------------------------------------------------

Proprietà 'geowebfolder' configurata ma incorretta. Oppure mancanza della folder 'mapguide' dentro la geowebfolder

------------------------------------------------------------------------------------------------
15-10-2019 10:21:18,732 [localhost-startStop-1] GEOWEB INFO
 
MgInizializer - init()
Now Geoweb wil try to load the webconfig.ini. This is the loading priority. Geoweb firstly look for the property mapguide.pathTo.webconfig.ini inside configuration.properties. Secondarily, if missing, Geoweb looks for the file webconfig.ini under static contents folder.As last chance Geoweb looks for the file webconfig.ini under the classPath.
Property mapguide.pathTo.webconfig.ini had been found inside configuration.properties file with valorized S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
Configured path refers to an existing file
Initializing MapGuide with the file: S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
applyResourcePackageInAllMapGuideServer()
Checking if there is a resource package to apply to MapGuide Server..
Loooking for folder S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide..
Cannot load any resource package. Property geowebfolder inside file configuration.properties results configured but is incorrect.Resource package file must be placed under the specified folder, respecting the path: [geowebfolder]/mapguide/ and named with extension: .mgp.Please check that the configured name match the folder name in file system.
done
------------------------------------------------------------------------------------------------

Due IpAddress configurati (uno esistente ed uno finto); un file .mpg trovato; elaborazione .mpg fallita perchè file aperto con un programma esterno (7zip) durante lo startup del server; risorsa caricata solo su un server (ma senza elaborazione);

------------------------------------------------------------------------------------------------
15-10-2019 10:04:34,395 [localhost-startStop-1] GEOWEB INFO
 
MgInizializer - init()
Now Geoweb wil try to load the webconfig.ini. This is the loading priority. Geoweb firstly look for the property mapguide.pathTo.webconfig.ini inside configuration.properties. Secondarily, if missing, Geoweb looks for the file webconfig.ini under static contents folder.As last chance Geoweb looks for the file webconfig.ini under the classPath.
Property mapguide.pathTo.webconfig.ini had been found inside configuration.properties file with valorized S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
Configured path refers to an existing file
Initializing MapGuide with the file: S:/deploy/GW_MODULES_MG31/conf/webconfig.ini
applyResourcePackageInAllMapGuideServer()
Checking if there is a resource package to apply to MapGuide Server..
Loooking for folder S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide..
Folder S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide exists
building all the resource package in folder: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide
building resource package named: cde_test_2.mgp
S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide\cde_test_2.mgp: Impossibile accedere al file. Il file è utilizzato da un altro processo.
Error building resource package named: cde_test_2.mgp
siteAddressList: [192.168.0.225, 192.168.0.168]
applyResourcePackage() - resourcePackage: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide\cde_test_2.mgp
computeMd5Hex() - file: S:\deploy\GW_MODULES_MG31\WEB\geowebfolder\mapguide\cde_test_2.mgp
md5 computed in nanoseconds: 6628700
computed md5Hex: 1f769acff2fc69590a87699c4fbafe7f
  * nAddressLeft: 2
  * attemp number: 1
  * currentSiteAddress: 192.168.0.225
  * Resource package correctly applied to MapGuide site address: 192.168.0.225
  * nAddressLeft: 1
  * Resource package had not been updated on n 1 MapGuide address: [192.168.0.168]
done
------------------------------------------------------------------------------------------------

WorkflowInizializerService

WorkflowInizializerService, as well as common xInitializerService stuff, performs an automatic Activiti Process Definition (.bpmn file) deploy.

Before gw version 4.4.4 it was possible to handle Activiti deployments only from the Webadmin (manually managing the .bpmn files) Now there is an automatic procedure that look for all the Process Definitions files with .bpmn extension existing under this path

	[geowebfolder]/activiti/

The [geowebfolder] is configurable under configuration.properties file. If the file is found, GeoWeb try to load to all the available .bpmn files and to deploy them inside Activiti workflow engine.

In geoweb exist the following convention:

Activiti Process Definition ID ⇐= matches =⇒ GwProcess name

This convention is respected even here: the name of every .bpmn file HAVE TO MATCH with one GwProcess name. If a relation is found, the .bpmn is deployed and linked to the GwProcess. This is not an Activiti requirement, that blocks the ProcessDefinition deploy, but it is simply an our choice in aim to avoid to erroneously deploying things unrelated to GwProcess.

There is a mechanism that ensures that a single .bpmn file, if not modified subsequently, it will not to be deployed again on Activiti on the next server startups: a md5 check is performed at this purpose. If we want to exclude that md5 check there is a flag to enable inside configuration.properties (default false)

workflow.activiti.forceDeploy.enabled=true

TODO

Dalla versione 4.6.x è stato introdotto il concetto di evento e di registrazione degli eventi. Per questo, sono stati predisposti dei nuovi servizi che si occupano proprio di registrare gli eventi creati sia a livello di configurazione, sia a livello di utilizzo base del framework (ad esempio in caso di operazioni CRUD in tabella).

Gli eventi vengono registrati su apposite tabelle ma anche nel database non relazionale ElasticSearch. In quest'ultimo caso, affinché possa avvenire la connessione al database, è necessario che nel configuration.properties siano presenti e correttamente valorizzati i seguenti nuovi parametri:

######################################################################
#    E L A S T I C   S E A R C H 
######################################################################
# These parameters are used for insert events in elasticSearch
elastic.search.url=http://elastic.k8s.gwcloud.it/
elastic.search.user=geoweb
elastic.search.password=<password>
elastic.search.index.name=<realm>

Inoltre, per la corretta registrazione degli eventi, è necessario valorizzare anche i seguenti nuovi parametri, che si riferiscono al modulo e alla piattaforma dell'applicativo:

##################################################################
#    P L A T F O R M      A N D      M O D U L E
##################################################################
codPlatform=
codModule=

Versione 4.6.x

Client

Admin

Dettaglio Sezioni

MongoDB