How to overcome the "Downloading settings from server failed" error

Background: 

Store settings on server allows clients the ability to store their Trader Workstation (TWS) settings/configuration on the cloud and retrieve them at anytime from another computer. This feature allows you to use the layout of a specific user on two or more machines.

In some specific circumstances, the operation which stores/downloads the settings to/from the cloud may fail and the following error message may appear shortly after the TWS has loaded on the screen:

 

 

 How to overcome this error message?

 The underlying causes of this message are usually the following:

  • ACCESS TO THE LOCAL MACHINE IS BLOCKED: A security setup, such as a firewall or antivirus, prevents the access of this computer to the cloud storage. This prevents TWS from accessing the remote server, thus disallowing the settings file upload or download. Recommended workaround: set up an exception on the firewall or antivirus in order to exclude the TWS executable file (c:\Jts\tws.exe) or the entire TWS folder (C:\Jts) from the real time security scan. The procedure to set an exclusion may vary, according to the software you are using, therefore we recommend consulting the user guide or the on-line documentation of your specific security program.
     
  • ACCESS TO THE REMOTE SERVER IS BLOCKED: A firewall or proxy service blocks the communication with the cloud storage through the network on which this computer is. In this scenario, you (or your IT / Networking departments, in case you do not have the rights for such an operation) can modify the firewall or proxy settings to allow the computer to communicate with the cloud server s3.amazonaws.com on the TCP port 443. For additional details about the hosts/ports which needs to be allowed for the proper TWS operation, please see as well the section "DESKTOP TWS" of KB2816. Please refer to the documentation of your specific software in order to create specific rules for your firewall or proxy system.

 

See KB2323 for instructions on how to restore TWS settings from external storage
See KB2320 for instructions on transferring settings from one user to another

 

IB TWS and IB Key Merger into IBKR Mobile

OVERVIEW

The migration for your user depends upon your current use of the apps as follows:

1. Your Smartphone is solely used for trading (IB TWS installed) - Click Here
2. Your Smartphone is solely used for authentication (IB Key installed) -  Click Here
3. Your Smartphone is used for both trading and authentication (IB TWS and IB Key installed) - Click Here
4. Your Smartphone is used for Debit Card transactions (IB Key installed) -  Click Here
 

You are a user of IB TWS

You have been trading on your smartphone with IB TWS and you have not used IB Key.
1. Upon first launch of the application you will see the following new Home Screen.
Figure 1 is the Home Screen of IBKR Mobile for iOS devices. Figure 2 is the Android device version.

     
Figure 1                                                     Figure 2

2. Tap on the Trade button.
3. The rest of the application experience is identical to what you have already used in the past.
 

 

Access to the other functions from the Trading Screen

If you wish to access the other functions of the IBKR Mobile, such as the Authentication module or the
Debit Card functions:

For iOS (Figure 3)
1. Open the menu ‘More’ (lower right-hand corner of your screen).
2. Scroll to the very bottom of this page
For Android (Figure 4)
1. Open the Application menu
2. Scroll to the bottom section - App Settings

       

Figure 3

    

Figure 4
 

You are an IB Key user

Activation

1. Launch the IBKR Mobile and tap on Authentication.
2. The app will detect the installation of the IB Key and will suggest a course of action - either an
automated migration (Figure 5) on an update and then automated migration.
You can as well choose to manually migrate at a later point.

     
Figure 5                                                 Figure 6                                                 Figure 7

After the migration is completed, should you run the IB Key standalone application - the one you have
authenticated with in the past - you will see the following screen (Figure 8).


Figure 8

 

Daily Operation


A. Nothing changes in the daily login experience if you have an Internet connection - the Seamless
Authentication process will be used:
1. Enter your credentials in the corresponding fields (in the TWS, Account Management, WebTrader or
IBKR Mobile). Click on Login.
2. The system will send you a notification on your smartphone’s screen - tap on it.
3. Depending on your device, present your face to the camera or fingerprint on the sensor (iOS) or
enter your PIN code (Android). The system will the automatically proceed with the login.


