Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Overview


FIX Edge Java is an application server providing FIX connectivity to multiple clients. Client applications communicate with FEJ through one of the multiple transport protocols (e.g. Simple Sockets, TIBCO, CORBA, HTTPs) employing transport adaptors. It is designed to be as easy as possible to install, configure, administrate and monitor trading information flows. It is written in Java and has a performance profile suitable for the needs of all clients up to and including large sell-side institutions and large volume traders.

...

Code Block
languagebash
$ java -version
java version "1.8.0_60"
Java(TM) SE Runtime Environment (build 1.8.0_60-b27)
Java HotSpot(TM) 64-Bit Server VM (build 25.60-b23, mixed mode)

Installation

To get started, you need to download the FEJ distribution. You should end up downloading a compressed ZIP file named something like fixedgej-1.0.0.zip. Once you have downloaded the FEJ zipball, installing and setting up a standalone FEJ node is pretty simple and straightforward. Let’s extract the compressed zip archive into /usr/share. On Linux, Mac OS X, or any other UNIX-like system you can use the following command to extract the distribution:

Code Block
languagebash
$ unzip fixedgej-1.0.0.zip -d /usr/share
$ cd /usr/share/fixedgej-1.0.0/
$ ls
CDDL-license.txt               apache-license-2.0.txt  bin   icons  license.txt  scripts    tmp          wrapperApp.jar
FixEdgeJavaVersionHistory.txt  bat                     conf  lib    log          templates  wrapper.jar

If you are using Windows, you will need to use a decompression tool such as WinZip to extract the distribution.

In the distribution directory, you will find a bin directory that contains the scripts needed to start FEJ on UNIX platforms (Linux, Mac OS X, etc.) and a `bat' directory that contains the scripts for Windows. The conf directory holds configuration files. The lib directory contains Java JAR files, which are third-party files needed to run FEJ.

Once we have extracted the zipball, the next thing is to configure and start FEJ.

Starting the FEJ container on Windows (Unix)

Now, let’s go ahead and start FEJ. All FEJ administration scripts to start/stop the container for Windows are shipped along with the archive in the bat folder with the following content (Unix: similar in the bin folder):

Code Block
languagebash
$ pwd
/usr/share/fixedgej-1.0.0/bat
$ ls
installService.bat  runConsoleW.bat               setenv.bat        systemTrayIcon.bat    wrapper.bat
queryService.bat    runServicesManagerClient.bat  startService.bat  sytemTrayIconW.bat    wrapperW.bat
runConsole.bat      runServicesManagerServer.bat  stopService.bat   uninstallService.bat

To start FEJ as a console application on the Windows system, you need to execute the runConsole.bat (unix: ./runConsole.sh):

Code Block
languagebash
$ ./runConsole.bat

To avoid going to the FEJ install directory to run these scripts, you can include it in your PATH variable as follows:

Code Block
languagebash
$ export PATH=$PATH:/usr/share/fixedgej-1.0.0/bat

To start FEJ as a Windows service you first need to install it. To install the application as a service execute installService.bat (unix: ./installDaemon.sh).

Info

You need to have administrative privileges to run these script.

A successful installation of the container will show the following output:

Code Block
languagebash
$ ./installService.bat

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>cd C:\cygwin64\usr\share\fixedgej-1.0.0\bat\

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>call setenv.bat
"java" -Xmx30m -Djna_tmpdir="C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../tmp"
-Djava.net.preferIPv4Stack=true -jar "C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../wrapper.jar"
-i "C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../conf/wrapper.conf"
YAJSW: yajsw-alpha-12.00
OS   : Windows 7/6.1/amd64
JVM  : Oracle Corporation/1.8.0_60/D:\Program Files\Java\jre1.8.0_60/64
Oct 13, 2015 11:59:16 AM org.apache.commons.vfs2.VfsLog info
INFO: Using "C:\cygwin64\tmp\vfs_cache" as temporary files store.
************* INSTALLING FixEdgeJava ***********************

.
<some omitted output>
.

Service FixEdgeJava installed 
Press any key to continue . . .

Service installation completes successfully.

We are now ready to start the service. Run the startService.bat (unix: ./startDaemon.sh):

Code Block
languagebash
$ ./startService.bat

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>cd C:\cygwin64\usr\share\fixedgej-1.0.0\bat\

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>call setenv.bat
"java" -Xmx30m -Djna_tmpdir="C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../tmp"
-Djava.net.preferIPv4Stack=true -jar "C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../wrapper.jar"
-t "C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../conf/wrapper.conf"
YAJSW: yajsw-alpha-12.00
OS   : Windows 7/6.1/amd64
JVM  : Oracle Corporation/1.8.0_60/D:\Program Files\Java\jre1.8.0_60/64
Oct 13, 2015 12:10:33 PM org.apache.commons.vfs2.VfsLog info
INFO: Using "C:\cygwin64\tmp\vfs_cache" as temporary files store.
************* STARTING FixEdgeJava ***********************

Service FixEdgeJava started 
Press any key to continue . . .

Service starts successfully.

To stop the service, you can use stopService.bat script (unix: ./stopDaemon.sh):

Code Block
languagebash
$ ./stopService.bat

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>cd C:\cygwin64\usr\share\fixedgej-1.0.0\bat\

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>call setenv.bat
"java" -Xmx30m -Djna_tmpdir="C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../tmp"
-Djava.net.preferIPv4Stack=true -jar "C:\cygwin64\usr\share\fixedgej-
1.0.0\bat\/../wrapper.jar" -p "C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../conf/wrapper.conf"
YAJSW: yajsw-alpha-12.00
OS   : Windows 7/6.1/amd64
JVM  : Oracle Corporation/1.8.0_60/D:\Program Files\Java\jre1.8.0_60/64
Oct 13, 2015 12:13:36 PM org.apache.commons.vfs2.VfsLog info
INFO: Using "C:\cygwin64\tmp\vfs_cache" as temporary files store.
************* STOPPING FixEdgeJava ***********************

Service FixEdgeJava stopped 
Press any key to continue . . .

Service stopped successfully.

Finally, if you want to uninstall the service run uninstallService.bat (unix: ./uninstallDaemon.sh):

Code Block
languagebash
$ ./uninstallService.bat

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>cd C:\cygwin64\usr\share\fixedgej-1.0.0\bat\

C:\cygwin64\usr\share\fixedgej-1.0.0\bat>call setenv.bat
"java" -Xmx30m -Djna_tmpdir="C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../tmp"
-Djava.net.preferIPv4Stack=true -jar "C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../wrapper.jar"
-r "C:\cygwin64\usr\share\fixedgej-1.0.0\bat\/../conf/wrapper.conf"
YAJSW: yajsw-alpha-12.00
OS   : Windows 7/6.1/amd64
JVM  : Oracle Corporation/1.8.0_60/D:\Program Files\Java\jre1.8.0_60/64
Oct 13, 2015 12:15:39 PM org.apache.commons.vfs2.VfsLog info
INFO: Using "C:\cygwin64\tmp\vfs_cache" as temporary files store.
************* REMOVING FixEdgeJava ***********************

Service FixEdgeJava removed 
Press any key to continue . . .

...


Configuration

This section will acquaint you with the basic information used during the configuration of the application.

...