Rational RequisitePro Web Services installation using Rational Web Platform (RWP)

Answer

Prerequisites:
Rational RequisitePro 7.0.1 installed along with RequisiteWeb on the system. (Earlier versions are not supported.)

RequisitePro Web service application configuration:
When you install RequisiteWeb, the Rational Web Platform (RWP) and RequisitePro Web service are also installed. In order for the Web service to function properly, you must perform the following configuration steps.

Using RWP as the application server:
If you are using RWP as the application server, note the following in the supplied Rational RequisitePro Integration Guide (RPM_ReqPro_Integration.pdf), which is located in the install package in the documents folder:
- The external application servers mentioned in the System Requirements section on page 2 are not required.
- RequisitePro Client for Web, mentioned in the Rational RequisitePro Components Installation section on page 3, is mandatory.
- The instructions contained in the section Deploying the Rational RequisitePro Web Services EAR file in pages 3 to 8 are not relevant.
- The RequisitePro server port number, shown in Figure 7 on page 12 , must be specified on the default RWP port number 11080.

Perform the following steps to use RWP as the application server. These include:
1. Configuring the environment variables
2. Replacing the proxies.jar file

To configure the environment variables:
1. To edit the file, open the resources.xml file located under:

%RATIONAL_INSTALLATION_DIRECTORY%\Common\rwp\EmbeddedExpress\profiles\profile2\config\cells\DefaultNode\nodes\DefaultNode\servers\server1\

2. Enter the following text into the resources.xml file just before the ending </xmi:XMI> tag:

Code:
  <resources.env:ResourceEnvironmentProvider xmi:id="ResourceEnvironmentProvider_1166438141305" name="reqproprovider">
    <factories xmi:type="resources.env:ResourceEnvEntry" xmi:id="ResourceEnvEntry_1166445307290" name="REQPRO_CATALOG_PATH" jndiName="REQPRO_CATALOG_PATH" referenceable="Referenceable_1166445249482">
      <propertySet xmi:id="J2EEResourcePropertySet_1166445351917">
        <resourceProperties xmi:id="J2EEResourceProperty_1166445351917" name="REQPRO_CATALOG_PATH" type="java.lang.String" value="%REQPRO_INSTALLATION_DIRECTORY%\RequisitePro\ReqWeb\projects\catalog.txt" required="false"/>
      </propertySet>
    </factories>
    <factories xmi:type="resources.env:ResourceEnvEntry" xmi:id="ResourceEnvEntry_1166445378740" name="RJCB_DLL_PATH" jndiName="RJCB_DLL_PATH" referenceable="Referenceable_1166445249482">
      <propertySet xmi:id="J2EEResourcePropertySet_1166445422846">
        <resourceProperties xmi:id="J2EEResourceProperty_1166445422846" name="RJCB_DLL_PATH" type="java.lang.String" value="%REQPRO_INSTALLATION_DIRECTORY%\Common\RJCB.dll" required="false"/>
      </propertySet>
    </factories>
    <factories xmi:type="resources.env:ResourceEnvEntry" xmi:id="ResourceEnvEntry_1166445447477" name="REQPRO_BRIDGE_DLL_PATH" jndiName="REQPRO_BRIDGE_DLL_PATH" referenceable="Referenceable_1166445249482">
      <propertySet xmi:id="J2EEResourcePropertySet_1166445486189">
        <resourceProperties xmi:id="J2EEResourceProperty_1166445486189" name="REQPRO_BRIDGE_DLL_PATH" type="java.lang.String" value="%REQPRO_INSTALLATION_DIRECTORY%\RequisitePro\bin\ReqProBridge.dll" required="false"/>
      </propertySet>
    </factories>
    <referenceables xmi:id="Referenceable_1166445249482" factoryClassname="com.ibm.reqpro.config.StringFactory" classname="java.lang.String"/>
</resources.env:ResourceEnvironmentProvider>
----end of code----

3. Replace all instances of the environment variable ‘%REQPRO_INSTALLATION_DIRECTORY%’ by supplying the exact path where Rational RequisitePro is installed. There should be three instances of this in this file. See the below example showing this variable with a valid value.

Example:
<resources.env:ResourceEnvironmentProvider xmi:id="ResourceEnvironmentProvider_1166438141305" name="reqproprovider">
    <factories xmi:type="resources.env:ResourceEnvEntry" xmi:id="ResourceEnvEntry_1166445307290" name="REQPRO_CATALOG_PATH" jndiName="REQPRO_CATALOG_PATH" referenceable="Referenceable_1166445249482">
      <propertySet xmi:id="J2EEResourcePropertySet_1166445351917">
        <resourceProperties xmi:id="J2EEResourceProperty_1166445351917" name="REQPRO_CATALOG_PATH" type="java.lang.String" value="C:\Program Files\Rational\RequisitePro\ReqWeb\projects\catalog.txt" required="false"/>
      </propertySet>
    </factories>
    <factories xmi:type="resources.env:ResourceEnvEntry" xmi:id="ResourceEnvEntry_1166445378740" name="RJCB_DLL_PATH" jndiName="RJCB_DLL_PATH" referenceable="Referenceable_1166445249482">
      <propertySet xmi:id="J2EEResourcePropertySet_1166445422846">
        <resourceProperties xmi:id="J2EEResourceProperty_1166445422846" name="RJCB_DLL_PATH" type="java.lang.String" value="C:\Program Files\Rational\Common\RJCB.dll" required="false"/>
      </propertySet>
    </factories>
    <factories xmi:type="resources.env:ResourceEnvEntry" xmi:id="ResourceEnvEntry_1166445447477" name="REQPRO_BRIDGE_DLL_PATH" jndiName="REQPRO_BRIDGE_DLL_PATH" referenceable="Referenceable_1166445249482">
      <propertySet xmi:id="J2EEResourcePropertySet_1166445486189">
        <resourceProperties xmi:id="J2EEResourceProperty_1166445486189" name="REQPRO_BRIDGE_DLL_PATH" type="java.lang.String" value="C:\Program Files\Rational\RequisitePro\bin\ReqProBridge.dll" required="false"/>
      </propertySet>
    </factories>
    <referenceables xmi:id="Referenceable_1166445249482" factoryClassname="com.ibm.reqpro.config.StringFactory" classname="java.lang.String"/>
  </resources.env:ResourceEnvironmentProvider><referenceables xmi:id="Referenceable_1166445249482" factoryClassname="com.ibm.reqpro.config.StringFactory" classname="java.lang.String"/>
</resources.env:ResourceEnvironmentProvider>
---------------end of example-----------------

4. Save and close resources.xml.

Replace the proxies.jar file:
1. Copy the proxies.jar file from RequisitePro installation directory '="%REQPRO_INSTALLATION_DIRECTORY%\RequisitePro\lib' to the following directory: ="%RATIONAL_INSTALLATION_DIRECTORY%\Common\rwp\EmbeddedExpress\profiles\profile2\installedApps\DefaultNode\WebServices.ear\RequisiteProWebservice.war\WEB-INF\lib\

Note: The integration may not work properly if another proxies.jar is found in the same system path.
- DO NOT keep a copy of the original proxies.jar before replacing it.
- DO NOT keep a copy in a new folder in the same path.

Once you've updated these files, then stop and start your RWP services.

After you log into Rational Portfolio Manager, when you start the Import process you will need to provide an URL, which will be similar to this:

http://<server_name>:11080/reqpro/services/RequisiteProWebservice
Replace <server_name> with the name of your server.

You can check that you have connectivity by typing this line into a browser, if you have connectivity, you will see a page similar to the one below.