Page History

...

All you need is 5 to 10 minutes and to follow these basic steps.

• #Background
• #Getting the software
• #Start the server
• #Deploy a sample application
• 1. Quick Start
• 1. Quick Start
• 1. Quick Start
• 1. Quick Start

Background

Apache Felix Karaf is a small and lightweight OSGi based runtime. This provides a small lightweight container onto which various bundles can be deployed.

1. Quick Start#top

Getting the software

At this time you have one option to get the software. The fastest and easiest way is to get the binary directly from the Apache site. Since this article is intended to help you to have Apache Felix Karaf up and running in the fastest way only the binary download will be covered at this time.

...

The installation of Karaf is as simple as uncompressing the .zip or .tar files. The next step is to start the server.

1. Quick Start#top

Start the server

With Karaf already installed, open a command line console and change directory to <SERVICEMIX_HOME>. To start the server, run the following command in Windows:

...

In the output, locate the line containing camel-example-osgi and note the id of the bundle in the first column. Then launch the following command:

osgi/stop [SMX4KNL:id]

If you wish, you can start again the sample by using the following command:

osgi/start [SMX4KNL:id]

To uninstall the demo, run the following command:

osgi/uninstall [SMX4KNL:id]

Common Problems

1. Launching SMX4 can result in a deadlock in Felix during module dependency resolution. This is often a result of sending a SIGINT (control-C) to the process when it will not cleanly exit. This can corrupt the caches and cause startup problems in the very next launch. It is fixed by emptying the component cache:

   Code Block
   rm -rf data/cache/*

...

This document showed you how simple it is to have Apache Felix Karaf up and running. The overall time for getting the server running should be less than five minutes if you have the prerequisite (Java 1.5) already installed. Additionally, this article also showed you how to deploy and test a simple Apache Camel application in less than five minutes.

1. Quick Start#top

{scrollbar}