GlassFish Server

Server, JBI Engine & Components

To use jSeduite, you need to install an application server to host web services and orchestrations. We're using GlassFish v2.1 as a reference server.

You can download the setup file at the following download web page. Just follow the instructions.

then, you need to deploy a BPEL engine inside the application server. the following archive contains everything you need: bpel_jbi.zip. Start your glassfish domain, and then run in a web browser the Admin Interface.

Install saxonlib.jar and wsdlextlib.jar as JBI Shared librairies
Install bpelserviceengine.jar as a JBI Compoment.

That's all!

Warning: The way glassfish handles XML namespaces depends on your installation procedure. If you've followed another procedure (such as deploying a glassfish bundle), you can experiment some “namespace” problems (information will be broadcasted with explicit namespaces).

MySql JDBC Connector

The binding between GlassFish Server and MySql is done trough the official Connector/J library, developed by the MySQL project.

You'll have to download the jar (for example mysql-connector-java-5.1.7-bin.jar) file and then put it inside the lib folder of your glassfish installation. For example:

mosser@asmodeus:~$ cp mysql-connector-java-5.1.7-bin.jar /Applications/NetBeans/glassfish-v2ur2/lib/.

JDBC Resource & Pool

jSeduite services relies on a database library which assume the existence of a special JDBC resource called jdbc/jseduite (case sensitive, it MUST be declared using this name).

Next manipulations must be done inside a web browser, running the Glassfish Admin console web application (http://localhost:4848/, replace localhost by your server name if you're running a remote server).

By default, login is admin and password is adminadmin.

Pool Creation

Go to Resources menu (left panel), and then click on JDBC and finally Connection Pools.
Click new and then fill the form with the following informations.

Click on next. You can then customize the pool, but usually default values fit well. Don't forget to set the following Additional properties inside the bottom panel:
- Password: use the value you've defined as epub_password when setting up the database
- User: use the value you've defined as epub_login when setting up the database
- URL: jdbc:mysql://localhost:3306/jSeduite
Click on Finish to finalize the pool creation

JDBC Resource Creation

Now, click on JDBC Resource on left panel, and then on the New button.
Fill the form using the following values:

click on Ok to finalize the process

Well, you're ready to use database interface services !