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


Chapter 6 Deploying the Adapter Using TIBCO Administrator : Deploying the Project

Deploying the Project
Before deploying a project, the machine on which the adapter is installed must be part of a TIBCO administration domain. After you have installed the TIBCO Administration Server, any machine on which you install TIBCO Runtime Agent (required by an adapter) can be added to the administration domain. The TIBCO software installed on the machine is then visible and accessible via the TIBCO Administrator GUI.
When you deploy a project, startup scripts and other information about the different components are sent to the machines to which the components were assigned. The project data store and TIBCO Administration Server are updated with the deployed components.
To deploy a project:
1.
2.
Assign adapter archives in the EAR file to adapters installed in the administration domain and likewise assign process archives to process engines.
3.
Password Handling
At design time, the adapter uses a password to connect to the back-end application and fetch metadata. At runtime, the adapter uses a password to connect to the back-end application and interoperate with it. If you create a 4.x configuration using TIBCO Designer 5.1.2, and use the configuration against a 4.x adapter version, some special considerations are required for security.
If you plan to run the adapter locally, define the runtime password value to be a global variable. Before starting the adapter, include the runtime password as a client variable in the adapter's TRA file and obfuscate it using the obfuscate tool. For example, if the password value is defined as %%myPassword%%, create a global variable named myPassword in the global variables section with no value and include the following entry in the adapter's TRA file:
tibco.clientVar.myPassword
If you plan to deploy the adapter using TIBCO Administrator Enterprise Edition 5.1, checkmark the Service property of the global variable in the global variables section. Before deploying the adapter, go to the Advanced tab of the adapter archive and set the password value under the Runtime Variables section.
See Also
See the TIBCO Administrator User’s Guide for an introduction to the TIBCO administration domain and detailed information about the above steps.
Predefined Properties
Table 16 describes predefined properties.
 
Identifies the absolute pathname to the Designer project or to the DAT file where the adapter configuration is defined. This is a mandatory property.
Specifies the location of the adapter configuration inside the project file. This is a mandatory property.
---If a relative path is specified, the adapter service is assumed to be under the default area in the project: /tibco/private/adapter/
---If an absolute path is specified, the adapter configuration is looked up in the project as defined by the argument.
The user name and password used by the repository server to access the project. This is an optional property. If the property is specified in the properties file, it overrides the value in the repository.
Tibco.clientVar. adkenanPassword
tibco.clientVar. adkenanSecurityRealm
A new parameter adkenanSecurityRealm has been added in the tra file of the adapter. This is an optional property. If the property is specified in the properties file, it overrides the value in the repository.
Specifies the runtime values to substitute for global variables defined in the project. This value takes precedence over the named global value set in the project. Substitution takes place only at start up. This is an optional property. If the property is specified in the properties file, it overrides the value in the repository.
Append the global variable to tibco.clientVar, then give its value. For example:
This is the location where the Kenan application is installed. This corresponds to the $ARBORDIR environment variable. This is a mandatory property.
The bin folder under $ARBORDIR. This contains all middleware related executables. By default, this points to $ARBORDIR/bin. This is a mandatory property.
This is the location where Kenan/FX client products are installed. This corresponds to the $BSDSITE environment variable. The java directory under $BSDSITE contains middleware libraries (Java archives) and related properties files. By default, this points to the $ARBORDIR/bsdm_site. This is a mandatory property.
This is the location where BEA Tuxedo is installed. This corresponds to the $TUXDIR environment variable. Kenan/FX middleware uses Tuxedo as the messaging layer. This is a mandatory property.
This is the location where the BEA Tuxedo libraries are installed. By default, this points to $TUXDIR/lib. This is a mandatory property.
This is the location where the BEA Tuxedo executables (binaries) are located. By default, this points to $TUXDIR/bin. This is a mandatory property.
Specifies the server where Tuxedo WSL (WorkStation) is listening. This variable takes the form //<host IP>:<port>.

By default this is specified as //192.168.114.225:20531. It has to be changed accordingly. This is an optional property. This property is applicable only if the workstation address (WSNADDR) is not specified in the tpinit.properties file.
This variable shows the list of Tuxedo FML32 files used by the Kenan/FX middleware. The values set by default are: bali.fml, aruba.fml, ShieldWare.fml, tpadm, Usysflds. It is strongly recommended not to change these. This is a mandatory property.
This variable points to the location of the FML32 files. This is a mandatory property. By default, this is $BSDSITE/config:$TUXDIR:$TUXDIR/udataobj.
This variable points to the location of the 64-bit JRE installation. This points to a complete JRE installation. This is a mandatory property.
This variable specifies the name of the Custom Function Factory Class. This class is used to create Custom Function message handlers. This is a mandatory property only if you are using the custom function callout feature.

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