|
|
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://<host>:<port>/<project>/process
| + | |
− | | + | |
− | [[Image:RemoteTomcat.png]]
| + | |