Home > Installation

Install Note for WebLogic 8.1

Warnings

  • This chapter describes a quick installation example of webMethods MDM on BEA WebLogic 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 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.

Installation Example Overview

  • Create the MDM_HOME directory: uncompress mdm_home.zip
  • Install webMethods MDM library  : add libraries in the CLASSPATH environment variable
  • Configure JVM arguments (Java system properties) : Create the JAVA_OPTIONS environment variable
  • Create an application domain : using the"Configuration Wizard"
  • Deploy webMethods MDM application  : using WebLogic Server Console

Installation Example Detail

  • 1. Create a MDM_HOME directory, for example C:\MDM\home
  • 2.Create a MDM_LIB directory, for example, C:\MDM\lib
  • 3. Create a MDM_EAR directory, for example C:\MDM\ear
  • 4. Uncompress the 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

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

C:\MDM.software\lib\activation.jar
C:\MDM.software\lib\mail.jar
C:\MDM.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/mdmPlatformForWebLogic.ear to the MDM_EAR directory. In our example, we will have:

C:\MDM\ear\mdmPlatformForWebLogic.ear

  • 7. Create environment variables

Variable name: CLASSPATH, add C:\MDM\lib\mail.jar;C:\MDM\lib\hsqldb.jar;C:\MDM\lib\activation.jar
Variable name: MDM_HOME_WEBLOGIC, variable value: C:\MDM\home
Variable name: JAVA_OPTIONS, variable value:
-Dmdm.home=%MDM_HOME_WEBLOGIC% -Dmdm.properties=%MDM_HOME_WEBLOGIC%\mdm.properties

  • 8. Launch the console "BEA WebLogic Platform 8.1 – Configuration Wizard "
  • 9. Select "Create a new Weblogic configuration "
  • 10. Click on the button "Next "
  • 11. Select "Basic WebLogic Server Domain "
  • 12. Click on the button "Next "
  • 13. Select "Express "
  • 14. Click on the button "Next "
  • 15. Configure the name and password for the administrator. In our example, the name is weblogic and the password is weblogic.
  • 16. Click on the button "Next "
  • 17. Select "Production Mode ", "Sun SDK 1.4.2_08@ … "
  • 18. Click on the button "Next "
  • 19. Select "Template –Server - myserver ", and replace "mydomain " by "mdmDomain " in the field "Configuration Name : "
  • 20. Click on the button "Create "
  • 21. Select "Start Admin Server "
  • 22. Click on the button"Done "
  • 23. In the console "C:\WINDOWS\system32\cmd.exe – startWebLogic.cmd ", type "weblogic " for user name and "weblogic " for password
  • 24. Launch "Internet Explorer " (or Firefox) , type the url : http://localhost:7001/console
  • 25. Type "weblogic " for user name and "weblogic " for password
  • 26. In the menu on the left, click "mdmDomain/Deployments/Applications ", the in the page on the right, click "Deploy a new Application… "
  • 27. In "Location ", select the mdmPlatformForWebLogic.ear directory. In our example: C:/MDM/ear
  • 28. Select mdmPlatformForWebLogic.ear, then click on the button "Continue "
  • 29. Click on the button "Deploy ". The webMethods MDM application is deployed and launched (see information in the command console)
  • 30. Quit the server: in the command console, type Ctrl-C, then close the console
  • 31. Restart the server : Windows – Start – All programs – BEA WebLogic Platform 8.1 – User Projects – mdmDomain – Start Server
  • 32. Type http://localhost:7001/console in Internet Explorer (or Firefox)
  • 33. In the menu on the left, click on "mdmDomain/Deployments/Applications/mdmPlatformForWebLogic ",
  • 34. In the page on the roght, select "Deploy ", then click on the button "Start Application "
  • 35. 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

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

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

  • 38. 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 WebLogic 8.1

