SFelix Quickstart

You have two ways of starting SFelix:

You can also of course:

Start SFelix from the Bytecode

To start SFelix from the bytecode, execute the following steps:
  • unjar the bytecode archive
  • jar xvf sfelix_bytecode.jar
  • launch SFelix:

    cd sfelix_bytecode/

    chmod u+x sfelix.sh

    ./sfelix.sh
  • select a new OSGi profile in the shell
  • gives the keystore password to enable the bundle signature verification

    the password used for the example keystore jarvalidation/sFelixKeystore is:

    sfelix

If you want to test SFelix, you can try the SF-Jarsigner Tool , which enables to sign and publish bundles on a remote Repository through FTP.

Start SFelix from the Source Code

To start SFelix from the source code, execute the following steps:
  • unjar the code source

    jar xvf sfelix_src.jar
  • build and launch SFelix:

    cd sfelix_src/

    chmod u+x build_run.sh

    ./build_run.sh
  • select a new OSGi profile in the shell
  • gives the keystore password to enable the bundle signature verification

    the password used for the example keystore jarvalidation/sFelixKeystore is:

    sfelix

If you want to test SFelix, you can try the SF-Jarsigner Tool , which enables to sign and publish bundles on a remote Repository through FTP.

The build_run.sh script does the following:

  • Compiles and installs the code:

    mvn clean install
  • signs the newly create Bundles:

    ./sfelix_sign.sh
  • generates the launcher script

    ./sfelix_generate.sh
  • checks the validity of the code archives and launches SFelix:

    ./sfelix.sh
The default keystore is given in the jarvalidation/sFelixKeystore file. If you need to use your own, modify the sfelix_generate.sh script.

Install new Bundles

All the bundles that are installed in SFelix must be signed, and the signer must be known in the keystore file.

  • For a quick test, install the given example Bundle fridgebundle-1.1.jar from the OSGi shell:

    start file:///path/fridgebundle-1.1.jar
  • So as to install your own signed bundles, you can sign them with the SF-Jarsigner tool we provide, or with Sun jarsigner.