| h1. Installation |
| |
| This chapter describes how to install Apache Karaf Cave into an existing Apache Karaf instance. |
| |
| h2. Pre-installation requirements |
| |
| As Apache Karaf Cave is a Apache Karaf sub-project, it has to be installed into a running Apache Karaf instance. |
| |
| Apache Karaf Cave is available as Apache Karaf features. The easiest way to install is just to have an internet |
| connection from the Apache Karaf running instance. |
| |
| Apache Karaf Cave 4.0.x is designed to work on Apache Karaf 4.0.x. |
| |
| h2. Registration of the Apache Karaf Cave features |
| |
| Simply register the Apache Karaf Cave features URL in your Apache Karaf instance: |
| |
| {code} |
| karaf@root()> feature:repo-add cave 4.0.0 |
| Adding feature url mvn:org.apache.karaf.cave/apache-karaf-cave/4.0.0/xml/features |
| {code} |
| |
| Now Apache Karaf Cave features are available, ready to be installed: |
| |
| {code} |
| karaf@root()> feature:list|grep -i cave |
| cave-server | 4.0.0 | | Uninstalled | karaf-cave-4.0.0 | |
| cave-storage | 4.0.0 | | Uninstalled | karaf-cave-4.0.0 | |
| cave-http | 4.0.0 | | Uninstalled | karaf-cave-4.0.0 | |
| cave-rest | 4.0.0 | | Uninstalled | karaf-cave-4.0.0 | |
| cave-maven | 4.0.0 | | Uninstalled | karaf-cave-4.0.0 | |
| {code} |
| |
| h3. Starting Apache Karaf Cave Server |
| |
| The Apache Karaf Cave Server is installed by the {{cave-server}} feature: |
| |
| {code} |
| karaf@root()> feature:install cave-server |
| {code} |
| |
| The cave-server feature is a meta-feature which actually installs: |
| * cave-storage feature providing the Cave filesystem default storage. |
| * cave-http feature providing the Cave HTTP service allowing a remote access to the repositories. |
| * cave-rest feature providing the Cave REST API allowing to manipulate the repository remotely with any REST HTTP client. |
| * cave-maven feature providing a complete Maven repository for the Cave repositories. |
| |
| After the installation of the cave-server feature, new commands are available: |
| |
| {code} |
| karaf@root()> cave:<TAB> |
| cave:repositories cave:repository-create cave:repository-destroy |
| cave:repository-install cave:repository-populate cave:repository-proxy |
| cave:repository-uninstall cave:repository-update cave:repository-upload |
| {code} |