Avertissements

  • Ce chapitre décrit un exemple d'installation rapide de webMethods MDM sur BEA WebLogic Application Server v8.1.
  • 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

  • Créer le répertoire MDM_HOME : décompressé mdm_home.zip
  • Installer webMethods MDM librairie : ajouter les libraires dans la variable d’environnement CLASSPATH
  • Configurer JVM arguments (Java system properties) : Créer variable d’environnement JAVA_OPTIONS
  • Créer un domaine d’application : Utiliser "Configuration Wizard"
  • Déployer l’application webMethods MDM : Utiliser le Console de WebLogic Server

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. Créer un répertoire en tant que MDM_LIB, par exemple C:\MDM\lib
  • 3. Créer un répertoire en tant que MDM_EAR, par exemple C:\MDM\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:\MDM\home\mdmRepository, un répertoire
C:\MDM\home\schemas, un répertoire
C:\MDM\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/mdmPlatformForWebLogic.ear vers le répertoire MDM_EAR. Dans notre exemple, nous aurons :

C:\MDM\ear\mdmPlatformForWebLogic.ear

  • 7. Créer les variables d’environnement

Variable CLASSPATH : y ajouter C:\MDM\lib\javamail.jar;C:\MDM\lib\hsqldb.jar;C:\MDM\lib\activation.jar
Variable MDM_HOME_WEBLOGIC : y affecter la valeur C:\MDM\home
Variable JAVA_OPTIONS : y affecter la valeur
-Dmdm.home=%MDM_HOME_WEBLOGIC% -Dmdm.properties=%MDM_HOME_WEBLOGIC%\mdm.properties

  • 8. Lancer la console "BEA WebLogic Platform 8.1 – Configuration Wizard "
  • 9. Sélectionner "Create a new Weblogic configuration "
  • 10. Cliquer sur le bouton "Next "
  • 11. Sélectionner "Basic WebLogic Server Domain "
  • 12. Cliquer sur le bouton "Next "
  • 13. Sélectionner "Express "
  • 14. Cliquer sur le bouton "Next "
  • 15. Configurer le nom et mot de passe d’administrateur. Dans notre exemple, le nom est weblogic, le mot de passe est également weblogic.
  • 16. Cliquer sur le bouton "Next "
  • 17. Sélectionner "Production Mode ", "Sun SDK 1.4.2_08@ … "
  • 18. Cliquer sur le bouton "Next "
  • 19. Sélectionner "Template –Server - myserver ", et remplacer "mydomain " par "mdmDomain " dans le champs "Configuration Name : "
  • 20. Cliquer sur le bouton "Create "
  • 21. Sélectionner "Start Admin Server "
  • 22. Cliquer sur le bouton "Done "
  • 23. Dans la console "C:\WINDOWS\system32\cmd.exe – startWebLogic.cmd ", taper "weblogic " en tant que nom d’utilisateur et "weblogic " en tant que mot de passe
  • 24. Lancer "Internet Explorer ", taper l'url : http://localhost:7001/console
  • 25. Taper "weblogic " en tant que nom d’utilisateur, et "weblogic " en tant que mot de passe
  • 26. Dans le menu à gauche, cliquer sur "mdmDomain/Deployments/Applications ", puis dans la page à droit, cliquer sur "Deploy a new Application… "
  • 27. Dans la partie "Location ", sélectionner le répertoire du fichier mdmPlatformForWebLogic.ear. Dans notre exemple, c’est C:/MDM/ear
  • 28. Sélectionner mdmPlatformForWebLogic.ear, puis cliquer le bouton "Continue "
  • 29. Cliquer sur le bouton "Deploy ". L’application webMethods MDM est déployée et lancée – voir les informations dans la console de commandes
  • 30. Quitter le serveur : dans la console de commandes, taper Ctrl-C, puis fermer la console.
  • 31. Relancer le serveur : Windows – Démarrer – Tous les programmes – BEA WebLogic Platform 8.1 – User Projects – mdmDomain – Start Server
  • 32. Retaper http://localhost:7001/console, dans Internet Explorer
  • 33. Dans le menu à gauche, cliquer sur "mdmDomain/Deployments/Applications/mdmPlatformForWebLogic ",
  • 34. Dans la page à droite, sélectionner l’onglet "Deploy ", puis cliquer sur le bouton "Start Application "
  • 35. 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 d'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

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

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

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