The ClearQuest Connector Setup Wizard updates the cqconnector.properties file based on the choices that you make in the wizard. If you intend to deploy the ClearQuest Connector on the same computer where you run the wizard, you do not need to edit the cqconnector.properties file. If you intend to deploy the ClearQuest Connector on a different computer, such as one that runs Linux®, copy the cqconnector.properties file to that computer and then edit the file so that any computer path names specified in parameters are correct.
| Parameter | Description |
|---|---|
| com.ibm.rational.interop.pollingPeriod | Polling period, which controls how frequently the ClearQuest Gateway polls for changes to the ClearQuest user database. The default polling period is 60 seconds. |
| com.ibm.team.uris | Jazz™ server Uniform Resource Identifier (URI). The default URI is https://cqconnector:cqconnector@localhost:9443/jazz. Use a semicolon (;) to separate entries for multiple Jazz servers. You must either create a Jazz user named cqconnector or replace cqconnector with the name of another Jazz user. The Jazz user (cqconnector or other) must have a Jazz ClearQuest Connector or Developer license. If you use cqconnector as the user ID, be sure to change the password from the default of cqconnector. |
| cq.dbSetDbName | ClearQuest schema repository and user database. The default schema repository is sample_schema_repo. The default user database is SAMPL. The format is schema-repository-connection-name/user-database-name. |
| cq.orderedProperties.record-type | A comma-separated list of fields that indicates
the order in which the ClearQuest Connector should
set the values of those fields during outgoing synchronization operations.
You can set the parameter for each record type that has a synchronization
rule. Fields that you do not specify in the list are processed after
those in the list. You might need to specify the order if your ClearQuest record types contain
hooks that establish dependencies between fields. Another way to specify the order is to use the Web Dependent Fields property on fields in the form definition in the ClearQuest Designer. If you specify both the Web Dependent Fields property and the cq.orderedProperties parameter, the ClearQuest Connector uses the order specified with the cq.orderedProperties parameter. |
| cq.password | Password for logging into the ClearQuest user database. The ClearQuest Gateway and the Import tool use this password and the user name that you specify with the cq.userId parameter to log into the ClearQuest user database and retrieve records that you want to import into a Jazz repository. The default value is cqconnector. Be sure to change the password from the default value. |
| cq.userId | User name for logging into the ClearQuest user database. The ClearQuest Gateway and the Import tool use this user name and the password that you specify with the cq.password parameter to log into the ClearQuest user database and retrieve records that you want to import into a Jazz repository. The default value is cqconnector. This user must have SQL editor permission. |
| cq.queryTreeRoot | Full path name of the root folder that contains
the project area-specific folder or folders of queries that you use
to filter the records to be synchronized with Rational Team Concert™ items.
You can specify a query for each record type that you synchronize
per project area. You must write the queries in such a way that they
do not select a ClearQuest record
to be synchronized with more than one project area on the same Jazz Team Server. The root folder can be at any level of the folder hierarchy under Public Queries or Personal Queries, but its hierarchy must be as follows: root-folder/project-area-name-folder. Queries must be stored directly in the project area folders. You can have multiple project area folders. The name of each project area folder must match its corresponding project area name in the Jazz repository. You must specify a value for this parameter. The root query folder that you specify must exist and it must contain a folder for each project area with which you plan to synchronize records and work items. If a project area folder does not contain a query for a record type that has a synchronization rule, the ClearQuest Connector attempts to synchronize all records of that record type. |
To modify the parameters:
Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug