...
This document describes how to install and configure Apache Felix Karaf for both Unix and Windows' platforms.
Here you will find information about what are pre requisite software, where to download Karaf from and how to customize the installation to use custom ports other than the defaults.
...
- 5 MB of free disk space for the Apache Felix Karaf x.y binary distribution.
- 3 MB of free disk space for the Apache Felix Karaf x.y source distributions or SVN checkout. The Maven build requires roughly 57 MB disk space and for the dependencies Maven downloads during building further 76 MB are required. As a lot of small files are produced, the exact space demands depend greatly on your cluster utilization ratio.
...
- Java Developer Kit (JDK) 1.5.x or greater (http://java.sun.com/).
- The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g.,
c:\Program Files\jdk.1.5.0_06
. To accomplish that, press Windows key and Break key together, switch to "Advanced" tab and click on "Environment Variables". Here, check for the variable and, if necessary, add it. - Apache Maven 2.0.8 9 (http://maven.apache.org/download.html).
...
- From a browser, navigate to http://felixkaraf.apache.org/site/downloadsdownload.cgihtml.
- Scroll down to the "Apache Felix Karaf" section and select the desired distribution.
For a binary distribution, the filename will be similar to:apache-felix-karaf-x.y.zip
. - Extract the files from the ZIP file into a directory of your choice. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
- Proceed to the #Starting Karaf section of this document.
- Following start-up, go to the #Testing the Installation section of this document.
- Optional: see 7.1. Enabling Colorized Console Output On Windows
...
- From a browser, navigate to http://felix.apache.org/site/downloads.cgi.
- Scroll down to the "Apache Felix Karaf" section and select the desired distribution.
For a source distribution, the filename will be similar to:apache-felix-karaf-x.y-src.zip
. - Extract Karaf from the ZIP file into a directory of your choice. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
Build Karaf using Maven 2.0.8 9 or greater and Java 5.Anchor Windows Source Installation Windows Source Installation
The recommended method of building Karaf is the following:Code Block cd [karaf_install_dir]\\src
Wiki Markup where {{\[FELIX:karaf_install_dir\]}} is the directory in which Karaf was installed.
Both steps take around 10 to 15 minutes.Code Block mvn
- Unzip the distribution using your favorite zip tool. The windows distribution is available at
Code Block \[karaf_install_dir\]\assembly\target\apache-felix-karaf-x.y.zip
- Proceed to the #Starting Karaf section of this document.
- Following start-up, go to the #Testing the Installation section of this document.
- Optional: see 7.1. Enabling Colorized Console Output On Windows
...
- From a browser, navigate to http://felixkaraf.apache.org/site/downloadsdownload.cgihtml.
- Scroll down to the "Apache Felix Karaf" section and select the desired distribution.
For a binary Unix distribution, the filename will be similar to: apache-felix-karaf-x.y.tar.gz. - Extract the files from the gzip file into a directory of your choice. For example:
Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.Code Block gunzip apache-felix-karaf-x.y.tar.gz tar xvf apache-felix-karaf-x.y.tar
- Proceed to the #Starting Karaf section of this document.
- Following start-up, go to the #Testing the Installation section.
...
- From a browser, navigate to http://felix.apache.org/site/downloads.cgi.
- Scroll down to the "Apache Felix Karaf" section and select the desired distribution.
For a source distribution, the filename will be similar to:apache-felix-karaf-x.y-src.tar.gz
. - Extract the files from the ZIP file into a directory of your choice. For example:
Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.Code Block gunzip apache-felix-karaf-x.y-src.tar.gz tar xvf apache-felix-karaf-x.y-src.tar
- Build Karaf using Maven 2.0.8 or greater and Java 5:
Code Block The preferred method of building Karaf is the following: cd [karaf_install_dir]/src where [karaf_install_dir] is the directory in which Karaf was installed. mvn
- Uncompress the distribution that has just been created
Code Block cd [karaf_install_dir]/assembly/target gunzip apache-felix-karaf-x.y.tar.gz tar xvf apache-felix-karaf-x.y.tar
- Proceed to the #Starting Karaf section of this document.
- Following start-up, go to the #Testing the Installation section.
...
Code Block |
---|
cd [karaf_install_dir]\src\assembly\target\apache-felix-karaf-x.y-SNAPSHOT
|
where karaf_install_dir
is the directory in which Karaf was installed, e.g., c:\Program Files\apache-felix-karaf-x.y
.
Then type:
Code Block |
---|
bin\karaf.bat |
...
Code Block |
---|
cd [karaf_install_dir]/src/assembly/target/apache-felix-karaf-x.y
|
where karaf_install_dir
is the directory in which Karaf was installed, e.g., /usr/local/apache-felix-karaf-x.y
.
Then type:
Code Block |
---|
bin/karaf.sh |
...
For both Windows and Unix installations, you can perform a clean shutdown of Karaf Kernel by using the following command:
...