Versions Compared

Key

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

...

Installation directories

Windows

  1. c:\B2BITS\FIXEdge_one
  2. c:\B2BITS\FIXEdge_two

Linux

  1. /home/user/B2BITS/FIXEdge_one
  2. /home/user/B2BITS/FIXEdge_two

where a user is the name of the user performing the installation

...

Info

Remember that Linux OS is case-sensitive. That means that e.g. FIXEdge1.sh and FixEdge1.sh are different files.

Pay attention to port values – using one port value in several instances may lead to conflicts and failures.

...

  1. Extract distribution archive of FIXEdge to the instance 1 folder (in our test case it is B2BITS1 on c: drive). Extract distributive archive of FIXEdge to the instance 2 folder (in our test case it is B2BITS2 on c: drive)
  2. Put license file to 1st instance fixedge FIXEdge root directory (c:\B2BITS\FIXEdge_one\FIXEdge). Put license file to 2nd  instance fixedge root directory (c:\B2BITS\FIXEdge_two\FIXEdge).         
  3. Edit service names in a wrapper.conf file for 2nd instance for they must be different from 1st instance names.

    Code Block
    titlewrapper.conf
     # Name of the service
     wrapper.ntservice.name=FIXICC - Agent FIXEdge2
      
     # Display name of the service
     wrapper.ntservice.displayname=FIXICC - Agent FIXEdge2
      
  4. Change port values in configuration files (see example in How to install two instances of FIXEdge on one host)

    parameter

    configuration file

    ListenPort

    engine.properties

    Monitoring.ListenPort

    engine.properties

    ControlCentre.XMLSockMonitor.Port

    FIXEdge.properties

    AgentServerPort

    agent.properties

  5. Open cmd.exe as Administrator and run the following scripts

    Code Block
    C:>\B2BITS\FIXEdge_one\FIXEdge\fixicc-agent\bat>installService.FIXEdge1.bat
    C:>\B2BITS\FIXEdge_one\FIXEdge\fixicc-agent\bat>startService.FIXEdge1.bat
    C:>\B2BITS\FIXEdge_one\FIXEdge\bin\FIXEdge1.install.cmd
    
  6. Edit the following files for 2nd instance
    In B2BITS\FIXEdge_two\FIXEdge\FIXEdge1\conf\FIXEdge.properties file set parameter ServiceName=FIXEdge2
    In B2BITS\FIXEdge_two\FIXEdge\FIXEdge1\bin\FIXEdge1.install.cmd change  FIXEdge.FIXEdge1 to FIXEdge.FIXEdge2
    In B2BITS\FIXEdge_two\FIXEdge\FIXEdge1\bin\FIXEdge1.service.run.cmd change  FIXEdge.FIXEdge1 to FIXEdge.FIXEdge2
    In B2BITS\FIXEdge_two\FIXEdge\FIXEdge1\bin\FIXEdge1.service.stop.cmd change  FIXEdge.FIXEdge1 to FIXEdge.FIXEdge2
    In B2BITS\FIXEdge_two\FIXEdge\FIXEdge1\bin\FIXEdge1.uninstall.cmd change  FIXEdge.FIXEdge1 to FIXEdge.FIXEdge2
  7. Open cmd.exe as Administrator and run the following scripts

    Code Block
    C:>\B2BITS\FIXEdge_two\FIXEdge\fixicc-agent\bat>installService.FIXEdge1.bat
    C:>\B2BITS\FIXEdge_two\FIXEdge\fixicc-agent\bat>startService.FIXEdge1.bat
    c:>\B2BITS\FIXEdge_two\FIXEdge\bin\FIXEdge1.install.cmd
    
  8. You can connect to the server and start the server in FIXICC in the same manner as for one-instance case (for details see https://kb.b2bits.com/display/B2BITS/FIXEdge+Installation+Guide)

...

Code Block
$>/home/user/B2BITS/FIXEdge_one/FIXEdge/fixicc-agent/bin/installDaemon.sh
$>/home/user/B2BITS/FIXEdge_one/FIXEdge/fixicc-agent/bin/startDaemonNoPriv.sh
$>/home/user/B2BITS/FIXEdge_two/FIXEdge/fixicc-agent/bin/installDaemon.sh
$>/home/user/B2BITS/FIXEdge_two/FIXEdge/fixicc-agent/bin/startDaemonNoPriv.sh

Use ps -ef command to find processes corresponding to fixicc agent  agent servers.


5. You can connect to the server and start the server in FIXICC in the same manner as for a one-instance case (for details see https://kb.b2bits.com/display/B2BITS/FIXEdge+Installation+Guide)

 If everything is OK you can see servers started in FIXICC GUI (on the picture below you can see our test case example. First The first two string correspond to the windows case and the last two strings show two Linux fixedge instances running)

...

Example Configuration used for testing

Two-instance configuration has been prepared and tested

Test case 1.

Windows 10

FIXEdge-6.6.0.12-FA-2.25.0.24-Windows-vc14-x64.zip installation package

For Windows installations, FIXICC GUI application is running on the same windows machineTest case 2.

Linux CentOS7

FIXEdge-6.6.0.12-FA-2.25.0.24-Linux-2.6.32-gcc-7.3.1-x86_64.tar.gz installation package

FIXICC GUI application running on the windows machine

Port configuration

parameter

configuration file

 

FIXEdge1 windows

FIXEdge2

 windows

FIXEdge1

  linux

 

FIXEdge2

  linux

 

ListenPort

engine.properties

8901

8911

8901

8911

Monitoring.ListenPort

engine.properties

 

8803

8813

8803

8813

ControlCentre.XMLSockMonitor.Port

FIXEdge.properties

8902

8912

8902

8912

AgentServerPort

agent.properties

8903

8913

8005

8006

Uninstall

If you wish to uninstall both instances of FIXEdge you should do the following steps depending on what operating system you are running

...

Code Block
C:\B2BITS\FIXEdge_one\FIXEdge\fixicc-agent\bat\stopService.FIXEdge1.bat
C:\B2BITS\FIXEdge_one\FIXEdge\fixicc-agent\bat\uninstallService.FIXEdge1.bat

C:\B2BITS\FIXEdge_two\FIXEdge\fixicc-agent\bat\stopService.FIXEdge1.bat
C:\B2BITS\FIXEdge_two\FIXEdge\fixicc-agent\bat\uninstallService.FIXEdge1.bat

C:\B2BITS\FIXEdge_one\FIXEdge\bin\FIXEdge1.uninstall.cmd
C:\B2BITS\FIXEdge_two\FIXEdge\bin\FIXEdge1.uninstall.cmd

...

Code Block
$>/home/user/B2BITS/FIXEdge_one/FIXEdge/fixicc-agent/bin/stopDaemonNoPriv.sh
$>/home/user/B2BITS/FIXEdge_one/FIXEdge/fixicc-agent/bin/uninstallDaemon.sh

$>/home/user/B2BITS/FIXEdge_two/FIXEdge/fixicc-agent/bin/stopDaemonNoPriv.sh
$>/home/user/B2BITS/FIXEdge_two/FIXEdge/fixicc-agent/bin/uninstallDaemon.sh

$>/home/user/B2BITS/FIXEdge_one/FIXEdge/bin/FIXEdge1.stop.sh
$>/home/user/B2BITS/FIXEdge_two/FIXEdge/bin/FIXEdge1.stop.sh

2. Remove B2BITS/FIXEdge_one  and B2BITS/FIXEdge_two folders recursively

Troubleshooting

Windows

Find troubleshooting notes for one-instance installation cases in

https://kb.b2bits.com/display/B2BITS/FIXEdge+installation+on+Windows.+Step+by+step+instruction

1. server installation fails. The error is Related articles:

Server installation fails with the error "Cannot create service. The specified service already exists in this database"

Check the ServiceName parameter in FIXEdge.properties file.2.

The second instance of fixicc-agent installs and starts without errors but doesn’t appear in services

 

Check wrapper.conf file – service names must be changed.3.

The server does not start from FIXICC GUI. The process starts and hangs for a long time, but no error messages appear in the details field.

Check server name parameter in FIXEdge1.service.run.cmd.

Try to run FIXEdge as console application to get full error using FIXEdge1.run.cmd or FIXEdge1.run.sh

Linux

Find troubleshooting notes for one-instance installation cases in https://kb.b2bits.com/display/B2BITS/FIXEdge+installation+on+Linux.+Step+by+step+instruction