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 Stardust deployments within Eclipse. Install Apache Tomcat, e.g. from Please refer to the Stardust 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 Stardust 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


Note, that it might happen sometimes 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 -Xmx512m -XX:MaxPermSize=128m

Server Arguments
Figure: Setting Server Arguments for Tomcat

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