Installation in YAJSW

Overview

To get started, you need to download the FEJ distribution. You should end up downloading a compressed ZIP file named something like fixedgej-x.y.z.zip. Once you have downloaded the FEJ zip, 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:

$ 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, find the bin directory that contains the scripts needed to start FEJ on UNIX platforms (Linux, Mac OS X, etc.) and the 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.

Remember to place the license file (fixaj2-license.bin) to the confdirectory ( fixedgej-1.6.2\conf).

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 directory with the following content (Unix: similar in the bin folder):

$ 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 runConsole.bat (unix: ./runConsole.sh):

$ ./runConsole.bat

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

$ 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).

You need to have administrative privileges to run these scripts.

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

$ ./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 . . .

The service installation is completed successfully.

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

$ ./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 . . .

The service started successfully.

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

$ ./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 . . .

The service stopped successfully.

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

$ ./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 . . .

The service was removed successfully.

Check the FIXEdge Java status via FIXICC

After installation is done and FIXEdge is up and running, the user can remotely check FIXEdge Java Server status with the FIXICC monitoring UI tool.

FIXICC supports FIXEdge Java starting from version 2.12

Please follow the following steps:

  1. Add a new server.
  2. FIXICC uses an administrative session for communicating with FIX engines.

  3. Default parameters for an administrative session in FIXEdge Java are:

    • Type: B2BITS FIX Edge Java

    • Port: 8911

    • Username: admin

    • Password: admin

    • SenderCompId: admin

    • TargetCompId: admin

      Don't forget to specify the destination host.


  4. Right-click on the just created server and select Connect.
  5. Enter the credentials. The default ones are: admin/admin
  6. If the connection is successful, then the status of the server will be changed from RED (No connection) to Lime (Connected directly to engine).

    The server will show the configured sessions and its status.
  7. Installation is completed.