IBM Support

PI34173: DOORS LICENSES CONSUMED AS PART OF AN OSLC OPERATION ARE NOT RELEASED WHEN THE SESSION TIMEOUT OCCURS.

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • TEST 1
    - DOORS Web Access (DWA) is configured with DWA licenses.
    - Rational Quality Manager (RQM) and DOORS are integrated via
    OSLC.
    - An RQM user creates an OSLC link from a RQM artifact to one in
    DOORS.
    - As part of this operation a DWA license will be taken.
    - The RQM user logs out of RQM.
    
    Expected Result: After a certain period of time the DWA license
    will be released.
    Actual Result: Works fine, the DWA License is released after a
    certain period of time.
    
    TEST 2
    - DOORS Web Access (DWA) is configured to use DOORS Licenses
    (by adding the system property <f:property
    name="use.doors.client.license.only" value="true"/> in the DWA
    festival.xml file)
    - Rational Quality Manager (RQM) and DOORS are integrated via
    OSLC.
    - An RQM user creates an OSLC link from a RQM artifact to one in
    DOORS.
    - As part of this operation a DOORS license will be taken.
    - The RQM user logs out of RQM.
    
    Expected Result: After a certain period of time the DOORS
    license will be released.
    Actual Result: The DOORS License is not released even after
    considerable amount of time.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Any user attempting to create OSLC links to DOORS artifacts  *
    * (via the DOORS requirements picker when in RTC or RQM).      *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * DOORS Web Access is not releasing DOORS licenses after       *
    * logging out from RQM.                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Logging out of the tool (in this case RQM) used to create a link
    is not equivalent to logging out of DWA.
    
    The license taken when a user logs into a DOORS delegated user
    interface will only be released once a particular timeout occurs
    and this is expected functionality.
    
    This timeout is controlled via an entry in FESTIVAL.XML, and the
    default period is for 30 minutes:
    
     <f:property name="OauthAccessTokenTimeout" value="xxx"/>
    
     Where xxx is the number of minutes.
    
    Some consideration was made to making each OSLC operation atomic
    in its own right so that they would acquire a license, execute
    and then release the license. However this has an impact on
    performance and for certain integration points (such as DOORS
    RQM reconcile) it became a deal breaker.
    
    The current design is intended to balance a number of
    perspectives. The license is released, just not immediately.
    

Problem conclusion

  • This is resolved in the 9.6.1.3 release.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI34173

  • Reported component name

    TLOGIC DOORS

  • Reported component ID

    5724V61DR

  • Reported release

    960

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2015-02-04

  • Closed date

    2015-06-26

  • Last modified date

    2015-06-26

  • 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

    TLOGIC DOORS

  • Fixed component ID

    5724V61DR

Applicable component levels

  • R961 PSY

       UP



Document information

More support for: Rational DOORS

Software version: 9.6

Reference #: PI34173

Modified date: 26 June 2015