Home > Installation

Deploy on J2EE Application Servers

 

EBX.Platform can be deployed on any J2EE application server, supporting at least Servlet 2.3. We provide a general documentation on J2EE deployment and specific Installation Notes for major Application Servers:

Warnings

  • Installation notes of EBX.Platform on J2EE Application Servers do not replace the documentation of each 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 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 module as a Web application at the same level as the 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.

Déploiement sur des serveurs d'application J2EE

EBX.Platform peut être déployé sur tout serveur d'application supportant au moins Servlet 2.3. Nous fournissons une documentation générale sur le déploiement J2EE ainsi que des notes d'installation spécifiques pour certains serveurs d'application :

Avertissements

  • Ce chapitre décrit un exemple d'installation rapide de EBX.Platform sur des serveurs d'application.
  • 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 en tant qu'application Web au même niveau que les applications Web de EBX.Platform. 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.

 

Home > Installation