Sample ex30 - Integration of FOS Products

The ex30 sample is a Fulfillment Provisioning example including the following :

• FOM Client Adapter
• OSS/J JMS-Profile Client Adapter (EMS)
• OSS/J WS-Profile Client Adapter
• FPOMS

You can find the sample located at $SW_HOME/distrib/kabira/kpsasample/samples/ex30.

The readme file is available at $SW_HOME/distrib/kabira/kpsasample/samples/ex30/conf/README.

The following steps help configure and run the sample ex30 for complete end-to-end Integration between TIBCO Fulfillment Orchestration Suite (FOS) of products.

1. Additional Softwares Needed:
   1. Maven 3.x
   2. JDK 6
   3. Jetty (when example is run, Jetty is downloaded automatically therefore wget must be working on the machine)
2. Enterprise Message Service Factories: Create the following factories
   1. TopicConnectionFactory - System/JSR264/ApplicationType/OrderManagement/Application/1-0;1-0-0;TIBCO-FOS-FP/Comp/TopicConnectionFactory.
   2. QueueConnectionFactory - System/JSR264/ApplicationType/OrderManagement/Application/1-0;1-0-0;TIBCO-FOS-FP/Comp/QueueConnectionFactory.
3. Enterprise Message Service Queues
   1. System/JSR264/ApplicationType/OrderManagement/Application/1-0;1-0-0;TIBCO-FOS-FP/Comp/MessageQueue
4. Enterprise Message Service Topics:
   1. System/JSR264/ApplicationType/OrderManagement/Application/1-0;1-0-0;TIBCO-FOS-FP/Comp/XVTEventTopic
5. Environment Variables Needed:
   1. The following are the additional variables needed to run ex30, change according to your environment:

      export GNU_TAR=/bin/tar
      	export MAVEN_HOME=/user_data/softwares/maven3/apache-maven-3.0.4
      	export JAVA_HOME=/user_data/softwares/jdk1.8.0_25
      	export SAMPLE_JAVA_HOME=/user_data/softwares/jdk1.8.0_25 (this is needed to run ex30, JAVA_HOME env var is not considered)
      	export EMS_HOME=/opt/tibco/ems/8.3
      	export PATH=$JAVA_HOME/bin:$MAVEN_HOME/bin:$SAMPLE_JAVA_HOME/bin:$EMS_HOME/bin:$PATH
      	export FOM_EMS_HOST=<your ems ip address>
      	export FOM_EMS_PORT=<ems port>
      	export FOM_EMS_USER_PASSWORD=<admin user password>

   2. if a single Enterprise Message Service server keep the below as it is otherwise, modify:

      export FC_EMS_HOST=$FOM_EMS_HOST
      	export FC_EMS_PORT=$FOM_EMS_PORT
      	export FC_EMS_USER_PASSWORD=$FOM_EMS_USER_PASSWORD

6. Copy Enterprise Message Service libraries libtibems64.so, libtibemsadmin64.so, and libtibemslookup64.so from $EMS_HOME/lib to $SW_HOME/3rdparty/<os>/tibco-ems/8.3.0_<architecture>/kablib. For example, on Linux, $SW_HOME/3rdparty/linux/tibco-ems/8.3.0_x86_64/kablib.
   Note: If you use TIBCO Enterprise Message Service 8.0, perform the following: a) Copy the above .so files to the mentioned target directory, that is ../8.3.0_<architecture>/kablib b) Open the $SW_HOME/distrib/kabira/kpsa/samples/ca/ossjomws/jetty-admin.ksh file. Locate this line: CopyChmod $EMS_HOME/lib/tibjms.jar $TRG_DEPS_DIR. After the above line, add the CopyChmod $EMS_HOME/lib/tibcrypt.jar $TRG_DEPS_DIR line.
7. Create a Softlink: $SW_HOME/3rdparty to /opt/kabira.
8. Run the sample using the following command:

   $ mkdir /tmp/test
   $ cd test
   $ provadmin run fpsample sample=ex30