Home > Installation

Main Configuration (mdm.properties file)

The file mdm.properties centralizes configuration for webMethods MDM. The definition of its access path is detailed in the section Deployment on a J2EE application server

License activation (license key)

#################################################
## webMethods MDM License number
## (as specified by your license agreement)
#################################################

mdm.license=paste_here_your_license_key

mdm_home directory

This parameter specifies the access path to the mdm_home directory. By default, webMethods MDM uses the environment variable defined in the system properties (see section Installation - Getting Started).

## This property is used later in this file (see "${mdm.home}")
## It is not required otherwise by webMethods MDM.
## (as stated above "${mdm.home}" will first look on system properties
## so this assignment provides a default value)
mdm.home=

Root directory

This the directory that contains the archives, the history and HSQLDB server files (when the repository is using this server in standalone mode).

#################################################
## Path for webMethods MDM XML repository
#################################################
mdm.repository.directory=${mdm.home}/mdmRepository

Handling temporary files

Temporary files are stored such as :

# The property mdm.temp.directory allows to specify a directory for temporary files.
# Default value is java.io.tmpdir
#
mdm.temp.directory = ${java.io.tmpdir}
#mdm.temp.directory = /tmp/java

webMethods MDM Repository Preloading

This parameter specifies whether repository shall be preloaded at server startup.

#################################################
## Specifies whether repository shall be preloaded at server startup.
## Value must be one of: true, false
## Default value is true.
#################################################
#mdm.repository.preload=false

webMethods MDM Repository Persistence

webMethods MDM repository uses one of the following persistence layers: HSQLDB (default), Oracle DB or IBM DB2.

The installation required for each database is described in chapter Components.

################################################################
## The maximum time to set up the database connection,
## in milliseconds.
################################################################
mdm.persistence.timeout=10000
################################################################
## The prefix to add to all table names of persistence system.
## This may be useful in some special cases of Hsqldb, Oracle, or Db2.
################################################################
mdm.persistence.table.prefix=
################################################################
## Case webMethods MDM persistence system is Hsqldb 'standalone'.
################################################################
mdm.persistence.factory=hsql.standalone mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy ################################################################
## Case webMethods MDM persistence system is Hsqldb 'server mode',
##
## If Hsqldb is declared as JNDI data source in your application server, only mdm.persistence.factory is necessary,
## but mdm.persistence.url, mdm.persistence.user and mdm.persistence.password must be removed.
################################################################
mdm.persistence.factory=hsql.server mdm.persistence.url=jdbc:hsqldb:hsql://127.0.0.1/mdmDatabase mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy ################################################################
## Case webMethods MDM persistence system is Oracle
##
## If Oracle is declared as JNDI data source in your application server, only mdm.persistence.factory is necessary,
## but mdm.persistence.url, mdm.persistence.driver, mdm.persistence.user and mdm.persistence.password must be removed.
################################################################
mdm.persistence.factory=oracle mdm.persistence.url=jdbc:oracle:thin:@127.0.0.1:1521:mdmDatabase mdm.persistence.driver=oracle.jdbc.OracleDriver mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy ################################################################
## Case webMethods MDM persistence system is IBM DB2.
##
## If DB2 is declared as JNDI data source in your application server, only mdm.persistence.factory is necessary,
## but mdm.persistence.url, mdm.persistence.driver, mdm.persistence.user and mdm.persistence.password must be removed.
################################################################
mdm.persistence.factory=db2 mdm.persistence.url=jdbc:db2://127.0.0.1:50000/mdmDatabase mdm.persistence.driver=com.ibm.db2.jcc.DB2Driver mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy

Users Directory

This parameter specifies the Java directory factory class name. It must be defined only when Default webMethods MDM directory is not used.

#################################################
## Specifies the Java directory factory class name.
## Value must be the fully qualified name of the Java class.
## The class must extend com.softwareag.mdm.service.directory.DirectoryFactory.
#################################################
#mdm.directory.factory=xxx.yyy.DirectoryFactoryImpl

Logs

#################################################
## Directory of log files
## This property is used by special appender prefixed
## by 'mdmFile:' (see log section below)
#################################################
mdm.logs.directory=${mdm.home}/mdmLog

The most important logging categories are :

