Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Getting Started : Deploying the Adapter

Deploying the Adapter
This section describes how to deploy the runtime adapter from the command line. The adapter instance configured in the last section will be deployed.
To deploy the adapter from the command line, follow these steps:
1.
a.
From the Project menu, select Export Full Project.
b.
Browse and select the location of the directory where you want to save the DAT file in the Export Project dialog, for example e:\temp.
c.
Enter the name for the .dat file in the Project Name field in the Export Project dialog, for example, testpub.
d.
Click OK. The testpub.dat file is generated and saved in e:\temp.
2.
The TIBCO Runtime Agent file is a runtime configuration file with the tra suffix. Before deploying the adapter, you need to create a TIBCO Runtime Agent file or edit the default TIBCO Runtime Agent file.
The installation program generates the adtuxedo_native.tra and adtuxedo_wrkstn.tra files for the TIBCO ActiveMatrix Adapter for Tuxedo. The files are located in the TIBCO_HOME\adapter\adtuxedo\veriosn_number\bin directory. You need to use the adtuxedo_wrkstn.tra file if the adapter works as a Tuxedo Workstation client and use the adtuxedo_native.tra file if the adapter works as a Tuxedo Native client.
In this example, the adapter works as a workstation client. You need to make a copy of the adtuxedo_wrkstn.tra file. You can rename it, for example test.tra, and update the related variables. At a minimum, the following variables must be updated:
tibco.repourl—pathname of the TIBCO Designer project DAT file
tibco.configurl—name of the adapter configuration
application.args—properties file to pass to the application
tibco.env.WSNADDR—The IP address of the WSL (Workstation Listener) that the client will contact, along with a free port number. This value must be reflected in the ubbconfig file.
If the Field ID is to be loaded dynamically at runtime, set the following environment variables:
FLDTBLDIR32 — contains a list of directories (separated by commas) where field tables can be found
FIELDTBLS32 — contains a list of the files in the table directories (separated by commas) that are to be used
For this example, update the variables as follows:
tibco.repourl E:/temp/testpub.dat
tibco.configurl TuxedoAdapterConfiguration
tibco.env.WSNADDR //192.168.66.44:8100
application.args -system:propFile    %TIB_ADTUXEDO_HOME%/bin/test.tra
3.
You can run the adapter as a console application using a custom properties file. The commands given next starts the adapter service that is identified in the test.tra properties file, which is located in the same directory as the executable. The absolute pathname to the properties file must be given if it is located in a different directory than the executable.
Before deploying the adapter, you can start the TIBCO ActiveMatrix BusinessWorks process configured in Task D. The process starts to work after receiving the messages from the publication service of the specified adapter.
To deploy the adapter, follow these steps:
a.
In another command window, navigate to the APPDIR directory. In this example, the APPDIR directory is TIBCO_HOME\adapter\adtuxedo\veriosn_number\examples\AgentBased\PurchaseOrder.
b.
Run the make.bat file.
c.
Navigate to the TIBCO_HOME\tibco\adapter\veriosn_number\bin\ directory in a command line window.
d.
Type adtuxedo_wrkstn -system:propFile test.tra to start the adapter instance.
e.
clt is a request sent from the Tuxedo client. clt invokes the Tuxedo service that sends a request to the adapter through the adapter agent. The adapter publishes the data to the TIBCO environment.
4.
From a command prompt you can stop the adapter by publishing a message on the adtuxedo termination subject or type Ctrl-C in the window where the adapter was started.

Copyright © TIBCO Software Inc. All Rights Reserved