B. If you have no Internet connection, you will use the IBKR Mobile in Challenge-Response mode:
1. Enter your credentials in the corresponding fields (in the TWS, Account Management, WebTrader or
IBKR Mobile). Click on ‘Login'.
2. Click on the link saying “I did not receive a notification”.
3. Launch the IBKR Mobile and tap on ‘Authentication’.
4. In the field Challenge of your smartphone application enter the values displayed on the Login
Screen. Tap the ‘Generate’ button.
5. Enter the values displayed by your smartphone app into the field Response string on the Login
Screen. Click ‘Login’.

 

You are a user of both IB TWS and IB Key

1. Please complete first the procedure for the activation of the Authentication module of the IBKR
Mobile app (Click Here).
2. Login to the trading screen by taping on the Trade button of the Home Screen in your new IBKR
Mobile app (Click Here).

 

You use an IB Debit Card

1. Please complete first the procedure for the activation of the Authentication module of the IBKR
Mobile app (Click Here).
2. On the Home Screen of the IBKR Mobile app tap on the Debit Card button. The rest of the experience
is identical to what you have already used in the past.

 

 

How to adjust font size in TWS

Background: 

By default, Trader Workstation (TWS) is designed to display in a font size and style which can be read comfortably for the average user across various screen sizes and resolutions. With the advent of new technologies, there has been an exponential push to make monitors with higher display sizes and your layout may need to be further adjusted manually. This document serves to explain how to manually adjust the font size for TWS.

Procedure

To adjust font size throughout TWS:

  1. From the Anchor window, click the Font Size Adjustment icon.
  2. Check the button Adjust window & column widths to ensure all windows will resize automatically to keep the same font:window ratio. (If unchecked, only font size will change but window size will remain the same).
  3. Click the button Smaller or Larger until the font size is correct.
    Notice that the font size will change immediately as you click the button.
  4. Click the Font Size Adjustment icon   when done.

Note: It is possible that currently not all windows will be adjusted in the same way.

IBKR Host and Ports Documentation

Background: 

TWS connects to IBKR servers via port 4000 and 4001, if using SSL, and will not operate on any other port. If you are using a proxy server, it needs to be a transparent with both inbound and outbound ports open so that the TWS can function properly.

Below are listed all the gateways, along with the corresponding destination host that might be used by the TWS when you use our services, please allow access to those hosts.

The easiest way to test whether your connection needs any special setup or has been configured properly is to use IBKR's Dedicated Test page, which will provide a dynamic test of your network’s connection against our main trading and market data servers. If a “Success” response is returned, there is nothing more for you to do. If the response is “Failure”, we recommend adding an exception for the new hosts to your network’s configuration or review your changes.

Note: If your network uses a browser proxy, the test page can produce false positives. In this case, or if you are not sure what your network setup is, turn to your network administrators, who can perform ping and telnet tests to the hosts listed below to confirm compliance with the connectivity requirements.

Specs:

CLIENT PORTAL AND WEBSITE

REGION/PRODUCT

SERVER (HOST)

PORTS1

IBKR WEBSITE – AMERICA

www.interactivebrokers.com

443

IBKR WEBSITE – Canada

www.interactivebrokers.ca

443

IBKR WEBSITE – UK

www.interactivebrokers.co.uk

443

IBKR WEBSITE – INDIA2

www.interactivebrokers.co.in

443

IBKR WEBSITE – JAPAN2

www.interactivebrokers.co.jp

443

IBKR WEBSITE – HONG KONG2

www.interactivebrokers.com.hk 443

IBKR WEBSITE – CHINA2

www.ibkr.com.cn 443

IBKR WEBSITE - AUSTRALIA

www.interactivebrokers.com.au 443

ACCOUNT MGMT – EAST

gdcdyn.interactivebrokers.com

443

ACCOUNT MGMT – CENTRAL

cdcdyn.interactivebrokers.com

443

DISASTER RECOVERY SITE

www.ibgdr.com 80

1: Standard Communication: TCP Port 80 | SSL Communication: TCP Port 443.

2: This IB Server host does not support ping request.

Important Note: If you are accessing Client Portal from a corporate network where the Internet access is provided through a load balancing equipment, you may receive error messages about expired/invalid session and/or missing web content upon or after the login phase.  The load balancer cycles your outbound connections over two or more network interfaces to equalize the network workload. As a consequence of this mechanism, your HTTP requests reach our systems from different IP addresses, invalidating your Client Portal session.
In this scenario, as a solution, please ask your network administrator or IT group to configure your machine/device for bypassing the load balancer. This will allow your session to remain valid and alive.
 

 

