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
• Configuring an Embedded Audit Trail Database
• Setting the Server Launch Configuration

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 http://tomcat.apache.org/download-70.cgi. 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.

   
   Figure: Define a New Server

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

   
   Figure: Choose Tomcat version

6. Browse to the folder of your Tomcat installation.

   
   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.

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

   
   Figure: Create a New Audit Trail Database

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

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:

Figure: Audit Trail in Package Explorer

Note

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:

• delete the incomplete audit trail files
• stop and restart your server
• restart Eclipse

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.

3. In the Edit launch configuration properties dialog switch to the Arguments tab.
4. 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

Figure: Setting Server Arguments for Tomcat

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