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

Borislav Kapukaranov

Virgo

3.0.0.RC1

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

  • Borislav Kapukaranov, SAP AG - Configuring framework extensions and fragments on system bundle


Table of Contents

1. Introduction
1.1. A Note for Virgo Kernel Users
1.2. A Note for Virgo Jetty Server Users
2. Concepts
2.1. Modular Runtimes and Applications
2.2. OSGi Concepts
2.3. Spring DM Concepts
2.4. Virgo Concepts
3. Installing Virgo Tomcat Server
3.1. Prerequisites
3.2. Installing from the ZIP Download
3.3. Post-installation steps
4. Installing Virgo Kernel
4.1. Prerequisites
4.2. Installing from the ZIP Download
4.3. Post-installation steps
5. Starting and Stopping VTS
5.1. Starting Virgo Tomcat Server
5.2. Starting in Clean Mode
5.3. Starting in Debug Mode
5.4. Starting with JMX Access Modifications
5.5. Starting with a Custom Configuration Directory
5.6. Stopping Virgo Tomcat Server
5.7. Cleaning Virgo Tomcat Server without Starting it
6. Overview of the Virgo Kernel and User Region
6.1. The Virgo Kernel
6.2. The User Region
7. Equinox Console
7.1. Enabling Equinox Console
7.2. Using the Equinox Console Extension (vsh)
7.3. Equinox Console Extension Subcommand Reference
7.4. Class Loading Commands
7.5. Class Loading Commands Reference
8. The Admin Console
8.1. Invoking the Admin Console
8.2. Typical Admin Console Use Cases
9. The Provisioning Repository
9.1. Overview of the Provisioning Repository
9.2. Finding and Downloading Bundles from the SpringSource Enterprise Bundle Repository
9.3. Configuring the repository
10. Serviceability
10.1. Event logging
10.2. (Trace) Logging
10.3. Service Dumps
11. Working with Applications
11.1. Deploying Artifacts
11.2. Undeploying Artifacts
12. Configuration
12.1. Configuring the Virgo Kernel and User Region
12.2. Configuring Serviceability
12.3. Configuring the Web Integration Layer
12.4. Configuring the Embedded Jetty Servlet Container
12.5. Configuring the Embedded Tomcat Servlet Container
12.6. Configuring the Local Provisioning Repository
12.7. Configuring a Hosted Repository
12.8. Configuring the OSGi Framework
12.9. Configuring framework extensions and fragments on the system bundle
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. Timeout During Startup Due to Insufficient Resources
B.3. OutOfMemoryError: PermGen space running on Sun VM
B.4. Alternate serviceability and work Directories
B.5. Problem Deleting Installation Directory under Windows
B.6. Virgo Jetty Server Restrictions
C. Further Reading