WebSphere brand IBM WebSphere Premises Server, Version 6.1.x

Creating Data Capture and Delivery configuration jobs

Use the XMLConfig tool to create Data Capture and Delivery configuration jobs.

Note: WebSphere® Premises Server 6.1.x does not package or use Device Manager server with Data Capture and Delivery. This information is only for existing infrastructure with Device Manager server.

The XMLConfig tool was installed with WebSphere RFID Premises Server 6.0.x and can be found in the IBM_RFID_HOME\premises\tools\dms path. There is an XML directory that contains samples. Replace the values in these samples, as well as in the samples included in this document, with your Device Manager server host name, user ID (for example, dmsuser), and password in order to access the Device Manager server Web Service. Also, specify the device name under which the Data Capture and Delivery controller registers on the Device Manager server.

Use Device Manager commands to interact with the Device Manager server to check job status or create jobs to retrieve the Edge Configuration Node Tree. You can also perform these actions with the Device Manager Application. Run the commands from the following directory:
IBM_RFID_HOME\DeviceManager\dmadmcli\bin
Refer to the following sample commands (see the Device Manager Help for more details):
  • Check jobs and their status for the OSGi device type:
    dmlsjob -dc OSGi
  • Check job progress for an individual device:
    dmlsprogress -n device_ID -out PAIR
  • Retrieve the Edge Configuration (Node Discovery):
    dmaddjob -dc OSGi -n device_ID -no T -jt SYNCMLDM_WTREE -jp 
    TREE_WALKER_TARGET_URI=./OSGi/BundleConfiguration STORE_NODES=yes SEARCH_DEPTH=2
    After running this command, you can access the Edge Config Admin settings on the Device Manager server using the Device Management Console. Right click on the device and select View Inventory... > Management Tree.

The initial deployment works with a Data Capture and Delivery controller that has been set up correctly using Device Manager server. After the initial OSGi framework startup, the device registers at the Device Manager server and waits for a Device Manager job to run.

To start the initial deployment of the Data Capture and Delivery software, verify that the Data Capture and Delivery controller registered successfully by listing all devices in the Device Management Console. Then create a Node Discovery job using the command described above and verify the Inventory Management Tree.

Use the XMLConfig tool to create a multistep configuration job. You can use the following XML as a template. Replace device_ID with the ID that the Data Capture and Delivery controller enrolls at the Device Manager server.
<?xml version="1.0" encoding="UTF-8"?>

<dms-task>
	<server uid="user_ID" passwd="password">
		<url value="http://dms_host_name/dmserver/servlet/rpcrouter"/>
	</server>

	<job action="replace" type="SYNCMLDM_CMD" deviceClass="OSGi" notification="True"
			 deviceName="device_name">   <!--MUST BE EXISTING DEVICE-->
		<param name="1#REPLACE_ITEM_1_TARGET_URI" 
value="./OSGi/BundleConfiguration/com.ibm.rfid.bundle.loader/bundleListURL"/>
		<param name="1#REPLACE_ITEM_1_DATA" 
value="http://dms_host_name/bundleadmin/GetBundle?name=
http://host_name/bundles/bundlelists/file_name.txt"/>
		<param name="1#REPLACE_CMD_NUMBER" value="1"/>
		<param name="2#REPLACE_ITEM_1_TARGET_URI" value=
"./OSGi/BundleConfiguration/com.ibm.rfid.edge.config/com.ibm.rfid.edge.config.url"/>
		<param name="2#REPLACE_ITEM_1_DATA" value=
"http://rfid_host_name:port/ibmrfidadmin/premises.sl?action=
getconfig&amp;edge=device_ID"/>
		<param name="2#REPLACE_CMD_NUMBER" value="2"/>
		<param name="3#REPLACE_ITEM_1_TARGET_URI" 
value="./OSGi/BundleConfiguration/com.ibm.rfid.edge.config/
com.ibm.rfid.edge.config.autostart"/>
		<param name="3#REPLACE_ITEM_1_DATA" value="true"/>
		<param name="3#REPLACE_CMD_NUMBER" value="3"/>
	</job>	
</dms-task>
This sample job configures the bundle loader to retrieve a bundle list file from the Device Manager server using the bundleadmin servlet. It also configures the EdgeConfig bundle to retrieve the EdgeConfig XML file from WebSphere Premises Server. After this job runs successfully, start another node discovery job to verify the deployment results.
Note: If you copy and paste this sample XML into a file, the line breaks are replaced by blanks. Make sure you remove these blanks from your XML file.

Library | Support | Terms of use

(c) Copyright IBM Corporation 2004, 2008. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.