Difference between revisions of "Gemini/Management/GettingStarted"

From Eclipsepedia

Jump to: navigation, search
(Getting Started)
 
Line 4: Line 4:
 
== Getting Started ==
 
== Getting Started ==
  
1. Download Equinox (org.eclipse.osgi) and org.eclipse.osgi.services jars. Both are available in the Equinox SDK on [http://download.eclipse.org/equinox/| Equinox download page].
+
# Download Equinox (org.eclipse.osgi) and org.eclipse.osgi.services jars. Both are available in the Equinox SDK on [http://download.eclipse.org/equinox/ | Equinox Downloads].
 +
# Download osgi.enterprise jar from [http://download.eclipse.org/tools/orbit/downloads/ | Orbit Downloads].
 +
# Download Gemini Management (org.eclipse.gemini.management) [http://www.eclipse.org/gemini/management/download/ | Gemini Management Downloads].
 +
# Place the four bundles in a folder, e.g. <i>test-gemini-management</i>.
 +
# Create a subfolder <i>configuration</i> with a <i>config.ini</i> file in it to configure Equinox. In <i>config.ini</i> define the property <i>osgi.bundles</i>:
 +
<source lang="text">
 +
osgi.bundles=./org.eclipse.osgi.services_<version>.jar@start,\
 +
  ./osgi.enterprise_<version>.jar@start,\
 +
  ./org.eclipse.gemini.management-2.0.0.RELEASE.jar@start
 +
</source>
  
2. Download osgi.enterprise jar from [http://download.eclipse.org/tools/orbit/downloads/drops/S20111018035124/ | Eclipse Orbit repository].
+
Start Equinox with
 +
<source lang="text">
 +
java -jar org.eclipse.osgi.<version>.jar -console
 +
</source>
 +
Note: With Equinox 3.8 you have to pass a property <i>-Dosgi.console.enable.builtin=true</i> or add the Gogo shell bundles to your installation and <i>config.ini</i> to access the OSGi console.
  
3. [download.eclipse.org/gemini/management/nightly-zips/org.eclipse.gemini.mgmt-1.0.0-SNAPSHOT.jar| Download] Gemini Management jar.
+
What's next?
  
4. Place the four bundles in a folder, e.g. <i>test-gemini-management</i>.
+
# Create a test bundle, from which to invoke the MBeans of Gemini Management. Your test bundle should registers the platform MBeanServer as an OSGi service - Gemini Management needs such service to be registered in order to work.
 
+
# Install and start your test bundle.
5. Create a subfolder <i>configuration</i> with a <i>config.ini</i> file in it to configure Equinox. In <i>config.ini</i> define the property <i>osgi.bundles=./org.eclipse.osgi.<version>.jar@start, ./org.eclipse.osgi.services.<version>.jar@start, ./osgi.enterprise_4.2.0.v201108120515.jar@start, /org.eclipse.gemini.mgmt-1.0.0-SNAPSHOT.jar@start</i>
+
 
+
6. Create a test bundle, from which to invoke the MBeans of Gemini Management. Your test bundle should registers the platform MBeanServer as an OSGi service - Gemini Management needs such service to be registered in order to work.
+
 
+
7. Start Equinox with java -jar org.eclipse.osgi.<version>.jar -console
+
 
+
8. Install and start your test bundle.
+
  
 
== Using Gemini Management in Eclipse ==
 
== Using Gemini Management in Eclipse ==

Latest revision as of 05:14, 24 September 2013

[edit] Getting Started

  1. Download Equinox (org.eclipse.osgi) and org.eclipse.osgi.services jars. Both are available in the Equinox SDK on | Equinox Downloads.
  2. Download osgi.enterprise jar from | Orbit Downloads.
  3. Download Gemini Management (org.eclipse.gemini.management) | Gemini Management Downloads.
  4. Place the four bundles in a folder, e.g. test-gemini-management.
  5. Create a subfolder configuration with a config.ini file in it to configure Equinox. In config.ini define the property osgi.bundles:
osgi.bundles=./org.eclipse.osgi.services_<version>.jar@start,\
  ./osgi.enterprise_<version>.jar@start,\
  ./org.eclipse.gemini.management-2.0.0.RELEASE.jar@start

Start Equinox with

java -jar org.eclipse.osgi.<version>.jar -console

Note: With Equinox 3.8 you have to pass a property -Dosgi.console.enable.builtin=true or add the Gogo shell bundles to your installation and config.ini to access the OSGi console.

What's next?

  1. Create a test bundle, from which to invoke the MBeans of Gemini Management. Your test bundle should registers the platform MBeanServer as an OSGi service - Gemini Management needs such service to be registered in order to work.
  2. Install and start your test bundle.

[edit] Using Gemini Management in Eclipse