mdm.log4j.category.log.kernel category
- display at the launch of webMethods MDM configuration
- display of exceptions content
mdm.log4j.category.log.setup category
- display of compilation result of all webMethods MDM objects

#################################################
## Log4J properties:
##
## We have some specific syntax extensions:
## - Appender mdmFile:<aFileName>
## Defines a file appender with default settings (threshold=DEBUG)
##
## - property log.defaultConversionPattern is set by Java
#################################################
#mdm.log4j.debug=true #mdm.log4j.disableOverride= #mdm.log4j.disable= mdm.log4j.rootCategory= INFO mdm.log4j.category.log.kernel= INFO, Console, mdmFile:kernel, kernelMail mdm.log4j.category.log.persistence= INFO, mdmFile:persistence mdm.log4j.category.log.setup= INFO, Console, mdmFile:kernel mdm.log4j.category.log.mail= INFO, Console, mdmFile:mail mdm.log4j.category.log.frontEnd= INFO, Console, mdmFile:kernel mdm.log4j.category.log.frontEnd.incomingRequest= INFO mdm.log4j.category.log.frontEnd.requestHistory= INFO mdm.log4j.category.log.frontEnd.UIComponentInput= INFO mdm.log4j.category.log.fsm= INFO, Console, mdmFile:fsm mdm.log4j.category.log.fsm.dispatch= INFO mdm.log4j.category.log.fsm.pageHistory= INFO mdm.log4j.category.log.reporting= INFO, mdmFile:reporting mdm.log4j.category.log.reportingMail= INFO, mdmFile:reporting #mdm.log4j.category.log.reportingMail= INFO, mdmFile:reporting, reportingMail mdm.log4j.category.log.wbp= FATAL, Console #--------------------------------------------------
mdm.log4j.appender.Console.Threshold = INFO mdm.log4j.appender.Console=com.softwareag.mdm.org.apache.log4j.ConsoleAppender mdm.log4j.appender.Console.layout=com.softwareag.mdm.org.apache.log4j.PatternLayout mdm.log4j.appender.Console.layout.ConversionPattern=${log.defaultConversionPattern} #--------------------------------------------------
mdm.log4j.appender.kernelMail.Threshold = ERROR mdm.log4j.appender.kernelMail = com.softwareag.mdm.org.apache.log4j.net.SMTPAppender mdm.log4j.appender.kernelMail.To = admin@domain.com mdm.log4j.appender.kernelMail.From = admin${mdm.site.name} mdm.log4j.appender.kernelMail.SMTPHost = smtp.domain.com mdm.log4j.appender.kernelMail.Subject = webMethods MDM Error on Site ${mdm.site.name} (VM ${mdm.vm.id}) mdm.log4j.appender.kernelMail.layout.ConversionPattern=**Site ${mdm.site.name} (VM${mdm.vm.id})**%n${log.defaultConversionPattern} mdm.log4j.appender.kernelMail.layout = com.softwareag.mdm.org.apache.log4j.PatternLayout #--------------------------------------------------
mdm.log4j.appender.reportingMail.Threshold = ERROR mdm.log4j.appender.reportingMail = com.softwareag.mdm.org.apache.log4j.net.SMTPAppender mdm.log4j.appender.reportingMail.To = admin@domain.com mdm.log4j.appender.reportingMail.From = reporting@domain.com mdm.log4j.appender.reportingMail.SMTPHost = smtp.domain.com mdm.log4j.appender.reportingMail.Subject = webMethods MDM Reporting on Site ${mdm.site.name} (VM ${mdm.vm.id}) mdm.log4j.appender.reportingMail.layout.ConversionPattern=**Site ${mdm.site.name} (VM ${mdm.vm.id})**%n${log.defaultConversionPattern} mdm.log4j.appender.reportingMail.layout = com.softwareag.mdm.org.apache.log4j.PatternLayout

Mail configuration

webMethods MDM can activate the mail feature. It is used by webMethods Master Data Manager to inform the Administrator of changes on agreements and actors.

Those properties are independent from log configuration (send mail based on the log4J library).

#################################################
## Mail Manager parameters
## activate MailManager (true or false, default false)
## polling interval is in seconds (default is 10)
#################################################
mdm.mail.activate=true mdm.mail.smtp.host = smtp.domain.com #mdm.mail.polling.interval = 5 #mdm.mail.smtp.login= #mdm.mail.smtp.password=

