...

If you are interested in trying out one of our server products, please contact us so we can arrange temporary access to the installer packages.

Installing Apache Karaf

Karaf Felix is an OSGi container from the Apache foundation .When we started using Karaf the upstream project only provided raw zip files with some unfortunate default configuration details, therefore we create our own Karaf packages for safe and easy deploymentand has been packaged by us in an open source effort together with an ssh console as a package called osgi-runner.

On Windows servers, download the installer, apacheosgi-karafrunner-X.X.X-X-setup-x64.exe, from fx.iteg.at and work it through.

In Debian installations, install the package apacheosgi-karafrunner-server.

There is no need to start Karaf the osgi-runner service it right away, we will always need to perform configuration tasks first.

Configurating of

...

osgi-runner

The basic configuration of Apache Karaf is covered in a separate page, Basic Configuration of Apache Karafosgi-runner.

For production setups, please read that through!

...

The debian packages are called apacheosgi-karafrunner-osgi-bundle-activator resp. osgi-bundles-*.

...

On Windows this means to copy the Drivers into the drivers\ subdirectory of the Karaf osgi-runner installation, usually C:\Program Files\apacheosgi-karafrunner\drivers\.

Typical names of the drivers are:

• for MSSQL: sqljdbc4.jar ("4" does not refer to the driver version but to the version of the JDBC API)
• for MySQL: mysql-connector-java.jar
• for Oracle: ojdbc6-11.2.0.1.0.jar resp. ojdbc7-12.1.0.2.0.jar


Feel free to use either the drivers from fx.iteg.at or from the manufacturer of the database server.

...

For debian we provide packages containing the drivers mentioned above, the packages are called apacheosgi-karafrunner-mssql, apacheosgi-karafrunner-mysql, and apacheosgi-karaf-oracle - and there is a meta package apache-karaf-jdbc-all that depends on all of themrunner-oracle11 resp. osgi-runner-oracle12.

Installing Application Bundles

...

Some installations of some applications require an additional package specific to the customer or a particular third party component to use. The product specific installation manuals have the details.

Starting the

...

osgi-runner Service

Now is the right time to start Karaf.

In Windows, start the Windows' Service Manger (services.msc, as Administrator) and start the Service Karaf osgi-runner.

Alternatively, you may enter net start osgi-runner on a Windows command in administrator mode.

In Linux, just call /etc/init.d/apacheosgi-karaf runner start.

Hint: Start happens asynchronously

Like many servers, "started" does not necessarily mean "up and available".

Apache Karaf osgi-runner starts asynchronously int the background, and it and may take a minute or more for it to become up and available.

Continue with the Configuration

Now is the right time to start Karaf to be able to continue with the product specific configuration editing the Karafosgi-runner's config files or using one of the web based configuration managers as described at the bottom of the Basic Configuration of Apache Karafosgi-runner page.