Virgo OSGi bundles CLI

Command line tool for Virgo OSGi server management and automation.

These bash scripts allow you upload, deploy and manage OSGi bundles at Virgo OSGi server and legacy SpringSource dm Server.

Getting Started

This project provides 2 scripts to manage OSGi bundles at:

• virgo-bundles.sh - Virgo OSGi server from EclipseRT
• dmserver-bundles.sh - SpringSource dm Server (legacy)

Use following format to run scripts:

./virgo-bundles.sh <command> [options]

Commands

Scripts support following commands:

• deploy - upload and deploy OSGi bundle to Virgo server, required options: -f
• status - check status of bundle at Virgo server, required options: -n, -v
• stop - stop bundle at Virgo server, required options: -n, -v
• start - start bundle at Virgo server, required options: -n, -v
• refresh - refresh bundle at Virgo server, required options: -n, -v
• uninstall - uninstall bundle from Virgo server, required options: -n, -v
• list - list bundles deployed at Virgo server, optional filter options: -n, -t, -v
• help - display help information

Options

Following options are supported by each script:

• -f path - location of OSGi bundle to upload, e.g. /opt/repo/org.slf4j.api-1.7.2.jar
• -n name - bundle symbolic name, e.g. org.slf4j.api
• -v version - bundle version, e.g. 1.7.2
• -t type - bundle type, possible types: bundle, plan, par, configuration, default: bundle
• -user auth - user name and password for basic auth, e.g. admin:passwd (will be prompted if not given)
• -url url - Virgo server URL, e.g. http://virgo.internal:7070
• -verbose - enable verbose output

Examples

Upload and deploy a new OSGi bundle to Virgo server, deployed bundle will be activated:

./virgo-bundles.sh deploy -f ~/dev/virgo-test-1.0.0-SNAPSHOT.jar

Check status of deployed bundle, possible bundle states: ACTIVE, RESOLVED:

./virgo-bundles.sh status -n virgo-test -v 1.0.0.SNAPSHOT

Stop activated bundle at Virgo server:

./virgo-bundles.sh stop -n virgo-test -v 1.0.0.SNAPSHOT -url http://localhost:8081

Start deployed bundle at Virgo server:

./virgo-bundles.sh start -n virgo-test -v 1.0.0.SNAPSHOT -verbose

Refresh deployed bundle at Virgo server:

./virgo-bundles.sh refresh -n virgo-test -v 1.0.0.SNAPSHOT

Uninstall deployed bundle:

./virgo-bundles.sh uninstall -n virgo-test -v 1.0.0.SNAPSHOT

References

• Virgo from EclipseRT official web site
• Continuous Deployment with Docker and Virgo
• UploadServlet.java from Virgo management console
• Latest version of SpringSource dm Server