MustGather: Persistent Naming Server and ORB related problems in WebSphere InterChange Server V4.3.0.2 and later environments

The following list of items are required in order to proceed with problem analysis of PNS or ORB related problems in WebSphere InterChange Server version 4.3.0.2 or later releases.

• Versions of the ORB client and ORB server
• ORB Debug Traces and ORB Comm Traces
• PNS trace

• Windows
  In the PersistentNameServer_start.bat file, replace the following line
  
  call orbd.bat -ORBInitialPort %ORB_PORT% -port %ORBD_PORT%
  
  with
  
  call tnameserv.exe -ORBInitialPort %ORB_PORT%
  
  
• UNIX
  In the PersistentNameServer.sh file, replace the following line
  
  exec $CROSSWORLDS/jre/bin/orbd -ORBInitialPort ${ORB_PORT} -port ${ORBD_PORT} &
  
  with
  
  exec $CROSSWORLDS/bin/jre/tnameserv -ORBInitialPort ${ORB_PORT}

1. Getting ORB client and ORB server versions
• Windows:
  
  From %WICS%\jre\bin, run:
  
  java com.ibm.CORBA.iiop.Version
  
  
• UNIX:
  From $WICS/jre/bin, run:
  
  java com.ibm.CORBA.iiop.Version
  
  
2. Getting ORB debug and comm traces
   You will need to separate ORB client and ORB server logs as instructed in this technote. Samples discussed in this technote are for WebSphere InterChange Server running on AIX and Toolset and Adapters on Windows 2000 systems.
   
   Gather the ORB trace for the client (Toolset and/or Adapters) and server (WebSphere InterChange Server) in separate files by following these instructions:
   
   In the WebSphere Business Integration toolset environment, back up the current startcsm.bat file and add the ORB tracing parameters:
   
   -Dcom.ibm.CORBA.Debug.Output=<full path>\orbtools.trc -Dcom.ibm.CORBA.Debug=true -Dcom.ibm.CORBA.CommTrace=true
   
   Your startcsm.bat file should look like this after the change:
   *******************************************************************************
   set WSWB_EXECUTABLE=C:\IBM\WICS43\Tools\WSWB212\eclipse.exe
   set WSWB_PATH=C:\IBM\WICS43\Tools\WSWB212
   
   call "%CROSSWORLDS%"\bin\CWSharedEnv.bat
   
   set ORB_PROPERTY=-DORBNamingProvider=CosNaming -Dorg.omg.CORBA.ORBClass=com.ibm.CORBA.iiop.ORB -Dorg.omg.CORBA.ORBInitialPort=%ORB_PORT% -Dorg.omg.CORBA.ORBInitialHost=%ORB_HOST% -Dcom.ibm.CORBA.Debug=true -Dcom.ibm.CORBA.Debug.Output=<full path>\orbtools.trc -Dcom.ibm.CORBA.CommTrace=true
   
   "%WSWB_EXECUTABLE%" -data "%WSWB_PATH%\Workspace" -vm %JRE_BIN%\javaw.exe -vmargs %ORB_PROPERTY% -DCWTools.home="%CROSSWORLDS%\bin"
   
   endlocal
   ********************************************************************************
   When you start the CSM and connect to WebSphere InterChange Server, you should see the trace information in the orbtools.trc file.
   
   To generate ORB tracing for a specific adapter ( in this case hosted on the Windows box), you will need to modify the adapter start up file start_<adaptername>.bat and add the ORB_PROPRTY variable as indicated below:
   
   ********************************************************************************
   set ORB_PROPERTY=-DORBNamingProvider=CosNaming -Dorg.omg.CORBA.ORBClass=com.ibm.CORBA.iiop.ORB -Dorg.omg.CORBA.ORBInitialPort=%ORB_PORT% -Dorg.omg.CORBA.ORBInitialHost=%ORB_HOST% -Dcom.ibm.CORBA.Debug=true -Dcom.ibm.CORBA.Debug.Output=<full path>\orb_adapterName.trc -Dcom.ibm.CORBA.CommTrace=true
   ***********************************************************************************
   
   When you start individual adapters , you should see the trace information in the orb_adapterName.trc file(s).
   
   To generate ORB tracing on the WebSphere InterChange Server side (in this case on AIX), modify the CWSharedEnv.sh file (after backing it up) on your AIX system (the same three ORB trace parameters should be added to the ORB_PROPERTY variable as well.
   
   After including the debug parameters, this is how the partial CWSharedEnv.sh file should look:
   
   ********************************************************************************
   if [ -n "$ORB_OAHOST" ]; then
   ORB_LOCAL_HOST_PROP="-Dcom.ibm.CORBA.LocalHost=$ORB_OAHOST"
   fi
   
   # BufferSize Setting
   # increase the buffer size may improve performance
   ORB_BUFFER_SIZE_PROP="-Dcom.ibm.CORBA.BufferSize=8192"
   
   ORB_PROPERTY="-DORBNamingProvider=CosNaming -Dorg.omg.CORBA.ORBClass=com.ibm.CORBA.iiop.ORB -Dorg.omg.CORBA.ORBInitialPort=$ORB_PORT -Dorg.omg.CORBA.ORBInitialHost=$ORB_HOST
   -Dcom.ibm.CORBA.Debug=true -Dcom.ibm.CORBA.Debug.Output=/home/IBM/CW430/logs/orbserver.trc -Dcom.ibm.CORBA.CommTrace=true ${ORB_LOCAL_HOST_PROP}"
   
   export ORB_PORT ORB_HOST ORB_PROPERTY
   *********************************************************************************
   
   Once you appended the parameters mentioned previously, you should find the debug information logged to the orbserver.trc file.
   
   
3. Generating Persistent Naming Server trace
• Windows:
  In the PersistentNameServer.bat file, make the following change:
  
  call orbd.bat -ORBInitialPort %ORB_PORT% -port %ORBD_PORT% -J-Dcom.sun.CORBA.ORBDebug=transport,POA,naming,giop,subcontract,serviceContext >C:\PNS.trc &
  
  The resulting output will be sent to C:\PNS.trc file.
  
  
• UNIX
  In the PersistentNameServer.sh script, make the following change:
  
  exec $WICS/jre/bin/orbd -ORBInitialPort ${ORB_PORT} -port ${ORBD_PORT} -J-Dcom.sun.CORBA.ORBDebug=transport,POA,naming,giop,subcontract,serviceContext >output_file &
  
  The resulting output will be sent to the output file as specified by you.