2.2 Installing Web Server

Although the steps are similar, the details of installing the Virgo Web Server depend on the operating system.

Obtain Web Server from the download site (http://www.eclipse.org/virgo/download). This guide is consistent with version 2.1.0.RELEASE of Web Server.

Installing Web Server on Windows™ operating systems

Unzip the download of Web Server to the root directory of a drive (this will avoid possible problems with long pathnames). Set an environment variable %VWS_HOME% to refer to the unzipped folder…

prompt> cd C:\
prompt> "%JAVA_HOME%"\bin\jar xf \path\to\virgo-web-server-2.1.0.RELEASE.zip
prompt> set VWS_HOME=C:\virgo-web-server-2.1.0.RELEASE

To verify the installation, issue the command: "%VWS_HOME%"\bin\startup.bat and ensure a message numbered UR0001I is displayed. Many other messages about starting and installing other required artifacts are produced, but the UR0001I message indicates that the user region is ready for use. (Timestamps have been removed and thread names and other details may vary with different installations and versions.)

system-artifacts             <TC0000I> Starting Tomcat. 
system-artifacts             <TC0010I> Creating HTTP/1.1 connector with scheme http on port 8080. 
system-artifacts             <TC0010I> Creating HTTP/1.1 connector with scheme https on port 8443. 
system-artifacts             <TC0010I> Creating AJP/1.3 connector with scheme http on port 8009.
system-artifacts             <TC0001I> Started Tomcat. 
system-artifacts             <DE0004I> Starting bundle 'org.eclipse.virgo.web.core' version '2.1.0.RELEASE'. 
system-artifacts             <DE0004I> Starting bundle 'org.eclipse.virgo.web.dm' version '2.1.0.RELEASE'. 
start-signalling-1           <DE0005I> Started bundle 'org.eclipse.virgo.web.dm' version '2.1.0.RELEASE'. 
system-artifacts             <DE0005I> Started bundle 'org.eclipse.virgo.web.tomcat' version '2.1.0.RELEASE'. 
start-signalling-1           <DE0005I> Started bundle 'org.eclipse.gemini.web.tomcat' version '1.1.0.RELEASE'. 
start-signalling-2           <DE0005I> Started bundle 'org.eclipse.virgo.web.core' version '2.1.0.RELEASE'. 
start-signalling-2           <DE0005I> Started plan 'org.eclipse.virgo.web' version '2.1.0'. 
Thread-2                     <UR0001I> User region ready. 

Shut down the server by pressing Ctrl-C.

Installing Web Server on UNIX™ operating systems

Unzip the download of Web Server to a suitable location on the file system, such as the home directory. (If the download was automatically unzipped by the operating system, simply move the unzipped directory to the chosen location.) Set an environment variable $VWS_HOME to refer to the unzipped folder…

prompt$ mkdir /path/to/home/springsource
prompt$ cd /path/to/home/springsource
prompt$ unzip /path/to/virgo-web-server-2.1.0.RELEASE.zip
prompt$ export VWS_HOME=/path/to/home/springsource/virgo-web-server-2.1.0.RELEASE

To verify the installation, use a terminal window to issue the command: $VWS_HOME/bin/startup.sh and ensure a message numbered UR0001I is displayed. Many other messages about starting and installing other required artifacts are produced, but the UR0001I message indicates that the user region is ready for use. (Timestamps have been removed and thread names and other details may vary with different installations and versions.)

system-artifacts             <TC0000I> Starting Tomcat. 
system-artifacts             <TC0010I> Creating HTTP/1.1 connector with scheme http on port 8080. 
system-artifacts             <TC0010I> Creating HTTP/1.1 connector with scheme https on port 8443. 
system-artifacts             <TC0010I> Creating AJP/1.3 connector with scheme http on port 8009.
system-artifacts             <TC0001I> Started Tomcat. 
system-artifacts             <DE0004I> Starting bundle 'org.eclipse.virgo.web.core' version '2.1.0.RELEASE'. 
system-artifacts             <DE0004I> Starting bundle 'org.eclipse.virgo.web.dm' version '2.1.0.RELEASE'. 
start-signalling-1           <DE0005I> Started bundle 'org.eclipse.virgo.web.dm' version '2.1.0.RELEASE'. 
system-artifacts             <DE0005I> Started bundle 'org.eclipse.virgo.web.tomcat' version '2.1.0.RELEASE'. 
start-signalling-1           <DE0005I> Started bundle 'org.eclipse.gemini.web.tomcat' version '1.1.0.RELEASE'. 
start-signalling-2           <DE0005I> Started bundle 'org.eclipse.virgo.web.core' version '2.1.0.RELEASE'. 
start-signalling-2           <DE0005I> Started plan 'org.eclipse.virgo.web' version '2.1.0'. 
Thread-2                     <UR0001I> User region ready. 

Shut down the server by pressing Ctrl-C.