Virgo User Guide

Rob Harrop

Paul Kuzan

Sam Brannen

Paul Harris

Christopher Frost

Ben Hale

Glyn Normington

Juliet Shackell

Steve Powell

Violeta Georgieva

Hristo Iliev

Virgo

2.1.1.RELEASE

Copyright © 2009, 2010 VMware Inc. and others

Contributors:

  • VMware Inc. - initial contribution

  • Violeta Georgieva, SAP AG - Tomcat context configuration

  • Hristo Iliev, SAP AG - Setting jmx.properties permissions


Table of Contents

1. Introduction
1.1. A Note for Virgo Kernel Users
2. Installing Virgo Web Server
2.1. Prerequisites
2.2. Installing from the ZIP Download
2.3. Post-installation steps
3. Installing Virgo Kernel
3.1. Prerequisites
3.2. Installing from the ZIP Download
3.3. Post-installation steps
4. Starting and Stopping VWS
4.1. Starting Virgo Web Server
4.2. Starting in Clean Mode
4.3. Starting in Debug Mode
4.4. Starting with JMX Access Modifications
4.5. Starting with a Custom Configuration Directory
4.6. Stopping Virgo Web Server
5. Overview of the Virgo Kernel and User Region
5.1. The Virgo Kernel
5.2. The User Region
6. Equinox Console Extension (vsh)
6.1. Using the Equinox Console Extension
6.2. Equinox Console Extension Subcommand Reference
7. The Admin Console
7.1. Invoking the Admin Console
7.2. Typical Admin Console Use Cases
8. The Provisioning Repository
8.1. Overview of the Provisioning Repository
8.2. Finding and Downloading Bundles from the SpringSource Enterprise Bundle Repository
8.3. Configuring the repository
9. Serviceability
9.1. Event logging
9.2. (Trace) Logging
9.3. Service Dumps
10. Working with Applications
10.1. Deploying Artifacts
10.2. Undeploying Artifacts
11. Configuration
11.1. Configuring the Virgo Kernel and User Region
11.2. Configuring Serviceability
11.3. Configuring the Embedded Tomcat Servlet Container
11.4. Configuring the Local Provisioning Repository
11.5. Configuring a Hosted Repository
11.6. Configuring the OSGi Framework
A. Event log codes
A.1. Format of the event log codes
B. Known Issues
B.1. Timeout During Startup Due to Firewall Settings
B.2. OutOfMemoryError: PermGen space running on Sun VM
B.3. Alternate serviceability and work Directories
B.4. Web Application Context Configuration File Copying
C. Further Reading