SpringSource Application Platform User Guide

Rob Harrop

Paul Kuzan

Sam Brannen

Damilola Senbanjo

Paul Harris

Christopher Frost

SpringSource Application Platform

1.0.0.RC1

Copyright © SpringSource Inc., 2008


Table of Contents

1. Installing
1.1. Prerequisites
1.2. Installing from the ZIP Download
1.2.1. Downloading the ZIP file
1.2.2. Installing
1.2.2.1. On a Linux Platform
1.2.2.2. On a Microsoft Windows Platform
1.3. Post-installation steps
1.3.1. Set a Platform home environment variable
1.3.1.1. On a Linux Platform
1.3.1.2. On a Microsoft Windows Platform
2. Start and Stop SpringSource Application Platform
2.1. Start
2.1.1. On a Linux Platform
2.1.2. On a Microsoft Windows Platform
2.2. Clean Start
2.2.1. On a Linux Platform
2.2.2. On a Microsoft Windows Platform
2.3. Start in debug mode
2.3.1. On a Linux Platform
2.3.2. On a Microsoft Windows Platform
2.4. Start with JMX Access Enabled
2.4.1. On a Linux Platform
2.4.2. On a Microsoft Windows Platform
2.5. Stop
2.5.1. On a Linux Platform
2.5.2. On a Microsoft Windows Platform
3. The Web based Administration Console
3.1. Authentication with the Admin Console
3.2. The sections of the Admin Console
4. Provisioning Repository
4.1. Introduction
4.2. Repository Structure
4.3. Installing Bundles
4.4. Installing Libraries
4.5. Finding Bundles in the SpringSource Enterprise Bundle Repository
4.6. Configuring the repository
5. Serviceability
5.1. Log Files
5.2. Trace
5.2.1. Application Output
5.2.1.1. Per-application trace
5.2.1.2. System.out and System.err
5.2.2. Roll-over of trace files
5.3. Service Dumps
6. Working with Applications
6.1. Deploying Artifact
6.1.1. Hot Deploy
6.1.2. Manually Deploy
6.1.3. What Happens When You Deploy
6.1.4. Deployment Ordering
6.1.5. Restrictions
6.2. Undeploying an Artifact
6.2.1. Hot Undeploy
6.2.2. Manually Undeploy
7. Configuring the SpringSource Application Platform
7.1. Configuring Serviceability
7.1.1. Configuring tracing
7.1.2. Configuring logging
7.1.3. Configuring dump files
7.2. Configuring the Embedded Tomcat Servlet Container
7.2.1. Servlet Container Configuration
7.2.2. Connector Configuration
7.2.3. Tomcat Configuration Files
7.3. Configuring Equinox
7.3.1. Configuring the telnet console
7.4. Configuring Deployment
7.4.1. Configuring the Deployment Timeout
7.5. Configuring the Provisioning Repository
7.5.1. Search Paths
7.5.1.1. Wildcards
7.5.1.2. System properties
7.5.2. Example configurations
7.5.2.1. Replace bundles/usr with an Ivy cache
7.5.2.2. Replace bundles/usr with a Maven local repository
8. Known Issues
8.1. Timeout During Startup Due to Firewall Settings
9. Log Error Codes
9.1. Log Codes
9.1.1. Subsystem Codes
9.1.2. Error Number
9.1.3. Event Severity
9.2. Detailed Log Codes
9.2.1. Concurrent Log Codes
9.2.2. Control Log Codes
9.2.3. Config Log Codes
9.2.4. Deployer Log Codes
9.2.5. FFDC Log Codes
9.2.6. Bootstrap Log Codes
9.2.7. Kernel Log Codes
9.2.8. OSGi Log Codes
9.2.9. Profile Log Codes
9.2.10. Servlet Log Codes
9.2.11. Web Log Codes
10. Further Reading