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


Chapter 4 Administration Server Properties File : General Properties

General Properties
The following properties are available to all server-based projects:
file.encoding—Optional. Default value is ISO8859-1.
The encoding format for the tibcoadmin_domain.tra property file. By default, the property file is encoded as ISO8859-1. The encoding can be changed to UTF-8 to support multibyte characters.
Typically, this property is not required if the JVM encoding format and the property file encoding format are the same. However, if your JVM and the property file use different encoding formats, this property must be set to correspond to the property file encoding format.
repo.forceInstanceLocks—Optional. Default value is false.
If this property is set to true, the server takes over any existing instance locks. This automatically allows its projects to be modified by client requests.
Warning. This property should only be changed if instance locks have been left hanging by another server and need to be broken. Careless use of this property causes the former lock holder to immediately become read-only, and any pending changes by any of its clients to be lost.
repo.instanceNames—Optional. Use of this option is not recommended.
A comma-separated list of projects to which the server connects. If the list is empty, the server connects to all projects matching its search criteria.
A server-based project exists for a server under these circumstances:
Storage is a file, there is a project with a .dat extension in the server’s search directory, and the file’s contents is a valid TIBCO project.
If the list contains entries, the server connects to the existing server-based projects and throws warnings for non-existing server-based projects.
repo.lockTimeout—Optional. Default value is 120 seconds.
The number of seconds the server is willing to wait without hearing from a client that has locked various resources, before automatically freeing those resources.
This option does not apply to project instance locks.
repo.minimizeHandshakeInterval—Optional. Default value is false.
Bypass delay while checking for duplicate servers during startup if true. This is for use only while testing.
Warning. This is an extremely dangerous option. If there are multiple servers in the environment, this could allow two servers with the same name to be operational simultaneously for a short period of time. During this time clients might get duplicate or contradictory messages leading to invalid states, exceptions, and possibly data corruption.
Be absolutely sure to set this to false in production environments.
repo.qThreadCnt—Optional. The default is 1. The value is set to 2 by the TIBCO Domain Utility.
The queue thread count controls how many threads the server uses to process client read requests for each project. If this value is 2 or more, read requests are processed during commits, but the required memory and number of threads increases. The number can be increased if client applications are waiting and the CPU is running at less than 100 percent.
repo.serverHeartbeatInterval—Optional. Default value is 30000 (30 seconds).
Specifies the server heartbeat interval in milliseconds. Server heartbeats allow clients to detect when a server goes down. Consider increasing the interval if network delays are causing false time-outs after waits of less than the value given.
Any number less than 1000 is considered to be in seconds. For example 900 is not 0.9 seconds, but rather 15 minutes.
repo.serverName—Required.
Name of the administration domain.
repo.serverPassword—Optional.
Use this password to avoid accidental changes to projects (for example, deleting projects) when security is turned off.
repo.secureStatementUseOldLocale—This property specifies the locale to be used by the statement generation logic when generating date and time strings. This is false by default and the default locale is US English. However, for compatibility with old clients, administrator may set this to true and it will generate date/time strings that are compatible with both older and new clients.
Security authentication does not work if the administration server is 5.0.1 or later and the client is pre-5.0.1. Setting the repo.secureStatementUseOldLocale property to true allows this combination to work.
java.property.tra_deploy_timeout—When deploying large applications the TIBCO Hawk agent can time-out before deployment completes, causing it to fail. Depending on your TIBCO Runtime Agent installation version, this can be addressed as follows:
If TIBCO Runtime Agent 5.2.1 or greater is installed on the deployment target machines and on the machine that hosts the administration server, you can increase the value for the java.property.tra_deploy_timeout property in the TIBCO_ADMIN_DOMAIN_HOME\domain-name\bin\ tibcoadmin_domain-name.tra file.
If TIBCO Runtime Agent 5.2.0 or greater is installed on the deployment target machines and TIBCO Runtime Agent 5.2.0 or greater is installed on the machine that hosts the administration server, you can increase the value for the tra_deploy_timeout property in the TIBCO_TRA_DOMAIN_HOME\domain-name\hawkagent.cfg file on each target machine where deployment is failing due to the Hawk agent timing out.
tibcoadmin.client.encoding—Specifies the character encoding that is used to encode the HTML sent to the browser. In most cases UTF-8 is the best choice as it can handle all character sets. In some cases, a different encoding that is tailored to the specific character set(s) being used may offer slightly better performance.
tibcoadmin.autoRefreshInterval—Specifies the interval, in milliseconds, that is used for the auto-refresh feature on the monitor screens. Default is 20000.
tibcoadmin.monitor.traceLogMaxLines—Specifies the maximum number of lines to retrieve during a trace log search. Default is 1000.
DisableAdministratorClearLocks—Objects stored in the admininstration, authorization and application domains can acquire locks. By default, these locks are cleared when the administration server starts. You can change this behavior by setting DisableAdministratorClearLocks to true so that locks are not cleared when the administration server starts for the administration domain where the property is set. The property can be set in the AdministrationDomain.properties and AuthorizationDomain.properties files, which are located in the TIBCO_HOME\tra\domain\domain-name folder.

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