Home > Installation

Install Note for WebSphere 6

Warnings

  • This chapter describes a quick installation example of webMethods MDM on IBM WebSphere 6 Application Server.
  • It does not replace the documentation of this application server.
  • It is not a general installation recommendation, since actual 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 this document we do not deploy an additional webMethods MDM module. For this, a good practice would be to rebuild an EAR with the webMethods MDM module as a Web application at the same level as the others webMethods MDM Web applications. In this case the web application must declare its class-path dependency in the standard manner specified by Java™ 2 Platform Enterprise Edition Specification, v1.4:

    J2EE.8.2 Optional Package Support

    (...)

    A JAR format file (such as a .jar file, .war file, or .rar file) can reference a .jar file by naming the referenced .jar file in a Class-Path header in the referencing JAR file’s Manifest file. The referenced .jar file is named using a URL relative to the URL of the referencing JAR file. The Manifest file is named META-INF/MANIFEST.MF in the JAR file. The Class-Path entry in the Manifest file is of the form

    Class-Path: list-of-jar-files-separated-by-spaces

    In an "industrialized" process, we strongly recommend to develop a script that automatically builds the EAR, with the specific webMethods MDM module(s), the webMethods MDM Web applications and also all the shared libraries needed.

  • 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.

Overview

  • 1. Create MDM_HOME directory and uncompress mdm_home.zip
  • 2. Instal webMethods MDM library: "Websphere Server Application - First steps ", "Environment ", "Shared Libraries "
  • 3. Configure JVM arguments (Java system properties) : "Servers ", "Application servers ", "Java and Process Management ", "Process Definition ", "Java Virtual Machine ", "Additional Properties ", "Generic JVM arguments "
  • 4. Deploy webMethods MDM application: "Applications ", "Install New Application "

Detail

  • 1. Create MDM_HOME directory, in our example C:\webMethodsMDM.software\home
  • 2. Create MDM_LIB directory, in our example C:\webMethodsMDM.software\lib
  • 3. Create MDM_EAR directory, in our example C:\webMethodsMDM.software\ear
  • 4. Uncompress the file mdm_home.zip to MDM_HOME. In our example, after uncompression, we will have the following files:

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

  • 5. Copy third-party library files to MDM_LIB directory. In our example, we will have:

C:\webMethodsMDM.software\lib\activation.jar
C:\webMethodsMDM.software\lib\mail.jar
C:\webMethodsMDM.software\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.
  • 6. Copy the file webMethodsMDM.software/webapps/ear-packaging/mdmPlatform.ear to MDM_EAR. In our example, we will have:

C:\webMethodsMDM.software\ear\mdmPlatform.ear

  • 7. Launch the "Websphere Server Application - Fist steps" console
  • 8. Start the server
  • 9. Launch the administration console and login
  • 10. Specify the webMethods MDM library:

a. In the menu on the left, click on"Environment "
b. Click on "Shared Libraries "
c. In the "Shared Libraries " page , click on the button "New ". The "Shared Librarie > New " page is displayed.
d. In the field *Name, type the library name, in our example lib_of_mdm
e. In the field *Classpath, type the MDM_LIB path, in our example C:\webMethodsMDM.software\lib
f. Click on the button "OK "
g. Save modifications by clicking on "Save " in the "Messages " panel at the bottom of the page "Shared Libraries ".
h. Click on the button "Save "

  • 11. Specify the webMethods MDM configuration file path:

a. In the menu on the left, click on "Servers "
b. Click on "Application servers "
c. In the page"Application servers ", Click on the server nae. In our example, the server name is server1.
d. In the confioguration page of "Application servers > server1 ", click on "Java and Process Management ", which is a sub-menu of "Server Infrastructure "
e. Click on "Process Definition "
f. Click on "Java Virtual Machine ", which is a sub-menu of "Additional Properties "
g. In the field "Generic JVM arguments ", type :
-Dmdm.home= C:\webMethodsMDM.software\home –Dmdm.properties=C:\webMethodsMDM.software\home\mdm.properties
h. Here, mdm.home is the directory for MDM_HOME, mdm.properties is the configuration file of MDM. In our example, they are respectively C:\webMethodsMDM.software\home et C:\webMethodsMDM.software\home\mdm.properties
i. Click on the button "OK ", at the bottom of the page "Application servers > server1 > Java Virtual Machine "
j. Save modifications by clicking on "Save " in the "Messages " panel at the top of the page "Application servers > server1 > Java Virtual Machine ".

  • 12. Deploy Web Applications:

