Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
EIG:Install into Apache Karaf
Contents
Introduction
ECFs Remote Services/Remote Service Admin implementation may be used on any OSGi R4.3+ compatible Framework Implementation. Starting with ECF 3.8.0 we will provide the Apache Karaf provisioning metadata to allow ECF RS/RSA SDK to be easily installed into a Karaf installation.
What is Karaf?
Karaf is a lightweight OSGi server that supports installing Karaf-based features into the runtime. For more information about Karaf, and/or to download see here, and for more information about Karaf provisioning see here.
Installing ECF Remote Services SDK into Karaf
Karaf 3.x
Requirements: Karaf 3.x requires Java 1.7 (1.8 is not supported).
In the instructions below, use the following for the <repo url>
<repo url>: http://download.eclipse.org/rt/ecf/latest/site.p2/karaf-features.xml
Karaf 4.x
requirements: Karaf 4.x can use either Java 1.7 or 1.8.
1.7 <repo url>: http://download.eclipse.org/rt/ecf/latest/site.p2/karaf4-features.xml
1.8 <repo url>: http://download.eclipse.org/rt/ecf/latest/site.p2/karaf4-j8-features.xml
ECF Remote Services SDK Install
- If you haven't already done so, install the Karaf webconsole
- In Karaf command shell: feature:install webconsole
- Open a Web Browser at http://localhost:8181/system/console. See here for Karaf default username/password and other information about the use of the webconsole.
- Add the ECF Repository
- From the Webconsole Main menu choose Main->Features
- Add the appropriate <repo url> from above to in the text box, and select Add URL button
The available ECF's features will then be shown below (e.g. ecf.rs.sdk)
- Install the ECF SDK
- To install from the webconsole, click on the arrow for the ecf.rs.sdk feature/row underneath the Actions column to install.
- To install from the Karaf command console, enter this command: feature:install -v ecf.rs.sdk
- When install is complete, the bundles list will have all ECF bundles active