GlassFish Deployment Guide

Install GlassFish

You can download the GlassFish Server from the GlassFish project site. This side also includes an Installation guide for installing GlassFish on different platforms. GlassFish is provided in two versions. Version 3.x is a Java EE6 Implementation. The newer Version GlassFish 4.x is based on the Java EE7 specification. After you have installed the GlassFish Server you can start the server by switching into the directory and execute the startup script:

GLASSFISH_DIST/domains/domain1/bin

After the server is started you can access the GlassFish web console from your web browser with the following URL:

http://localhost:4848/

Setting up a Imixs-Workflow database pool

The Imixs-Sample Application expects a database resource with the name “jdbc/workflow-db”. Thus you need first to set up a Database Pool and a JDBC resource before you can deploy the application successful. In this example we create a database pool for the build in derby database from GlassFish. You can also configure any other database like MySQL, Oracle, Informix, Microsoft SQL Server,….

To create a new database pool in GlassFish follow these steps:

1. make sure the derby database is started

   GLASSFISH_DIST/bin/asadmin start-database

2. start admin console -> http://localhost:4848/

3. navigate to Application Server >> Resources >> JDBC >> Connection Pools
4. click “new” to create a new database source
   • name: your database name (e.g. “imixs_db_pool”)
   • resource type : javax.sql.DataSource
   • Database Vendor : Derby
5. click “next”. Now only the following property settings are necessary:
   • ConnectionAttributes: ;create=true
   • DatabaseName: “imixs_db_pool”
   • Password: “APP”
   • User: “APP”
   • ServerName : “loacalhost”
   • portnumber: 1527
6. Now create a JDBC Resource - Navigate to “Application Server >> Resources >> JDBC >> JDBC Resources”
7. click “new” to create a new resource
   • jndiName: jdbc/workflow-db
   • PoolName: imixs_db_pool

Setup a Security Realm

To login to the Imixs-Sample Application you need also to configure a security realm. Follow the steps below:

1. start admin console -> http://localhost:4848/
2. navigate to Configuration->Security->realms
3. add a new file realm named “imixsrealm”
4. choose the class Name “com.sun.enterprese.security.auth.realm.file.FileRealm”
5. Set the JAAS Context to “fileRealm”
6. Set the Key File to a new File name. e.g. “keyfile”
7. open the newly created realm configuration and click on button “manage users”
8. Add the following test accounts:

It is also possible to configure other security bindings as the file based described here. Only the realm name should match to “imixsrealm”.

Deploy the Imixs-Sample Application

Now install the war file of the Imixs-Sample Application by the following steps:

1. Be sure, that your database server is up and running. Start it with >asadmin start-database
2. Be sure, that the domain, which you will deploy the application on, is started and alive
3. Now you can start the Admin Console in the browser. The port is listed in the output while starting the domain, i.e. in the default domain domain1 it is >http://localhost:4848
4. Choose Applications -> Enterprise Applications and click the button “deploy” in the main frame
5. Choose as type “Enterprise Application (.ear)”
6. at Location choose “Packaged file to be uploaded to the server” and browse to the location, where the ear file is stored
7. press the button “ok” located in the upper right corner –> ear will be deployed