IbcAlpha/IBC 3.16.2

on GitHub

This release provides two enhancements:

• IBC now detects situations where more than one potentially valid autorestart file exists when starting or restarting.

  This situation can arise if multiple instances of IBC are configured with the same TWS_SETTINGS_PATH and the same auto-restart time (for example live and paper trading instances). The safest approach is to ensure that different auto-restart times are configured, separated by at least one minute (but 5 minutes would be safer still). It's also worth considering using different TWS_SETTINGS_PATH settings, so that this issue doesn't arise.

  When IBC detects this situation, it deletes all the autorestart files and then proceeds with a normal start of TWS/Gateway. This means that the login form is displayed and handled in the usual way by IBC, including full Second Factor Authentication for live accounts.

  IBC writes details of the detected autorestart files to its logfile as an aid to diagnosing the problem.

• The SessionManager method previously with signature static void Initialise(boolean isGateway) has been renamed and made public. Its new signature is public static void initialise(boolean isGateway).

  This is necessary for programs that run IBC in-process rather than starting it via the scripts.

DO I NEED TO UPGRADE TO THIS RELEASE?

For a new IBC installation, you should download the relevant zip file and proceed as detailed in the User Guide (included in the zip file, or at https://github.com/IbcAlpha/IBC/blob/master/userguide.md).

Otherwise proceed as in the 'How to Upgrade' description below. Note that:

• If the circumstances described above regarding the autorestart files do not apply to you, you do not need to deploy the updated script file.

• If you do not load IBC within your own program, you do not need to deploy the updated IBC.jar file.

HOW TO UPGRADE

Either extract the relevant changed files from the zip file, or download them directly from the provided URL. Overwrite the existing version with the new one. You can do this while TWS/Gateway are running, but you must then shut TWS/Gateway down and start it afresh for the updates to take effect: note that using File | Restart or the RESTART command will not work correctly.

The only changed files are:

IBC.jar (URL https://github.com/IbcAlpha/IBC/blob/master/resources/IBC.jar)
version (URL https://github.com/IbcAlpha/IBC/blob/master/resources/version)

StartIBC.bat (Windows only, scripts subfolder, URL https://github.com/IbcAlpha/IBC/blob/master/resources/scripts/StartIBC.bat)

ibcstart.sh (Linux/macOS only, scripts subfolder, URL https://github.com/IbcAlpha/IBC/blob/master/resources/scripts/ibcstart.sh)