0% found this document useful (0 votes)
4 views

Eclipse - Workspace Configuration

The document provides a guide for configuring the Eclipse workspace for Rapid Application Development using Stardust. It covers steps for integrating the Apache Tomcat server, setting up an embedded audit trail database, and adjusting server launch configurations to optimize memory usage. Additionally, it includes troubleshooting tips for database issues and emphasizes the importance of proper server setup for multiple web projects.
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
4 views

Eclipse - Workspace Configuration

The document provides a guide for configuring the Eclipse workspace for Rapid Application Development using Stardust. It covers steps for integrating the Apache Tomcat server, setting up an embedded audit trail database, and adjusting server launch configurations to optimize memory usage. Additionally, it includes troubleshooting tips for database issues and emphasizes the importance of proper server setup for multiple web projects.
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 6

7/27/2019 Configuration of the Eclipse Workspace

Stardust Documentation > Developer Handbook > Rapid Application Development >
< Previous Next >
Configuration of the Eclipse Workspace

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

https://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.stardust.docs.wst%2Fhtml%2Fwst-integration%2Fconfiguration.html 1/6
7/27/2019 Configuration of the Eclipse Workspace

5. Click Next.

Figure: Choose Tomcat version

6. Browse to the folder of your Tomcat installation.

https://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.stardust.docs.wst%2Fhtml%2Fwst-integration%2Fconfiguration.html 2/6
7/27/2019 Configuration of the Eclipse Workspace

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:


https://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.stardust.docs.wst%2Fhtml%2Fwst-integration%2Fconfiguration.html 3/6
7/27/2019 Configuration of the Eclipse Workspace

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:

https://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.stardust.docs.wst%2Fhtml%2Fwst-integration%2Fconfiguration.html 4/6
7/27/2019 Configuration of the Eclipse Workspace

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 Stardust 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 Stardust"


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:

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.

https://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.stardust.docs.wst%2Fhtml%2Fwst-integration%2Fconfiguration.html 5/6
7/27/2019 Configuration of the Eclipse Workspace

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.

The next topic of Rapid Application Development is Creating a Dynamic Web Project in Eclipse.

Stardust Documentation > Developer Handbook > Rapid Application Development >
< Previous Next >
Configuration of the Eclipse Workspace

Copyright © 2016 FIS

https://help.eclipse.org/neon/index.jsp?topic=%2Forg.eclipse.stardust.docs.wst%2Fhtml%2Fwst-integration%2Fconfiguration.html 6/6

You might also like