WebSphere brand IBM WebSphere Premises Server, Version 6.1.x

Configuring the IBM Data Capture and Delivery Toolkit for WebSphere Premises Server

This task describes how to configure the IBM® Data Capture and Delivery Toolkit for WebSphere® Premises Server.

When using the IBM Data Capture and Delivery Toolkit for WebSphere Premises Server, make sure the Java™ compiler is set to compliance level 1.4. To verify and set the compliance level, start Eclipse and click Window > Preferences > Java > Compiler.

The following launch configurations are included in the toolkit:
DataCapture-FullSim
Launches both the Simulated Reader and the simulated WebSphere Premises Server on one machine. This configuration launches the I/O Simulator, the Premises Simulator, and the Premises Simulator Status Window interfaces.
The I/O Simulator interface allows you to simulate input and output pins.
The Premises Simulator interface allows you to set the portal ID and the Data Capture and Delivery device ID, to start and stop the reader simulator on the Data Capture and Delivery device, to restart the OSGi framework for the Data Capture and Delivery device, and to reload the XML configuration for the Data Capture and Delivery device.
The Premises Simulator Status Window interface allows you to set the Data Capture and Delivery device ID. It also displays the last heartbeat, the last alert, and the total batch processing time that was received from the Data Capture and Delivery device.
This launch configuration works immediately after installation and no other machine or WebSphere Premises Server is required. You can use this launch configuration to verify the installation.
DataCapture-RdrSim
Launches a remote Data Capture and Delivery device, the Simulated Reader, and the I/O Simulator interface. This configuration simulates a remote Data Capture and Delivery device that has a Simulated Reader and is connected to a WebSphere Premises Server (real or simulated) that is running on a separate machine. The I/O Simulator interface is also launched.
This launch configuration requires another machine and also requires additional configuration.
DataCapture-LLRP
Launches the LLRP reader agent and the I/O Simulator interface.

Low Level Reader Protocol (LLRP) is a standard specification for the network interface between an RFID reader and its controlling software or hardware. For more information on LLRP, see http://www.epcglobalinc.org/standards/llrp/.

This launch configuration requires that WebSphere Premises Server (real or simulated) is running on another machine.
DataCapture-PremSim
Launches a simulated WebSphere Premises Server. The Premises Simulator interface and Premises Simulator Status Window interface are also launched.
The simulated server must be run on a separate machine from the Simulated Reader.

Launching the Simulated Reader and simulated WebSphere Premises Server on the local system

This section describes how to configure the Simulated Reader and WebSphere Premises Server simulator on a local system. This launch configuration allows you to run the simulators on one machine.

Procedure
  1. From within Eclipse, click Run > Open Run Dialog....
  2. Browse to and select DataCapture-FullSim. It is located under OSGi Framework.
  3. Click Run.

Launching the Simulated Reader and I/O Simulator interface while connecting to a remote WebSphere Premises Server or Premises Simulator

This section describes how to configure the Simulated Reader and I/O Simulator interface when you are connecting it to a WebSphere Premises Server (real or simulated), which is located on another machine.

Procedure
  1. Ensure the configuration file that is sent to the Data Capture and Delivery controller contains the correct value for the server.ip property in the MicroBroker configuration agent. To do this, add the following line to the HOSTS file on the machine that hosts the Simulated Reader:
    premises_server_ip_address put_premises_hostname_here

    For premises_server_ip_address, enter the WebSphere Premises Server IP address. All instances of "put_premises_hostname_here" in the configuration file will be replaced with this IP address.

  2. In the edge-rdrsim-llrp.xml file, which is located in the com.ibm.rfid.resource.toolkit project in the Configurations folder, modify the matrix.properties property of the PortalControllerAgent as follows:
    1. Make sure the following properties are commented as follows:
      <property key="matrix.properties" value="file:BDDR.properties"/>
      <!--<property key="matrix.properties" 
      value="http://put_premises_hostname_here/bundles/BDDR.properties"/>-->
    2. Copy com.ibm.rfid.resource.toolkit/Matrices/BDDR.properties from the workspace to the root runtime directory. By default the root runtime directory is the Eclipse installation root, which is the directory location for the eclipse.exe file.
  3. From within Eclipse, click Run > Open Run Dialog....
  4. Browse to and select DataCapture-RdrSim. It is located under OSGi Framework.
  5. Click Run.
