Enhanced Quote Service EQS Setup and Troubleshooting Guide Revision

Document Sample
Enhanced Quote Service EQS Setup and Troubleshooting Guide Revision Powered By Docstoc
					Enhanced Quote Service (EQS)
Setup and Troubleshooting Guide

Revision 1.01
7/18/2007
Table of Contents


Nexa Technologies Enhanced Quote Service (EQS) .................................................................3
Overview ....................................................................................................................................3
System Requirements ................................................................................................................3
Connection IP/Ports....................................................................................................................3
Application Installation Paths/Log Files ......................................................................................4
Improvements and Changes.......................................................................................................5
Nexa Technologies Network Driver Update Information.............................................................6
How to Determine the Date of Your Network Card Driver ..........................................................8
Error Messages Users May Encounter Upon Login..................................................................11
Software Installation Tips .........................................................................................................12




Nexa Technologies, Inc.                                                                                                            Page 2 of 12
Nexa Technologies Enhanced Quote Service (EQS)
Overview
Nexa now offers a new enhanced quote service that expands the feed data capabilities for Axis based
trading platforms (AxisPro, Axis 3.0, RadiusPro, etc.). With these new products, there are a few things to
take into consideration when upgrading your client.

Along with increased system specification requirements, there are new connection addresses and ports that
will need to be opened for outbound traffic through your firewall. Also, there are new application log files
that will help us in diagnosing client problems, new software installation paths, and a couple of minor
behavioral differences between the old and new versions.

The new java based Axis products require that your network adapter be updated with the latest
manufacturer’s driver. We will cover those adapters that we’ve found to be problematic and list solutions for
getting them to work with the new application. We’ve also included a section that will help you determine the
date of the driver for your network interface. This will aid you in diagnosing whether there is a more recent
driver available for your card.

Lastly, we cover a few software installation tips and suggestions.

System Requirements
The recommended system resource requirements have increased to support the EQS. The minimum
recommended system requirements are:
Operating System: Window XP (service pack 2)
CPU: Pentium IV 1 GHz
Memory: 1 GB Ram
Video: 128 MB video

Internet Connectivity: High-speed services such as cable, DSL, and FTTP are recommended. Dial-up does
not have the speed or sufficient capacity that is required. Due to the number of simultaneous connections to
various ports with the new EQS system, Satellite connections are not able to handle the ever increasing
number of quote events efficiently enough for our application to maintain consistent connectivity to our quote
environment. For this reason, satellite connections are also not supported.

Note: It has been reported that the client application with the EQS no longer installs correctly with the
Window 98 OS. Nexa discontinued support for the Windows 98 OS shortly after Microsoft discontinued their
support for 98 a few years ago.




Connection IP/Ports
The new connection IP addresses and ports that will need to be opened up in the firewall in order to access
the new quote environment.

Outbound Traffic (from Client PC to Axis Servers):
Destination IP Range (Primary): 199.106.232.0/255.255.255.0
Destination IP Range (DR): 63.241.212.0/255.255.255.0
Destination TCP Port Range: 80, 443, 17185-17199




Nexa Technologies, Inc.                                                                  Page 3 of 12
If your IT staff needs specific hosts rather than the range of ports above, the following is a list of
the specific IP's and ranges required:

Primary New York Addresses:
level2.pentrader.net (199.106.232.237) TCP ports 17185 & 17186
news.pentrader.net (199.106.232.237)TCP Port 80
ttequity.nexatech.com (199.106.232.195) TCP ports 17190 – 17199
ttoption.nexatech.com (199.106.232.196) TCP ports 17190 – 17199
ttdequity.nexatech.com (199.106.232.193) TCP ports 17190 – 17199
ttdoption.nexatech.com (199.106.232.194) TCP ports 17190 – 17199
ttbook.nexatech.com (199.106.232.197) TCP ports 17190 – 17199
ttjms1.nexatech.com (199.106.232.159) TCP port 443
ttjms2.nexatech.com (199.106.232.161) TCP port 443
ttjms3.nexatech.com (199.106.232.162) port 443
ttbarjms.nexatech.com (199.106.232.17) TCP port 443
tttrading.nexatech.com (199.106.232.250) TCP port 443
ttdownload.nexatech.com (199.106.232.252) TCP port 80