DESKTOP TWS

REGION/TOOL

PRIMARY/BACKUP

SERVER (HOST)

PORTS


TWS AMERICA – EAST

PRIMARY

gdc1.ibllc.com / ndc1.ibllc.com


4000 / 4001

BACKUP

gdc1_hb1.ibllc.com / ndc1_hb1.ibllc.com


TWS AMERICA – CENTRAL

PRIMARY

cdc1.ibllc.com


4000 / 4001

BACKUP

cdc1_hb1.ibllc.com


TWS EUROPE

PRIMARY

zdc1.ibllc.com


4000 / 4001

BACKUP

zdc1_hb1.ibllc.com

TWS ASIA

PRIMARY

hdc1.ibllc.com

4000 / 4001

BACKUP

hdc1_hb1.ibllc.com

TWS ASIA - CHINA3

PRIMARY

mcgw1.ibllc.com.cn

4000 / 4001

BACKUP

mcgw1_hb1.ibllc.com.cn
TWS AUTO-UPDATE PRIMARY

download.interactivebrokers.com

443

download2.interactivebrokers.com

RISK NAVIGATOR

PRIMARY

risk.interactivebrokers.com

443

TWS CLOUD SETTINGS

PRIMARY

s3.amazonaws.com

443

IB CAM

PRIMARY

gdc1.ibllc.com

4000 / 4001

DIAGNOSTICS REPORTS

PRIMARY

https://wit1.interactivebrokers.com

443

3: Gateway dedicated to clients with accounts assigned to the Hong Kong server, but are physically connecting from Mainland China.

 

 

 

How to check and solve connectivity issues affecting the Trader Workstation (TWS)

Background: 

The Trader Workstation (TWS) software needs to connect to our gateways and market data servers in order to work properly. Connectivity issues affecting your local network or your Internet Service Provider network may negatively affect the TWS functionality. In this article we will indicate how to test your connectivity using an automated connectivity test web page.

 

How to test the connectivity using the automated "IB Connectivity Test" web page?

1) Click on this link: http://www.interactivebrokers.com/cgi-bin/conn_test.pl 

2) Please wait until all the tests have been completed and results have been displayed. If you see "Success" as outcome for all tests, your connectivity to IB Servers is reliable at the present moment. No additional connectivity troubleshooting or configuration should be needed.

3) If you see "Fail" as outcome for one or more test/s, please click on the link "Fail" itself in order to display the "IB Network Troubleshooting Guide". That section will help you conduct some manual tests to identify the cause of the failure.

Note for Corporative environments and Proxy server users: the automated "Connectivity Test" page may return misleading results in case your machine is accessing the Internet through a Proxy server. This usually happens if you are connected to a company network. If this is your case, we kindly ask you to contact your Network Administrator or your IT Team and ask them to perform a manual connectivity tests towards the destination servers indicated in the table on the top of the IB automated "Connectivity Test" web page itself. The manual connectivity test should be conducted using destination TCP ports 4000 and 4001. Should they prefer to have the server list in another format or should they need to set up the firewall / IP Management rules, you can forward them this page.

 

Locating Portfolio Page

The portfolio page allows you to view and montor your current portfolio at the individual position level, including psoition quantity, market value, current bid-ask and profit/loss. Instructions for locating the page vary by trading platform and are outlined below:

TWS Classic - First check to see if you have detached the page from the main window (an option provided by right clicking on the tab). If this is the case, the page will be open but hidden behind the main window. Minimize the main window by clicking on the minimize icon located in the upper-right hand corner of the screen. If you are able to then view the portfolio page and wish to reattach it, simply right click on the tab to open the menu and select the "Attach Page" option.

If the page is not detached, select the "Account Window" option from the top menu bar and then "Portfolio Window" menu option.

 

Mosiac - from the Montor window, click on the small + sign located to the right of any existing monitor tabs. Then select "Portfolio" and this page will reappear.

 

 

How to start multiple TWS sessions on Mac

Background: 

By default the Mac OsX does not allow the user to run multiple sessions of the same application but with the following workaround you can overcome this limitation for the Trader Workstation application.

 

  • In case you are fine with running slightly different versions of the TWS, please follow the instructions on Procedure 1

  • In case you absolutely want to run multiple session of the same TWS version, please follow the instructions on Procedure 2

 

