FIX Service for Sonic ESB - Readme
General Release - November 2010

Contents


Welcome to the Pervasive FIX services for Progress Sonic ESB. This document contains the most up-to-date information about the software and may supersede that in the product documentation. It covers the following topics:

Environments Supported

The services have been tested on the following systems and platforms for use with Sonic ESB 7.5 and 7.6.

System
Supported Versions
Hardware Platform
Microsoft Windows
Server 2003 SP2
Server 2008
XP SP2
XP SP3, 32-bit only
Vista Business Edition SP1
x86, 32-bit
x86-64, 64-bit
Linux
Red Hat 4, 32-bit only
Red Hat 5
SuSE 10
x86, 32-bit
x86-64, 64-bit

Technical support is provided only for these systems and platforms.

Before You Begin

Before using the services, install the necessary applications on your computer or network.

The services can work in a distributed environment. This allows you to install Sonic ESB and Sonic MQ Domain Manager on one networked machine and the Sonic containers on another machine.

All of the following must be installed on the same networked machine:

Java Runtime Environment

Progress Sonic MQ is bundled with JRE 1.4.2 and JRE 1.5. The FIX services require JRE 1.5 or newer. Review the following for any tasks you may need to perform.

Updating on Windows

For demonstration purposes, assume that Sonic is installed in C:\Sonic and JRE 1.5 is installed in C:\Sonic\MQ7.6\jre15-win32.

To update your Sonic batch files on Windows

  1. Open the file C:\Sonic\MQ7.x\bin\setenv.bat in a text editor.
  2. Find the following lines:
  3. set SONICMQ_JRE=C:\Sonic\jre14-win32\bin\java.exe

    set SONICMQ_JREW=C:\Sonic\jre14-win32\bin\javaw.exe

    set MGMTCONSOLE_JRE=C:\Sonic\jre14-win32\bin\java.exe

  4. Change the lines as follows:
  5. set SONICMQ_JRE=C:\Sonic\MQ7.6\jre15-win32\bin\java.exe

    set SONICMQ_JREW=C:\Sonic\MQ7.6\jre15-win32\bin\javaw.exe

    set MGMTCONSOLE_JRE=C:\Sonic\MQ7.6\jre15-win32\bin\java.exe

  6. Save and close the file.
  7. Open the file C:\Sonic\ESB7.x\bin\setenv.bat in a text editor.
  8. Find the following lines:
  9. set JAVA_HOME=C:\Sonic\jre14-win32

    set JAVA_14_HOME=C:\Sonic\jre14-win32

  10. Change the lines as follows:
  11. set JAVA_HOME=C:\Sonic\MQ7.6\jre15-win32

    set JAVA_14_HOME=C:\Sonic\MQ7.6\jre15-win32

  12. Save and close the file.
Updating on Linux

For demonstration purposes, assume that Sonic is installed in /opt/Sonic and JRE 1.5 is installed in /opt/java5/jre. Use the following command to verify where your JRE versions are located and edit the example to fit your setup:

java -version

To update your Sonic batch files on Linux

  1. Verify that the Java 1. 5 home is set to the JAVA_HOME environment variable:
  2. echo $JAVA_HOME

  3. If it is not, run the following command:
  4. export JAVA_HOME=/opt/java5

  5. Next, run the following commands:
  6. cd /opt/Sonic/MQ7.x/bin/

    cp setenv setenv.old

    cat setenv.sh | sed "s,\(SONICMQ_JRE=\"\).*\",\1$JAVA_HOME/jre/bin/java\"," | sed "s,\(MGMTCONSOLE_JRE=\).*,\1\"$JAVA_HOME/username/bin/java\","> setenv

    cd /opt/Sonic/ESB7.x/bin/

    cp setenv.sh setenv.sh.old

    cat setenv.sh | sed "s,\(JAVA_HOME=\"\).*\",\1$JAVA_HOME/jre\",">setenv.sh

Setup Notes

FIX services run on both Microsoft Windows and Linux operating systems. You must manually import the services into Sonic ESB.

For details on importing and using the service, see Services for Progress Sonic ESB User’s Guide. This documentation file is called sonic_services.pdf and is included with your installation package.

Useful Links

Disclaimer

PERVASIVE SOFTWARE INC. LICENSES THE SOFTWARE AND DOCUMENTATION PRODUCT TO YOU OR YOUR COMPANY SOLELY ON AN “AS IS” BASIS AND SOLELY IN ACCORDANCE WITH THE TERMS AND CONDITIONS OF THE ACCOMPANYING LICENSE AGREEMENT.

PERVASIVE SOFTWARE INC. MAKES NO OTHER WARRANTIES WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING THE SOFTWARE OR THE CONTENT OF THE DOCUMENTATION; PERVASIVE SOFTWARE INC. HEREBY EXPRESSLY STATES AND YOU OR YOUR COMPANY ACKNOWLEDGES THAT PERVASIVE SOFTWARE INC. DOES NOT MAKE ANY WARRANTIES, INCLUDING, FOR EXAMPLE, WITH RESPECT TO MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE OR ARISING FROM COURSE OF DEALING OR USAGE OF TRADE, AMONG OTHERS.

© Copyright 2008 Pervasive Software Inc.

All Rights Reserved.


Pervasive Software Inc.
http://www.pervasive.com
12365 Riata Trace Pkwy, Bldg B
Austin, TX 78727 USA
Voice: (512) 231-6000
Fax: (512) 231-6010
Online Pervasive Contacts

*** END OF README ***