Scout/Tutorial/3.8/Run Scout Server in Virgo

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

Abstract

This tutorial describes how to deploy a simiple Scout server application to Virgo Web Server. The Virgo Web Server from EclipseRT is a completely module-based Java application server that is designed to run enterprise Java applications and Spring-powered applications with a high degree of flexibility and reliability.

Preparations

This section describes some preparations to have all necessary parts to use the application with Virgo.

Download Virgo

Please download Virgo Tomcat Server from the Eclipse download page. For this tutorial version 3.0.3 was used. When the download has been completed, extract Virgo to a directory of your choice. During this tutorial we will refer to this folder containing Virgo as ${VIRGO_HOME}.

Create Example Scout Project

We will deploy the backend from the 'Hello World' tutorial and then access the server using the Swing client. For this first complete the 'Hello World' tutorial (Please note: for this tutorial we only need the Swing client. So you can untick the others when creating the project [1]).

When the 'Hello World' tutorial is completed, select the project node in the Scout Explorer and scroll to the 'Technologies' section in the 'Scout Object Properties' view [2]. Uncheck all three ticked technologies and just confirm with OK for each change. We have now removed the support for webservices, SVG fields and database access for our project as we don't need it for this tutorial.

Export Scout Project

With the selection still on the project node in the Scout Explorer choose 'Export Scout Project...' [3]. On the first page of the Wizard specify an export target directory and check 'Server Web Application' and 'Client Application (ZIP)' [4]. Press 'Finish'. The Scout SDK now exports a Server Application (bundled as WAR file) and a client application as ZIP file to the given directory.

Create Virgo Repository

Switch to the 'repository' directory below the ${VIRGO_HOME} directory and create a new folder named 'helloworld'. Open the WAR file that has been exported in the section above with a ZIP application of your choice and unpack the contents of WEB-INF/eclipse/plugins to the just created 'helloworld' folder [5].

Go to the conf folder below the ${VIRGO_HOME} directory and open the file 'org.eclipse.virgo.repository.properties' in a text editor of your choice. Modify the file content as follows (please note the changes in bold font):

ext.type=external
ext.searchPattern=repository/ext/{artifact}
usr.type=watched
usr.watchDirectory=repository/usr
helloworld.type=external
helloworld.searchPattern=repository/helloworld/{artifact}
chain=ext,usr,helloworld