Procedure 1

you can then use this procedure which is the most simple:

1) Open the web page www.ibkr.com

2) Go to the menu Technology --> TWS Software.

3) First download and install one of the auto-updating TWS versions (TWS LATEST or TWS according to your preference).

4) Once you have completed the installation, download and install one of the offline versions (OFFLINE TWS LATEST or OFFLINE TWS according to your preference).

5) You will then see on your Desktop two different Trader Workstation icons. You can use the first shortcut to start the first TWS session and the second one to start the additional one, as you can see on the screenshot below:

 

 

 

 

Procedure 2

1) Launch the first session of the Trader Workstation using the TWS icon present on your Desktop. If you still do not have any Trader Workstation icon, please go to the web page www.ibkr.com and click on the menu Technology -> TWS Software. Then download and install one of the TWS versions present there.

2) Open the Finder and click on Applications on the left side menu. Then select Utilities and then launch Terminal.

3) The Terminal will appear on the screen and will point to the home folder of your current Mac OsX user. Now please enter the commands listed below (as well displayed on the screenshot) on your Terminal. After each one, press ENTER on your keyboard.

cd Applications

cd Trader\ Workstation

open -n Trader\ Workstation.app

4) The login window for your second TWS session will then appear on your Desktop. You can now close the Terminal.

 

Note: the procedure above presumes that the TWS executable is located in the following path: users/yourusername/home/Applications/Trader Workstation/Trader Workstation.app

If at the time you installed the TWS, you selected to install it for all the users of your system, then the TWS executable will be located here:

/Applications/Trader Workstation/Trader Workstation.app

and therefore you would need to issue the following commands in the Terminal:

cd /Applications

open -n Trader\ Workstation.app

 

 

Market Data Non-Professional Questionnaire

Overview: 

Insight into completing the new Non-Professional Questionnaire.

Background: 

The NYSE and most US exchanges require vendors to positively confirm the market data status of each customer before allowing them to receive market data. Going forward, the Non-Professional Questionnaire will be used to identify and positively confirm the market data status of all customer subscribers. As per exchange requirements, without positively identifying customers as non-professional, the default market data status will be professional. The process will protect and maintain the correct market data status for all new subscribers. For a short guide on non-professional definitions, please see ibkb.interactivebrokers.com/article/2369.

Each question on the questionnaire must be answered in order to have a non-professional designation. As exchanges require positive confirmations of proof for non-professional designations, an incomplete or unclear Non-Professional Questionnaire will result in a Professional designation until the status can be confirmed. 

If the status should change, please contact the helpdesk.

Explanation of questions:

1)    Commercial & Business purposes

a)    Do you receive financial information (including news or price data concerning securities, commodities and other financial instruments) for your business or any other commercial entity?

Explanation: Are you receiving and using the market data for use on behalf of a company or other organization aside from using the data on this account for personal use?

b)    Are you conducting trading of any securities, commodities or forex for the benefit of a corporation, partnership, professional trust, professional investment club or other entity?

Explanation: Are you trading for yourself only or are you trading on behalf of an organization (Ltd, LLC, GmbH, Co., LLP, Corp.)?

c)    Have you entered into any agreement to (a) share the profit of your trading activities or (b) receive compensation for your trading activities?

Explanation: Are you being compensated to trade or are you sharing profits from your trading activities with a third party entity or individual?

d)    Are you receiving office space, and equipment or other benefits in exchange for your trading or work as a financial consultant to any person, firm or business entity?

Explanation: Are you being compensated in any way for your trading activity by a third party, not necessarily by being paid in currency.

2)    Act in a capacity

a)    Are you currently acting in any capacity as an investment adviser or broker dealer?

Explanation: Are you being compensated to manage third party assets or compensated to advise others on how to manage their assets?

b)    Are you engaged as an asset manager for securities, commodities or forex?         
 

Explanation: Are you being compensated to manage securities, commodities, or forex?

c)     Are you currently using this financial information in a business capacity or for managing your employer’s or company’s assets?

Explanation: Are you using data at all for a commercial purposes specifically to manage your employer and/or company assets?