Deployment site identification

This parameter allows you to specify the address for technical log mails.

#################################################
## Unique Site Name
## --> used by monitoring mails and by repository
#################################################
mdm.site.name= name@domain.com

Configuration hot reloading

Some parameters can be dynamically reloaded, without restarting webMethods MDM. The parameter ‘thisfile.checks.intervalInSeconds’ indicated the time interval between each mdm.properties verification.

#################################################
### Checks if this file has been updated
### If value <= 0, no more checks will be done
#################################################
thisfile.checks.intervalInSeconds=1

In development mode, this parameter can be set up to 1 second. On a production side, where changes are less frequent, the value can be greater, or set up to 0 to avoid hot-reloading.

This property is not always optional, if the module is deployed as a WAR (depends of the application server).

Applications that use webMethods MDM navigation engine

Those properties concern Web applications that use webMethods MDM internal navigation engine: mainly webMethods Master Data Manager.

Application template reloading:

#################################################
## Reload templates when it is updated
## (default value for all webMethods MDM modules).
## (value can be overrided by each webMethods MDM module.
#################################################
templates.checksIfUpdated=true

Debug mode in the webMethods MDM modules Web pages (use only when developing):

#################################################
## End-User Debug Mode
## (default for all webMethods MDM modules ).
## Debug information appears on end-user web page.
#################################################
frontEnd.debugMode=false

Running mode

This property defines how webMethods MDM runs. The developer assistant is activated in webMethods Master Data Manager only in development mode.

#################################################
## Server Mode
## Value must be one of: development, integration, production
## Default is production.
#################################################
backend.mode=integration

Resource filtering

This property allows to filter some files and directories in the resources directories content (resource type node, with an associated facet that indicate the directory that contains usable resources).

