Prerequisites
ReutersRFA Adapter Software Requirements
1. rfa.jar (v8.2.1.L1) (shipped with the adapter)
2. Configuration Tool:
This comes along with the ReutersRFA Adapter(config/RFA_ConfigTool.zip). Platform dependent startup scripts config_editor.bat (for Windows) and config_editor.ksh(for Unix/Linux) are provided in the RFA_ConfigTool.zip to activate the configuration UI tool. The RFA Configuration Tool provides a graphical user interface (GUI) to manage the configuration database of RFA Session Layer Software Package. It can be used to populate (import) configuration database from an XML document, manipulate in-memory configuration data and back up (export) configuration database to an XML document. Configuration done using the UI tool will be stored to the system root.
In Windows this information is stored in the registry that is, HKEY_LOCAL_MACHINE\Software\JavaSoft\Prefs for system Preferences and HKEY_CURRENT_USER\SOFTWARE\JavaSoft\Prefs for user Preferences in a very fluffy format.
In Linux, user preferences are stored in ~/.java and System Preferences are stored in /etc/.java For more information, refer to Reuters RFA JAVA SDK.
Setup
The Editor is packaged in config_editor.jar. Assume that the JAR file is installed in the following directory: /Reuters/RFAJ/Tools/config_editor.jar
This file need to be included in the class path in order to run the editor. When setting the CLASSPATH environment variable, specify the full file name of the JAR file. The CLASSPATH must be set prior to starting the RFA configuration Editor to ensure the VM picks up the correct value.
Windows
A batch file config_editor.bat is provided in the directory /Reuters/RFAJ/Tools. The parameter editor can be invoked by double-clicking on the file config_editor.bat. Alternatively, in a command prompt shell, type: set EDITOR_PATH=C:\Reuters\RFAJ\Tools\ set CLASSPATH=%CLASSPATH%;%EDITOR_PATH% where "C:" is the drive on which both JAR files reside.
Unix
A ksh script file config_editor.ksh is provided in the directory /Reuters/RFAJ/Tools. The configuration Editor can be invoked by executing the script file config_editor.ksh. Alternatively, in a ksh, type: export EDITOR_PATH=/Reuters/RFAJ/Tools/config_editor.jar export CLASSPATH=$CLASSPATH:$EDITOR_PATH
Running the Editor
By using default XML parser contained in JRE, Java com.reuters.rfa.tools.config.editor.ConfigEditor
Execute the appropriate script to start the configuration tool then click on File->Import->File->RSSLSampleConfig.xml to import the file. The sample configuration file has the value of "localhost" for the configuration variable name serverList. Change this value to the name of the host on which the P2PS or Source Distributor is running.
Following steps to be followed for creating namespace
For example, ApamaNameSpace
2. Create connection and session nodes under namespace
3. Under connection, create a new connection with the following properties
connectionType : Consumer Connection Type (RSSL), Non-Interactive Provider connection type(RSSL_NIPROV)
Note:
RFA Adapter doesn't support SSL connection type.
serverList : Server IP. For example, localhost
portNumber : Server port. For example, 14002
4. Under session, create a new session with the following properties:
connectionList : can be mapped to connections configured as above
shareConnections : false (for better performance)
The namespace is ready and can start configuring RFA adapter.
Note:
Ensure that the user has root privileges to create preferences using configuration tool.
DISCLAIMER
IAF adapter doesn't make use of RFA_ConfigTool. It is dependent on configurations stored in memory(as explained above). There is no relation between IAF configuration file and RFA configuration Tool.