WSRF Plug-ins for OSGi

Overview

Requirements

Download

FAQs

Forum

Reviews

Platform requirements for WSRF Plug-ins for OSGi

This technology runs in a desktop or laptop environment.

Operating systems: Windows® 2000/XP; RedHat Linux® 9.0

Hardware (minimum):

• Pentium 3, 600 MHz
• 256 MB of RAM

Java™ tool: Java 1.4.2

Installation instructions for WSRF Plug-ins for OSGi

1. Download and unzip the WSRF4OSGi_v0.9.zip file in the directory of your choice. The directory structure is as follows (assuming it is unzipped in the c: drive):
C:\WSRF4OSGi_v0.9: Root directory containing components.
• \doc\: Contains documentation related to the WSRF4OSGi environment.
• \example\AddressBookExample: Contains documents, plug-ins, and source subdirectories.
• \example\BundleResoruceExample: Contains documents, plug-ins, and source subdirectories.
• \license: Contains licensing information.
• \plugins: Core plug-ins of WSRF4OSGi.
• \runtime: SMF run-time environment required for setting WSRF4OSGi environment.
• \tools\SkeletonGeneratorTool: Tool required for generating Skeletons -Adapter and WebService for WS-Resource.
• \tools\StubGeneratorTool: Tool for generating stubs for a WS-Resource running in OSGi environment.
• \tools\wabTool: Tool for generating the Web Application Bundle (WAB), which can be installed the same way as an OSGi bundle.

Installing the WSRF4OSGi server node

The following steps should be taken in a set-up WSRF4OSGi environment.

1. Make sure that your m/c is connected to the network and has a valid IP address.
2. Unzip the contents of the SMF profile provided with WSRF4OSGi at some appropriate location. For convenience, we will extract it to the same location where its zip file has been placed in the WSRF4OSGi directory structure.
3. From the command prompt, enter the SMF directory (for example: C:\WSRF4OSGi_v0.9\runtime\smf).
4. Start SMF by issuing following command:
C:\WSRF4OSGi_v0.9\runtime\smf> startSMF
5. Install each plug-in from the WSRF4OSGi_v0.9\plugins directory into the SMF run-time environment by issuing the following command:
install file:/<plugin location>/<plug-in name>
For example: In order to install com.ibm.pvcws_6.0.0.alpha.jar (with zip file extracted to C:\), use the following command:
install file:/C:/WSRF4OSGi_v0.9/plugins/com.ibm.pvcws_6.0.0.alpha.jar

Install the plug-ins in the following order:

com.ibm.pvcws_6.0.0.alpha.jar
com.ibm.pvcws.osgi_6.0.0.alpha.jar
com.ibm.wsrf.schemahost_1.0.0.jar
com.ibm.wsaddressing_1.0.0.jar
com.ibm.wsbf_1.0.0.jar
com.ibm.wsrf.common_1.0.0.jar
com.ibm.wsrf.wsrlt_1.0.0.jar
com.ibm.wsrf.wsrp_1.0.0.jar
com.ibm.wsrf.client_1.0.0.jar
com.ibm.wsrf.wsdlgenerator_1.0.0.jar
com.ibm.wstop_1.0.0.jar
com.ibm.wsn.common_1.0.0.jar
com.ibm.wsn.marshaller.epr_1.0.0.jar
com.ibm.wsn.marshaller.tpex_1.0.0.jar
com.ibm.wsn_1.0.0.jar
com.ibm.wsn.client_1.0.0.jar

6. Start the WSRF4OSGi run-time bundles by issuing following commands:
smf> start [sequence of bundles mentioned above]

For example:

smf> start 18 19
In this example, 18 is the bundle ID of com.ibm.pvcws_6.0.0.alpha.jar and 19 is the bundle ID of com.ibm.pvcws.osgi_6.0.0.alpha.jar.

Notes:

• Before starting SMF in a Linux environment, edit smf.properties files and change the default HTTP port to 8080. Port 80 may be available only to the super-user. For example: set org.osgi.service.http.port=8080
• In a Linux environment, SMF can be started by using following command:
  sh StartSMF.sh
• If the plug-ins file path contains spaces, then put the plug-ins path in quotes. For example:
  install "file:/C:/some location/WSRF4OSGi_v0.9/plugins/com.ibm.pvcws_6.0.0.alpha.jar"

The package includes the following plug-ins for setting up the client-side environment:

com.ibm.pvcws_6.0.0.alpha
com.ibm.pvcws.osgi_6.0.0.alpha
com.ibm.wsaddressing_1.0.0
com.ibm.wsbf_1.0.0
com.ibm.wsrf.common_1.0.0
com.ibm.wsrf.client_1.0.0
com.ibm.wsn.common_1.0.0
com.ibm.wsn.client_1.0.0
com.ibm.wsn.marshaller.epr_1.0.0
com.ibm.wsn.marshaller.tpex_1.0.0

The following two types of clients are possible:

• Normal Java client: Add the above plug-ins in the class path.
• OSGi-based client: The required plug-ins must be installed and started in the OSGi environment.

Installing WSRF4OSGi-based WS-Resources

1. In order to set up a WS-resource in an OSGi environment, WSRF4OSGi must be installed and running at that node. One can set up the server-side plug-ins for WS-resource in the following manner:
1. If the resource component of WS-Resource construct is an OSGi bundle, then install it in the OSGi run-time environment.
2. Install the Adapter component of WS-Resource in the OSGi run-time environment.
3. Install the Web service component of WS-Resource in the OSGi run-time environment.
2. The Bundle WS-Resource sample (included in the WSRF4OSGi_v0.9.zip file) can be set up in the following manner:
1. Install the following plug-ins in the following order:
com.ibm.wsrf.example.bundle.resource_1.0.0
com.ibm.wsrf.example.bundleresource.adapter_1.0.0
com.ibm.wsrf.example.bundleresource.webservice_1.0.0

2. Start each of the above plug-ins.

Installation instructions for the samples are located in the installation guide of each sample's respective sample directory.