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]).

Export Scout Project

After the Hello World project is completed select the project node in the Scout Explorer and choose 'Export Scout Project...' [2]. On the first page of the Wizard specify an export target directory and check 'Server Web Application' and 'Client Application (ZIP)' [3]. 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 the WEB-INF/eclipse/plugins to the just created 'helloworld' folder.