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

Difference between revisions of "Scout/Tutorial/3.7/Deploy to Tomcat"

< Scout‎ | Tutorial‎ | 3.7
(Replaced content with "The Scout documentation has been moved to https://eclipsescout.github.io/.")
 
Line 1: Line 1:
{{ScoutPage|cat=Tutorial 3.7}}
+
The Scout documentation has been moved to https://eclipsescout.github.io/.
 
+
=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.
+
 
+
==Install Tomcat ==
+
If you have not yet installed Tomcat please go to the [http://tomcat.apache.org/ 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.
+
<br/>[[Image:Tomcat_running.png|left]]
+
<br clear="all" />
+
 
+
==Export Scout Application to WAR File ==
+
 
+
In the Scout SDK perspective use the context menu ''''Export to WAR file ...'''' on the server node as shown below.
+
 
+
<br/>[[Image:Export_to_war_contextmenu.png|left]]
+
<br clear="all" />
+
 
+
This opens the WAR export wizard dialog
+
 
+
<br/>[[Image:Export_to_war_dialog.png|left]]
+
<br clear="all" />
+
 
+
* '''Product file''': Server product to be deployed. This will usually be the production product (not the development product)
+
* '''WAR file''': Path to the ''webapps'' directory of your Tomcat installation followed by the WAR file name
+
* Checkbox '''Overwrite existing WAR file''': Replaces an existing WAR file (path, and file name as specified above)
+
 
+
<br/>
+
* Checkbox '''Include client application''': Exports and packs the client application into the WAR file (see selection dialog below)
+
* '''Client product to include''': Client product to be included in the WAR file
+
 
+
<br/>[[Image:Export_to_war_client.png|left]]
+
<br clear="all" />
+
 
+
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/
+
 
+
<br/>[[Image:Scout_app_homepage.png|left]]
+
<br clear="all" />
+
 
+
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:&#47;&#47;<host>:<port>/<project>/process
+
 
+
[[Image:RemoteTomcat.png]]
+

Latest revision as of 07:24, 18 March 2024

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

Back to the top