IBM Support

Connection reset error when registering application and application setup for upgrade from V2 to V3

Troubleshooting


Problem

Attempts to connect the Jazz Team Server to IBM Rational Quality Manager when upgrading from V2 to V3 in a distributed environment, phased migration results in a connection reset error.

Cause

The functional user qm_user exists in the Jazz Team Server (JTS) user repository but does not exist in the Quality Mangement (QM) repository.

Environment

  1. For an example of this upgrade process, refer to the CLM Information Center topic Rational Quality Manager 2.0 to 3.0.1 upgrade process example.

    The JTS is already in place. You are using LDAP authentication. The Jazz Team Server has already been configured. One or more applications, such as CCM might have already been registered.

    You have finished all migration steps and are at the final step to connect your upgraded QM version 3.0.1.x and associated databases to the existing JTS version 3.0.1.x. See this topic in the CLM Information Center for a reference point.

    Application registration is completed successfully. Since you are sharing an existing JTS (JTS V3.0.1 is already in place) you go to the Web Admin UI to connect your upgraded QM and associated databases to the existing JTS.
  2. Go to JTS admin.
  3. Go to Applications.
  4. Type the discovery URL for QM.
  5. Process succeeds.
  6. Log into the Administration page of the Jazz Team Server by pointing your web browser to: https://<hostname>:9443/jts/admin
  7. Click the Server tab.
  8. In the left pane, in the Configuration section, click Registered Applications.
  9. In the Registered Applications section, click Add.
  10. In the Add Application window, type this information about your application:
    • Application Name for the application - It must be unique among all applications registered with the Jazz Team Server.
    • Discovery URL - The service contribution resource (SCR) URL for the application. In general, for the Discovery URL, add /scr to the end of the public URL of the application. For example, if the public URL for the Change and Configuration Management application is https://<hostname>:9443/ccm, the corresponding SCR URL is https://<hostname>:9443/ccm/scr. If upgrading from a version 2.x product, the discovery SCR URL would be https://<hostname>:9443/jazz/scr.
    • Application Type - After you type the Discovery URL, wait a few moments and the Jazz Team Server will detect the type of application that you are registering.
    • Consumer Secret Type - The consumer secret for the application that you are registering to use. The Jazz Team Server will automatically generate a consumer key.
    • Functional User ID - After you type the Discovery URL, the application will suggest a functional user ID. Type the user ID of the functional user that will perform background tasks. The Jazz Team Server will automatically suggest a user ID, or you can click Browse and search for an existing one. The functional user ID does not have to exist in the external registry; if the user doesn't exist in the repository, it will be automatically be created.
  11. Click Finish.
  12. After you register with the Jazz Team Server, if necessary configure the application. To do so, in the message that confirms that you've registered the application, click Application Setup Wizard. You will have to provide or confirm the database settings, finalize the configuration, and link the application to the Lifecycle Project Administration application so that all applications registered with the Jazz Team Server can share project areas. Not all applications require additional configuration. The following steps are for the setup wizard for a CCM or QM application:
    • In the Configure Database page for the application, provide or confirm the database connection. Click Test Connection, and then click Next.
    • In the Configure Data Warehouse page for the application, confirm the database connection, click Test Connection, and then click Next.
    • In the Finalize Application page, click Finalize Application Setup. Verify that Finalize completes without error and the Next button is enabled. Click Next.
    • On the Summary page, verify that there are no errors.

Diagnosing The Problem

In addition to the error message, there are errors in the JTS log. The registration of QM application always succeeded but the Application Wizard would never load. You cannot access the QM/admin application, but after restarting the application, it is accessible.

First in JTS log, there is the "register application" error:

