Home > Installation

Install Note for WebLogic 8.1

Warnings

  • This chapter describes a quick installation example of EBX.Platform 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 EBX.Platform is given in chapter Components.
  • In this document, we do not deploy an additional EBX.Platform module. For this, a good practice would be to rebuild an EAR with the EBX.Platform module as a Web application at the same level as other EBX.Platform 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 EBX.Platform module(s), the EBX.Platform 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 ebx.jar or other libraries on the class-loading system.

Installation Example Overview

  • Create the EBX_HOME directory: unzip ebx_home.zip
  • Install EBX.Platform library: add libraries in the CLASSPATH environment variable
  • Configure JVM arguments (Java system properties): Create the JAVA_OPTIONS environment variable
  • Create an application domain by using the "Configuration Wizard"
  • Deploy EBX.Platform application by using WebLogic Server Console

Installation Example Detail

  1. Create a EBX_HOME directory, for example C:\EBX\home
  2. Create a EBX_LIB directory, for example, C:\EBX\lib
  3. Create a EBX_EAR directory, for example C:\EBX\ear
  4. Unzip the ebx_home.zip file to EBX_HOME. In our example, we will then have the following files:

    5. C:\EBX\home\schemas, a directory
    C:\EBX\home\ebx.properties, a text file

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

    6. C:\EBX.software\lib\activation.jar
    C:\EBX.software\lib\mail.jar
    C:\EBX.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 ebx.software/webapps/ear-packaging/ebxPlatformForWebLogic.ear to the EBX_EAR directory. In our example, we will have:

    7. C:\EBX\ear\ebxPlatformForWebLogic.ear

  7. Create environment variables

    8. Variable name CLASSPATH: add C:\EBX\lib\mail.jar;C:\EBX\lib\hsqldb.jar;C:\EBX\lib\activation.jar
    Variable name EBX_HOME_WEBLOGIC: variable value to set is C:\EBX\home
    Variable name JAVA_OPTIONS: variable value to set is
    -Debx.home=%EBX_HOME_WEBLOGIC% -Debx.properties=%EBX_HOME_WEBLOGIC%\ebx.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 "ebxDomain" 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), enter the url: http://localhost:7001/console
  25. Enter "weblogic" for user name and "weblogic" for password
  26. In the menu on the left, click "ebxDomain/Deployments/Applications". In the page on the right, click "Deploy a new Application…"
  27. In "Location", select the ebxPlatformForWebLogic.ear directory. In our example, it is: C:/EBX/ear
  28. Select ebxPlatformForWebLogic.ear, then click on the button "Continue"
  29. Click on the button "Deploy". The EBX.Platform application is deployed and launched (see information in the command console)
  30. Quit the server: in the command console, press simultaneously on Ctrl-C, then close the console
  31. Restart the server: Windows – Start – All programs – BEA WebLogic Platform 8.1 – User Projects – ebxDomain – Start Server
  32. Enter http://localhost:7001/console in Internet Explorer (or Firefox)
  33. In the menu on the left, click on "ebxDomain/Deployments/Applications/ebxPlatformForWebLogic"
  34. In the page on the right, select "Deploy", then click on the button "Start Application"
  35. Run EBX.Platform.

    36. After Tomcat launch, run EBX.Manager Web application: http://localhost:7001/ebx/.

    At first launch, EBX.Platform Wizard helps you to configure the default properties of your initial repository.

Note d'installation sur WebLogic 8.1

Avertissements

  • Ce chapitre décrit un exemple d'installation rapide de EBX.Platform 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 EBX.Platform est fournie dans le chapitre Composants.
  • Dans cet exemple, nous ne déployons pas un module EBX.Platform tiers. Pour cela, une bonne pratique est de construire un EAR qui inclut le module EBX.Platform en tant qu'application Web au même niveau que les applications Web de EBX. 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 EBX.Platform spécifiques, les applications Web EBX.Platform 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 ebx.jar ou de toute autre bibliothèque sur le système de class-loading du serveur d'application.

Résumé d'un exemple de procédure

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

Détail d'un exemple de procédure

  1. Créer un répertoire en tant que EBX_HOME, par exemple C:\EBX\home
  2. Créer un répertoire en tant que EBX_LIB, par exemple C:\EBX\lib
  3. Créer un répertoire en tant que EBX_EAR, par exemple C:\EBX\ear
  4. Décompresser le fichier ebx_home.zip vers EBX_HOME. Dans notre exemple, après la décompression, nous aurons les fichiers suivants :

    5. C:\EBX\home\schemas, un répertoire
    C:\EBX\home\ebx.properties, un fichier texte

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

    6. C:\ebx.software\lib\activation.jar
    C:\ebx.software\lib\mail.jar
    C:\ebx.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 ebx.software/webapps/ear-packaging/ebxPlatformForWebLogic.ear vers le répertoire EBX_EAR. Dans notre exemple, nous aurons :

    7. C:\EBX\ear\ebxPlatformForWebLogic.ear

  7. Créer les variables d’environnement

    8. Variable CLASSPATH : y ajouter C:\EBX\lib\javamail.jar;C:\EBX\lib\hsqldb.jar;C:\EBX\lib\activation.jar
    Variable EBX_HOME_WEBLOGIC : y affecter la valeur C:\EBX\home
    Variable JAVA_OPTIONS : y affecter la valeur
    -Debx.home=%EBX_HOME_WEBLOGIC% -Debx.properties=%EBX_HOME_WEBLOGIC%\ebx.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 "ebxDomain" dans le champ "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", entrer "weblogic" en tant que nom d’utilisateur et "weblogic" en tant que mot de passe
  24. Lancer "Internet Explorer", saisir l'url : http://localhost:7001/console
  25. Entrer "weblogic" en tant que nom d’utilisateur, et "weblogic" en tant que mot de passe
  26. Dans le menu à gauche, cliquer sur "ebxDomain/Deployments/Applications", puis dans la page à droite, cliquer sur "Deploy a new Application…"
  27. Dans la partie "Location", sélectionner le répertoire du fichier ebxPlatformForWebLogic.ear. Dans notre exemple, c’est C:/EBX/ear
  28. Sélectionner ebxPlatformForWebLogic.ear, puis cliquer le bouton "Continue"
  29. Cliquer sur le bouton "Deploy". L’application EBX.Platform est déployée et lancée – voir les informations dans la console de commandes
  30. Quitter le serveur : dans la console de commandes, appuyer simultanément sur Ctrl-C, puis fermer la console.
  31. Relancer le serveur : Windows – Démarrer – Tous les programmes – BEA WebLogic Platform 8.1 – User Projects – ebxDomain – Start Server
  32. Retaper http://localhost:7001/console, dans Internet Explorer
  33. Dans le menu à gauche, cliquer sur "ebxDomain/Deployments/Applications/ebxPlatformForWebLogic"
  34. Dans la page à droite, sélectionner l’onglet "Deploy", puis cliquer sur le bouton "Start Application"
  35. Valider votre installation.

    36. Lancez l'application Web EBX.Manager : http://localhost:7001/ebx/.

    Au premier lancement, EBX.Platform fournit un assistant permettant de configurer un référentiel de démarrage.

 

Home > Installation