Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Scout/Tutorial/3.8/Deploy to Tomcat

< Scout‎ | Tutorial‎ | 3.8
Revision as of 04:35, 4 May 2012 by Mvi.bsi-software.com (Talk | contribs) (Deploy a Scout Application to Tomcat)

The Scout documentation has been moved to https://eclipsescout.github.io/.

Note.png
Under construction
This page is under construction


Deploy a Scout Application to Tomcat

This page shows how to export and deploy your Scout application to a Tomcat webserver using the Scout SDK.

Warning2.png
Mac OS X
There is a Bug on Mac OS X when using the Oracle JDK 7: [378445]. If you want to export Scout projects on Mac please use the Apple JDK 6 until the bug is solved.


Install Tomcat

If you have not yet installed Tomcat please go to the Tomcat homepage. Then download and install Tomcat version 6 or 7 using the proposed default settings. Once you started the webserver you verify that its running by starting your browser with the address http://localhost:8080. Your browser should display some page similar as shown below.


Tomcat running.png


Export Scout Application to WAR File

In the Scout SDK perspective use the context menu 'Export Scout Project ...' on the project node as shown below.

Scout-ExportWarFile.PNG

This opens the export dialog.

Scout-ExportWarFile1.PNG Mark the Checkbox RAP Web Application if you need it. Specify a path to your .war file and click next.


Scout-ExportWarFile2.PNG
  • WAR file: Path to the webapps directory of your Tomcat installation followed by the WAR file name
  • Product file: Server product to be deployed. This will usually be the production product (not the development product)


  • Client product to include: Client product to be included in the WAR file

Scout-ExportWarFile ClientProductSelection.PNG


In the screenshot above we've selected the SWT client (production product) to be included in the WAR

Restart Tomcat, View Application Home Page, Download Client

With autodeploy or restart of the Tomcat server we can access the application homepage under http://localhost:8080/documentApp/

If not, import the created .war file in tomcat manager http://localhost:8080/manager/.


Scout app homepage.png


By clicking on Download or documentApp.zip the Scout client can be downloaded from the webserver. To start the client follow the steps described on the application home page.

Deploy to remote host

If your tomcat server is not at localhost, change the value server.url in the config.ini of the desired client e.g. ui.swt.production, like below:

  server.url=http://<host>:<port>/<project>/process

RemoteTomcat.png

Back to the top