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.RELEASE

Copyright © 2009, 2011 VMware Inc. and others

Contributors:

  • VMware Inc. - initial contribution and subsequent updates

  • 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. Equinox Console
6.1. Enabling the Equinox Console
6.2. Using the Equinox Console Extension (vsh)
6.3. Equinox Console Extension Subcommand Reference
6.4. Class Loading Commands
6.5. Class Loading Command 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. Downloading Bundles from the SpringSource Enterprise Bundle Repository
8.3. Configuring the Repository
9. Serviceability and Diagnostics
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 OSGi Framework
11.2. Configuring Framework Extensions and Fragments on the System Bundle
11.3. Configuring Serviceability and Diagnostics
11.4. Configuring the Local Provisioning Repository
11.5. Configuring a Hosted Repository
11.6. Configuring the Kernel and User Region
11.7. Configuring the Embedded Tomcat Servlet Container
11.8. Configuring the Web Integration Layer
11.9. Configuring the Embedded Jetty Servlet Container
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 JVM
B.4. Alternate serviceability and work Directories
B.5. Problem Deleting Installation Directory under Windows
B.6. Virgo Jetty Server Restrictions
B.7. Virgo Tomcat Server War File Transformation
C. Further Reading