2012-05-07 14:03:16,092 [              WebContainer : 0]  WARN         org.apache.http.impl.client.DefaultHttpClient       - Authentication error: Unable to respond to any of these challenges:  {oauth=WWW-Authenticate: OAuth realm="Jazz%20Team%20Server",           oauth_problem="invalid_consumer_key"}                                  
2012-05-07 14:08:12,204 [              WebContainer : 7]  WARN         org.apache.http.impl.client.DefaultHttpClient       - Authentication  
error: Unable to respond to any of these challenges: {oauth=WWW-Authenticate: OAuth realm="Jazz%20Team%20Server",          oauth_problem="invalid_consumer_key"}                                  
2012-05-07 14:13:06,744 [              WebContainer : 2]  WARN        
org.apache.http.impl.client.DefaultHttpClient       - Authentication error: Unable to respond to any of these challenges:                  
{oauth=WWW-Authenticate: OAuth realm="Jazz%20Team%20Server",         oauth_problem="invalid_consumer_key"}                                  
2012-05-07 14:17:11,378 [              WebContainer : 0]  WARN        
com.ibm.team.repository                             - CRJAZ2127I The  application "/qm" with id "167e8f9b-ac16-4713-8fab-171a36eb5e5e" was  
successfully unregistered.          

In the JTS Admin > Applications GUI, it looks like the registration is successful, but it is not.

Here are the errors in the QM log:

[5/7/12 13:47:49:672 EDT] 00000000 WsServerImpl  A   WSVR0001I: Server  
server1 open for e-business                                              
[5/7/12 13:49:57:894 EDT] 00000016 SystemOut     O 2012-05-07            
13:49:57,894 RQM [WebContainer : 0] ERROR                                
eam.repository.service.internal.util.ScrubberUtils  - CRJAZ1054I Invalid
ChangeEvent expiration itemType specification                            
"com.ibm.team.build.BuildResult":com.ibm.team.workitem.WorkItem:5184000  
com.ibm.team.build.BuildResult:172800.                                  
[5/7/12 13:50:04:025 EDT] 00000018 SystemOut     O 2012-05-07            
13:50:04,025 RQM [jazz: AsynchronousTaskRunner-0] ERROR                  
com.ibm.rqm.process.deployment                      - CRJAZ1451I An      
exception occurred while executing the task                              
"ProcessTemplatesMigrationTask", contributed by component                
"com.ibm.rqm.process.deployment".  The task will be rescheduled.        
com.ibm.team.repository.common.TeamRepositoryException: CRJAZ1832E The  
user configured to perform the request                                  
"htt ps://<hostname>:9443/jts/service/com.ibm.team.reposito 
ry.service.internal.license.ILicenseRestService/assertLicense?operationI
d=com.ibm.team.process.server.saveProcessTemplate&user=https%3A%2F%2Frat
ionaldev03.dctest.inc%3A9443%2Fjts%2FcontributorIdentity%2F_KGRY4CFWEdq-
WY5y7lROQw&assign=true" on the JTS is not authorized.  There may not be  
a functional user configured for the oauth consumer, or the functional  
user that is configured does not have sufficient privileges to perform  
the requested operation.  Connection Error: Unauthorized                
 at                                                                      
com.ibm.rqm.process.deployment.internal.ProcessTemplatesMigrationTask.ru
nTask(ProcessTemplatesMigrationTask.java:101)                            
 at                                                                      
com.ibm.team.repository.service.async.AbstractAutoScheduledTask.executeT
ask(AbstractAutoScheduledTask.java:86)...              

These errors are caused by this event:

com.ibm.team.repository.common.LicenseNotGrantedException: CRJAZ1832E    
The user configured to perform the request                              
"htt ps://<hostname>:9443/jts/service/com.ibm.team.reposito 
ry.service.internal.license.ILicenseRestService/assertLicense?operationI
d=com.ibm.team.process.server.saveProcessTemplate&user=https%3A%2F%2Frat
ionaldev03.dctest.inc%3A9443%2Fjts%2FcontributorIdentity%2F_KGRY4CFWEdq-
WY5y7lROQw&assign=true" on the JTS is not authorized.  There may not be a functional user configured for the oauth consumer, or the functional user that is configured does not have sufficient privileges to perform the requested operation.  Connection Error: Unauthorized                
 at                                                                      
com.ibm.team.repository.service.compatibility.license.internal.LicenseService.assertLicenseRemotely(LicenseService.java:149)

Resolving The Problem

When you register the application, do not use the suggested functional user "qm_user". Browse to an existing LDAP user with "JazzAdmins" repository permissions and a Quality Manager Professional CAL (Client Access License).

[{"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"RQM Server","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.0.1;3.0.1.1;3.0.1.2;3.0.1.3","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Quality Manager

Document Information

Modified date:
16 June 2018

UID

swg21593575