Home > Installation

J2EE Deployment Overview

Deployment of the "ebx" Web application (required)

When EBX.Platform is deployed on an application server, the ebx Web application ensures its initialization and is the unique entry point for EBX.Platform Web tools.

The ebx Web application contents:

Note: The ebx.properties file can be stored in another location in the file system (see below).

The entry point of EBX.Platform Web tools is provided by the servlet com.onwbp.front.FrontServlet. You will have to define the mapping for this Servlet in the web.xml file. By default, the mapping is "/".

Auto-launch required

The element <load-on-startup>1</load-on-startup> of the web.xml file must indicate that the FrontServlet initializes itself at the launch of the application server. This ensures EBX.Platform initialization.

Inter-contexts access required

It is necessary that the FrontServlet is authorized to access other contexts (ServletContext).

For example, on Tomcat, this configuration is provided by the attribute crossContext in the server.xml file, as shown below:

<Context path="/ebx" docBase="(...)" crossContext="true"/>

Deployment of the root module (required)

Any application that uses EBX.Platform requires the root module to be deployed as a Web application. This application is identified by the following name:

  • ebx-root-1.0

Deployment of EBX.Manager (optional)

EBX.Manager is the Data Governance Tool. To use it, you need to deploy the following Web application:

  • ebx-manager-1.0

Deployment of Data Model Assistant (optional)

Data Model Assistant helps to design models for Master Data. To use it, you need to deploy the following Web application:

  • ebx-war

How to specify the path to ebx.properties configuration file ?

The access path to the main configuration file of EBX.Platform can be specified in three ways (by priority order):

  1. By defining the Java system property ebx.properties. 

    For example, by adding the option -Debx.properties=<filePath> on Java command-line (see Sun documentation ).

  2. By defining the servlet initialization parameter ebx.properties. 

    This J2EE standard setting must be done in the web.xml file of ebx web application. Hence, this parameter will be accessed by EBX.Platform via the call to method ServletConfig.getInitParameter("ebx.properties") in servlet FrontServlet. 

  3. If nothing is specified, by default, ebx.properties is located in the directory WEB-INF of the ebx Web application.

The contents of this file is detailed in the ebx.properties chapter.

EBX.Platform module registration

Every specific Web application that is defined as an EBX.Platform module must be registered with the ModulesRegister.registerWebApp() API. Registration of modules is explained in the EBX.Platform Modules chapter.

 

Home > Installation