#################################################
## list (separated by comma) of regexps excluding resource
## the regexp must be of type "m:[pattern]:[options]".
## the list can be void
#################################################
mdm.resource.exclude=m:CVS/*:

Session persistence

Those properties concern Web applications that use webMethods MDM internal session persistence: mainly webMethods Master Data Manager.

By default, in mdm.properties, the property that indicate the directory for session persistence is:

#################################################
## Deprecated.
## Path for persisted sessions
#################################################
mdm.sessions.directory=${mdm.home}/mdmSession

Activity reports

Files generated by the reporting feature are located in a directory defined by the following property:

#################################################
## Deprecated.
## Path for reporting files
#################################################
mdm.reports.directory=${mdm.home}/mdmReporting

Activation and configuration of the reporting feature is achieved in mdm.properties with:

#################################################
## Deprecated.
## Automatic reporting batch parameters
## By default automatic reporting batch is not activate
## If automatic reporting batch is activated, it is
## schedule by default at 03:00 AM
##################################################
#mdm.reports.activate=true #mdm.reports.timer.hour = 2 #mdm.reports.timer.minute = 30
#################################################
## Deprecated.
## Config VM logs (for reporting feature)
## MUST start at index 0.
#################################################
#vm.0.logDir=${mdm.home}/mdmLog #vm.1.logDir=${mdm.home}/mdmLog

URLs computing

By default, webMethods MDM runs in "standalone" mode: external resources (images, javascripts...) are served by the application server.

By default, URL-related parameters in mdm.properties don't have to be filed.
In this case, the server name and the port are get from the initial request (for webMethods Master Data Manager tool).

##################################################################
## webMethods MDM FrontServlet: default properties for computing servlet address
##
## {useLocalUrl}:
## If set to true, servlet address is a "local absolute" URL.
## (that is, a relative URL consisting of an absolute path: "/path")
## See RFC 2396, http://www.ietf.org/rfc/rfc2396.txt).
## This property is defined once for HTTP and HTTPS.
## Default value is false.
##
## {host}:
## If neither defined nor adapted, retrieves initial request host
## {port}:
## If neither defined nor adapted, retrieves initial request host
## {path}:
## Mandatory, may be empty
##
## Resulting address will be:
## protocol://{host}:{port}/{path}
##
## Each property for HTTP (except {port}) may be inherited from HTTPS property,
## and reciprocally.
##################################################################
#mdm.servlet.useLocalUrl=true #mdm.servlet.http.host= #mdm.servlet.http.port= mdm.servlet.http.path=mdm/ #mdm.servlet.https.host= #mdm.servlet.https.port= #mdm.servlet.https.path= ##################################################################
## External resources: default properties for computing external resources address
##
## The same rules apply as webMethods MDM FrontServlet properties (see comments).
##
## Each property may be inherited from webMethods MDM FrontServlet.
##################################################################
#mdm.externalResources.useLocalUrl=true #mdm.externalResources.http.host= #mdm.externalResources.http.port= #mdm.externalResources.http.path= #mdm.externalResources.https.host= #mdm.externalResources.https.port= #mdm.externalResources.https.path=

Proxy Mode

The proxy mode allows to use a front HTTP server to serve static resources (images, css, javascripts...). This architecture reduces the charge on the application server for static HTTP requests. In addition, this configuration allows to use SSL security on the front server.

The Web server transmits requests to the application server, regarding a path in the URL.
This ‘servletAlias’ path is specified in mdm.properties.

The Web server serves all external resources. Those resources are stored in a dedicated directory, accessible with the path ‘resourcesAlias’.

In addition, webMethods MDM must be able to access external resources by the file system (at adaptation model and adaptations compilation time). To do so, specificy the property mdm.webapps.directory.externalResources.

mdm.properties can be configured this way:

#################################################
## Path for external resources if they are not
## delivered within web applications
## This field is mandatory if in proxy mode.
#################################################
mdm.webapps.directory.externalResources= D:/http/resourcesFolder #################################################
#mdm.servlet.useLocalUrl=true #mdm.servlet.http.host= #mdm.servlet.http.port= mdm.servlet.http.path= servletAlias #mdm.servlet.https.host= #mdm.servlet.https.port= mdm.servlet.https.path= servletAlias #################################################
#mdm.externalResources.useLocalUrl=true #mdm.externalResources.http.host= #mdm.externalResources.http.port= mdm.externalResources.http.path= resourcesAlias #mdm.externalResources.https.host= #mdm.externalResources.https.port= mdm.externalResources.https.path= resourcesAlias

Reverse Proxy Mode

URLs generated by webMethods MDM for requests and externalo resources must contain a server name, a port number and a specific path prefix.

mdm.properties can be configured this way:

#################################################
mdm.servlet.http.host= reverseDomain #mdm.servlet.http.port= mdm.servlet.http.path=mdm/ mdm.servlet.https.host= reverseDomain #mdm.servlet.https.port= mdm.servlet.https.path=mdm/ #################################################
## Web parameters (for external resources)
## if nothing is set, values are taken from servlet.
#################################################
mdm.externalResources.http.host= reverseDomain #mdm.externalResources.http.port= #mdm.externalResources.http.path=mdm/ mdm.externalResources.https.host= reverseDomain #mdm.externalResources.https.port= mdm.externalResources.https.path=mdm/

Tuning

Some options can be set so as to enhance the memory space usage.

mdm.properties can be configured this way:

################################################################
## Technical parameters for memory and performance tuning
################################################################

# Import commit threshold allows to specify the commit threshold
# exclusively for the archive import launched directly from Manager.
#
# For more details about the commit threshold, see the JavaDoc ProcedureContext.setCommitThreshold().
# Default value is 0.
#
mdm.manager.import.commit.threshold=100
# Validation messages threshold allows to specify the maximum number of messages to consider
# when performing a validation.
# This threshold is considered for each severity in each validation report.
# When the threshold is reached:
# - for severities 'error' or 'fatal', the validation is stopped.
# - for severities 'info' or 'warning', the validation continues without
# registering messages beyond the threshold. However the number of messages
# is still counted and messages of other severities can still be added.
#
# When set to 0 or a negative value the threshold is not considered.
# Default value is 0.
#
mdm.validation.messages.threshold=0

Configuration principale (fichier mdm.properties)

Le fichier mdm.properties centralise la configuration globale de webMethods MDM. La définition de son chemin d’accès est détaillée dans la section Déploiement sur un serveur d'application J2EE.

Activation de licence (numéro de licence)

#################################################
## webMethods MDM License number
## (as specified by your license agreement)
#################################################

mdm.license=paste_here_your_license_key

Répertoire mdm_home

Ce paramètre permet d'indiquer le chemin d'accès au répertoire mdm_home. Par défaut, webMethods MDM utilise la variable d'environnement définie dans les propriétés système (voir la section Démarrage rapide ).

Répertoire racine

Ce répertoire contient les archives, les fichiers d'historisation ainsi que les fichiers HSQLB (quand le référentiel utilise ce serveur en mode standalone).

#################################################
## Path for webMethods MDM XML repository
#################################################
mdm.repository.directory=${mdm.home}/mdmRepository

Gestion des fichiers temporaires

Les fichiers temporaires sont stockés dans le répertoire défini comme suit :

# The property mdm.temp.directory allows to specify a directory for temporary files.
# Default value is java.io.tmpdir
#
mdm.temp.directory = ${java.io.tmpdir}
#mdm.temp.directory = /tmp/java

Préchargement du référentiel webMethods MDM

Par défaut, le référentiel webMethods MDM est chargé au démarrage du serveur.

Persistance du référentiel webMethods MDM

Le référentiel webMethods MDM est basé sur un des systèmes de persistance suivants : HSQLDB (défaut), Oracle DB ou IBM DB2

L'installation nécessaire à chaque base de données est traitée au chapitre Composants.

################################################################
## The maximum time to set up the database connection,
## in milliseconds.
################################################################
mdm.persistence.timeout=10000 ################################################################
## The prefix to add to all table names of persistence system.
## This may be useful in some special cases of Hsqldb, Oracle, or Db2.
################################################################
mdm.persistence.table.prefix= ################################################################
## Case webMethods MDM persistence system is Hsqldb 'standalone'.
################################################################
mdm.persistence.factory=hsql.standalone mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy ################################################################
## Case webMethods MDM persistence system is Hsqldb 'server mode',
##
## If Hsqldb is declared as JNDI data source in your application server, only mdm.persistence.factory is necessary,
## but mdm.persistence.url, mdm.persistence.user and mdm.persistence.password must be removed.
################################################################
mdm.persistence.factory=hsql.server mdm.persistence.url=jdbc:hsqldb:hsql://127.0.0.1/mdmDatabase mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy ################################################################
## Case webMethods MDM persistence system is Oracle
##
## If Oracle is declared as JNDI data source in your application server, only mdm.persistence.factory is necessary,
## but mdm.persistence.url, mdm.persistence.driver, mdm.persistence.user and mdm.persistence.password must be removed.
################################################################
mdm.persistence.factory=oracle mdm.persistence.url=jdbc:oracle:thin:@127.0.0.1:1521:mdmDatabase mdm.persistence.driver=oracle.jdbc.OracleDriver mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy ################################################################
## Case webMethods MDM persistence system is IBM DB2.
##
## If DB2 is declared as JNDI data source in your application server, only mdm.persistence.factory is necessary,
## but mdm.persistence.url, mdm.persistence.driver, mdm.persistence.user and mdm.persistence.password must be removed.
################################################################
mdm.persistence.factory=db2 mdm.persistence.url=jdbc:db2://127.0.0.1:50000/mdmDatabase mdm.persistence.driver=com.ibm.db2.jcc.DB2Driver mdm.persistence.user=xxxxxxxxx mdm.persistence.password=yyyyyyyy

Annuaire des utilisateurs

Ce paramètre spécifie le nom de la classe Java qui construit l'annuaire spécifique. Il ne doit être défini que si l'annuaire par défaut de webMethods MDM n'est pas utilisé.

Logs

Deux catégories Log4J sont importantes :

Catégorie mdm.log4j.category.log.kernel
- affichage au lancement de la configuration de webMethods MDM
- affichage du contenu de toutes les exceptions générées (pile d'exécution).
Catégorie mdm.log4j.category.log.setup
- affichage du résultat de compilation de tous les objets de webMethods MDM

Pour désactiver la création d'un fichier de log ou pour que des mails de logs ne soient pas envoyés, il suffit de commenter dans mdm.properties la ligne décrivant la catégorie log4j correspondante. Dans l'exemple suivant, seuls kernel.log, setup.log et fsm.log sont créés.

#################################################
## Log4J properties:
##
## We have some specific syntax extensions:
## - Appender mdmFile:<aFileName>
## Defines a file appender with default settings (threshold=DEBUG)
##
## - property log.defaultConversionPattern is set by Java
#################################################
#mdm.log4j.debug=true #mdm.log4j.disableOverride= #mdm.log4j.disable= mdm.log4j.rootCategory= INFO mdm.log4j.category.log.kernel= INFO, Console, mdmFile:kernel, kernelMail mdm.log4j.category.log.persistence= INFO, mdmFile:persistence mdm.log4j.category.log.setup= INFO, Console, mdmFile:kernel mdm.log4j.category.log.mail= INFO, Console, mdmFile:mail mdm.log4j.category.log.frontEnd= INFO, Console, mdmFile:kernel mdm.log4j.category.log.frontEnd.incomingRequest= INFO mdm.log4j.category.log.frontEnd.requestHistory= INFO mdm.log4j.category.log.frontEnd.UIComponentInput= INFO mdm.log4j.category.log.fsm= INFO, Console, mdmFile:fsm mdm.log4j.category.log.fsm.dispatch= INFO mdm.log4j.category.log.fsm.pageHistory= INFO mdm.log4j.category.log.reporting= INFO, mdmFile:reporting mdm.log4j.category.log.reportingMail= INFO, mdmFile:reporting #mdm.log4j.category.log.reportingMail= INFO, mdmFile:reporting, reportingMail mdm.log4j.category.log.wbp= FATAL, Console #--------------------------------------------------
mdm.log4j.appender.Console.Threshold = INFO mdm.log4j.appender.Console=com.softwareag.mdm.org.apache.log4j.ConsoleAppender mdm.log4j.appender.Console.layout=com.softwareag.mdm.org.apache.log4j.PatternLayout mdm.log4j.appender.Console.layout.ConversionPattern=${log.defaultConversionPattern} #--------------------------------------------------
mdm.log4j.appender.kernelMail.Threshold = ERROR mdm.log4j.appender.kernelMail = com.softwareag.mdm.org.apache.log4j.net.SMTPAppender mdm.log4j.appender.kernelMail.To = admin@domain.com mdm.log4j.appender.kernelMail.From = admin${mdm.site.name} mdm.log4j.appender.kernelMail.SMTPHost = smtp.domain.com mdm.log4j.appender.kernelMail.Subject = webMethods MDM Error on Site ${mdm.site.name} (VM ${mdm.vm.id}) mdm.log4j.appender.kernelMail.layout.ConversionPattern=**Site ${mdm.site.name} (VM${mdm.vm.id})**%n${log.defaultConversionPattern} mdm.log4j.appender.kernelMail.layout = com.softwareag.mdm.org.apache.log4j.PatternLayout #--------------------------------------------------
mdm.log4j.appender.reportingMail.Threshold = ERROR mdm.log4j.appender.reportingMail = com.softwareag.mdm.org.apache.log4j.net.SMTPAppender mdm.log4j.appender.reportingMail.To = admin@domain.com mdm.log4j.appender.reportingMail.From = reportingMDM@domain.com mdm.log4j.appender.reportingMail.SMTPHost = smtp.domain.com mdm.log4j.appender.reportingMail.Subject = webMethods MDM Reporting on Site ${mdm.site.name} (VM ${mdm.vm.id}) mdm.log4j.appender.reportingMail.layout.ConversionPattern=**Site ${mdm.site.name} (VM ${mdm.vm.id})**%n${log.defaultConversionPattern} mdm.log4j.appender.reportingMail.layout = com.softwareag.mdm.org.apache.log4j.PatternLayout

Configuration de la messagerie

webMethods MDM peut activer ou non la messagerie. Entre autres, elle est utilisée par webMethods Master Data Manager pour informer l’administrateur de changements sur les accords et sur les acteurs.

Ces propriétés sont indépendantes de la configuration des logs (envoi de mail basé sur la librairie log4j).

Identification du site de déploiement

Le paramètre suivant permet d'identifier le site de déploiement pour l’envoi des messages de logs techniques.

Rechargement à chaud de la configuration

Certains paramètres peuvent être rechargés dynamiquement sans avoir à réinitialiser webMethods MDM. Le paramètre ‘thisfile.checks.intervalInSeconds’ indique l'intervalle de temps entre chaque vérification du fichier mdm.properties.

En développement ce paramètre peut être positionné à 1 seconde, pour des questions de réactivité. Sur un site de production, où les changements de configuration sont moins fréquents, cette valeur peut être plus élevée, ou bien être mise à zéro, pour empêcher toute reprise à chaud de changements.

Cette propriété n’est pas toujours opérationnelle si le module est déployé en mode WAR (dépend du serveur d’application).

Applications utilisant le moteur de navigation webMethods MDM

Ne sont concernées par ces propriétés que les applications Web qui utilisent le moteur interne de navigation webMethods MDM. webMethods Master Data Manager en fait partie.

Rafraîchissement des maquettes des applications:

Mode debug dans les pages web des modules webMethods MDM (à utiliser uniquement lors de développement) :

Mode de fonctionnement

Cette propriété définit le mode de fonctionnement de webMethods MDM. L'assistant développeur n'est activé dans webMethods Master Data Manager qu'en mode development.

Filtrage de ressources

Cette propriété permet de filtrer un certain nombre de fichiers et répertoires dans le contenu des répertoires de ressource (nœud de type ressource, avec une facette associée indiquant le répertoire contenant les ressources utilisables).

Persistence de sessions

Ne sont concernées par ces propriétés que les applications Web qui utilisent une gestion de contexte webMethods MDM. webMethods Master Data Manager en fait partie. Les applications qui persistent les contextes webMethods MDM (sessions utilisateur) ont besoin d’un répertoire de sauvegarde.

Par défaut, dans mdm.properties, la propriété indiquant le répertoire est :

#################################################
## Deprecated.
## Path for persisted sessions
#################################################
mdm.sessions.directory=${mdm.home}/mdmSession

Rapports d’activité

Les fichiers générés par la fonctionnalité de reporting sont regroupés dans un répertoire défini par la propriété suivante :

#################################################
## Deprecated.
## Path for reporting files
#################################################
mdm.reports.directory=${mdm.home}/mdmReporting

L’activation et la configuration de la fonctionnalité de reporting se fait dans mdm.properties avec :

#################################################
## Deprecated.
## Automatic reporting batch parameters
## By default automatic reporting batch is not activate
## If automatic reporting batch is activated, it is
## schedule by default at 03:00 AM
##################################################
#mdm.reports.activate=true #mdm.reports.timer.hour = 2 #mdm.reports.timer.minute = 30
#################################################
## Config VM logs (for reporting feature)
## MUST start at index 0.
#################################################
#vm.0.logDir=${mdm.home}/mdmLog #vm.1.logDir=${mdm.home}/mdmLog

Calcul des URLs

Par défaut, webMethods MDM fonctionne en mode « standalone » : les ressources externes (images, javascripts, etc…) sont servies par le serveur d’application.

Par défaut, les paramètres du fichier mdm.properties portant sur les URLs n’ont pas besoin d’être renseignées.
Dans ce cas, le nom du serveur et le port sont déduits de la requête initiale (pour l'outil webMethods Master Data Manager).

Mode Proxy

Le mode proxy permet d'utiliser un serveur HTTP en frontal pour servir les ressources statiques (images, css , javascripts, etc..). Cette architecture a pour avantage de décharger le serveur d'applications des requêtes HTTP statiques. Cette configuration permet également de prendre en charge la sécurité SSL au niveau du serveur frontal.

Le serveur Web transmet les requêtes vers le serveur d’application en fonction d’un chemin présent dans l’URL.
Ce chemin ‘servletAlias’ est décrit dans les propriétés d’mdm.properties.

Le serveur Web sert toutes les ressources externes. Ces dernières sont mises dans un répertoire dédié, accessible par le chemin ‘resourcesAlias’.

De plus, webMethods MDM doit pouvoir accéder par le système de fichiers aux ressources externes (lors de la compilation du modèle de données et des adaptations). Pour cela, il faut renseigner la propriété mdm.webapps.directory.externalResources.

Le fichier mdm.properties peut être configuré comme suit :

Mode Reverse Proxy

Les URLs générées par webMethods MDM pour les requêtes et les ressources externes doivent contenir un nom de serveur, un numéro de port et un préfixe de chemin spécifiques.

Le fichier mdm.properties peut être configuré comme suit :

Tuning

Il est possible de préciser certains paramètres afin d'optimiser l'utilisation mémoire.

Le fichier mdm.properties peut être configuré comme suit :

Home > Installation

Copyright © Software AG 2000-2007. All rights reserved.
Trademarks and brand names referred to in this web site relating to organizations
other than Software AG are the property of those organizations
and Software AG makes no claims to such property.