Administering eXtreme Scale servers and applications in an OSGi environment

Use this topic to install the WebSphere® eXtreme Scale server bundle, an optional fragment that allows loading of your application bundles and non-dynamic user classes, such as plug-ins, agents, data objects, and so on.

1. Install the eXtreme Scale server bundle. You must know the file URL of the bundle Java archive (JAR) file. For example:

   osgi> install file:///home/user1/myOsgiEnv/plugins/objectgrid.jar
   Bundle id is 41
   
   osgi>

   The eXtreme Scale bundle is now installed, but not yet resolved.
2. If the eXtreme Scale server must load user classes directly, rather than using dynamic plug-ins exposed via OSGi services, then you must also install a user-developed fragment that either provides those classes or imports them.
   If you are using dynamic plug-ins and not using agents, you can skip this step. Here is an example of how to install a custom fragment:

   osgi> install file:///home/user1/myOsgiEnv/plugins/myFragment.jar
   Bundle id is 42
   
   osgi> ss
   
   Framework is launched.
   
   id	State       Bundle
   ...
   41	INSTALLED   com.ibm.websphere.xs.server_7.1.1
   42	INSTALLED   com.mycompany.myfragment_1.0.0
   
   osgi>

   Now the eXtreme Scale server bundle and the custom fragment that attaches to the bundle are both installed.
3. Start the eXtreme Scale server bundle; for example:

   osgi> start 41
   
   osgi> ss
   
   Framework is launched.
   
   id	State       Bundle
   ...
   41	ACTIVE      com.ibm.websphere.xs.server_7.1.1
   	              Fragments=42 
   42	RESOLVED    com.mycompany.myfragment_1.0.0
   	              Master=41
   
   osgi>

4. Now install and start all user application bundles using the same previously mentioned commands. To start a grid on this server, the server and container definition must be declared using Blueprint, or the application must start the server and container programmatically from a bundle activator or some other mechanism.