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.
Difference between revisions of "Scout/Tutorial/3.7/Deploy to Tomcat"
(→Export Scout Application to WAR File) |
|||
(15 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ScoutPage|cat=Tutorial}} | + | {{ScoutPage|cat=Tutorial 3.7}} |
− | =Deploy | + | =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. | This page shows how to export and deploy your Scout application to a Tomcat webserver using the Scout SDK. | ||
Line 7: | Line 7: | ||
==Install Tomcat == | ==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. | 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. | |
− | Once you started the webserver you verify | + | |
<br/>[[Image:Tomcat_running.png|left]] | <br/>[[Image:Tomcat_running.png|left]] | ||
<br clear="all" /> | <br clear="all" /> | ||
Line 24: | Line 23: | ||
<br clear="all" /> | <br clear="all" /> | ||
− | * '''Product file''': | + | * '''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 | * '''WAR file''': Path to the ''webapps'' directory of your Tomcat installation followed by the WAR file name | ||
− | * Checkbox '''Overwrite existing WAR file''': | + | * Checkbox '''Overwrite existing WAR file''': Replaces an existing WAR file (path, and file name as specified above) |
− | * Checkbox '''Include client application''': | + | |
+ | <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/>[[Image:Export_to_war_client.png|left]] | ||
<br clear="all" /> | <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/>[[Image:Scout_app_homepage.png|left]] | ||
<br clear="all" /> | <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://<host>:<port>/<project>/process | ||
+ | |||
+ | [[Image:RemoteTomcat.png]] |
Revision as of 08:26, 12 April 2012
The Scout documentation has been moved to https://eclipsescout.github.io/.
Contents
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 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.
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.
This opens the WAR export wizard dialog
- 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)
- 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
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/
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