d)    Are you using the capital of any other individual or entity in the conduct of your trading?

Explanation: Are there assets of any other entity in your account other than your own?

3)    Distribute, republish or provide data to any other party

a)    Are you distributing, redistributing, publishing, making available or otherwise providing any financial information from the service to any third party in any manner?

Explanation: Are you sending any data you receive from us to another party in any way, shape, or form?

4)    Qualified professional securities / futures trader

a)    Are you currently registered or qualified as a professional securities trader with any security agency, or with any commodities or futures contract market or investment adviser with any national or state exchange, regulatory authority, professional association or recognized professional body? i, ii
YES☐             NO☐

i) Examples of Regulatory bodies include, but are not limited to,

  • US Securities and Exchange Commission (SEC)
  • US Commodities Futures Trading Commission (CFTC)
  • UK Financial Service Authority (FSA)
  • Japanese Financial Service Agency (JFSA)

ii) Examples of Self-Regulatory Organization (SROs) include, but are not limited to:

  • US NYSE
  • US FINRA
  • Swiss VQF 

How to install the TWS API Components on Mac / Unix

NOTE: If you have already agreed to the API License Agreement please start at Step 3 below.

Instructions

  1. Click directly on the button below to access the API software download page. 
  2. This will direct you to Interactive Brokers API License Agreement, please review it.
  3. Once you have clicked "I Agree", refer to the Mac / Unix section to download the API Software for your o.s.
    API Software Download List
  1. This will download twsapi_macunix.n.m.zip to your computer.
    (where n and m are the major and minor version numbers respectively)
  2. Open Terminal (Ctrl+Alt+T on most distributions)
    (On Mac press Command+Space to launch Spotlight, then type terminal and press Return)
  3. Navigate to the directory where the installer has been downloaded (normally it should be the Download folder within your home folder) and confirm the file is present.

     $  cd ~/Downloads
     $  ls

  1. Unzip the contents the installer into your home folder with the following command (if prompted, enter your password):
    $  sudo unzip twsapi_macunix.n.m.zip -d $HOME/
    Installation directions Step 3 and Step 4
  2. To access the sample and source files, navigate to the IBJts directory and confirm the subfolders samples and source are present.
    $  cd ~/IBJts
    $  ls
    Installation directions Step 5
 

 

Legacy Instructions - API Version ≤ 9.71

Note: IB only offers API Version 9.72+. In the event you already have an existing legacy version and need to install it, please refer to the directions below:

  1. locate the file twsapi_macunix.n.m.jar on your computer.
    (where n and m are the major and minor version numbers respectively.)
  2. Open Terminal (Ctrl+Alt+T on most distributions)
    (On Mac press Command+Space to launch Spotlight, then type terminal and press Return)
  3. Navigate to the directory where the .jar file has been located (normally it should be the Download folder within your home folder) and confirm it is present.
    cd ~/Downloads
    $  ls
  4. Extract the contents of the .jar file into your home folder.
    $  jar xf twsapi_macunix.n.m.jar -d $ HOME/
  5. To access the sample and source files, navigate to the IBJts directory and confirm the subfolders samples and source are present.
    $  cd ~/IBJts
    $  ls
 
 

Additional Information 

You can as well refer to KB2222 for video instructions on installing the Legacy API Components on a Mac.

 

How to restore TWS settings from external storage

Overview: 

This article outlines the procedure for restoring TWS settings from an external location, example external hard drive, USB or other file location.

To restore TWS settings from an external source:

1. Log into TWS

2. Click on File and select Settings Recovery

Menu: File -> Settings Recovery                                     

3. Select Custom and click on Ok

Settings Recovery options                                                                                                                    

4. In the Look in field click on the drop down menu and select the directory where the TWS settings file is stored, example; If the file was located on the Desktop you would scroll to Desktop as shown below                                     Choose settings file location                                                              

5. Once you are in the directory containing the settings file,  select the settings file, example tws.xml and click on Open.

Enter settings filename

6.  In the Open settings confirmation window select Open without reporting problem

settings confirmation

 

See KB3146 for instructions on overcoming the "Downloading settings from server failed" error

See KB2320 for instructions on transferring settings from one user to another

See KB2282 for instructions on how to transfer settings from one computer to another

 

 

 

 

Syndicate content