a. In the menu on the left, click on "Applications "
b. Click on "Install New Application "
c. In the page "Preparing for the application installation ", inthe field "Specify path ", select mdmPlatform.ear file. In our example, it is C:\webMethodsMDM.software\ear\mdmPlatform.ear
d. Click on the button "Next " at the bottom of the page "Preparing for the application installation "
e. Select "Use default virtual host name for Web modules : "
f. Click on the button "Next "
g. Click on the button "Continue "
h. In the page "Install new Application, Step 1 Select installation options " : the field "Directory to install application " is the installation directory of webMethods MDM. In our example, it is "C:\webMethodsMDM.software\ear "
i. Click on the button "Next "
j. In the page "Install new Application, Step 2 Map modules to servers " : click on the button "Next "
k. In the page "Install new Application, Step 3 Map resource references to resources " : as we don't use JNDI resource in this example, input DefaultDatasource, click on the button "Next "
l. In the page "Install new Application, Step 4 Map virtual hosts for Web modules " : map all modules: mdm.war, mdm-root.war, mdm-manager.war au default_host.
m. Click on the button "Next "
n. Click on the button "Finish "
o. The page "Installing… " is displayed. The message "Application webMethods MDM installed successfully " will be displayed at the bottom of the page.
p. Click on "Save to Master Configuration " at the bottom of the page
q. Click on the button "Save "

  • 13. Link Web Applications to the webMethods MDM library

a. In the menu on the left, click on "Applications "
b. Click on "Enterprise Applications "
c. In the page "Enterprise Applications ", click on webMethods MDM
d. In the page "Enterprise Applications > webMethods MDM ", click on "Libraries ", which is bellow "Additional Properties "
e. Click on the button "Add "
f. Select the library we add in step 10 lib_of_mdm
g. Click on the button "OK "
h. Save modifications by clicking on "Save " in the "Messages" panel at the top of the page "Enterprise Applications "
i. Click on the button "Save "

  • 14. In the console "Websphere Server Application - First steps ", stop the server
  • 15. In the console "Websphere Server Application - First steps ", start the server
  • 16. Restart the administration console, in the menu on the left, click on "Applications "
  • 17. Click on "Enterprise Applications "
  • 18. In the page "Enterprise Applications ", select webMethods MDM
  • 19. Click on the button "Start ".
  • 20. Activate your license

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

  • by email if you've downloaded (or get a CD) a free Express edition or a 60-days trial Standard or Enterprise edition
  • in your license contract if you've purchased the Standard or Enterprise edition

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

  • 21. 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.

  • 22. 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.

  • 23. 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 pour WebSphere 6

Avertissements

  • Ce chapitre décrit un exemple d'installation rapide de webMethods MDM sur IBM WebSphere Application Server v6.
  • 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.
  • Dans cet exemple, nous ne déployons pas un module webMethods MDM tiers. Pour cela, une bonne pratique est de construire un EAR qui inclut le module webMethods MDM en tant qu'application Web au même niveau que les applications Web de MDM. En ce cas les fichiers war doivent déclarer leurs dépendances de la manière standard qui est spécifiée par le document "Java™ 2 Platform Enterprise Edition Specification, v1.4" :

    J2EE.8.2 Optional Package Support

    (...)

    A JAR format file (such as a .jar file, .war file, or .rar file) can reference a .jar file by naming the referenced .jar file in a Class-Path header in the referencing JAR file’s Manifest file. The referenced .jar file is named using a URL relative to the URL of the referencing JAR file. The Manifest file is named META-INF/MANIFEST.MF in the JAR file. The Class-Path entry in the Manifest file is of the form

    Class-Path: list-of-jar-files-separated-by-spaces

    Pour un processus "industrialisé", nous recommandons fortement de développer un script qui construit automatiquement l'EAR, en y incluant les modules webMethods MDM spécifiques, les applications Web webMethods MDM fournies ainsi que toutes les bibliothèques nécessaires.

  • 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.

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

  • 1. Créer le répertoire MDM_HOME et y décompresser mdm_home.zip
  • 2. Installer la librairie webMethods MDM: "Websphere Server Application - Premiers pas ", "Environment ", "Shared Libraries "
  • 3. Configurer les arguments JVM (Java system properties) : "Servers ", "Application servers ", "Java and Process Management ", "Process Definition ", "Java Virtual Machine ", "Additional Properties ", "Generic JVM arguments "
  • 4. Déployer l’application webMethods MDM : "Applications ", "Install New Application "

Détail de l'exemple de procédure

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

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

  • 5. Copier les bibliothèques partagées dans le répertoire MDM_LIB. Dans notre exemple, nous aurons :

C:\webMethodsMDM.software\lib\activation.jar
C:\webMethodsMDM.software\lib\mail.jar
C:\webMethodsMDM.software\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.
  • 6. Copier le fichier webMethodsMDM.software/webapps/ear-packaging/mdmPlatform.ear vers le répertoire MDM_EAR. Dans notre exemple, nous aurons :

C:\webMethodsMDM.software\ear\mdmPlatform.ear

  • 7. Lancer la console "Websphere Server Application - Premiers pas "
  • 8. Démarrer le serveur
  • 9. Lancer la console d’administration et s’identifier.
  • 10. Spécifier la bibliothèque webMethods MDM :