What to do next

The MicroBroker console view can be used to interact with the publish and subscribe engine and trigger events. Do not start the application ping bundle, which is stopped by default.

Note: On a remote system, Data Capture and Delivery cannot log messages unless you install the console log manually. For example, run the following command from the remote Data Capture and Delivery console:
install http://fully_qualified_host_name/bundles/com.ibm.rfid.console.log_version.jar start
The log level of the remote Data Capture and Delivery console is determined by the Alert Agent edge.log.threshold property in the Data Capture and Delivery XML configuration file. The default value of this property is error. If you change the value of this property, restart the remote Data Capture and Delivery environment or reload the configuration.

Launching the LLRP Reader while connecting to a remote WebSphere Premises Server or Premises Simulator

This section describes how to configure the LLRP Reader when you are connecting it to a WebSphere Premises Server (real or simulated), which is located on another machine.

Procedure
  1. Ensure the configuration file that is sent to the Data Capture and Delivery controller contains the correct value for the server.ip property in the MicroBroker configuration agent. To do this, add the following line to the HOSTS file on the machine that hosts the Simulated Reader:
    premises_server_ip_address put_premises_hostname_here

    For premises_server_ip_address, enter the WebSphere Premises Server IP address. All instances of "put_premises_hostname_here" in the configuration file will be replaced with this IP address.

  2. In the edge-rdrsim-llrp.xml file, which is located in the com.ibm.rfid.resource.toolkit project in the Configurations folder, modify the matrix.properties property of the PortalControllerAgent as follows:
    1. Make sure the following properties are commented as follows:
      <property key="matrix.properties" value="file:BDDR.properties"/>
      <!--<property key="matrix.properties" 
      value="http://put_premises_hostname_here/bundles/BDDR.properties"/>-->
    2. Copy com.ibm.rfid.resource.toolkit/Matrices/BDDR.properties from the workspace to the root runtime directory. By default the root runtime directory is the Eclipse installation root, which is the directory location for the eclipse.exe file.
  3. From within Eclipse, click Run > Open Run Dialog....
  4. Browse to and select DataCapture-LLRP. It is located under OSGi Framework.
  5. Click Run.
What to do next

The MicroBroker console view can be used to interact with the publish and subscribe engine and trigger events. Do not start the application ping bundle, which is stopped by default.

Note: On a remote system, Data Capture and Delivery cannot log messages unless you install the console log manually. For example, run the following command from the remote Data Capture and Delivery console:
install http://fully_qualified_host_name/bundles/com.ibm.rfid.console.log_version.jar start
The log level of the remote Data Capture and Delivery console is determined by the Alert Agent edge.log.threshold property in the Data Capture and Delivery XML configuration file. The default value of this property is error. If you change the value of this property, restart the remote Data Capture and Delivery environment or reload the configuration.

Launching the Premises Simulator

This section describes how to configure the Premises Simulator for use with the IBM Data Capture and Delivery Toolkit for WebSphere Premises Server.

Procedure
  1. From within Eclipse, click Run > Open Run Dialog....
  2. Browse to and select DataCapture-PremSim. It is located under OSGi Framework.
  3. Click Run.

Adding additional XML configuration files to the Premises Simulator

This section describes how to add additional configuration files to the Premises Simulator for use with the IBM Data Capture and Delivery Toolkit for WebSphere Premises Server.

Procedure
  1. Copy the new configuration file to the Configurations directory within the com.ibm.rfid.resource.toolkit project. For example, com.ibm.rfid.resource.toolkit/Configurations/edge-samsys.xml.
  2. Add a new, unique property to the com.ibm.rfid.premises.simulator.servlet.properties file within the com.ibm.rfid.premises.simulator.servlet.bundle package of the com.ibm.rfid.premises.simulator.servlet project, which maps the new configuration file to a Data Capture and Delivery controller ID. For example, E2=edge-samsys.xml.
  3. Restart the Premises Simulator.

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.