Tutorial: Running eXtreme Scale bundles in the OSGi framework
The OSGi sample builds on the Google Protocol Buffers serializer samples. When you complete this set of lessons, you will have run the serializer sample plug-ins in the OSGi framework.
This sample demonstrates the OSGi bundles. The serializer plug-in is incidental and is not
required. The OSGi sample is available on the WebSphere eXtreme Scale samples gallery. You must download the
sample, and extract it into the wxs_home/samples directory.
The root directory for the OSGi sample is wxs_home/samples/OSGiProto.
The command examples in this tutorial assume that you are running on the UNIX operating system. You must adjust the command example to run on a Windows operating system.
Learning objectives
After completing the lessons in this tutorial, you will understand the OSGi sample concepts and know how to complete the following objectives:- Install the WebSphere® eXtreme Scale server bundle into the OSGi container to start the eXtreme Scale server.
- Set up your eXtreme Scale development environment to run the sample client.
- Use the xscmd command to query the service ranking of the sample bundle, upgrade it to a new service ranking, and verify the new service ranking.
Time required
This module takes approximately 60 minutes to complete.Prerequisites
In addition to downloading and extracting the serializer samples, this tutorial also has the following prerequisites:- Introduction: Starting and configuring the eXtreme Scale server and container to run plug-ins in the OSGi framework
In this tutorial you start an eXtreme Scale server in the OSGi framework, start an eXtreme Scale container, and wire the sample plug-ins with eXtreme Scale runtime environment. - Module 1: Preparing to install and configure eXtreme Scale server bundles
Complete this module to explore OSGi sample bundles and examine configuration files that you use to configure the eXtreme Scale server. - Module 2: Installing and starting eXtreme Scale bundles in the OSGi framework
Use the lessons in this module to install the eXtreme Scale server bundle into the OSGi container, and start the WebSphere eXtreme Scale server. - Module 3: Running the eXtreme Scale sample client
The WebSphere eXtreme Scale server is now running in an OSGi environment. Complete the steps in this module to run an WebSphere eXtreme Scale client that inserts data into the grid. - Module 4: Querying and upgrading the sample bundle
Complete the lessons in this module to use the xscmd command to query the service ranking of the sample bundle, upgrade it to a new service ranking, and verify the new service ranking.