PrimeXM MT4 Bridge

Installation

Prerequisites

Provide PrimeXM Support with the following information to prepare the Bridge license:

• MT4 server name, as shown in the Common settings in MT4 Administrator.
• Dedicated MT4 Manager account for the Bridge plugin. This account does not require permissions or group access rights.
• DNS names or IP addresses of the primary and backup MT4 servers.

Obtain the Bridge plugin, primexm_bridge.dll, and the corresponding license, primexm_bridge.lic, before installation. PrimeXM supplies the license using the information above.

Installation Procedure

1. Confirm that primexm_bridge.dll and primexm_bridge.lic have the same base filename. A mismatch prevents the Bridge from loading.
2. In Windows Services, stop MetaTrader 4 Server.
3. Copy both files to the MT4 server's plugins directory, for example D:\MetaTrader4\plugins.
4. Start MetaTrader 4 Server.
5. In MT4 Administrator, open Plugins. Place the Bridge at the top of the plugin list so it has priority over other plugins.
6. If you changed the plugin order, restart MetaTrader 4 Server again to apply the priority change.
7. If a failover or backup server is used, copy the plugin and corresponding license to its plugins directory as well.

See the MT4 Bridge installation video.

Update

1. Copy the supplied update files to the MT4 server. An update may include one or more of primexm_bridge.dll, primexm_bridge.lic, and primexm_bridge.ini; replace only the files supplied for that update.
2. Back up the installed .dll, .lic, and .ini files to a directory outside plugins so the previous version can be restored if required.
3. In Windows Services, stop MetaTrader 4 Server.
4. Replace the supplied files in the installed plugins directory, for example D:\MetaTrader4\plugins.
5. Confirm that the .dll, .lic, and .ini files retain the same base filename, primexm_bridge.
6. Start MetaTrader 4 Server.
7. In MT4 Administrator, open Plugins and confirm that the Bridge is at the top of the list. Move it back to the top if required.
8. If you changed the plugin order, restart MetaTrader 4 Server again to apply the priority change.

Note: A filename mismatch between the plugin, license, and configuration files prevents the Bridge from loading correctly.

Note: MT4 WatchDog synchronizes the .dll and .ini files from the primary server to the failover server. If the license is updated, manually copy the corresponding .lic file to the failover or backup server's plugins directory.

See the MT4 Bridge update video.

Uninstall

1. In Windows Services, stop MetaTrader 4 Server.
2. Open the MT4 server's plugins directory, for example D:\MetaTrader4\plugins.
3. Move primexm_bridge.dll, primexm_bridge.lic, primexm_bridge.ini, and the primexm_bridge folder outside plugins, or delete them.
4. Start MetaTrader 4 Server.
5. On the failover or backup server, remove primexm_bridge.lic from plugins. MT4 WatchDog removes the corresponding .dll and .ini files automatically.

Note: To stop using the Bridge permanently, uninstall it completely rather than disabling the plugin in MT4 Administrator.

See the MT4 Bridge uninstall video.

Connectivity Verification

Open the Bridge log for the required date, for example D:\MetaTrader4\plugins\primexm_bridge\logs\YYYYMMDD.log.

After installation or an MT4 server restart, check the configured rules and included groups and securities:

[INFO] connect start
[INFO 0] config: name=1000: Bridge value=sec=FX;g=PXM*;acc=acc1
[INFO] including: group=PXM-1 security=FX
[INFO] including: group=PXM-2 security=FX
[INFO] connect end

Then verify the connection sequence:

1. connecting: host=xcorename.primexm.com:port — connection attempt started.
2. connected: host=xcorename.primexm.com:port — network connection established.
3. access granted: host=xcorename.primexm.com:port — access to the XCore session granted.

A failed connection attempt is recorded in the Bridge log as:

[INFO] connection failed: host=xcorename.primexm.com:port