Home > Installation

Install Note for Tomcat (Version 5.0.* or 5.5.*)

Warnings

  • This chapter describes a quick installation example of webMethods MDM on Tomcat Application Server.
  • It does not replace the documentation of this application server.
  • It is not a general installation recommendation, since current installation process is fixed by architecture choices (technical environment, applications mutualization, delivery process, company choices, etc.).
  • The complete description of the components needed by webMethods MDM is given in chapter Components.
  • In order to avoid unpredictable behavior, the minimal rule to follow is to avoid any duplication of mdm.jar or other libraries on the class-loading system.
  • The description below uses the variable name $CATALINA_HOME to refer to the directory into which you have installed Tomcat 5, and is the base directory against which most relative paths are resolved. However, if you have configured Tomcat 5 for multiple instances by setting a CATALINA_BASE directory, you should use $CATALINA_BASE instead of $CATALINA_HOME for each of these references.

Installation Example Overview

  • Create the MDM_HOME directory: uncompress mdm_home.zip
  • Install webMethods MDM libraries : add libraries (jar files) to tomcat shared lib directory
  • Configure JVM arguments (Java system properties) : create the JAVA_OPTS environment variable
  • Deploy webMethods MDM application : copy all war files to tomcat webapps directory

Installation Example Detail

  • 1. Create a MDM_HOME directory, for example C:\MDM\home
  • 2. Uncompress the webMethodsMDM.software\files\mdm_home.zip file to MDM_HOME. In our example, after uncompression, we will have the following files:

C:\MDM\home\mdmRepository, a directory
C:\MDM\home\schemas, a directory
C:\MDM\home\mdm.properties, a text file

  • 3. Copy mdm.jar to $CATALINA_HOME\shared\lib\ (or $CATALINA_BASE\shared\lib\) directory. The file mdm.jar is provided in the directory webMethodsMDM.software\lib\. In our example, we will have:

$CATALINA_HOME\shared\lib\mdm.jar

  • 4. Copy third-party library files to $CATALINA_HOME\shared\lib\ (or $CATALINA_BASE\shared\lib\) directory. In our example, we will have:

$CATALINA_HOME\shared\lib\activation.jar
$CATALINA_HOME\shared\lib\mail.jar
$CATALINA_HOME\shared\lib\hsqldb.jar

The exact description of these components is given in chapter Components. Obviously, if those components are already deployed on the class-loading system, they don't have to be duplicated.
  • 5. Copy the war files in webMethodsMDM.software\webapps\wars-packaging to the $CATALINA_HOME\webapps\ (or $CATALINA_BASE\webapps\) directory. In our example, we will have:

$CATALINA_HOME\webapps\mdm.war : Initialization servlet for webMethods MDM applications
$CATALINA_HOME\webapps\mdm-root.war : Provides a common default configuration for adaptation models and adaptations
$CATALINA_HOME\webapps\mdm-manager.war : Master Data Management Web application

  • 6. Modify $CATALINA_HOME\conf\server.xml (or $CATALINA_BASE\conf\server.xml) file. Add the following line to the <Host> element

<Context path="/mdm" crossContext="true" docBase="mdm.war"/>

After this modification, we will have :

<Host name=...>
... ...
<Context path="/mdm" crossContext="true" docBase="mdm.war"/>
... ...
</Host>

  • 7. Configure launch properties

If our tomcat is launched by a command in Windows' DOS console or Unix shell, we can create another launcher file:

In Windows, the launcher file can be start_mdm.bat, which has the following:

set MDM_HOME=<path_to_the_directory_mdm_home>
set JAVA_OPTS=-Dmdm.home=%MDM_HOME% -Dmdm.properties=%MDM_HOME%\mdm.properties
call %CATALINA_HOME%\bin\startup.bat

In Unix, the launcher file can be start_mdm.sh, which has the following:

export MDM_HOME=<path_to_the_directory_mdm_home>
export JAVA_OPTS="$JAVA_OPTS"
-Dmdm.properties=$MDM_HOME/mdm.properties
-Dmdm.home=$MDM_HOME
exec $CATALINA_HOME/bin/startup.sh

(!) Accounts used to launch webMethods MDM must have create/update/delete rights on $MDM_HOME directory.

Windows users that have installed Tomcat as a service may set Java options through the Tomcat service manager GUI (Java tab).
Be sure to set options on separate lines in the Java Options field of the GUI. e.g.:

-Dmdm.home=<path_to_the_directory_mdm_home>
-Dmdm.properties=<path_to_the_directory_mdm_home>\mdm.properties

