GlbalFIX Release Bulletin Versin 6.0
Financial Fusin and Financial Fusin Server are trademarks f Financial Fusin, Inc. Sybase and Sybase Central are trademarks f Sybase, Inc. indicates registratin in the United States f America WebLgic is a trademark f BEA Systems, Inc. Oracle is a trademark f Oracle Crpratin. SPARC is a trademark f SPARC Internatinal, Inc. Windws 2003 is a registered trademark f Micrsft Crpratin. HP and HP-UX are registered trademarks f Hewlitt-Packard Develpment Cmpany. Slaris, Java, and all Java-based marks are trademarks r registered trademarks f Sun Micrsystems, Inc. in the U.S. and ther cuntries. All ther cmpany and prduct names mentined may be trademarks, registered trademarks, service marks, r trade names f their respective cmpanies. Cpyright 2006 Financial Fusin, Inc. All rights reserved. This wrk may nt be reprduced, in whle r in part, in any way r by any means, electrnic r mechanical, including phtcpying, recrding r thrugh strage and retrieval mechanisms, withut prir written cnsent f Financial Fusin, Inc. Financial Fusin, Inc. 561 Virginia Rad Cncrd, MA 01742 USA
Table f Cntents 1. Accessing current release bulletin infrmatin... 1 2. Prduct summary... 1 3. Special installatin instructins... 2 4. New and changed functinality in this versin... 3 5. Knwn prblems... 4 6. Fixed prblems... 8 7. Prduct cmpatibilities... 8 8. Dcumentatin updates and clarificatins... 8 9. Technical supprt... 10
1. Accessing current release bulletin infrmatin A mre recent versin f this release bulletin may be available frm Prduct Supprt. Please refer t Technical Supprt r yur License Agreement fr details n cntacting custmer supprt. Please refer t the prduct readme file fr any last-minute changes r imprtant infrmatin that may affect installatin r use f the prduct. 2. Prduct summary Enclsed is Financial Fusin TradeFrce Suite GlbalFIX and GlbalFIX Lite. Please refer t the GlbalFIX Feature Guide fr details n cmpnents and features f versin 6.0 f GlbalFIX and GlbalFIX Lite. Hardware and sftware requirements Operating system: Windws 2003, Windws XP Prfessinal, Slaris 9, Slaris 10, r HP-UX 11i. Minimum memry (RAM): GlbalFIX (512 MB) Message Brker (256 MB) Universal Alerts Engine (10 MB) Minimum disk space (typical installatin): GlbalFIX (400 MB) Message Brker (25 MB) Universal Alerts Engine (10 MB) Applicatin server: WebLgic 8.1 (SP 5), Enterprise Applicatin Server (EAServer) 5.0, r EAServer 5.5. JRE: Sun Java Run-time Envirnment (JRE) 1.4.2 Database server: Adaptive Server Anywhere (ASA) 9 (with jcnnect 5.5), Adaptive Server Enterprise (ASE) 12.5.3, r Oracle Database Server 9.2.0.1.0. 1
3. Special installatin instructins Please refer t the GlbalFIX Installatin and Cnfiguratin Guide fr detailed installatin instructins. Please refer t the prduct readme file fr any last-minute changes r imprtant infrmatin that may affect installatin r use f the prduct. Installatin CD directry structure The directry structure fr the GlbalFIX 6.0 installatin CD cnsists f: This release bulletin, which prvides any last-minute changes r imprtant infrmatin that may affect installatin r use f the prduct. Third-party license agreement. Stipulates the cnditins under which third-party licenses are granted. /dcs. Cntains: GlbalFIX Installatin and Cnfiguratin Guide GlbalFIX Develper's Guide and API Reference GlbalFIX Feature Guide GlbalFIX Quick Start Guide Message Brker Develper s Guide and API Reference Message Brker Installatin and Cnfiguratin Guide Universal Alerts Engine Develper s Guide and API Reference Universal Alerts Engine Feature Guide /install. Cntains the GlbalFIX and GlbalFIX Lite installatin prgrams. The installatin requires a valid license key. Installatin ntes GlbalFIX: 1. The JMS Adapter is supprted n the Windws and Slaris platfrms nly. GlbalFIX Lite: 1. Befre running the GlbalFIX Lite Server, set FFSINSTALLDIR as a glbal envirnment variable pinting t the GlbalFIX Lite installatin lcatin. 2. Befre cmpiling any GlbalFIX Lite Java prgram, make sure JDK 1.4.2 is installed and FFSJDKDIR is set as a glbal envirnment variable pinting t the JDK 1.4.2 installatin lcatin. 2
3. When deplying a bean int JBss using the build.bat (fr Windws) r build.sh (fr Slaris) utility, use: %FFSINSTALLDIR%\FIX\bin\build.bat (Fr Windws) $FFSINSTALLDIR/FIX/bin/build.sh (Fr Slaris) Example: Deplying a custmized FIX41CallbackBean (Fr Windws) Cpy the custmized FIX41CallbackBean Java prgram t %FFSINSTALLDIR%\FIX\api\cm\ffusin\msgbrker\generated\MessageBrke r\api\fix41\callback. Add all libraries required by the custmized FIX41CallbackBean t MYCLASSPATH f build.bat. Frm the cmmand line, navigate t the %FFSINSTALLDIR%\FIX\bin directry and execute: build.bat FIX41 Callback Example: Deplying a custmized FIX41CallbackBean (Fr Slaris) i. Cpy the custmized FIX41CallbackBean Java prgram t $FFSINSTALLDIR/FIX/api/cm/ffusin/msgbrker/generated/MessageBrker /api/fix41/callback. ii. Add all libraries required by the custmized FIX41CallbackBean t MYCLASSPATH f build.sh. iii. Frm the cmmand line, navigate t the $FFSINSTALLDIR/FIX/bin directry and execute: build.sh FIX41 Callback 4. New and changed functinality in this versin GlbalFIX 6.0 prvides the fllwing new features and enhancements: Reprting: The new reprting server (GRS server) enables users t generate business and peratinal reprts. Operatinal reprts prvide FIX administratrs with infrmatin n the number f messages GlbalFIX is prcessing at the server and sessin levels. Business reprts prvide business users r sales managers verview status n the rders (buy, sell, rejected, and s n) prcessed thrugh the gateway. Supprt fr Chinese Securities Trading Exchange Prtcls (STEP) 1.0: GlbalFIX 6.0 supprts the new STEP prtcl thrugh message frmat changes and sessin-level mdificatins. 3
Clustering Enhancements: In previus versins, GlbalFIX clusters nly recnnected sessins in fail-ver situatins when the cnnectin was initiated by a cunter party. In versin 6.0, GlbalFIX als recnnects sessins fr which it (GlbalFIX) initiated the cnnectin. In additin, fail-ver time has been reduced frm previus versins. Universal Alerts Engine Integratin: GlbalFIX 6.0 features tighter integratin with the Universal Alerts Engine (UAE), enabling yu t: Administer the UAE cluster frm the GlbalFIX user interface Schedule autmatic end-f-day (EOD) prcessing fr sessins Send e-mail alerts t ntify users f events such as: Sessin discnnectin/recnnectin EOD prcessing cmpletin JMS Adapter errrs JMS Adapter: GlbalFIX 6.0 intrduces the JMS Adapter as the new standard message adapter, replacing the existing MQ adapters. User Interface Cleanup and Enhancements: The user interface (UI) n lnger requires the use f ppup dialgs and multiple panes fr setting prperties. Instead, the UI uses a tree hierarchy t display a list f prperties n the left side f the screen. When yu select a prperty in the tree, yu can set attributes fr the prperty n the right side f the screen. In additin, the UI nw enables yu t filter and search the audit and message lg views. 5. Knwn prblems The fllwing issues are knwn t exist within GlbalFIX and GlbalFIX Lite. Where applicable, issue descriptins cntain infrmatin n wrkarunds. Fr the mst up-t-date list f knwn issues, cnsult the readme file packaged with GlbalFIX and GlbalFIX Lite. GlbalFIX: 1. WebLgic ships with a previus versin f the Sybase jcnnect database driver. GlbalFIX 6.0 includes up-t-date jcnnect drivers. T avid a memry leak when using the WebLgic applicatin server, update the start scripts t have the latest jcnnect drivers ccur befre the WebLgic cmpnents in the Java classpath. 4
T update the start scripts n Windws, shut dwn yur GlbalFIX servers and perfrm the fllwing: i. Update %FFSINSTALLDIR%\FIX\bin\startweblgicfix.cmd, by changing the line set CLASSPATH=.;%wl_cp%;%mb_cp%;%fix_cp%;%fixcallback_cp%;%jcnnect%;%uae% t set CLASSPATH=.;%jcnnect%;%wl_cp%;%mb_cp%;%fix_cp%;%fixcallback_cp%;%uae% ii. Update bth %FFSINSTALLDIR%\FIXDem\bin\startWebLgicfixDemBuy.cmd and %FFSINSTALLDIR%\FIXDem\bin\startWebLgicfixDemSell.cmd by changing the line set CLASSPATH=.;%wl_cp%;%mb_cp%;%fix_cp%;%fixcallback_cp%;%fixsend_cp%; %jcnnect%;%uae_cp% t set CLASSPATH=.;%jcnnect%;%wl_cp%;%mb_cp%;%fix_cp%;%fixcallback_cp%; %fixsend_cp%;%uae_cp% iii. After updating the start scripts, restart yur GlbalFIX servers. T update the start scripts n Slaris/HP-UX, shut dwn yur GlbalFIX servers and perfrm the fllwing: i. Update $FFSINSTALLDIR/FIX/bin/startWebLgicfix.sh by changing the line CLASSPATH=$fix:$mb:$weblgic:$fixcallback:$jcnnect::$UAECLASSPATH t CLASSPATH=$fix:$mb:$jcnnect:$weblgic:$fixcallback::$UAECLASSPATH ii. Update $FFINSTALLDIR/FIXDem/bin/startWebLgicfix.sh by changing the line CLASSPATH=$fix:$mb:$weblgic:$fixcallback:$fixsend:$jcnnect:$uae t CLASSPATH=$fix:$mb:$jcnnect:$weblgic:$fixcallback:$fixsend:$uae iii. After updating the start scripts, restart yur GlbalFIX servers. 5
2. Knwn issue with a C++ client cnnecting t the GlbalFIX EJBs. Wrkarund: Use the C++ lightweight API (LWAPI), which is supprted n multiple applicatin servers. Fr mre infrmatin n C++ cnnectivity t EJB, cntact the Sybase EAServer supprt team. 3. The DetailedMsgView DBAccess APIs d nt wrk if the GlbalFIX server is cnfigured t use file-based lgging. 4. Due t the enumeratin member name changes in the FIX40-44 message sets, cmplete the fllwing if yu want t wrk with previus releases f GlbalFIX: i. T upgrade the FIX40-44 message sets in the MBFFS database, redeply the FIX40-44 message sets using: %FFSINSTALLDIR%\FIX\xmls\FIX4X.xml (Fr Windws) $FFSINSTALLDIR/FIX/xmls/FIX4X.xml (Fr Slaris) ii. Update the FIX4X sending client prgrams. If the client prgram refers t the enumeratin members by name, sme changes are required. If the client prgram accesses the enumeratin members by their value r index, then n change is needed. Using the FIX43 "Side" enumeratin as an example, n change is required if the prgram calls EnumSide enuminstance = EnumSide.frm_int( ValueSetSide.getIndex( "1" ) ); If the prgram calls EnumSide enuminstance = EnumSide.Buy;, change EnumSide.Buy t EnumSide.Sid_Buy. 5. The FIXDem SendOrder sample will nt wrk if the user has installed the AlertDiscnnect sample int the FIXDem Servers. Wrkarund: Uninstall the AlertDiscnnect sample by running the uninstall script lcated at $FFSINSTALLDIR/FIXDem/samples/AlertDiscnnect. Restart the FIX Dem Applicatin Servers. 6. The Reuters Exchange Mnemnics listed in Appendix C f the FIX 4.0 and 4.1 Prtcl specificatins have naming cllisins (fr example: Swiss Optins and Financial Futures Exchange and Zurich Stck Exchange bth use 'Z'). The GlbalFIX Server cannt crrectly deduce the crrect exchange fr these cllisins and defaults t interpreting the mnemnic as representative f the exchange which appears later in the list. 7. Fr a sessin with Aut Recnnect enabled, the GlbalFIX server reprts that it is attempting t recnnect befre it actually tries t recnnect. 8. Deleting a sessin des nt delete the message lg data fr that sessin. As a result, message lg data can be retrieved fr a sessin that des nt exist. Als, if a sessin with message lg data is deleted and is then recreated, the ld message lg data is assciated with the recreated sessin. 6
Because f this issue, the DetailedMsgView sample fails if message lg data exists fr a deleted sessin. Wrkarund: Perfrm an end-f-day peratin n the sessin prir t deleting it. 9. When using the C++ LW API, if the GlbalFIX server discnnects an LW Cnnectin because the LW Cnnectin timeut has been reached, the client culd enter an infinite lp at 100% CPU utilizatin. Wrkarund: Disable the LW API timeut by setting the value t zer in the GlbalFIX Server cnfiguratin. 10. An issue n HP-UX PA-RISC causes the FIX Server t crash when using EAServer 5.0. Wrkarund: Navigate t the $JAGUAR/Repsitry/Server directry (fr example, /sybase/easerver/repsitry/server) and add the fllwing prperty t the FIXServer.prps file: cm.sybase.jaguar.server.jvm14.ptins=-xx:+allwusersignalhandlers GlbalFIX Lite: When yu have updated the prperties file, restart the FIX server. 1. A suspected memry leak in WebLgic n Slaris causes increased memry usage ver time until all memry is cnsumed. This issue is currently under investigatin. 2. The Sessin Refresh menu item in the Financial Fusin Management Cnsle des nt refresh the sessin in the GlbalFIX Lite server's memry. Wrkarund: Use the AdminCmmand sample t refresh the sessin. 3. The DetailedMsgView feature des nt wrk if the server is cnfigured t use file-based lgging. 4. Due t the message definitin changes frm FIX4.2 t FIX4.2Errata, in cnjunctin with the Message Brker lgn message structure change in the FIX4.2Errata message set, the fllwing message types are nt supprted fr the lgn message: 372 RefMsgType 384 NMsgTypes 385 MsgDirectin Additinally, when cnnecting sessins cnfigured with the FIX4.2Errata prtcl, a NSuchFieldExceptin exceptin will be thrwn twice. These exceptins can be ignred. 7
5. The Reuters Exchange Mnemnics listed in Appendix C f the FIX 4.0 and 4.1 Prtcl specificatin have naming cllisins (fr example, Swiss Optins and Financial Futures Exchange and Zurich Stck Exchange bth use 'Z'). The GlbalFIX Lite Server cannt crrectly deduce the crrect exchange fr these cllisins and defaults t interpreting the mnemnic as representative f the exchange which appears later in the list. 6. Fixed prblems Nt applicable. This is a new release f GlbalFIX. 7. Prduct cmpatibilities There are n knwn prduct cmpatibility issues. See Prduct Summary fr details n hardware and sftware prerequisites fr this prduct. 8. Dcumentatin updates and clarificatins At the time f release, the infrmatin presented here is the mst up-t-date and supersedes infrmatin presented in the identified dcuments. Please cntact Custmer Supprt t determine whether any subsequent dcument updates have been made. Please refer t Technical Supprt r yur License Agreement fr details n cntacting custmer supprt. GlbalFIX Installatin and Cnfiguratin Guide The GlbalFIX Installatin and Cnfiguratin Guide requires the fllwing changes: Chapter 5: Cnfiguring GlbalFIX Databases The intrductry paragraph in the sectin Creating the FIX and Message Brker Databases fr Oracle Installing the databases Pst-installatin (page 5-16) shuld als include: Furthermre, if yu have installed GlbalFIX and Oracle under separate users, set LD_LIBRARY_PATH=$ORACLE_HOME/lib fr yur GlbalFIX user and build yur MBFFS database while lgged in t yur GlbalFIX user accunt. Step 3 f the sectin Creating the FIX and Message Brker Databases fr Oracle Installing the databases Pst-installatin (page 5-17) shuld read: 3. Ensure the Oracle 8.1.7 JDBC driver (classes12.zip) resides in MB60ORACLEDIR\jdbc\lib. 8
Chapter 10: The GlbalFIX Reprting System Server The fllwing nte fund n pages 10-4, 10-10, and 10-13 shuld read Fr the GRS server t cnnect t the CF database, use the acrnym frm f the database name (fr example, ASE, ORACLE:thin) as the dbtype value. instead f Fr the GRS server t cnnect t the CF database, use the acrnym frm f the database name (fr example, ASE, ORA) as the dbtype value. The fllwing nte shuld fllw step 2b in the sectin Enabling the GlbalFIX Reprt Manager Web Applicatin Enabling the Web Applicatin n EAServer (page 10-9): If yu are using an Oracle database, add %ORACLE_HOME%\jdbc\lib\classes12.zip and %ORACLE_HOME%\jdbc\lib\nls_charset12.zip t yur %CLASSPATH% and %BOOTCLASSPATH% (Windws) r $ORACLE_HOME/jdbc/lib/classes12.zip and $ORACLE_HOME/jdbc/lib/nls_charset12.zip t yur $CLASSPATH and $BOOTCLASSPATH (Unix). The fllwing nte shuld fllw step 2b in the sectin Enabling the GlbalFIX Reprt Manager Web Applicatin Enabling the Web Applicatin n EAServer (page 10-9): If yu are using an Oracle database, add %ORACLE_HOME%\jdbc\lib\classes12.zip and %ORACLE_HOME%\jdbc\lib\nls_charset12.zip t yur %CLASSPATH% and %BOOTCLASSPATH% (Windws) r $ORACLE_HOME/jdbc/lib/classes12.zip and $ORACLE_HOME/jdbc/lib/nls_charset12.zip t yur $CLASSPATH and $BOOTCLASSPATH (Unix). The fllwing nte shuld fllw step 1a in the sectin Enabling the Web Applicatin n WebLgic (page 10-11): In rder fr the Web applicatin t functin prperly, edit the cnfig.xml file fr the administratin server and set the value fr the prperty HstnameVerificatinIgnred t true. Step 3e in the sectin Enabling the Web Applicatin n WebLgic (page 10-12) shuld als say: If yu are using EAServer, cpy the jcnn2.jar file frm the %FFSJCONNECTDIR%\classes directry t the GFIX6GRS\WEB-INF\lib directry. If yu are using Oracle, cpy classes12.zip and nls_charset12.zip frm $ORACLE_HOME/jdbc/lib t GFIX6GRS/WEB-INF/lib rather than jcnn2.jar. Step 3f in the sectin Enabling the Web Applicatin n WebLgic (page 10-12) shuld read: Mve the reprting.xml file frm the GFIX6GRS\WEB-INF\lib directry t the GFIX6GRS\WEB-INF\classes directry. 9
9. Technical supprt Each Financial Fusin installatin that has purchased a supprt cntract has ne r mre designated peple wh are authrized t cntact Financial Fusin Technical Supprt. If yu have any questins abut this installatin r if yu need assistance during the installatin prcess, ask the designated persn t cntact Financial Fusin Technical Supprt r the Sybase subsidiary in yur area. 10