The document discusses several OSGi tools including Libra, Gemini Web, and Virgo. Libra provides tools for OSGi enterprise application development by integrating existing PDE and WTP tooling. Gemini Web allows installation of WAR files and Web Application Bundles in OSGi and controls their lifecycle. Virgo is a modular Java application server for enterprise Java applications that features application isolation, hot deployment, and support for Spring. It discusses concepts like regions, deployment of bundles and plans, and debugging and security techniques for Virgo.

1. Hands on Gemini, Virgo, Libra
Hristo Iliev, Violeta Georgieva, Borislav Kapukaranov
March 22, 2011

2. Libra
OSGi Tooling, Creating Web Application Bundle

3. Overview
Integrates the existing WTP and PDE
tooling. Provides standard tools for OSGi
Enterprise application development.
Features:
 Creation of deployable artifacts
 Converting existing Java EE artifacts
 Editing and validation of artifact metadata
 OSGi server adapter
© 2011 SAP AG. All rights reserved. 3

4. Web Application Bundle
Creation
© 2011 SAP AG. All rights reserved. 4

5. Gemini Web
Web Application Bundles (WAB), JSF

6. Overview
Model for Java EE Web Applications in
OSGi. Interoperability between Java EE
Web Application and OSGi
Features:
 Installation of WAR files and Web
Application Bundles (WABs)
 Web application lifecycle control
 Control of configuration properties via URL
parameters
© 2011 SAP AG. All rights reserved. 6

7. Gemini Web
Building and Running
© 2011 SAP AG. All rights reserved. 7

8. Virgo
Concepts

9. Overview
Module-based Java application server,
designed to run enterprise Java and
Spring-powered applications.
Features:
 Application isolation
 Kernel isolation
 Provisioning
 Hot deployment
 Web container
 Spring 3
 Legacy library support
 Supportability
© 2011 SAP AG. All rights reserved. 10

10. Features
Group Highlights
Isolation Scoping
User region
Provisioning Hot deployment
Deploy artifacts
Repositories
Type dependencies
Web Jetty
Gemini Web + Tomcat
Libraries Spring
Synthetic bundle context
Supportability Logging
Deadlock detection
Heap dumps
© 2011 SAP AG. All rights reserved. 11

11. Regions
© 2011 SAP AG. All rights reserved. 12

12. Deployment
Hot deploy, Artifacts, Plans

13. Running application on Virgo
How?
 Hot Deploy (pickup directory)
 Admin Console
 Programmatically
© 2011 SAP AG. All rights reserved. 14

14. Deploy bundles
1. Unzip Virgo from the
resources/virgo/virgo-tomcat-server-
3.0.0.M03.zip file, located in the
tutorial materials
2. Start Virgo using either startup.bat or
startup.sh
© 2011 SAP AG. All rights reserved. 15

15. Hot deployment
Bundles
© 2011 SAP AG. All rights reserved. 16

16. Deploy bundles
1. Export from Eclipse & Deploy the
model bundle
2. Export & Deploy the web application
bundle
3. Check both bundles in Admin Console
https://localhost:8080/admin
user: admin
password: springsource
4. Request the web application here
http://localhost:8080/comics/series.jsf
© 2011 SAP AG. All rights reserved. 17

17. Application packaging
Bundle, WAR
 Standard
 Well known
PAR
 Archive with all modules  Atomic
 No ordering
Plan
 Ordering
 Scoping, Atomicity
Configuration
© 2011 SAP AG. All rights reserved. 18

18. Plans
<?xml version="1.0" encoding="UTF-8"?>
<plan name="multi-artifact.plan“ version="1.0.0”
scoped="true“ atomic="true"
xmlns=“…" xmlns:xsi=“…" xsi:schemaLocation=“…“>
<artifact type="configuration”
name="app-properties" version="1.0.0"/>
<artifact type="bundle”
name="com.acme.exciting.app" version="[2.0.0, 3.1.0)"/>
</plan>
© 2011 SAP AG. All rights reserved. 19

19. Hot deployment
Plan
© 2011 SAP AG. All rights reserved. 21

20. Deploy plans
1. Stop the model bundle (this time lets
use the Admin Console
https://localhost:8080/admin
user: admin
password: springsource)
2. Request the web application in a new
browser
http://localhost:8080/comics/series.jsf -
what happens?
3. Undeploy both bundles
© 2011 SAP AG. All rights reserved. 22

21. Deploy plans - atomicity
1. Copy both bundles in repository/usr
2. Create a plan for our application using
the already existing one as a skeleton
3. Deploy the created plan via Admin
Console
4. Check how stopping the model bundle
will affect the application this time
© 2011 SAP AG. All rights reserved. 23

22. Usage hints
Debug, Security, Supportability

23. Debugging
Debug options:
 -debug <port>
 -suspend
Serviceability :
 Logs
 Dumps
 Heap dumps
© 2011 SAP AG. All rights reserved. 25

24. Productive usage
Restrict access:
 Remove Admin console
 Bind OSGi telnet to localhost
Optimize:
 Move artifacts watched  external
 Pre-compile JSPs
© 2011 SAP AG. All rights reserved. 26

25. Feedback
Mailing list:
https://dev.eclipse.org/mailman/listinfo/vir
go-dev
Virgo forums:
http://www.eclipse.org/forums/index.php
?t=thread&frm_id=159
© 2011 SAP AG. All rights reserved. 27

26. Thank You!
Contact information:
Hristo Iliev (hsiliev@gmail.com)
Borislav Kapukaranov (b.kapukaranov@gmail.com)
Violeta Georgieva (violeta.georgieva@sap.com)