7.2. Manual Deployment
Overview
You can manually deploy and undeploy bundles by issuing commands at the Red Hat JBoss Fuse console.
Installing a bundle
Use the
osgi:install command to install one or more bundles in the OSGi container. This command has the following syntax:
osgi:install [-s] [--start] [--help] UrlList
Where UrlList is a whitespace-separated list of URLs that specify the location of each bundle to deploy. The following command arguments are supported:
-s- Start the bundle after installing.
--start- Same as
-s. --help- Show and explain the command syntax.
For example, to install and start the bundle, ProjectDir
/target/foo-1.0-SNAPSHOT.jar, enter the following command at the Karaf console prompt:
osgi:install -s file:ProjectDir/target/foo-1.0-SNAPSHOT.jar
Note
On Windows platforms, you must be careful to use the correct syntax for the
file URL in this command. See Section A.1, “File URL Handler” for details.
Uninstalling a bundle
To uninstall a bundle, you must first obtain its bundle ID using the
osgi:list command. You can then uninstall the bundle using the osgi:uninstall command (which takes the bundle ID as its argument).
For example, if you have already installed the bundle named
A Camel OSGi Service Unit, entering osgi:list at the console prompt might produce output like the following:
... [ 175] [Active ] [ ] [Started] [ 60] ServiceMix :: FTP (2009.02.0.psc-01-00RC1) [ 181] [Resolved ] [ ] [ ] [ 60] A Camel OSGi Service Unit (1.0.0.SNAPSHOT)
You can now uninstall the bundle with the ID,
181, by entering the following console command:
osgi:uninstall 181
URL schemes for locating bundles
When specifying the location URL to the
osgi:install command, you can use any of the URL schemes supported by Red Hat JBoss Fuse, which includes the following scheme types:
