Agile on Weblogic server -- JMS Destination configuration

In this blog I am about to explain about a patch for D2R i.e. Agile to E-biz pip where Agile is on Weblogic server.
While doing ACS “Agile Content Services” setup in Agile we need to follow the “JMS Destination” configuration which is to pass the data from Agile to our SOA server.
Steps given in installation and configuration document for D2R is in the assumption of Agile is on OC4J server but if your Agile is on Weblogic Server our problem will come into the picture.

For that Oracle has given the patch - p9010426_9300_WINNT.zip where you need to follow some steps.

Here I am explaining about the steps involved about applying the patch and generally what problems we will face while applying the patch and workarounds.

Follow the steps to apply the patch.
1. Patch 9010426 (Only for WebLogic platform)

1.1 Install and Configure Patch 9010426

1) Stop the agile server
2)Extract the zip file p9010426_9300_WINNT.zip
3)Open command prompt and Navigate to the extracted files folder
4)Set the Environment variable JAVA_HOME to the jdk installed with the agile 9.3 PLM
5) Execute Install_Patch.bat and you should see INSTALLATION SUCCESSFULL and BUILD SUCCESSFULL

6)Now start the agile server
7) Navigate to the \agileDomain\lib directory and verify that you see the following files aqapi.jar, aqjms.properties, WLS103AQJMSStartupClass.jar
8)Open the aqjms.properties file and edit the information (SOA DB) for Server, Port and DBInstance

Server= your hostname or ipaddress
Port= soaDBport number
DBInstance=SID

Save the file and close it

9)In the command prompt,navigate to the \agileDomain\lib and execute the following command

This command will creates the files 1) aqjms_user.properties and 2) aqjms.dat
in the \agileDomain\lib folder

C:\bea\jdk160_05\bin\java –cp.;WLS103AQJMSStartupClass.jar;C:\bea\wlserver_10.3\server\lib\weblogic.jar;%classpath% com.oracle.oems.weblogic.AQJMSPasswordUtility -username PLMECOQueue -password PLMECOQueue

Bold letters in the above command will change based on your environment and installed drive.
Most of the cases it is “PLMECOQueue” only.


Sometime while executing this command you might face some issue like given below
unrecognized option: -username
could not create the Java virtual machine.

Solution:
That might be because of the spaces in the command. In case try with giving space before and remove after “–cp “in the command

Also sometimes you may face the error –
Error:
Exception in thread "main" java.lang.NoClassDefFoundError: ûcp

Solution :
In case, you need to give “-” in “-cp” part of the above command from the key which is next to “Numlock” button on your keyboard (i.e. sometimes it will give problem using the key next to “0” in the keyboard)

10) Check that the following files get created under the \agileDomain\lib
aqjms_user.properties, aqjms.dat

11) Navigate to \agileDomain\config and edit the file config.xml. Add the following lines before the tag . Edit the entries marked in bold as per your environment. For target specify the agile server name.

<startup-class>
<name><aqstartupclass></name>
<target>agilePCServer</target>
<deployment-order>1000</DEPLOYMENT-ORDER>
<class-name>com.oracle.oems.weblogic.AQJMSStartupClass</CLASS-NAME> <arguments>AQJMSPropertiesFile=aqjms.properties,AQJMSPasswordFile=aqjms_user.properties,AQJMSSecretFile=aqjms.dat,AQJMSConfigDirectory=D:/AgileBuilds/Agile93WLS/agileDomain/lib</arguments>
<failure-is-fatal>true</FAILURE-IS-FATAL>
<load-before-app-deployments>true</LOAD-BEFORE-APP-DEPLOYMENTS>
<load-before-app-activation>true</LOAD-BEFORE-APP-ACTIVATION>
</STARTUP-CLASS>

Note: agilePCServer in the above tags is your agile server name.


12) Modify your startAgile.cmd (\agileDomain\bin) to add the system properties below.

-Doracle.jms.useEmulatedXA=false -Doracle.jms.useNativeXA=true



You can add it just before %DEBUG_OPTS% weblogic.server gotofinish


13)Start the Agile Server using the startAgile.cmd file. This will now load the startup class which will complete the binding that you configured earlier.

1.2 Create Agile destination in ACS (only Weblogic)

1. Login to java client and configure a new destination and test the destination to end the configuration