where <path_to_the_directory_mdm_home> is the directory where we have uncompressed mdm_home.zip. In our example, it's C:\MDM\home

  • 8. Activate your license

webMethods MDM requires a valid license key. This license key is provided:

  • on demand if you've downloaded (or get a CD) a trial edition,
  • with your license contract if you've purchased an webMethods MDM license.

Your license key must be pasted in %MDM_HOME%\mdm.properties file:

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

mdm.license=paste_here_your_license_key

  • 9. Verify the installation

After launched Tomcat, we can launch the webMethods Master Data Manager Web application:

The connection screen to webMethods Master Data Manager is displayed.

  • 10. Describe the Administrator organization

The Administrator organization is responsible for webMethods MDM administration. For more information, please read the Administrator Guide.

Log into webMethods Master Data Manager to edit organization and users:

Click on the PROFILE menu, then link Organization and edit information by clicking on Edit button.

To edit your user profile, click on My Profile menu and then edit your personal profile.

  • 11. Describe provider organization

webMethods MDM repository comes with a default provider organization. This organization is the webMethods MDM user. Every root adaptation created are owned by this organization.

Click on the PROFILE menu and edit information by clicking on Edit button.

To edit the user profile, click on My Profile menu and then edit the personal profile.

By default, webMethods Master Data Manager - Provider role, is launched in "developer mode". This mode is indicated by a yellow bar on the top of the screen.

Note d'installation sur Tomcat (version 5.0.* ou 5.5.*)

