Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "EIG:Install into Apache Karaf"

(Installing ECF Remote Services SDK into Karaf)
Line 9: Line 9:
 
==Installing ECF Remote Services SDK into Karaf==
 
==Installing ECF Remote Services SDK into Karaf==
  
*[http://karaf.apache.org/index/community/download.html Download] and [http://karaf.apache.org/manual/latest/quick-start.html Install] Karaf v3.x or v4.x
+
*[http://karaf.apache.org/index/community/download.html Download] and [http://karaf.apache.org/manual/latest/quick-start.html Install] Karaf v3.x or v4.x.  See [http://www.liquid-reality.de/display/liquid/2011/02/15/Karaf+Tutorial+Part+1+-+Installation+and+First+application here] for a Karaf install tutorial.
  
===Karaf 3.x Install===
+
===Karaf 3.x===
  
JVM Requirements:  Karaf 3.x requires Java 1.7 (1.8 is not supported).   
+
Requirements:  Karaf 3.x requires Java 1.7 (1.8 is not supported).   
  
In the Install instructions below, use the following for the '''repo url'''
+
In the Install instructions below, use the following for the <'''repo url'''>
  
 
'''http://download.eclipse.org/rt/ecf/latest/site.p2/karaf-features.xml'''
 
'''http://download.eclipse.org/rt/ecf/latest/site.p2/karaf-features.xml'''
  
===Karaf 4.x Install===
+
===Karaf 4.x===
  
JVM requirements:  Karaf 4.x can use either Java 1.7 or 1.8.
+
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.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'''
 
1.8 '''repo url''':  '''http://download.eclipse.org/rt/ecf/latest/site.p2/karaf4-j8-features.xml'''
  
 
===ECF Remote Services SDK Install===
 
===ECF Remote Services SDK Install===
  
*Install the Karaf webconsole
+
*If you haven't already done so, install the Karaf webconsole
 
**In Karaf command shell:  '''feature:install webconsole'''
 
**In Karaf command shell:  '''feature:install webconsole'''
**Open a Web Browser at '''http://localhost:8181/system/console''' and login.  See [http://karaf.apache.org/manual/latest-3.0.x/users-guide/webconsole.html here] for default username/password and other information about the webconsole.
+
**Open a Web Browser at '''http://localhost:8181/system/console'''.  See [http://karaf.apache.org/manual/latest-3.0.x/users-guide/webconsole.html here] for Karaf default username/password and other information about the use of the webconsole.
*In the webconsole, add the ECF Repository
+
*Add the ECF Repository
**From the Karaf Main menu choose '''Main->Features'''
+
**From the Webconsole Main menu choose '''Main->Features'''
**Add the appropriate '''repo url''' above to in the text box, and select '''Add URL''' button
+
**Add the appropriate '''repo url''' from above to in the text box, and select '''Add URL''' button
 
[[File:Karafinst1.png]]
 
[[File:Karafinst1.png]]
 
The available ECF <version> Karaf features will then be shown in the panel below (e.g. '''ecf.rs.sdk''')
 
The available ECF <version> Karaf features will then be shown in the panel below (e.g. '''ecf.rs.sdk''')

Revision as of 15:06, 6 July 2015

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 Install instructions below, use the following for the <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

Karafinst1.png The available ECF <version> Karaf features will then be shown in the panel below (e.g. ecf.rs.sdk) Karafinst2.png

  • 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

Karafinst3.png The ECF RS SDK is installed and running in Karaf

Back to the top