Connecting to Bonita in an AS (part I)

The Bonita platform can be deployed in an application server and accessed from a remote client. To archive that, the applications must run on an client application container but the set up details for that will change between environments.

To connect to a Bonita Runtime engine deployed in a JBoss server you need to:

1. Install the Bonita Runtime engine in an application server. You can see how to do that here.
2. Include the bonita-client-4.1.jar library in your application’s classpath. It can be found in the bonita-runtime-4.1/lib/client folder.
3. Include in your application’s classpath all the libraries that form part of your application server's client container. In the case of the JBoss AS, they are located in the ${jboss.home}/client folder.
4. Set up the properties required by the JNDI provider of your application server, so that your client code knows where the server lives. These properties will change between different application servers. In the case of JBoss those properties are:

   java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory java.naming.provider.url=jnp://localhost:1099 java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces

   The preferred method to set up those properties is including a jndi.properties file in your application’s classpath. You will need to change the host name (or IP) and port number in the java.naming.provider.url property to those of your application server installation.
5. Set the org.ow2.bonita.api-type system property with value EJB3 or EJB2 according to the EJB container supported by your application server.
6. Build and run your application.

Steps 3 and 4 are specific to JBoss, you will need to check your system's documentation to identify how to address those items. The other steps are general for Bonita and should not change between application servers.