CCRC UCM-ClearQuest integration web browser access problems

 information about possible causes for a Web browser reporting errors indicating that it can not find the requested Web page or the IBM® Rational® ClearQuest® Web login screen displaying ClearQuest errors when using the Rational ClearCase® Remote Client (CCRC) UCM-ClearQuest integration.
 
Symptom

Scenario:

Attempts to perform one of the two actions below in a ClearQuest-enabled project which causes the integration in the client to open a browser window displaying a ClearQuest form, results in one of the two symptoms below.

ACTIONS:

  1. The ClearQuest tab of the Activity Properties dialog should show aDisplay ClearQuest Record button. Clicking this button should open a browser window. 
  2. Performing a Work On or checkout when the UCM-enabled ClearQuest record chosen contains an empty mandatory field and is auto-transitioned into an active state, should open a browser window displaying a ClearQuest form in order to supply a mandatory field value.

SYMPTOMS:

  • Symptom 1: 
    Web browser shows an error message indicating it can not display the requested web page.
  • Symptom 2: 
    Web browser shows ClearQuest Web login screen displaying ClearQuest error message
 
Cause

For symptom 1:

If the browser window which is opened displays a browser-specific error message indicating that it can't display the requested web page, a probable cause relates to one of the following options:

  1. The ClearQuest Web URL defined by the –cqweb parameter in the ccweb.conf file on the CCRC server is incorrect. Review technote 1125332 for more information about the ccweb.conf file.
  2. The ClearQuest Web installation specified by the URL is not up and available.

For symptom 2 :

If the browser window which is opened displays a ClearQuest Web login screen displaying a ClearQuest error message, something is configured incorrectly on the ClearQuest Server's machine:

  1. This problem can occur when the ClearQuest server is running on a different machine than the CCRC server.
  2. This problem can also occur if a different set of ClearQuest Schema Repository connections is defined on the ClearQuest Server machine than is defined on the CCRC Server machine.

    Note: It is a requirement that the set of connections match. 

    If this mistake is made, the error message displayed on the ClearQuest Web login screen will look like this:
    Invalid login information. Can not find dbset directory ‘’
 
Environment

A CCRC Server running the Rational Web Platform (RWP) that is configured to support the CCRC UCM-ClearQuest Integration and which is also configured to enable the ClearQuest Web Integration.
 
Diagnosing the problem

On the CCRC client machine:
  • Run the client with client-side tracing enabled. Refer to technote 1234118 for information on how to setup debug tracing for the ClearCase Remote Client.
  • In the client, connect to the CCRC Server.
  • In the resulting client trace file, search for this string:setCQWebBaseURL. 

    You will see two lines that look like this:

    ...setCQWebBaseURL[CQWEBDEBUG]::Server configured for CQWeb integration, configured base URL:  http://my-cqweb-machine-name/cqweb 
    ...setCQWebBaseURL[CQWEBDEBUG]::Resolved base URL:http://my-cqweb-machine-name/cqweb


  • Check the base URL string from the trace file:

    Is the base URL string in the correct format?
    • Correct format: http://my-cqweb-machine-name/cqweb
    • Incorrect format: http://my-cqweb-machine-name/cqweb/ --> [Should not have trailing “/”]
    • Incorrect format: http://my-cqweb-machine-name/cqweb/login --> [Should not have “/login” appended]
  • Is the machine name in the URL correct?
  • Is ClearQuest Web installed on that machine and accessible from the machine where the CCRC client is running? 

    Note: To check this on the machine where the CCRC client is running, manually open a browser window and paste the URL into the browser's address bar, adding a “/login” suffix like this:http://my-cqweb-machine/cqweb/login

    If ClearQuest Web is available, the browser should display the ClearQuest login screen.

    Additionally, if you want to see the full ClearQuest Web-format URL which was passed to the browser window, search the client trace file for this string: CqBrowserDialog. 
    You will see a line that looks like this:

      ...CqBrowserDialog[CQWEBDEBUG]::Full CQWeb URL: [http://my-cqweb-machine-name/cqweb/main?schema=...&contextid=...] The full URL will appear between the square brackets
 
Resolving the problem

Solution for symptom 1
  1. Refer to the Setting Rational ClearCase Web integration parameters in the configuration file section of the IBM Rational ClearCase Administrators manual for details about properly setting up the configuration file.
  2. Ensure that the ClearQuest Web installation specified by the URL is up and available.


Solution for symptom 2
  1. Refer to the Configuring support for UCM projects that have been enabled for Rational ClearQuest using Rational ClearQuest Websection of the IBM Rational ClearCase Administrators manual for configuration details.
  2. Modify the ccweb.conf parameters ensuring that the same set of ClearQuest Schema Repository connections defined on the ClearQuest Server machine is also defined on the CCRC Server machine (it is a requirement that the set of connections match)

    Review the Rational ClearCase Administrators manual on the topic ofSetting Rational ClearCase Web integration parameters in the configuration file for more information.

No comments:

Post a Comment

Subscribe to: Post Comments (Atom)