"How to" instructions
How to upgrade FEJ to a new version
It is very simple to upgrade FEJ. First, download the new version of FEJ and unzip it (see Quick Start). Then, replace all files and directories in your FEJ home directory, except for the /conf directory. All custom user configurations are saved in /conf, therefore the upgrade will not affect personal settings.
How to configure session schedule that can't be defined via single cron-expression
FIXEdge Java 1.8.0 and earlier doesn't support several schedules for the session. So there is a limitation preventing creating a session schedule requiring multiple cron expressions.
For example, the session should have the next maintenance windows:
- Saturday: 6PM – 7PM ET
- Sunday: 10AM – 11AM ET
- Sunday: 6PM – 7PM ET
To achieve this, the user can configure a weekly session with start at 7 PM Sun and stop at 6 PM Sat. And cover the rest time intervals via external tools and scripts (FIXEdge JAVA administration shell CLI) that can start the session remotely.
FIXEdge Java Administrative shell requests passing of a password to it.
Before using it as part of the script, the user should at least once connect to the administrative shell and save SSH keys and insert a password manually.
Crontab scripts examples for credentials:
- username - test
- password - test
- remote host - fixedgej.sever.com:2000
- session name - session1
It is needed to add two additional commands to the crontab that will start the session at 7 PM Sat and 11 AM Sun:
sshpass -p test ssh -t test@fixedgej.sever.com -p 2000 'session start session1'
It is needed to add two additional commands to the crontab that will stop the session at 11 AM Sun and 6 PM Sun
sshpass -p test ssh -t test@fixedgej.sever.com -p 2000 'session start session1'
Optionally for the Windows remote host, you can use the plink tool (which is part of the PuTTY package):
plink.exe fixedgej.sever.com -P 2000 -l test -pw test -batch -t session start session1
How to configure Echo between FIXEdge Java and Simple Client
Echo configuration between FIXEdge Java and Simple Client is performed in the following way:
- Install FIXEdge Java.
To create the TestEchoAcceptor session, create a new file named fixedgej-x.x.x\conf\session\s_fix_TestEchoAcceptor.properties
Configure session parameters there:s_fix_TestEchoAcceptor.propertiessessionType=acceptor senderCompID=FIXEdgeJ targetCompID=FIXECHOCLIENT fixVersion=FIX.4.4 startOnload = true
Configure Business Logic rules in the fixedgej-x.x.x\conf\rules.groovy file. This will route all messages from the TestEchoAcceptor session back to the TestEchoAcceptor session.
rules.groovyRoutingContext rc = routingContext as RoutingContext; [ messageRule("FIXEDGE -> FIXECHOCLIENT") .sourceCondition({ source -> source.id == "TestEchoAcceptor" }) .action({ ctx -> def destination = rc.getDestinationById("TestEchoAcceptor") destination.send(ctx.getMessage()) ctx.exit() }) .build(), getRejectionRule(routingContext) ]
The session-id value in the rule
source.id ==
"TestEchoAcceptor"
is the same as the ID in the s_fix_TestEchoAcceptor.properties session configuration file.- Run FIXEdge Java.
For example, via the run script:- Windows: Go to the FIXEdge Java installation dir fixedgej-x.x.x\bat\ and run the runConsole.bat script.
- Linux: Go to the FIXEdge Java installation dir fixedgej-x.x.x/bin and run the runConsole.sh script.
Open FIX Client Simulator (FCS).
Create a new session as Initiator:Session type: Initiator SenderCompID = FIXECHOCLIENT TargetCompID = FIXEdgeJ FIX Version = 4.4 Remote Port = 8911 (server.port parameter in FEJ fixedge.properties -> fixedgej-x.x.x\conf\fixedge.properties ) Remote Host = localhost (or IP address/hostname of the FIXEdge Java server)
The default port for session acceptors is 8911 and specified as the server.port parameter in the fixedge.properties file.
NOTE: SenderCompID on the FCS side should have the same value as TargetCompId on the FIXEdge side. TargetCompId on the FCS side should be the same as SenderCompID on FIXEdge side.
Send the message from FIX Client Simulator (the Pipes character is used to represent the SOH character).
New Order - Echo test.msg8=FIX.4.4|9=156|35=D|49=FIXECHOCLIENT|56=FIXEdgeJ|34=2|52=20210625-22:16:38.867|11=Order#3|21=1|100=1|55=TESTSMBL|54=1|60=20131124-04:11:46.768|38=20000|40=2|44=34.7|10=026|
The file contains SOH symbols: NewOrderEchoTestMessage.txt
The Echo message from FIXEdge is received.
8=FIX.4.4|9=156|35=D|34=2|49=FIXEdgeJ|56=FIXECHOCLIENT|52=20210625-22:16:38.878|11=Order#3|21=1|100=1|55=TESTSMBL|54=1|60=20131124-04:11:46.768|38=20000|40=2|44=34.7|10=028|