a. Sur le menu de gauche, cliquer sur "Environment"
b. Cliquer sur "Shared Libraries"
c. Dans la page de "Shared Libraries ", cliquer sur le bouton "New ". La page "Shared Librarie > New " s’affiche.
d. Dans le champs *Name, taper le nom de la libraire, par exemple lib_of_mdm
e. Dans le champs *Classpath, taper le chemin de MDM_LIB. Dans notre exemple, c’est C:\webMethodsMDM.software\lib
f. Cliquer sur le bouton "OK "
g. Sauvegarder les modifications en cliquant "Save " du panneau "Messages " situé en haut de la page "Shared Libraries ".
h. Cliquer sur le bouton "Save "

  • 11. Spécifier le chemin du fichier de configuration webMethods MDM :

a. Sur le menu de gauche, cliquer sur "Servers "
b. Cliquer sur "Application servers "
c. Dans la page "Application servers ", cliquer sur le nom du serveur. Dans notre exemple, le nom du serveur est server1.
d. Dans la page de Configuration de "Application servers > server1 ", cliquer sur "Java and Process Management ", qui est un sous-menu de "Server Infrastructure "
e. Cliquer sur "Process Definition "
f. Cliquer sur "Java Virtual Machine ", qui est un sous-menu de "Additional Properties "
g. Dans le champ "Generic JVM arguments ", taper :
-Dmdm.home= C:\webMethodsMDM.software\home –Dmdm.properties=C:\webMethodsMDM.software\home\mdm.properties
h. Ici, mdm.home est le répertoire de MDM_HOME, mdm.properties est le fichier de configuration d’MDM. Dans notre exemple, ils sont respectivement : C:\webMethodsMDM.software\home et C:\webMethodsMDM.software\home\mdm.properties
i. Cliquer sur le bouton "OK ", qui se situe en bas de la page "Application servers > server1 > Java Virtual Machine "
j. Sauvegarder les modifications en cliquant "Save " du panneau "Messages " situé en haut de la page "Application servers > server1 > Java Virtual Machine ".

  • 12. Déployer les applications Web :

a. Sur les menus de gauche, cliquer sur "Applications "
b. Cliquer sur "Install New Application "
c. Dans la page "Preparing for the application installation ", dans le champs "Specify path ", sélectionner le fichier mdmPlatform.ear. Dans notre exemple, c'est C:\webMethodsMDM.software\ear\mdmPlatform.ear
d. Cliquer sur le bouton "Next " en bas de la page "Preparing for the application installation "
e. Sélectionner "Use default virtual host name for Web modules : "
f. Cliquer sur le bouton "Next "
g. Cliquer sur le bouton "Continue "
h. Dans la page "Install new Application, Step 1 Select installation options" : le champs "Directory to install application " est le répertoire d’installation d’webMethods MDM. Dans notre exemple, c'est "C:\webMethodsMDM.software\ear "
i. Cliquer sur le bouton "Next "
j. Dans la page "Install new Application, Step 2 Map modules to servers" : cliquer sur le bouton "Next "
k. Dans la page "Install new Application, Step 3 Map resource references to resources" : comme nous n'utilisons pas de ressource JNDI dans cet exemple, saisir DefaultDatasource, cliquer sur le bouton "Next "
l. Dans la page "Install new Application, Step 4 Map virtual hosts for Web modules" : mapper tous les modules : mdm.war, mdm-root.war, mdm-manager.war au default_host.
m. Cliquer sur le bouton "Next "
n. Cliquer sur le bouton "Finish "
o. La page "Installing… " s’affiche. Le message "Application webMethods MDM installed successfully " s’affichera en bas de page.
p. Cliquer sur "Save to Master Configuration " en bas de la page.
q. Cliquer sur le bouton "Save "

  • 13. Lier les applications Web à la bibliothèque webMethods MDM

a. Sur les menus de gauche, cliquer sur "Applications "
b. Cliquer sur "Enterprise Applications "
c. Dans la page "Enterprise Applications ", cliquer sur webMethods MDM
d. Dans la page "Enterprise Applications > webMethods MDM ", cliquer sur "Libraries ", qui est au dessous de "Additional Properties "
e. Cliquer sur le bouton "Add "
f. Sélectionner la libraire que nous avons ajoutée en étape 10 lib_of_mdm
g. Cliquer sur le bouton "OK "
h. Sauvegarder les modifications en cliquant "Save " du panel "Messages " situé en haut de la page "Enterprise Applications "
i. Cliquer sur le bouton "Save "

  • 14. Dans la console "Websphere Server Application - Premiers pas ", arrêter le serveur
  • 15. Dans la console "Websphere Server Application - Premiers pas ", démarrer le serveur
  • 16. Relancer la console d’administration, sur les menus de gauche, cliquer sur "Applications "
  • 17. Cliquer sur "Enterprise Applications "
  • 18. Dans la page "Enterprise Applications ", sélectionner webMethods MDM
  • 19. Cliquer sur le bouton "Start ".
  • 20. Activer votre licence

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

  • par email, si vous disposez de l'édition Express ou une évaluation 60 jours des éditions Standard ou Enterprise
  • en annexe de votre contrat de licence, si vous avez acquis une licence webMethods MDM Standard ou Enterprise

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

  • 21. Vérifier votre installation

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

L'écran de connexion doit s'afficher.

  • 22. 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.

  • 23. 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