Copyright © TIBCO Software Inc. All Rights Reserved

traDBConfig Utility

The traDBConfig utility is used to configure a supported vendor-supplied database driver. If you choose not to specify a vendor-supplied driver during installation, and later wish to use it, you can use this utility to update your files quickly.

You must restart TIBCO Administrator and the TIBCO Hawk agent after using this utility for the changes to be reflected. See TIBCO Runtime Agent Upgrading to Release 5.x for detailed instructions on changing to a vendor-supplied database driver for your existing installations and domains, as well as issues and limitations associated with this utility.

Syntax

>traDBConfig -type dbtype -dbPath db_driver_path (-ociPath oci_client_path) [-product product|-path directory|-filelist listfile]

 

Table 7 traDBConfig Utility Parameters

Parameter	Description
-type	The choices are: SQLServer, DB2, OracleThin and OracleThick.
-dbPath	The path of the vendor-supplied driver. For example: C:\oracle\product\10.1.0\db_1\jdbc\lib Specify the directory of the Oracle thick client if you specify OracleThick in -type.
-ociPath	The path of the Oracle OCI client directory. You must specify this field if you specify OracleThick in -type. On Windows, this is typically the ORACLE_CLIENT_HOME/BIN directory. On Unix systems, this is typically the ORACLE_CLIENT_HOME/lib or ORACLE_CLIENT_HOME/lib32 directory. For example: C:\oracle\product\10.2.0\client\BIN
-product	The product to configure: either tra for Runtime Agent or admin for TIBCO Administrator. If you use this parameter, the traDBConfig utility automatically updates the application files for Runtime Agent or TIBCO Administrator, respective, listed in Table 8. However, it does not update the domain files. To do so, use the -file option. See Notes for more information.
-path	The path of a .tra file you wish to update, or a directory that includes multiple .tra files you wish to update. Specify a directory path if you wish to change a single .tra files in that directory.
-filelist	A text file that contains the lists of files to update. This file can include any combination of the files listed in Table 8. Be sure to include all the files applicable to your installation, including application files as well as domain files. See Notes for more information. This file should be in the following format: FILES file1;file2;file3;...

Notes

In order for your installation of Runtime Agent or TIBCO Administrator and all your domains to function properly after using this utility, you must ensure that the utility updates all the files relevant to your installation.

If you have just installed Runtime Agent and TIBCO Administrator but have not added the machine to a domain, you may simply use the -product tra parameter and -product admin parameter to update the Runtime Agent and TIBCO Administrator files. After you update both the Runtime Agent and TIBCO Administrator files, you can use the vendor-supplied driver when creating new domains.

If you have installed both Runtime Agent and TIBCO Administrator, as well as created domains, then you must also update all the .tra files for the existing Hawk agents and administration servers. In this case, you can prepare a text file that contains a list of all the files that need to be updated and use the -filelist parameter, or you can execute traDBConfig with the -path parameter for each of the domain directories.

 

Table 8 Files for Update with traDBConfig Utility

	Files
Runtime Agent Files (Under TIBCO_HOME/tra/version)	template/domainutility/hawkagenttra.template bin/domain_create.tra bin/CorpUserSynchronizer.tra bin/CorpRoleSynchronizer.tra bin/AppManage.tra bin/RedeployAllAppsForUser.tra bin/MoveMachine.tra bin/ImportDomainSecurity.tra bin/Import2xSecurity.tra bin/ExportDomainSecurity.tra bin/domainutilitycmd.tra bin/domainutility.tra
Domain Hawk Agent Files	TIBCO_HOME/tra/domain/domain/ hawkagent_domain.tra
TIBCO Administrator Files (Under TIBCO_HOME/ administrator/ version)	template/tibcoadmintra.template
Domain Administration Server Files	TIBCO_HOME/administrator/domain/domain/ tibcoadmin_domain.tra

Copyright © TIBCO Software Inc. All Rights Reserved