IBM Service Management Framework Extension for Relocatable Services

Desktop/laptop:

Operating systems: Windows® NT, 2000, XP

Hardware (minimum):

• Pentium 3, 600 MHz
• 256 MB of RAM

Java tools: Java^TM 1.3.1 or 1.4.x

Other software: SMF Platform Profile for Windows (2000/XP)*

PDA

Operating systems: Windows CE
Hardware: Compaq iPAQ PocketPC 3850 along with PC Card Expansion Jackets or HP iPAQ H4155
Other software: SMF Platform Profile for PocketPC*

Note: Code has not been tested on any other version of PocketPC.

*To find out how to obtain and create an SMF profile for PocketPC and Desktops, please refer to Appendix 1 of ReSMF V0.9.1 - Install Guide.pdf packaged with ReSMFV0.9.1-Docs.zip.

The MoSeF environment in ReSMF has two primary components: MoSeF Node and MoSeF Administration Console.

Some sample bundles (including a cross-device scenario) have been provided along with this release. For details on installing them, please refer to the ReSMF V0.9.1 - Install Guide.pdf packaged with ReSMFV0.9-Docs.zip.

Installing MoSeF Node

MoSeF Node provides a hosting environment for relocatable services that are referred as Mobile Service Bundles.

In order to start MoSeF, a MoSeF registry must be running at one of the nodes. The registry is wrapped inside MoSeF itself. Corresponding to this there can be two types of MoSeF nodes:

• a MoSeF Node with registry running locally
• a MoSeF Node pointing to registry on other MoSeF Node.

Installation instructions on desktop/laptop:

Steps common to both types of MoSeF Nodes (with registry and without registry):

1. Make sure that your desktop is connected to the TCP/IP network and has a valid IP address.
2. Unzip the SMF profile for Windows in a suitable directory (for example, c:\smf).
3. Unzip the contents of ReSMFV0.9.1.zip in some suitable directory (for example, c:\mosef).
4. Inside c:\mosef is a property file named mosef.properties. In this property file, update the various log levels to appropriate values. (They can take values from 1 to 4.)
5. From the command prompt, enter SMF directory (for example, c:\smf>).
6. Start SMF by issuing the following command:
c:\smf> startsmf

Steps for installing and starting MoSeF node with registry running locally:

1. Update the "MOSEF_REGISTRY_IPADDRESS" field in the mosef.properties file with the IP address of this desktop/laptop.
2. Install the MoSeF bundle by issuing the following command:
smf > install file:/c:/mosef/mosef.jar
(This step will install the bundle and will give it a Bundle ID.)
3. Start the MoSeF bundle by issuing the following command:
smf > start BundleId

Steps for installing and starting MoSeF with registry running at some other node:

1. Update the "MOSEF_REGISTRY_IPADDRESS" field in the mosef.properties file with the IP address of any node running MoSeF Registry.
2. Install the MoSeF bundle by using the following command:
smf> install file:/c:/mosef/mosef.jar
3. Start the MoSeF bundle by using the following command:
smf> start BundleId

Notes:

• Before starting this MoSeF bundle, one should make sure that MoSeF Node with registry is already running. Please note that in the current release all MoSeF nodes use port 80 by default.
• If the name of the directory where mosef.jar is located contains blank spaces, then use double quotes to specify the .jar file location. For example, if mosef.jar is contained in the directory MoSeF Platform, then use double quotes in specifying the JAR file location as follows:
smf> install "file:/c:/MoSeF Platform/mosef.jar"

Installation instructions on PocketPC:

Steps common to both types of MoSeF Nodes (with registry and without registry):

1. Make sure that your PocketPC is hooked onto TCP/IP connection and has obtained the IP address.
2. Unzip the SMF profile for PocketPC file in a suitable directory (for example, \smf). Refer to Appendix 1 to create an SMF Profile for Desktops/Laptops.
3. Unzip the contents of ReSMFV0.9.1.zip in some suitable directory (for example, \mosef.)
4. Inside /mosef is a property file named mosef.properties. In this property file, update the various log levels to appropriate values. (They can take values from 1 to 4.)
5. Browse to the /smf directory from File Explorer and click on StartSMF.lnk.

Steps for installing and starting MoSeF node running with registry:

1. Update the MOSEF_REGISTRY_IPADDRESS field in the mosef.properties file with the IP Address of this PocketPC.
2. Install the MoSeF bundle by issuing following command:
smf > install file:/ mosef/mosef.jar (this step will install the bundle and will give it a BundleId)
3. Start the MoSeF bundle by issuing the following command:
smf > start BundleId

Steps for installing and starting MoSeF with registry running at some other node:

1. Update the MOSEF_REGISTRY_IPADDRESS field in the mosef.properties file with the IP Address of any node running MoSeF Registry.
2. Install the MoSeF bundle by using the following command:
smf> install file:/mosef/mosef.jar
3. Start the MoSeF bundle by using the command:
smf> start BundleId

Notes:

• Please make sure that your PocketPC has obtained a valid IP address and that you can ping it from your desktop.
• Before starting this MoSeF bundle, one should make sure that MoSeF Node with registry is already running. Please note that in the current release all MoSeF nodes use port 80 by default.
• If the name of the directory where mosef.jar is located contains blank spaces, then use double quotes to specify the .jar file location. For example, if mosef.jar is contained in the directory MoSeF Platform, then use double quotes in specifying the JAR file location as follows:
smf> install "file:/MoSeF Platform/mosef.jar"

Installing MoSeF Administration Console

1. Unzip the content of AdminConsoleV0.9.1.zip to a location from where you want to run the console.
2. Copy the following .jar files to the AdminConsole -> lib directory.
• mosef.jar
• servlet.jar (Find /smf/bundles/x-x-servlet23.jar, create a copy of it, and rename it as servlet.jar.)
• smf.jar (Find it in /smf/.)
3. To start the console, execute AdminConsole -> Adminconsole.bat

Notes:

• SMF need not be started in order to run the MoSeF Administration Console. Since the Administration Console requires the above mentioned .jar files bundled with SMF, it has been added as a prerequisite.
• Please refer to the ReSMF V0.9.1 - Install Guide.pdf packaged along with ReSMFV0.9.1-Docs.zip for instructions on configuring the MoSeF Administration Console.