Allen, TX Disaster Recovery Addresses:
apequity.nexatech.com (63.241.212.229) TCP ports 17190 – 17199
apoption.nexatech.com (63.241.212.230) TCP ports 17190 – 17199
apdequity.nexatech.com (63.241.212.231) TCP ports 17190 – 17199
apdoption.nexatech.com (63.241.212.232) TCP ports 17190 – 17199
apbook.nexatech.com (63.241.212.233) TCP ports 17190 – 17199
apjms1.nexatech.com (63.241.212.173) TCP port 443
apjms2.nexatech.com (63.241.212.177) TCP port 443
apjms3.nexatech.com (63.241.212.183) TCP port 443
aptrading.nexatech.com (63.241.212.178) TCP port 443
apdownload.nexatech.com (63.241.212.175) TCP port 80




Application Installation Paths/Log Files
The application will now be installed across two separate locations.

The default path will still remain as follows:
C:\Program Files\AxisPro\

The new location will contain the Java Runtime Environment and new log files, and is located in your
network, or local, profile folder under Documents and Settings.

An example of the installation path:
C:\Documents and Settings\jsmith\AxisPro\

There will be times when we will request that you have your client submit their log file to us for trouble-
shooting purposes. The naming convention of the file will read something like this:

For the current day’s log: bridge.log
For historical log files: bridge.log.2007-5-3




Nexa Technologies, Inc.                                                                      Page 4 of 12
Improvements and Changes
There are quite a few improvements to the Axis applications on the new EQS, including:
       Improved Options Quotes
       Full Option Chain Symbol List
       Improved Option Montage Quote Speed
       More Accurate Montage
       New Options Charting
       New Overlay of Options Symbols on Equity Charts
       Create Studies with Option Information
       Improved Equity Quotes:
       Improved Level 2 Quote Speed
       More Accurate Level 2
       Improved Account Quotes
       Improved Quote Speed for Real-Time P&L
       New Top Ten by Exchange
       The close price is now reset at 7:00 pm EST instead of about midnight EST and as a result the
        close amount and percent values are reset to zero earlier on the client application.
       The INET book box no longer displays print data.




Nexa Technologies, Inc.                                                              Page 5 of 12
Nexa Technologies Network Driver Update Information
If quotes and option chains are not updating in your application, or you are experiencing unusual
disconnection issues, then you may have a network card and/or driver that is known to have issues with our
software. You should check the manufacturer's website for driver updates. In many cases, network card
manufacturers use chips created by another company. Sometimes it is necessary to install that company’s
driver software instead.

Netgear FA311/FA312 Series Cards
Try the 1.80 version of the drivers from Netgear's Website. If you have an FA311 card and the 1.80 drivers
don't solve the issue, you may wish to try the 1.30 drivers, available from Netgear's FTP site.

Netgear GA311 Gigabit Adapter
We’ve seen this card fail in our lab. The drivers that Netgear included in the box (driver date: 10/9/2003)
were too old to fix the problem. The Netgear GA311 has a RTL8169S chip on board. The manufacturer of
that chip has new driver for it, available from Realtek’s Site. On our lab machine, this driver fixed the
problems.

Linksys LNE100TX v4 or v5, and Linksys NC100
We’ve seen the LNE100TX card fail in our lab. The Linksys LNE100TX and the Linksys NC100 has an
AN983B chip on board. The manufacturer of that chip has a new driver for it, available from
ADMTek/Infineon’s Site . On our lab machine, this new driver from the chip manufacturer fixed the problems.

These drivers from the chipset manufacturer are Microsoft certified. The drivers have corrected issues with
these cards such as disconnects, latency, and even some crashes.
How to install drivers from ADMTek/Infineon:
    1. Download the drivers from the Infineon web site.
    2. Click Start.
    3. Click Control Panel. If there is an option in the upper left to 'Switch to classic view', then do so.
    4. Click System.
    5. Click the Hardware tab, and then click the Device Manager button near the middle.
    6. Expand the Network Adapters category and locate your device.
    7. Right-click your Network Card and go to Update Drivers.
    8. Follow the Wizard until you see What do you want the Wizard to do? Click on Install from a list or
         specified location then click Next.
    9. Click Don't search. I will choose the driver to install. and click Next.
    10. Click on Have Disk..., then browse to where you unpack/unzipped the drivers.
    11. Click Open, then click Next and let the Wizard finish the driver installation.




Nexa Technologies, Inc.                                                                  Page 6 of 12
D-Link DFE-530TX+
Nexa has tested the D-Link DFE-530TX+ and found that the software operated properly with the drivers that
D-Link included in the box. (driver date: 7/17/2005)
However, if you experience problems, the D-Link DFE-530TX+ has an AN983B chip on board. The
manufacturer of that chip has new driver for it, available from ADMTek/Infineon’s Site
These drivers from the chipset manufacturer are Microsoft certified. The drivers have corrected issues with
these cards such as disconnects, latency, and even some crashes.
Nvidia nForce Networking Controller