Avertissements

  • Ce chapitre décrit un exemple d'installation rapide de webMethods MDM sur Tomcat Application Server.
  • Il ne remplace pas la documentation de ce serveur d'application.
  • Ce n'est pas une recommandation générale d'installation, puisque le processus réel d'installation est basé sur des choix d'architecture (environnement technique, mutualisation des applications, procédures de livraison, choix d'entreprise, etc.).
  • La description des composants requis et optionnels pour webMethods MDM est fournie dans le chapitre Composants.
  • Afin d'éviter tout comportement imprévisible, la règle minimale à suivre est d'éviter toute duplication du fichier mdm.jar ou de toute autre bibliothèque sur le système de class-loading du serveur d'application.
  • La description ci-dessous emploie le nom de variable CATALINA_HOME pour se rapporter au répertoire dans lequel vous avez installé Tomcat 5, et par rapport auquel la plupart des chemins relatifs sont résolus. Cependant, si vous avez configuré Tomcat 5 pour gérer des instances multiples en décrivant un répertoire CATALINA_BASE, vous devriez employer CATALINA_BASE au lieu de CATALINA_HOME pour chacune de ces références.

Résumé de l'exemple de procédure

  • Créer le répertoire MDM_HOME: décompresser mdm_home.zip
  • Installer les librairies de webMethods MDM  : ajouter les librairies (fichiers jar) au répertoire des bibliothèques partagées de tomcat
  • Configurer JVM arguments (Java system properties) : créer la variable d’environnement, JAVA_OPTS
  • Déployer l’application webMethods MDM : copier les fichiers war dans le répertoire webapps de tomcat

Détail de l'exemple de procédure

  • 1. Créer un répertoire en tant que MDM_HOME, par exemple, C:\MDM\home
  • 2. Décompresser le fichier webMethodsMDM.software\files\mdm_home.zip vers MDM_HOME. Dans notre exemple, après la décompression, nous aurons les fichiers suivants:

C:\MDM\home\mdmRepository, un répertoire
C:\MDM\home\schemas, un répertoire
C:\MDM\home\mdm.properties, un fichier texte

  • 3. Copier le fichier mdm.jar dans le répertoire $CATALINA_HOME\shared\lib\ (ou $CATALINA_BASE\shared\lib\). Le fichier se trouve dans le répertoire webMethodsMDM.software\lib\. Dans notre example, nous aurons:

$CATALINA_HOME\shared\lib\mdm.jar

  • 4. Copier les librairies tierces dans le répertoire $CATALINA_HOME\shared\lib\ (ou $CATALINA_BASE\shared\lib\). Dans notre exemple, nous aurons:

$CATALINA_HOME\shared\lib\activation.jar
$CATALINA_HOME\shared\lib\mail.jar
$CATALINA_HOME\shared\lib\hsqldb.jar

Ces librairies tierces sont décrites de manière plus détaillée au chapitre Composants. Evidemment elles ne sont pas à installer si elles sont déjà intégrées au système de class-loading du serveur.
  • 5. Copier les fichiers war, qui se trouvent dans le répertoire webMethodsMDM.software\webapps\wars-packaging, vers le répertoire $CATALINA_HOME\webapps\. Dans notre example, nous aurons:

$CATALINA_HOME\webapps\mdm.war : Servlet d'entrée commune aux outils webMethods MDM
$CATALINA_HOME\webapps\mdm-root.war : Ensemble de fichiers qui permettent de fournir une configuration par défaut aux modèles d'adaptation (schémas XML) et adaptations
$CATALINA_HOME\webapps\mdm-manager.war : Application web de gestion des données webMethods Master Data Manager

  • 6. Modifier le fichier $CATALINA_HOME\conf\server.xml (ou $CATALINA_BASE\conf\server.xml). Ajouter la ligne suivante dans l'élement <Host>

<Context path="/mdm" crossContext="true" docBase="mdm.war"/>

Après cette modification, nous aurons :

<Host name=...>
... ...
<Context path="/mdm" crossContext="true" docBase="mdm.war"/>
... ...
</Host>

  • 7. Configuration des propriétés de lancement

Si tomcat est lancé à partir d'une commande, dans une console DOS de Windows ou un shell Unix, nous pouvons créer un nouveau fichier de lancement:

Dans le cas de Windows, ce fichier de lancement, par example start_mdm.bat, aura les lignes suivantes:

set MDM_HOME=<path_to_the_directory_mdm_home>
set JAVA_OPTS=-Dmdm.home=%MDM_HOME% -Dmdm.properties=%MDM_HOME%\mdm.properties
call %CATALINA_HOME%\bin\startup.bat

Dans le cas d'Unix, ce fichier de lancement, par example start_mdm.sh, aura les lignes suivantes:

export MDM_HOME=<path_to_the_directory_mdm_home>
export JAVA_OPTS="$JAVA_OPTS"
-Dmdm.properties=$MDM_HOME/mdm.properties
-Dmdm.home=$MDM_HOME
exec $CATALINA_HOME/bin/startup.sh

(!) Le compte utilisé au lancement de webMethods MDM doit avoir les droits suffisants sur le répertoire $MDM_HOME (création, modification, suppression).

Les utilisateurs ayant installé Tomcat en service doivent définir les options de lancement Java dans la console de configuration (onglet Java).
Attention : ne définir qu'une option par ligne du champ Options Java de l'interface, i.e.:

-Dmdm.home=<path_to_the_directory_mdm_home>
-Dmdm.properties=<path_to_the_directory_mdm_home>\mdm.properties

ou <path_to_the_directory_mdm_home> est ici le répertoire où nous avons décompressé le fichier mdm_home.zip. Dans notre exemple, il est C:\MDM\home

  • 8. Activer votre licence

webMethods MDM requiert un numéro de licence valide. Ce numéro vous est fournit :

  • à la demande pour une version d'évaluation,
  • en annexe de votre contrat de licence si vous avez acquis une licence webMethods MDM.

Le numéro de licence doit être inséré dans le fichier %MDM_HOME%\mdm.properties file:

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

mdm.license=paste_here_your_license_key

  • 9. Vérifier votre installation

Afin de vérifier si webMethods MDM est correctement installé, lancez l'application Web webMethods Master Data Manager :

L'écran de connexion doit s'afficher.

  • 10. Décrire l'organisation Administrateur

L'organisation Administrateur a en charge l'administration de webMethods MDM. Pour plus d'information, reportez-vous au guide Administrateur.

L'édition des organisations et des utilisateurs se fait à l'aide de l'application Web webMethods Master Data Manager :

Cliquez dans le menu MON PROFIL puis sur le lien Organisation et modifiez les informations en cliquant sur le bouton Editer en haut à droite du panneau d'information.

Pour modifier votre profil utilisateur, cliquez sur le menu Mon Profil puis éditez votre profil personnel.

  • 11. Décrire l'organisation Fournisseur

Le référentiel XML par défaut de webMethods MDM définit une organisation ayant le rôle "Fournisseur". Il s'agit en général de l'entreprise utilisatrice de webMethods MDM. Toutes les adaptations racine nouvellement créées appartiennent à cette organisation.

Cliquez dans le menu MON PROFIL puis sur le lien Organisation et modifiez les informations en cliquant sur le bouton Editer en haut à droite du panneau d'information.

Pour modifier votre profil utilisateur, cliquez sur le menu Mon Profil puis éditez votre profil personnel.

Par défaut, webMethods Master Data Manager en profil Fournisseur est activé en mode Développeur. Ce mode est indiqué par la barre de titre de couleur jaune.

 

Home > Installation