Using Eclipse and the dm Server tools, it is possible to run applications directly from the IDE. As changes are made to the application in the IDE, they can be automatically applied to the running application allowing for rapid feedback of changes in function.
Before you can start the GreenPages application from Eclipse, you must import the projects. To import the projects into Eclipse:
Open the Import Wizard using→ .
From the Import Wizard select Next:→ and click
$GREENPAGES_HOME/solution as the root directory.
In the Import Projects window, select all the projects and click Finish:
Validate that the imported projects appear in Package Explorer:
There may be compilation errors at this stage.
Projects for dm Server are associated with a dm Server runtime environment in Eclipse. This is to allow launching and testing from within Eclipse, and also to allow classpath construction in Eclipse to mirror the dynamic classpath in the dm Server runtime.
Compilation errors in the previous step will be resolved here.
To configure a dm Server runtime environment:
Open→ → .
In the Show View dialog choose → to make the servers view visible:
Right-click in the Servers (which may not be empty) view and select → .
In the New Server dialog, choose → and click Next.
$DMS_HOME directory. Ensure that a JRE is selected
supporting Java 1.6 or above.
Click to complete creation of the server:
Select all projects (except Servers) in Package Explorer. Right-click on the projects and choose and then .
It is possible that there remain spurious build errors from Eclipse (see the Problems view), in which case a project clean build may clear the problems. Select → from the main menu, and choose to Clean all projects. It may be necessary to repeat this on a few projects. (This process is sometimes known as the “Eclipse dance”.)
Despite the dance steps outlined, there will remain some Warnings like this:
It is safe to ignore these.
Now that GreenPages is successfully imported into Eclipse, you can run the project directly from within the IDE.
If you previously deployed the GreenPages PAR to dm Server by copying the PAR file to the
pickup directory, be sure you now remove it so that it does not conflict with the deployment of the Eclipse project. On Unix:
prompt$ cd $DMS_HOME/pickup prompt$ rm greenpages-solution-2.1.0.RELEASE.par
prompt> cd %DMS_HOME%\pickup prompt> del greenpages-solution-2.1.0.RELEASE.par
Also, to prevent conflicts with the server configured in Eclipse, stop a currently-running dm Server by typing
Control-C in the console window from which you started the server.
To run GreenPages from within Eclipse:
Right click on the dm Server instance in the Servers view and select the menu item.
Add greenpages-solution (which is the containing project or PAR) to the server and finish.
To start dm Server from within Eclipse right-click on the dm Server node in the Servers window and choose Servers view should now show the server and the added project:. The
Verify that GreenPages is started correctly by checking for
<DE0005I> Started par 'greenpages' version '2.0.1'. in the Console window.
(If errors are shown implying that GreenPages failed to be installed, this may be because some dependencies were not copied to dm Server, as described in section the section called “Installing dependencies into dm Server”. Check this.)
Once installed and started GreenPages is again available from a web browser at the address http://localhost:8080/greenpages.