We’ve seen this integrated network controller fail, but we found that we could solve the issues by changing a
control panel setting for its driver. When we set the driver property “Checksum Offload” to “Disable”, this
solved the problem.
How to set the driver properties:
Open up Control Panel. If there is an option in the upper left to 'Switch to classic view', then do so.
Click System.
Click the Hardware tab, and then click the Device Manager button near the middle.
Expand the Network Adapters category and locate your device.
Right-click your Network Card and select Properties.
Select the Advanced tab.
Under Property, select Checksum Offload and then select Disable from the drop-down menu under Value.
Click OK to close the Properties window


Marvell Yukon 88E805X PCI Express Gigabit, and Marvell 88E803X Fast Ethernet
(We HIGHLY recommended that you use a different card)

We’ve seen Marvell Yukon integrated network controllers fail in our lab. Installing the most recent drivers
from Marvell’s Site greatly improves the performance of this network card.


Realtek RTL8139 Family PCI Fast Ethernet NIC and
Users experiencing problems running the application with this card should update the driver to version 671,
or later. The driver can be found at the manufacturer’s website here Realtek Website.


Realtek RTL8168/8111 PCI-E Gigabit Ethernet NIC
Users experiencing problems running the application with this card should update the driver to version 670,
or later. This driver can be found at the manufacturer’s website here Realtek Website.




Nexa Technologies, Inc.                                                                  Page 7 of 12
How to Determine the Date of Your Network Card Driver
As the technology that fuels the new EQS applications is constantly being updated, it is important
to make sure that the hardware on your PC has the most current driver set installed to ensure
compatibility and stability. Your network adapter is the most important component, as this is the
device that handles the streaming data between your PC and our network. This section will show
you how to check the date of your driver, so that you can compare your version with what the
manufacturer has available as the most current.


Open up Control Panel. If there is an option in the upper left to 'Switch to classic view', then do so.
Double-click on Network Connections.




Right-click on ‘Local Area Connection’ and select Properties.




Nexa Technologies, Inc.                                                                     Page 8 of 12
Nexa Technologies, Inc.   Page 9 of 12
Click ‘Properties’ under the General tab in the Local Area Connection Status window.
Now select Configure to open the network adapter properties window.




From the Controller Properties window, select the Driver tab.
Note the Driver Provider, Date, and Version.




Nexa Technologies, Inc.                                                                Page 10 of 12
Error Messages Users May Encounter Upon Login
Nexa Transport: Invalid Config (production/demo)
Problem: The Config URL is pointing to the production quote environment, while the Network and/or
RadiusPro addresses are pointing to the demo environment.




Solution: Change the Network and/or RadiusPro addresses to point to production (level2.pentrader.net and
broker.pentrader.net, respectively).

Nexa Transport: Invalid Config (demo/production)
Problem: The Config URL is pointing to the demo quote environment, while the Network and/or RadiusPro
addresses are pointing to the production environment.




Solution: Change the Network and/or RadiusPro addresses to point to the demo environment
(demo.nexadirect.com for both entries).


Nexa Transport Error (user.authentication.failed)
Problem: The java client libraries could not authenticate with the server.

Solution: Contact Nexa support to further troubleshoot.

Server Info Lookup Failed (404)
Problem: Problem retrieving an XML configuration file that is required to login. This could possibly indicate
a server being unavailable.

Solution: Contact Nexa support.




Nexa Technologies, Inc.                                                                 Page 11 of 12
Software Installation Tips
The new application contains java components that will update frequently. This will be noticeable during the
login process.

After upgrading through the software update process, you will notice that there are a few additional files that
require downloading. This process is normal and will take a few minutes the first time through. (Note: If you
are installing the software from the download off of the website, you will need to run the setup file twice. The
first time will remove the old application, while the second attempt will install the new version)

If you encounter problems completing the installation process, especially during the first login, then you will
need to make sure that you have added the new IP addresses and Ports from the prior section of this
document into your firewall. Whilst shutting down your firewall during the installation process will enable
completion of this process, improper firewall configuration will further hamper proper operation of the new
program.


As always, if you have any questions regarding the new software, please contact Nexa support.




Nexa Technologies, Inc.                                                                   Page 12 of 12