~~NOTOC~~
====== GlassFish Server ======


===== Server, JBI Engine & Components =====

{{  http://java.sun.com/javaee/img/glassfish_rounded100x88.gif|}}

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 [[https://glassfish.dev.java.net/downloads/v2.1.1-final.html|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: {{:setup:bpel_jbi.zip|bpel_jbi.zip}}. Start your glassfish domain, and then run in a web browser the [[http://localhost:4848|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 [[http://java.sun.com/javaee/downloads/index.jsp|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 [[http://dev.mysql.com/downloads/connector/j/5.1.html|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: 
<code bash>
mosser@asmodeus:~$ cp mysql-connector-java-5.1.7-bin.jar /Applications/NetBeans/glassfish-v2ur2/lib/.
</code>


===== 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).

<note warning>
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''.
</note>

==== 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.
{{  :setup:pool_step1.png  |}}
  * 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 [[mysql|setting up the database]]
    * ''User'': use the value you've defined as ''epub_login'' when [[mysql|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: 
{{  :setup:resource_step1.png  |}}
  * click on ''Ok'' to finalize the process

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