Configuration of the Eclipse Workspace

After a successful installation open your Eclipse and configure your workspace to be able to use the Rapid Application Development. Therefore you need to define the server and audit trail database as described in the following sections.

Configuring the Server

Eclipse provides integration for the Apache Tomcat Web environment and this can be used for rapid Infinity Process Platform deployments within Eclipse. Install Apache Tomcat, e.g. from http://tomcat.apache.org/download-70.cgi. Please refer to the Infinity Release Notes for details on the supported Tomcat version.

To establish Tomcat integration in Eclipse:

  1. From the Eclipse main menu choose File > New > Other...
  2. Select Server > Server.
  3. Click Next.

    Eclipse Server dialog
    Figure: Define a New Server

  4. Select Tomcat vx.x Server
  5. Click Next.

    Choose Tomcat
    Figure: Choose Tomcat version

  6. Browse to the folder of your Tomcat installation.

    Browse to Installation Folder
    Figure: Browse to Installation Folder

  7. Select Finish.

Open the Servers view to see the server listed:

  1. In the main menu select Window > Show View.
  2. Choose Other... > Server > Servers.

Eclipse Server View
Figure: The Server View

This server configuration can be used for multiple Web projects.

Configuring an Embedded Audit Trail Database

The database can be (re)used for multiple Web projects. When you have more than one active process model, each one needs its own audit trail database. The Database to be used drop-down box is used to select the audit trail matching the active project. The Manage existing Audit trail databases link allows you to add or delete databases as needed.

To create a new audit trail database:

  1. Double-click Tomcat v x.x in the Servers View to open the configuration dialog for Tomcat.
  2. Select new AuditTrail database

    Create a New Audit Trail Database
    Figure: Create a New Audit Trail Database

  3. Enter the database name.
  4. Select OK.

Audit Trail Database Name
Figure: Enter Database Name

Note, that there will be a pause as Infinity Process Platform creates the database!

A database schema for the audit trail is created automatically with the default name carnot. You find the new audit trail displayed in the Package Explorer:

Audit Trail in Package Explorer
Figure: Audit Trail in Package Explorer

Using Audit Trail Databases created with Versions earlier than 9.0

If you use an audit trail database in RAD that has been created with IPP version earlier than 9.0, you have to deselect and select the database from the server configuration page. Republishing the server updates the Tomcat server.xml file with the new resource definition entry for embedded database usage.

In the server.xml file, you should then see the following entry in the <GlobalNamingResources> section:

<Resource name="AuditTrail.DataSource" description="Embedded Derby database for IPP" 
   factory="org.apache.tomcat.jdbc.naming.GenericNamingResourcesFactory"
   type="org.apache.derby.jdbc.EmbeddedXADataSource"
   databaseName="carnot" user="carnot" password="ag" />

Incomplete Database

In some cases it might happen that your database created in the Rapid Application environment is incomplete. In this case try one of the following or a combination:

Setting the Server Launch Configuration

To avoid running out of PermGenSpace, increase the size of the permanent generation memory by setting the -XX:MaxPermSize argument in the run configuration for the server.

To set the server configuration:

  1. In the server view right-click your server and choose Open.
  2. Select Open launch configuration.

Server Launch

  1. In the Edit launch configuration properties dialog switch to the Arguments tab.
  2. In the VM arguments entry field enter the memory arguments for your server.
    For example for a Tomcat server set: -Xms128m -Xmx1024m -XX:MaxPermSize=256m

Server Arguments
Figure: Setting Server Arguments for Tomcat

Please note that you might increase the maximum perm size according to your requirements.