PM80745: Login to RTC hosted by WAS will fail when DOORS module is open in read only mode when submitting a Requirement Change Request

Rational DOORS and DOORS Web Access 9.5.1

APAR status

• Closed as program error.

Error description

• Login to RTC hosted by WAS will fail when DOORS module is open
  in read only mode when submitting a Requirement Change Request
  
  
  Rational Team Concert 4.x
     Hosted by WebSphere 8.x
  DOORS 9.4
  DOORS Web Access 1.5
  
  
  Steps to configure the environment:
  
  Configure the DOORS DWA Integrations by following the
  documentation below:
  
     Use Case Scenarios for DOORS/DWA and RTC
  
  https://www.ibm.com/developerworks/mydeveloperworks/blogs/Sriniv
  asMandava/?lang=en
  
     Configure DOORS and Rational Team Concert for globally
  distributed workers
  http://www.ibm.com/developerworks/rational/library/doors-rationa
  l-team-concert-globally-distributed-workers/
  
     Integrate Rational DOORS and Rational Team Concert change
  management
  http://www.ibm.com/developerworks/rational/library/integrate-rat
  ional-doors-and-rational-team-concert-change-management/index.ht
  ml
  
     RTC Documentation on jazz.net (no longer available)
         https://jazz.net/library/article/624
  
  
  Steps to reproduce:
     1. Open DOORS, Open a module in READ ONLY
     2. Module opens READ ONLY
     3. Change Management ?? Requirements Change Management ??
  Submit
     4. Presented with a prompt for login ? select login which
  opens the Jazz login screen.
     5. Enter credentials into RTC login screen
     6. The same login screen as step 4 as represented again.
     7. This time, the following error is seen within DOORS:
  
  Error!  The current URL is invalid or out of date.
     Run the default action
  
  
  Workaround:
  
  As noted within the documentation above, the DOORS DWA
  Integrations with RTC requires BASIC authentication.  The notes
  indicate steps for Tomcat hosted RTC servers, but fail to
  mention the correct steps for WebSphere hosted RTC instances.
  The steps to properly configure WebSphere RTC to use BASIC
  rather than the default FORM authentication, the following must
  be modified on the RTC server:
  
  Please modify the web.xml for the JTS, CCM and QM within the
  WebSphere profile.
  
  NOTE:  WebSphere caches the web.xml in several places. So
  without having to
  unpack jts.war and ccm.war modify the web.xml and redeploy you
  can:
  
  1. Shutdown the WebSphere profile
  2. Delete all of the contents of the wstemp and temp directories
  in the
  WebSphere profile:
  
   For example:
     C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp
     C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wstemp
  
  
  3. Modify the web.xml (both UNIX and Windows Examples provided)
  
  C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\LI
  BPOCNode01Cell\jts_war.ear\jts.war\WEB-INF\web.xml
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/jaz
  zNode01Cell/jts_war.ear/jts.war/WEB-INF/web.xml
  
  
  C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\LI
  BPOCNode01Cell\ccm_war.ear\ccm.war\WEB-INF\web.xml
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/jaz
  zNode01Cell/ccm_war.ear/ccm.war/WEB-INF/web.xml
  
  
  C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\LI
  BPOCNode01Cell\qm_war.ear\qm.war\WEB-INF\web.xml
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/jaz
  zNode01Cell/qm_war.ear/qm.war/WEB-INF/web.xml
  
  
  
  Please ALSO modify the following in the same way:
  
  C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\LIB
  POCNode01Cell\applications\jts_war.ear\deployments\jts_war\jts.w
  ar\WEB-INF\web.xml
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/jazz
  Node01Cell/applications/jts_war.ear/deployments/jts_war/jts.war/
  WEB-INF/web.xml
  
  
  C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\LIB
  POCNode01Cell\applications\ccm_war.ear\deployments\ccm_war\ccm.w
  ar\WEB-INF\web.xml
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/jazz
  Node01Cell/applications/ccm_war.ear/deployments/ccm_war/ccm.war/
  WEB-INF/web.xml
  
  
  C:\Program
  Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\LIB
  POCNode01Cell\applications\qm_war.ear\deployments\qm_war\qm.war\
  WEB-INF\web.xml
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/jazz
  Node01Cell/applications/qm_war.ear/deployments/qm_war/qm.war/WEB
  -INF/web.xml
  
  
  
  Please note that when you uncomment the BASIC config, you must
  comment out the FORM config as follows:
  
     ?login?
     ?auth?BASIC?/auth?
     ?realm?Jazz?/realm?
     ?/login?
     ?!--
     ?login?
     ?auth?FORM?/auth?
     ?form?
     ?form?/auth/authrequired?/form?
     ?form?/auth/authfailed?/form?
     ?/form?
    ?/login?
     --?
  
  4. Restart the WebSphere profile
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  APAR PM80745 - Login to RTC hosted by WAS will fail when
  DOORS module is open in read only mode when submitting a
  Requirement Change Request
  

Problem conclusion

• Resolved
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  RATL TEAM CONCE

• Fixed component ID

  5724V0400

Applicable component levels

• R400 PSN

     UP