Projects are not listed when using HP ALM 11

Technote (troubleshooting)


Problem(Abstract)

Projects are not listed when the Rational Adapter for HP ALM is configured to use HP ALM 11.

Symptom

Some users will not be able to view any projects associated with their domains on the main page. Administrators will also see an empty project listing when attempting to associate Rational Team Concert or Rational Requirements Composer project areas with the Rational Adapter for HP ALM projects.


Resolving the problem

WORKAROUND:


Configure the DomainsList.xml file

Follow these steps to configure the Rational HP ALM Adapter server to read from the DomainsList.xml file at startup.


On Tomcat:

  1. Stop the Tomcat application server. See the Starting Apache Tomcat documentation topic for instructions about how to stop and start Tomcat.

  2. Modify the server.startup script at HPInstallDir/server/. Add a com.ibm.oslc.qm.adapter.hpqc.domains_file parameter by specifying the location of the DomainsList.xml file. The default location is /DomainsList.xml

    JAVA_OPTS="$JAVA_OPTS -Dderby.system.home=`pwd`"
    JAVA_OPTS="$JAVA_OPTS -server"
    JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize=512M"
    JAVA_OPTS="$JAVA_OPTS -Xms256m"
    JAVA_OPTS="$JAVA_OPTS -Xmx1024m"
    JAVA_OPTS="$JAVA_OPTS -Dcom.ibm.oslc.qm.adapter.hpqc.domains_file=/DomainsList.xml"

  3. Modify the DomainsList.xml file at HPInstallDir/server/tomcat/webapps/hpqm/WEB-INF/classes. The XML file contains sample entries. Remove these entries and enter the appropriate list of domains and projects available to users.

    <Domains>
           <Domain Name="SAMPLE_DOMAIN_1">
                   <Projects>
                           <Project Name="SAMPLE_DOMAIN_1_PROJECT_1"/>
                   </Projects>
           </Domain>
           <Domain Name="SAMPLE_DOMAIN_2">
                   <Projects>
                           <Project Name="SAMPLE_DOMAIN_2_PROJECT_1"/>
                           <Project Name="SAMPLE_DOMAIN_2_PROJECT_2"/>
                           <Project Name="SAMPLE_DOMAIN_2_PROJECT_3"/>
                   </Projects>
           </Domain>
    </Domains>

  4. Start the Tomcat application server.


On WebSphere Application Server :
  1. Stop the WebSphere Application Server. See the Deploying and starting on WebSphere Application Server documentation topic for instructions about how to stop and start WebSphere Application Server.

  2. In the Administrative console select Servers > Server Type > Web application servers.

  3. Click the name of your server (for example “server1”).

  4. Expand Java and Process Management and select Process Definition.

  5. Under the Additional Properties section, click Java Virtual Machine.

  6. Scroll down and locate Generic JVM arguments.

  7. Append the com.ibm.oslc.qm.adapter.hpqc.domains_file parameter specifying the location of the DomainsList.xml file. The default location is /DomainsList.xml

    -Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    -Dcom.ibm.oslc.qm.adapter.hpqc.domains_file=/DomainsList.xml

  8. Click OK, then Save to master configuration.

  9. Modify the DomainsList.xml file at WebSphereInstallDir/AppServer/profiles/<profile_name>/installedApps/<node_name>/hpqm_war.ear/hpqm.war/WEB-INF/classes. The XML file contains sample entries. Remove these entries and enter the appropriate list of domains and projects available to users.

    <Domains>
           <Domain Name="SAMPLE_DOMAIN_1">
                   <Projects>
                           <Project Name="SAMPLE_DOMAIN_1_PROJECT_1"/>
                   </Projects>
           </Domain>
           <Domain Name="SAMPLE_DOMAIN_2">
                   <Projects>
                           <Project Name="SAMPLE_DOMAIN_2_PROJECT_1"/>
                           <Project Name="SAMPLE_DOMAIN_2_PROJECT_2"/>
                           <Project Name="SAMPLE_DOMAIN_2_PROJECT_3"/>

                 </Projects>
           </Domain>
    </Domains>

  10. Start the WebSphere Application Server.


Disable the DomainsList.xml file
To disable the Rational Adapter for HP ALM server from reading the DomainsList.xml file at startup, follow these steps.


On Tomcat:

Comment out the com.ibm.oslc.qm.adapter.hpqc.domains_file Java option line by adding the # character and restart the Tomcat application server.

#JAVA_OPTS="$JAVA_OPTS -Dcom.ibm.oslc.qm.adapter.hpqc.domains_file=/DomainsList.xml"


On WebSphere Application Server :

Follow the WebSphere Application Server instructions above to enable the domains_fileparameter. However, in step 7, remove the com.ibm.oslc.qm.adapter.hpqc.domains_file parameter instead of adding it.

Related information

Latest support documents

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Lifecycle Integration Adapters
Rational Adapter for HP ALM

Software version:

1.0, 1.0.0.1, 1.1, 1.1.0.1

Operating system(s):

Linux, Windows

Software edition:

Standard

Reference #:

1647747

Modified date:

2013-09-30

Translate my page

Machine Translation

Content navigation