Server Repository URL


The server repository URL identifies the project to load when the adapter starts. The string is given as a value to the tibco.repourl property which is specified in the adapter’s properties file.

The property syntax differs depending on the protocol with which the adapter and repository server communicate.

TIBCO Rendezvous

In case of a TIBCO Rendezvous transport, the locator string begins with tibcr:// or tibcr@. Next comes the project name.

In addition, the following optional properties are supported. They are separated by colons:

Table 9 Optional properties for server-based URL (TIBCO Rendezvous)
Property
Description
daemon
TIBCO Rendezvous rvd daemon value
service
TIBCO Rendezvous rvd service value
network
TIBCO Rendezvous rvd network value
rva
TIBCO Rendezvous rva host and port
subject
Instance discovery subject
discoveryTime
Timeout value in seconds for instance discovery
timeout
Timeout value in seconds for server requests
operationRetry
Number of retries when timeout occurs
userName
Any identifier (null or empty implies read only with guest privileges)
password
User password for security.
regionalSubject
TIBCO Rendezvous subject prefix used for regional read-operation in the load balancing mode. For additional information see the TIBCO Administrator Server Configuration Guide.
typeAccess

Type of adapter connection. Valid values are:

  • CLIENT_USAGE_DONT_CARE
  • Adapter reads until update, then switches to write. This is the default.

  • CLIENT_USAGE_READ_ONLY
  • Adapter is not allowed to do updates.

  • CLIENT_USAGE_READ_WRITE
  • Adapter can do both reads and updates.

urlFile
Path to the adapter’s properties file.
The property file identifier can either be a fully qualified path or a relative path.The legal properties in this file are the same as optional properties specified above. The properties in the file are appended to the repository locator string. If the same property appears in both locator string and property file, the properties in the locator string take precedence. Property values starting with # are considered obfuscated.

Examples
tibcr://myInst:service=5456:userName=ann:timeout=4000 
tibcr@myInst:service=5456:urlFile=/tibco/props/fredsProps.txt 
tibcr://myInst:urlFile=/tibco/props/fredsProps.txt 

HTTP and HTTPS

In case of HTTP transports url begins with http://.

In case of HTTPS transports url begins with https://.

Host name and port number are next (http://host:port). The port number is optional. If it is not specified, the default value used is 8080 for HTTP and 8443 for HTTPS.

The host name and port number are followed by the project name, which is preceded by a question mark (?), for example, http://host:8080/?inst1

Optionally, administrator/repo may be included as part of the instance name, for example, http://host:8080/administrator/repo/?inst1

HTTPS-specific properties should be placed in a property file and that file should be specified using "urlFile=". urlFile is therefore a required property for HTTPS.

In addition, remote HTTP/HTTPS adapters support the following optional properties separated by &. Note that when & is used as the properties separator, and the URL is specified on the command line, the URL should be enclosed in quotes so that shell does not interpret it.

Table 10 Optional properties for server-based URL (HTTP)
Property
Description
timeout
Timeout value in seconds for server requests.
operationRetry
Number of retries if a timeout occurs.
userName
Any identifier (null or empty implies read only with guest privileges).
password
User password for security.
typeAccess
Whether it is read only or read-write. Valid values are:
  • CLIENT_USAGE_DONT_CARE
  • Adapter reads until update, then switches to write. This is the default.

  • CLIENT_USAGE_READ_ONLY
  • Adapter is not allowed to do updates.

  • CLIENT_USAGE_READ_WRITE
  • Adapter can do both reads and updates.

urlFile
Path to the adapter’s properties file.
The property file identifier can either be a fully qualified path or a relative path. The legal properties in this file are the same as optional properties specified above. The properties in the file are appended to the repository locator string. If the same property appears in both locator string and property file, the properties in the locator string take precedence. Property values starting with # are considered obfuscated. See Defining a urlFile to be Accessed via HTTPS.

Examples
 
http://host:8080?myInst&userName=ann&timeout=4000 
http://host:8080/administrator/repo?myInst&userName=ann&timeout=4000 
https://host:8443?myInst&urlFile=httpsProps.ini 
https://host:8443/administrator/repo?myInst&urlFile=httpsProps.ini 
https://host:8443/administrator/repo?urlFile=httpsProps.ini 

Defining a urlFile to be Accessed via HTTPS

If the URL file is to be accessed via HTTPS, the following information must be included in the properties file:

Table 11 Properties Required for HTTPS urlFiles
Property
Description
trustedCertFormat
Format of the SSL certificate. Can be one of P12, PEM, DER (or ANS1).
httpsVendor

Name of the SSL provider.

The property is ignored because openssl is the only vendor supported.

keyFile

Key file.

Keys can either be embedded as in the case of P12 and DER or non-embedded as in the case of PEM. Key file is relevant only in case of non-embedded key files, that is, PEM.

identityFile
Location of the identity file.
identityType
Format of the identity file. Can be one of P12, PEM, DER (or ANS1).
trustedCertPassword
Password for the certificate specified by trustedCerts.
trustedCerts
Location of the trusted certificate or certificate chain.

Examples

Following is an example for a url file containing HTTPS specific properties:

httpsVendor=j2se 
trustedCerts=H:/downloads/certs/clientcerts/trustedcerts/RSA/PEM/R
SA1024ca1.cert.PEM 
trustedCertFormat=PEM 
trustedCertPassword=RSA1024ca1 
identityFile=H:/downloads/certs/clientcerts/idcert/RSA/P12/RSA1024
ca2.cert.P12 
 
identityType=P12 
keyPassword=RSA1024ca2 
 

TIBCO Adapter™ for COM User’s Guide
Software Release 5.3, September 2005
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com