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



Copyright © 2009, 2011 VMware Inc. and others


  • VMware Inc. - initial contribution and subsequent updates

  • Violeta Georgieva, SAP AG - Apache Tomcat configuration

  • Hristo Iliev, SAP AG - Setting permissions

  • Borislav Kapukaranov, SAP AG - Configuring framework extensions and fragments on system bundle; Added Virgo Nano references and tips

Table of Contents

1. Introduction
1.1. A Note for Virgo Kernel Users
1.2. A Note for Virgo Jetty Server Users
1.3. A Note for Virgo Nano Users
2. Concepts
2.1. Modular Runtimes and Applications
2.2. OSGi Concepts
2.3. Spring DM and Blueprint Concepts
2.4. Virgo Concepts
2.5. p2 Concepts
3. Using the p2 director
3.1. Prerequisites
3.2. Installing with the p2 director from Eclipse
4. Installing Virgo Server for Apache Tomcat
4.1. Prerequisites
4.2. Installing from the ZIP Download
4.3. Installing from an update site
4.4. Post-installation steps
5. Installing Virgo Kernel
5.1. Prerequisites
5.2. Installing from the ZIP Download
5.3. Installing from an update site
5.4. Post-installation steps
6. Installing Virgo Nano
6.1. Prerequisites
6.2. Installing from the ZIP Download
6.3. Installing from an update site
6.4. Post-installation steps
7. Starting and Stopping VTS
7.1. Starting Virgo Server for Apache Tomcat
7.2. Starting in Clean Mode
7.3. Starting in Debug Mode
7.4. Starting with JMX Access Modifications
7.5. Starting with a Custom Configuration Directory
7.6. Stopping Virgo Server for Apache Tomcat
7.7. Cleaning Virgo Server for Apache Tomcat without Starting it
7.8. Using Equinox Launcher
8. Equinox Console
8.1. Enabling the Equinox Console
8.2. Using Virgo Shell Commands
8.3. Virgo Shell Command Reference
8.4. Using the p2 for extending your Virgo installation
9. The Admin Console
9.1. Invoking the Admin Console
9.2. Typical Admin Console Use Cases
10. The Provisioning Repository
10.1. Overview of the Provisioning Repository
10.2. Downloading Bundles from the SpringSource Enterprise Bundle Repository
10.3. Configuring the Repository
11. Serviceability and Diagnostics
11.1. Event Logging
11.2. (Trace) Logging
11.3. Service Dumps
12. Working with Applications
12.1. Deploying Artifacts
12.2. Undeploying Artifacts
13. Configuration
13.1. Configuring the OSGi Framework
13.2. Configuring Framework Extensions and Fragments on the System Bundle
13.3. Configuring Serviceability and Diagnostics
13.4. Configuring the Local Provisioning Repository
13.5. Configuring a Hosted Repository
13.6. Configuring the Kernel and User Region
13.7. Configuring the Embedded Tomcat Servlet Container
13.8. Configuring the Web Integration Layer
13.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. Long Work Directory Paths under Windows
B.7. Virgo Jetty Server Restrictions
B.8. Shutdown Log Messages in Telnet Shell
C. Further Reading