Copyright © TIBCO Software Inc. All Rights Reserved
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 Adapter Tester and from a shell on a UNIX platform.
You cannot deploy the runtime adapter on the Microsoft Windows platform. If you configure the adapter on a Microsoft Windows platform, you can either convert the project to a DAT file or convert the project to an EAR file and then and deploy it on a UNIX machine.
Deploying the Runtime Adapter Using Adapter Tester
The adapter tester is a tool that is used for testing runtime adapters. The adapter tester tool is only supported on UNIX. Follow these steps to deploy the adapter instance.
1.
2.
From the Tools menu, select Show Adapter Tester.
3.
4.
You can see the progress of the request-response service from the console.
Deploying the Runtime Adapter from a Shell
To deploy the runtime adapter from a shell, follow these steps:
1.
a.
b.
From the Project menu, select Export Full Project.
c.
Browse and select the location of the directory where you want to save the DAT file in the Export Project dialog, for example TIBCO_HOME/adapter/adkenan/version_num/test.
d.
e.
f.
The rpc_sample.dat file will be generated and saved in TIBCO_HOME/adapter/adkenan/version_num/test.
2.
Create a TIBCO Runtime Agent file.
The TIBCO Runtime Agent file is a runtime configuration file with the tra suffix.
The installation program generates the TIBCO Runtime Agent file for TIBCO ActiveMatrix Adapter for Kenan/BP, and is called adkenan.tra.On UNIX, if the TIBCO Runtime Agent file generated by the installation program is copied and used by the runtime adapter (with the appropriate modifications), you need to set the required environment for the adapter before running the adapter.
You can use the adkenan.tra file or make a copy of the adkenan.tra file and update the related variables.
a.
Navigate to the TIBCO_HOME/adapter/adkenan/version_num/bin/ directory. Make a copy of the adkenan.tra file, and rename it, for example rpc_sample.tra.
b.
At a minimum, the following must be provided:
tibco.repourl—the pathname of the TIBCO Designer project or the DAT file of the project
tibco.configurl—the name of the adapter configuration
application.args— the path name of the properties file used by the runtime adapter
For example, you can use a text editor and set the following properties:
tibco.repourl TIBCO_HOME/adapter/adkenan/version_num/test/rpc_sample.dat
tibco.configurl KenanAdapterConfiguration1
application.args adkenan --propFile TIBCO_HOME/adapter/adkenan/version_num/bin/rpc_sample.tra
3.
a.
Navigate to the TIBCO_HOME/tibco/adapter/version_num/bin/ directory in a shell.
If you are using the default adkenan.tra properties file to start the adapter, type adkenan --run in the shell. Because the properties file has the same name prefix as the executable and is in the same folder, it need not be specified in the shell.
If you are using a custom TRA properties file that is located in the TIBCO_HOME/tibco/adapter/version_num/bin/ directory, type adkenan --run --propFile   filename.tra in a shell to start the adapter. The absolute pathname to the properties file must be given if the TRA file is located in a different directory than the executable.
b.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved