... | ... | @@ -8,10 +8,13 @@ SAlly 4 can be hosted in any OSGi container. We are developing and testing it in |
|
|
|
|
|
Note: For development, we recommend using Apache Karaf because it starts up faster. This becomes important when the OSGi environment becomes too cluttered with half-developed code.
|
|
|
|
|
|
The general producedure
|
|
|
The installation producedure is very similar for both Karaf and ServiceMix, namely
|
|
|
1) download the OSGi container
|
|
|
2) configure external repositories
|
|
|
3) install sally packages
|
|
|
|
|
|
|
|
|
### Installation on Service MIx
|
|
|
## Step 1: Download OSGI containers
|
|
|
### Service MIx
|
|
|
First you need to install Service Mix. Download the 5.0.0 distribution to a directory of your liking. Unzip it and start service mix.
|
|
|
```bash
|
|
|
wget http://apache.openmirror.de/servicemix/servicemix-5/5.0.0/apache-servicemix-5.0.0.zip
|
... | ... | @@ -20,19 +23,7 @@ cd apache-servicemix-5.0.0/bin |
|
|
./servicemix
|
|
|
```
|
|
|
|
|
|
After it finished loading, you should install some of the requirements for the SAlly 4 architecture. You can download the requirements by issuing the following commands in the Service Mix console:
|
|
|
```
|
|
|
features:addurl http://repo1.maven.org/maven2/org/apache/felix/org.apache.felix.ipojo.features/1.11.2/org.apache.felix.ipojo.features-1.11.2.xml
|
|
|
features:addurl http://neptune.eecs.jacobs-university.de/features/sally.features.xml
|
|
|
features:install sally-docmanager
|
|
|
```
|
|
|
|
|
|
For development I also recommend installing the web based consoles
|
|
|
```
|
|
|
features:install activemq-web-console ipojo-webconsole
|
|
|
```
|
|
|
|
|
|
### Installation on Karaf
|
|
|
### Karaf
|
|
|
Download the 3.0.1 of Karaf distribution to a directory of your liking. Unzip and start it.
|
|
|
```bash
|
|
|
wget http://apache.mirrors.hoobly.com/karaf/3.0.1/apache-karaf-3.0.1.zip
|
... | ... | @@ -41,8 +32,8 @@ cd apache-karaf-3.0.1/bin |
|
|
./karaf
|
|
|
```
|
|
|
|
|
|
Edit the file ```org.ops4j.pax.url.mvn.cfg```:
|
|
|
In section org.ops4j.pax.url.mvn.repositories add "http://neptune.eecs.jacobs-university.de/maven@id=kwarc" so that it looks like this:
|
|
|
## Step 2: configure external repositories
|
|
|
For both ServiceMix and Karaf, edit the file ```etc/org.ops4j.pax.url.mvn.cfg```. In section org.ops4j.pax.url.mvn.repositories, add "http://neptune.eecs.jacobs-university.de/maven@id=kwarc" so that it looks like this:
|
|
|
```
|
|
|
org.ops4j.pax.url.mvn.repositories= \
|
|
|
http://repo1.maven.org/maven2@id=central, \
|
... | ... | @@ -54,6 +45,21 @@ org.ops4j.pax.url.mvn.repositories= \ |
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
## Step 3: Install Sally
|
|
|
### ServiceMix
|
|
|
```
|
|
|
features:addurl http://repo1.maven.org/maven2/org/apache/felix/org.apache.felix.ipojo.features/1.11.2/org.apache.felix.ipojo.features-1.11.2.xml
|
|
|
features:addurl http://neptune.eecs.jacobs-university.de/features/sally.features.xml
|
|
|
features:install sally-docmanager
|
|
|
```
|
|
|
|
|
|
For development I also recommend installing the web based consoles
|
|
|
```
|
|
|
features:install activemq-web-console ipojo-webconsole
|
|
|
```
|
|
|
|
|
|
### Karaf
|
|
|
After it finished loading, you should install some of the requirements for the SAlly 4 architecture. You can download the requirements by issuing the following commands in the Karaf console:
|
|
|
```
|
|
|
feature:repo-add camel
|
... | ... | @@ -61,9 +67,9 @@ feature:repo-add activemq |
|
|
feature:repo-add http://repo1.maven.org/maven2/org/apache/felix/org.apache.felix.ipojo.features/1.11.2/org.apache.felix.ipojo.features-1.11.2.xml
|
|
|
feature:repo-add http://neptune.eecs.jacobs-university.de/features/sally.features.xml
|
|
|
feature:install sally-docmanager
|
|
|
|
|
|
```
|
|
|
|
|
|
For development I also recommend installing the web based consoles
|
|
|
```
|
|
|
feature:install webconsole ipojo-webconsole
|
|
|
``` |