ClearingWorkstation(CW1) InstallationGuide - NASDAQ · 2016. 7. 13. · The CW1 kit program performs the following actions: • Creates the directory structure under Program Files

Genium INET®

Clearing Workstation (CW1)Installation GuideNasdaq Nordic

Version: 4.1.0201

CW1_IG_6Document ID:

GENIUM_Product_a1860Documentation Release:

2016-05-24Release Date:

2016-05-24Publication Date:

Genium, INET, ITCH, CONDICO, and TradeGuard are registered trademarks of Nasdaq, Inc. X-streamTrading, OUCH, ICS-II, SWIFT Gateway, Genium Market Info (GMI), Appmind, PRM, PTRM, MiQ,SMARTS, X-stream CSD, Genium Risk Manager (GRM), TIP, CLICK, CLICK XT, and SECUR aretrademarks of Nasdaq, Inc.

Whilst all reasonable care has been taken to ensure that the details are true and not misleading at the timeof publication, no liability whatsoever is assumed by Nasdaq, Inc., or any subsidiary of Nasdaq, Inc., withrespect to the accuracy or any use of the information provided herein. Any license, delivery and support ofsoftware systems etc. require entering into separate agreements with Nasdaq, Inc. This document containsconfidential information and may not be modified or reproduced, in whole or in part, or transmitted in anyform to any third party, without the written approval from Nasdaq, Inc.

Copyright © 2016 Nasdaq, Inc. All rights reserved.

Table of Contents1 Summary of Changes ..............................................................52 About this Manual ...................................................................7

2.1 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

3 General Features ....................................................................93.1 Application Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

3.2 Kit and Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93.2.1 CW1 Server Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93.2.2 CW1 Client Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103.2.3 TCP/IP Address Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103.2.4 Folder Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103.2.5 Registry Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

4 Installation and Configuration .................................................134.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

4.1.1 SW Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134.1.2 Installation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134.1.3 Settings for New Installations and Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . .144.1.4 Previous Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144.1.5 Preparing the CW1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154.1.6 Preparing the CW1 Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164.1.7 Stopping the CW1 Server and CW1 Watchdog . . . . . . . . . . . . . . . . . . . . . . .16

4.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174.2.1 Installing the CW1 Server and CW1 Client . . . . . . . . . . . . . . . . . . . . . . . . . . . .174.2.2 Creating a Database and an ODBC Connection Manually . . . . . . . . . . .33

5 After Installation ....................................................................395.1 CW1 Server Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39

5.1.1 CW1 Watchdog Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .395.1.2 Viewing Startup Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .395.1.3 Changing OMnet Server Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39

5.2 CW1 Client Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405.2.1 Client Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405.2.2 Viewing Instance # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405.2.3 Testing Logging On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405.2.4 Analyzing and Reporting Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

5.3 New CW1 Client Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .425.3.1 Adding New CW1 Application Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

5.4 Database Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .425.4.1 Refreshing the CW1 Server via CW1 Client . . . . . . . . . . . . . . . . . . . . . . . . . . .425.4.2 Refreshing the CW1 Database via AM Commands . . . . . . . . . . . . . . . . . . .445.4.3 About Housekeeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .465.4.4 Renewing the Database Completely . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

© Nasdaq, Inc. • 2016 3(48)

Table of Contents

5.4.5 Shrinking the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

List of FiguresFigure 1: Existing Installed Instances Detected Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Figure 2: Unable to Launch Database Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

Figure 3: Config Driver Failed Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

Figure 4: Participant Interface Application Splash Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

Figure 5: Login Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

4(48) © Nasdaq, Inc. • 2016

Clearing Workstation (CW1) Installation Guide

1 Summary of ChangesChanges between this version and version a1799 (4.0.0270).

CommentChangesNo

Published with new code track on front page.1

© Nasdaq, Inc. • 2016 5(48)

Summary of Changes

6(48) © Nasdaq, Inc. • 2016


2 About this ManualThis document describes how to manage the installation and related actions of all the components of theGenium INET Clearing Workstation 1.

2.1 ReferencesFor more information, please refer to the following document:

• Clearing Workstation (CW1) User's Guide

© Nasdaq, Inc. • 2016 7(48)

About this Manual

8(48) © Nasdaq, Inc. • 2016


3 General FeaturesThe Clearing Workstation 1 is part of Genium INET Clearing and is used by the members of the clearingorganization.

3.1 Application ComponentsThe Clearing Workstation 1 application includes a set of software components for handling the members’interaction with the Genium INET Clearing, and for downloading clearing information to the member site.

It consists of the following parts:

• Clearing CW1 server

Runs in the background all day as a service on Windows’ operating system. It is connected to OMnetand exchanges clearing information which the central Genium INET Clearing.

• Clearing CW1 Watchdog

Runs in the background and controls start and restart of the CW1 server. If the CW1 server stops, theCW1 Watchdog restarts it immediately.

• Microsoft SQL Server

Stores customer specific data.

• CW1 Client

Has a graphical user interface and displays data stored in the database to the user. It provides windowsfor the user to enter data to be sent to the Genium INET Clearing. Many CW1 clients within the samemember can use the same CW1 server and the same database.

3.2 Kit and Structure

3.2.1 CW1 Server KitThe Genium INET CW1 server will be installed as a service with no automatic start. To keep the CW1server alive at all times, a CW1 Watchdog will be installed at the same time as the CW1 server. The CW1Watchdog will be installed as a service with automatic startup.

The CW1 server kit program performs the following actions:

• Creates the directory structure under Program Files.

• Installs the CW1 server executable files and DLLs.

• Inserts CW1 server configuration data into the Registry.

• Creates an MS SQL Database.

• Creates an ODBC system data-source name, DSN pointing to the database.

• Registers the cw1_srv program as a service with no automatic start.

• Registers the cw1_wtchdg program as a service with automatic start.

© Nasdaq, Inc. • 2016 9(48)

General Features

• Adds an icon in the start menu: Start, All Programs, NASDAQ, Genium INET Clearing

3.2.2 CW1 Client KitThe CW1 kit program performs the following actions:

• Creates the directory structure under Program Files.

• Installs the CW1 Client executable files and DLLs.

• Inserts CW1 Client configuration data into the Registry.

• Adds an icon in the start menu: Start, Programs, NASDAQ, Genium INET Clearing, ClearingWorkstation 1 for <Application Title>.

3.2.3 TCP/IP Address ResolutionMake sure that the IP addresses and identifications of the CW1 Client and Gateway nodes are entered intothe “hosts” file located on: C:\WINNT\system32\drivers\etc.

Example 1:

195.135.166.241 localhost

3.2.4 Folder StructureThe installation program creates the following default folder structure for the CW1 files if not customizedby the user:

Windows XPThe default root folder <ROOT> isC:\Program Files\NASDAQ\Genium INET CW1Windows 7

C:\Users\Public\Nasdaq\Genium Clearing Workstation1

<ROOT>\BinaryFiles—the names of the CW1 Client, CW1 serverand CW1 Watchdog reflect the instances.

Program Files

<ROOT>\DataBase\<instance #>Database

<ROOT>\Reports\<instance #>Reports

<ROOT>\InterfaceFiles\<instance #>Interface Files

<ROOT>\LogFiles—the names of the log files reflect the instances.Log Files

Note: The folder structure above can be entirely customized.

3.2.5 Registry EntriesSome registry settings are set up in Windows Registry during the installation. Genium INET CW1 specificregistry settings are stored in:

10(48) © Nasdaq, Inc. • 2016


HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\NASDAQ\Genium INET

The parameters in the registry should not be modified. If modifications seem necessary, consult NASDAQOMX personnel.

© Nasdaq, Inc. • 2016 11(48)

General Features

12(48) © Nasdaq, Inc. • 2016


4 Installation and ConfigurationAttention! Since the CW1 server starts as soon as it is installed, we strongly recommend that theseactions take place outside trading hours because the download can affect the performance of potentialtrading applications sharing the same physical connection.

4.1 PrerequisitesThis section provides information and instructions needed before starting the installation.

4.1.1 SW Requirements• Windows Server 2008 or Windows 7

• Microsoft.Net

• MS SQL Server

• MS Visual studio 2010 Redistributable x86.

4.1.2 Installation OptionsUsing different application instances means that the installed application is opened with different installationsettings. Different instances can also be used to keep different application versions on the same computer.

A complete installation procedure must be performed to install a new instance. The instance numbers identifythese installed instances. The application instance number is included in the license key on the fourth positionas described in the installation procedure. The different installation settings are stored in different foldersin the Registry.

The application executable files are stored in the <root>\ BinaryFiles folder with names reflecting theirversion. All other application files, such as database and reports, are stored in subfolders using the instancenumber.

© Nasdaq, Inc. • 2016 13(48)

Installation and Configuration

Figure 1: Existing Installed Instances Detected Window

4.1.3 Settings for New Installations and Upgrades

New versionUpgradingSetting

A new # must be used.The old # should be used.Instance #

A different node must be used upgrad-ed to the new version.

The old node can be used only if it isupgraded to the new version.

Omnet node and Socket

A new number must be used.The old number can be used.Client IPC

A new number must be used (but thesame number as the client IPC for thecorresponding instance).

The old number can be used.Socket number

A new title must be used.The old title can be used or changed.Application title

The other settings do not depend on instance or version.

4.1.4 Previous InstallationIf the CW1 server and/or CW1 Client has been previously installed, the CW1 Watchdog and all instancesof the CW1 server must be manually stopped from the Control Panel/Services window as described below.

14(48) © Nasdaq, Inc. • 2016


Installation of a new version of the CW1 application will remove the old program files before installing thenew files. Some of the old installation settings in the Registry will remain and appear in the installationwindows, where they can be edited.

4.1.5 Preparing the CW1To prepare for CW1 server installation, perform the following steps:

1. If supervision of the CW1 server from PATROL is desired (optional), the following must apply:•

• Layered Software products PATROL Agent and AppMind must be installed on a CW1 servernode before the CW1 server is installed.

• EN/Win subsystem must be installed on a CW1 server node before the CW1 server is installedto provide integration with the supervision framework (PATROL and AppMind).

• Installing an SQL server requires that you have .NET Framework 2.0 SP2 and Windows Installer4.5 or higher installed on your computer.

• A Microsoft SQL server must be installed, either on the same computer on which you installyour CW1 server, or on a different computer.

• The following two main settings are required in order for the CW1 installation to succeed increating the database and ODBC connection:

1. Windows Authentication mode to log on to the SQL server.

2. The Account Name for the SQL Server Database Engine must be set to NTAUTHORITY\SYSTEM. If you do not, the CW1 Server installation will not be allowed tocreate the database in the installation folder for the CW1 server.

• MS Visual studio 2010 Redistributable x86 must be installed.

2. Make sure that you have the following information:

• OMnet gateway host name.

• OMnet gateway socket number/port number.

• OMnet CW1 user ID, trading code.

• OMnet user password.

• The name of your authentication domain. The same Windows Domain must be used for the CW1server as well as all connected CW1 Clients. There must also be connectivity for Windows Domainnetwork traffic between all involved nodes.

• Application license key (required, provided by the exchange).

Note: The OMnet CW1 user ID and initial password are supplied by the Exchange.

3. Log in to Windows as administrator.

4. If the CW1 server has been previously installed, stop CW1 Watchdog, and all instances of the CW1server from the Control Panel/Services window.

© Nasdaq, Inc. • 2016 15(48)


Attention! It is essential that the CW1 Watchdog be stopped before the CW1 server.

5. The CW1 server installation installs ODBC, standards for database communication. For the installationto work properly shut down all active programs and all services in the Control Panel.

4.1.6 Preparing the CW1 ClientTo prepare for CW1 Client installation, perform the following steps:

1. Make sure that you have the following information:

• CW1 server node name.

• CW1 server socket number/port number.

• OMnet CW1 Client user ID, trading code.

• OMnet user password.

• Application license key (required, provided by the exchange).

2. Log in as Windows administrator.

3. If the CW1 Client has been previously installed, stop the CW1 Watchdog and all instances of the CW1server from the Control Panel/Services window as described below.

4.1.7 Stopping the CW1 Server and CW1 WatchdogPerform the following procedures to stop the CW1 server and CW1 Watchdog:

1. Log in as Administrator to the computer running the CW1 server.

2. Select Start, Settings, Control panel, Administrative tools, Services.

3. The Services window opens displaying service items.

4. Select the CW1 Watchdog item and select Stop on the right-click menu.

5. The CW1 Watchdog stops.

6. Select the CW1 server <instance> item and select Stop on the right-click menu.

7. The CW1 server <instance> stops.

8. Close the Services window.

16(48) © Nasdaq, Inc. • 2016


4.2 Installation

4.2.1 Installing the CW1 Server and CW1 ClientPerform this procedure to install the CW1 server and/or CW1 Client:

1. Double-click the file:

CW1_<version#>.exe

Customer="Genium INET Uncustomized"

Example of file name: CW1_2.0.0000_0__B045.exe

2. The Preparing Setup window appears.

3. The Welcome window opens.

4. Read the text, click Next.

5. The Registration window opens, used for set-up choice and for registration.

© Nasdaq, Inc. • 2016 17(48)


6. Select the option: Install both Genium INET CW1 Client and CW1 Server.

7. Enter registration information.

DescriptionField

Specify user name.Name

Enter company name.Company

Application license key provided by the exchange.License Key

8. Click Next.

9. A Registration Information box appears.

18(48) © Nasdaq, Inc. • 2016


10. The Server Settings 1 window opens.

© Nasdaq, Inc. • 2016 19(48)


Enter the settings for the CW1 server connections according to the table.

DescriptionField/Button

OMnet

Enter OMnet gateway host name.OMnet node

On this node the central Clearing database from which the CW1server retrieves information to store locally in the CW1 databaseis located. The OMnet node must be configured for the sameGenium INET version as the version being installed.

20(48) © Nasdaq, Inc. • 2016



Socket number

Select a set of node and socket and click Add.Node and Socket

Enter the socket number/port number of the OMnet gateway.

The information is copied to theOMnet Node andSocket numberfields.

Clicking Add copies the node in theOMnet node field to the Node list.

Add

Clicking Remove will delete the se-lected node from the Node list.

Remove

Will move the selected node up in theNode list.

Up

Will move the selected node down inthe Node list.

Down

Note: One set of OMnet node and Socket number ismandatory but more than one set can be specified. If theserver cannot log in to OMnet using the first set, it tries toconnect using the next set until all sets have been tried.

Enter the OMnet member Interface User ID, the trading code.The server will be dedicated to the member to whom the tradingcode relates.

User

Note: The OMnet user ID and password are defined in PD.

Enter the OMnet user password.Password

Confirm the OMnet password.Confirm

Select this check box to use a password which is already in use(update).

Keep existingpassword

Client IPC

Enter the socket num-ber/port number of the

Socket number forclient connection

CW1 server user whichcorresponds to thesocket number/portnumber for the CW1Client settings.

© Nasdaq, Inc. • 2016 21(48)



Note: If several instances are installed on the samemachine,each instance must use a unique number. Otherwise theclient may (try to) connect to an unintended server instance.

11. Click Next.


Specify settings for the CW1 server.


Logfiles Number of logfiles tokeep in the logfiles di-rectory.

Max no of logfiles tokeep

22(48) © Nasdaq, Inc. • 2016



Enter number of daysto keep the logfiles.

Max no of days to keeplogfiles

The server deletes thelogfiles that are olderthan this.

Create HTML files Select this box if theServer should create

Create HTML filesautomatically

HTML indexfiles forreports and interfacefiles

Reports Number of days tokeep the reports beforethey are deleted.

Number of days to keepreports

ISDN Select this box if theServer connects toOMnet via ISDN.

Connection to OMnetvia ISDN

13. Click Next.


© Nasdaq, Inc. • 2016 23(48)


15. Specify settings for the Database, Startup, and Interface files.

DescriptionFields/Buttons

Database This is the number of calendardays trades and clearing informa-

Nbr of days tokeep

tion are kept in the CW1Positions fordatabase. After this, they areExpired

Series deleted permanently from the

24(48) © Nasdaq, Inc. • 2016



database. Changing this valueaffects the size of the database.(Positions on the other hand, arekept as long they are kept in thecentral system, but never longerthan what this parameter speci-fies.)

Remove Trades and Clearing info based on:

Expiration date of seriesoption

Trade dateoption

This is the number of tradingdays this information is kept in

Nbr of days tokeep Trading

the Genium INET Clearing CW1and Clearinginfo database after the information

was first stored. Changing thisDays to keeptrading

value affects the size of thedatabase.

statistics,clearing info,paymentsand margins

Startup This is the time when the CW1server is starting up in the morn-

Server starttime

ing. It has to have the format hh-mmss, for example, 093000 for09:30

This is the time when the CW1server is exiting and restarted in

Server stoptime

the evening. It has to have theformat hhmmss, for example,233000 for 23:30.

Interface Files When you select this box, the in-terface files supported by Geni-

Createinterface filesautomatically um INET Clearing CW1 are cre-

ated by the Server at start-up andduring after business.

Enter number of days the inter-face files will remain on disk be-fore they are deleted.

Days to keepinterface files

© Nasdaq, Inc. • 2016 25(48)



Specifies whether preliminaryvector files should be download-ed or not.

Downloadpreliminarymargin vectorfiles.

16. Click Next. The Folder window opens.


Select theDual Positions box if the exchange is intended to keeppositions for current clearing date and next clearing date.

Dual Positions

Folders to install files

26(48) © Nasdaq, Inc. • 2016



To accept the default <root> for the setup program to install allGenium INET Clearing CW1 files, do nothing.

Default

To specify a specific <root> click Browse. The Choose Folderwindow opens:

Browse

Click Customize to select specific folders for all file groups thatthe set-up program will use for installing files:

Customize

• Program files

• Database (only for CW1 server)

• Reports

• Interface files

• Log files

• Report and interface files (only for CW1 server when HTMLfiles are created, because in this case these files must be locat-ed to the same folder).

The Folder Customize window looks like below:

© Nasdaq, Inc. • 2016 27(48)



This is an editable field. This field will be automatically filledwith information by the system. If, instead, you want to fill in the

SQLServer\Instance

name of a computer yourself, you can do so in this field. Youmust enter the name of the computer on which the SQL server isstored as well as the Instance name for the SQL server if you areusing an SQL Express version; for regular SQL Server only theserver name has to be entered without any instance name.

17. Click Next. The Client Settings window opens.

28(48) © Nasdaq, Inc. • 2016


18. Enter the settings according to the table.

DescriptionFields

Server Connection

Enter CW1 Server node name.Server node

Enter identification of the node where the CW1 server will berunning.

Enter the socket number used by the CW1 server. Use the socketnumber correlated to the intended instance of the CW1 server.

Socket number

If you are installing both server and client at the same time, thecorrect number will be automatically suggested as entry.

Note: If several instances are installed on the samemachine,each instance must use a unique number. Otherwise theclient may (try to) connect to an unintended server instance.

Application Title Enter a text of yourchoice to appear on the

Text in application title:For example: Companyname and version application title bar of

the windows and onthe start icon. Use dif-

© Nasdaq, Inc. • 2016 29(48)


DescriptionFields

ferent application titlesfor different instances.

Note:

Avoid using the following characters in the title, they are notsupported by Windows:

\ ? | > < : / * "

19. Click Next.

The Ready to Install window opens.

30(48) © Nasdaq, Inc. • 2016


20. Check that all recorded settings are correct and click Start Install.

21. The installation of CW1 starts. The progress is shown in the InstallShield Wizard.

22. The installation is completed. The Genium INET Clearing Workstation 1 Setup Complete windowappears.

© Nasdaq, Inc. • 2016 31(48)


In order for the CW1 installation to be successful and an SQL database to be created, the SQL serverhas to be installed on the same computer as the one on which you install the CW1 client and server.Therefore, if you have opted to use an SQL version other than SQL Express 2008 for your SW1installation, the following dialog will now appear:

Figure 12: Unable to Launch Database Dialog

1. In this dialog, click OK. The following dialog will appear:

Figure 13: Config Driver Failed Dialog

2. Again, click OK.

Note: These errors will not affect the general installation of the CW1 application. Since you will createthe database yourself, these two error messages have no bearing on the installation process.

Note: Please note, however, that the option to use another SQL server exists. For more informationabout this, see Section Creating a Database and an ODBC Connection Manually on page 33.

23. Click Finish.

32(48) © Nasdaq, Inc. • 2016


24. If, for some reason, the installation is not entirely successful, a window will appear, informing youthat you must restart your computer before the installation is completed.

Note: The installation will not be complete until you have actually restarted your computer.

25. Click Finish. The installation is now completed.

4.2.2 Creating a Database and an ODBC Connection ManuallyThe CW1 installation is currently configured for SQL Express 2008, but the option to use any other SQLversion exists. If you should opt to use an SQL version other than SQL Express 2008, and which is notinstalled on the same computer as your CW1 application, you must however create the database and ODBCconnection manually.

To create a database and an ODBC connection manually, follow these steps:

1. Go toC:\Program Files\NASDAQ\Genium INETClearingWorkstation1\DataBase\1, which is the defaultpath to the folder in which the script file that is supplied in the CW1 installation is stored, to fetch thisscript file.

You may have to edit this file before you can start to create the database. If the instance number isnot 1, all references to CW1_db1 need to be replaced with the correct instance number, for example,CW1_db2 for instance number 2. You may also have to change the path to the database files.

2. Now that you have created a database, go to Control Panel\Administrative Files\Data Sources (ODBC)to create an ODBC connection. The ODBC Data Source Administrator window appears.

© Nasdaq, Inc. • 2016 33(48)


3. In this window, click on the SystemDSN tab. Under that tab, clickAdd. TheCreate NewData Sourcewindow appears.

4. In this window, select the ODBC driver that matches your SQL server and click Finish. The CreateNew Data Source to SQL Server window appears:

5. In this window, enter data for the ODBC connection in the following way:

1. In the Name field, enter a name which the CW1 server can use to connect to the database. Thisname will be saved in the registry under the CW1 installation under the key CL_PIS_DSN andwill usually be entitled CW1 SQL DB 1.

2. In the Description field, enter any free text to describe the data source.

3. In the Server field, select the server name where the SQL server is located.

34(48) © Nasdaq, Inc. • 2016


Note: If you want to use an SQL Express server, the instance name also has to be present, such asTX0159\SQLEXPRESS.

6. Click Next. The Create New Data Source Authentication window appears:

7. In this window, set the way in which the database connection should log in to the SQL sever. Ifpossible, click the With Integrated Windows authentication option.

8. Click Next. The Change Default Database window appears:

9. In this window, change the default database to the one you created with the script file in step 1. Inother words, select the Change the default database to box to enable the field and select the correctdatabase. The window now looks as follows:

© Nasdaq, Inc. • 2016 35(48)


10. Click Next. The Create Data Source Change Settings window appears:

11. As a rule, you do not have to make any changes in this window, so just click Finish to continue. TheServer Setup Confirmation confirmation window appears:

12. In this window, click Test Data Source... to verify that the connection is working correctly. The SQLServer ODBC Data Source Test window appears:

13. Click OK to finish. You have now created an ODBC setting for the CW1 server.

14. Repeat this creation if more CW1 instances are installed; only the instance number has to be changes.

When you are finished, you can start the Clearing Workstation 1 server. It should run as normal, butyou may want to check the log files to make sure that it really is working correctly.

36(48) © Nasdaq, Inc. • 2016


On occasion, the Clearing Workstation 1 server is not allowed to connect through the ODBC connectionthat has been created for CW1. If this should happen, do as follows:

1. Go to Control Panel\Administrative Tools\Service, and in the window that appears select CW1 Server1and double-click on it. In the CW1 Server 1 Properties window that appears, click on the Log On tab.The window now looks as follows:

2. Click the This Account option and enter new log-in data of your choice and then click OK.

© Nasdaq, Inc. • 2016 37(48)


38(48) © Nasdaq, Inc. • 2016


5 After InstallationThis chapter describes actions to be taken after the installation.

5.1 CW1 Server Startup

5.1.1 CW1 Watchdog ControlThe CW1 server is started and restarted automatically by the Watchdog process. The Watchdog is restartedwhen the computer is restarted. The user does not need to perform any actions to run the CW1 server.

The first time the server starts, it downloads all active trades, all accounts, yesterday’s information andtoday’s instruments into the database. This may take some time.

Attention!We strongly recommend that the first startup take place outside trading hours since thedownload can affect the performance of potential trading applications sharing the same physical connection.

5.1.2 Viewing Startup ProgressThe progress of the startup can be followed in the server log file:

cw1_srv_2.xxxx<INSTANCE>_<NODE>.LOG

The log file is located in the Logfiles directory, specified in the Folder window. When the startup processis complete, the CW1 server prints “Init is complete. Doing the main loop.”

5.1.3 Changing OMnet Server PasswordThe OMnet server password is set during the installation. Use this procedure if you like to change it afterthe installation:

1. Open the folder in which the CW1 server executable resides.

2. Start a Command Prompt by running cmd.exe.

3. Drag and drop the server executable file onto the Command Prompt window. If the path name includesspaces, make sure the resulting text is enclosed in double quotes.

1. Add a space and the argument –chpassw

2. Add a space and the instance number of the configuration.

4. Press [Enter].

5. Enter new server password and press [Enter].

6. Confirm new password and press [Enter].

© Nasdaq, Inc. • 2016 39(48)

After Installation

Result: The server password is successfully changed.

It is also possible to enter everything on one row:

–chpassw <new password> <new password>

5.2 CW1 Client Startup

5.2.1 Client IconsAs part of the installation, the program group NASDAQ, Genium INET Clearing was added to the Startmenu.

The program name became CW1 for <Application Title>, where <application title> was entered during theinstallation in the Client Settings window.

5.2.2 Viewing Instance #To figure out to which instance # the application title relates, perform the following steps:

1. On Windows Start menu, select Programs, NASDAQ, Genium INET Clearing, CW1 for <ApplicationTitle>.

2. Select Properties on the right-click menu.

3. The CW1 for <Application Title> Properties window opens.

4. Select Shortcut view, Target field.

5. The Target field shows the instance #.

5.2.3 Testing Logging OnPerform this procedure if you want to start and log on to the CW1 application.

1. Switch on your workstation and start windows.

2. On Windows Start menu, select Programs, NASDAQ, Genium INET Clearing, CW1 for <ApplicationTitle>.

3. The Genium INET splash screen is presented followed by the Login - Genium INET Clearing window.

40(48) © Nasdaq, Inc. • 2016


Figure 14: Participant Interface Application Splash Window

Figure 15: Login Window

4. Enter your OMnet Username and Password.

Your OMnet CW1 user identification, trading codeUsername

Your OMnet CW1 user passwordPassword

Note: The OMnet CW1 user identification and password are defined in the PD.

5. Click OK.

6. If the login was successful, the Genium INET CW1 main menu appears.

© Nasdaq, Inc. • 2016 41(48)

After Installation

If the Logon was not SuccessfulFirst of all, make sure there were no spelling mistakes in the log-on fields.

Then check the following network environment:

• Is your workstation properly connected to the TCP/IP network?

• Do the entered OMnet gateway node name and port number exist and is this node up and running?

• Is your OMnet user identity and password set up on the OMnet gateway node?

• Is the OMnet gateway node set up with the TCP/IP address of your workstation?

5.2.4 Analyzing and Reporting ProblemsInformation on application problems is stored in the process log files located in:

<ROOT>\LogFiles.

Log File NameProcess

cw1_srv_<version>_<instance>_<node>.logCW1 server

cw1_client<version>_<instance>_<node>.logCW1 Client

cw1_wtchdg<node>.logCW1 Watchdog

When reporting problems of any kind to NASDAQ OMX Genium INET personnel, please send the contentsof the log files directory in the problem report. When reporting improvement suggestions, this is not necessary.

5.3 New CW1 Client Users

5.3.1 Adding New CW1 Application UsersNew users can be added from the PD, or in the CW1 application by a user with administrator's rights fromthe menu User Admin.

5.4 Database MaintenanceThis chapter describes some database maintenance activities.

Note:

All procedures described in this chapter affect the database used by the Genium INET Clearing CW1Server and should normally be used only upon recommendation from NASDAQ OMX.

The procedures in this section can be performed if the database for some reason has become corrupt.

5.4.1 Refreshing the CW1 Server via CW1 ClientUse the CW1 to perform this procedure.

42(48) © Nasdaq, Inc. • 2016


Use this procedure to refresh the database used by the CW1 Server:

1. Select Load/Reload on the Series menu.

2. The Load/Reload window appears.

3. Choose desired actions in the Action scroll list:

1. Select “restart the CW1 Server” and click Send.

Result: This operation restarts the CW1 Server.

2. Select “reload trades from a date” and click Send.

Result: This makes the Date and Commodity fields editable. Enter the date from which you wantto load trades. The trades from the specified date up to the current date are reloaded. You canchoose to select a specific commodity or all commodities. By selecting a commodity, only tradesplaced on derivative series for this commodity will be reloaded. This saves time compared toreloading all trades.

Note: This operation disconnects all clients from the server when the server reloads the trades andlets clients reconnect after the reload.

3. Select “reload all accounts” and click Send.

Result: This operation restarts the server and reloads all accounts during startup. It is not necessaryto use this function to reload accounts that have been added during the day. These are automaticallydownloaded when the user clicks Search in the Account Detail window and when the server isstarted.

4. Select “reload payments from a date” and click Send.

5. Enter the date from which you want to reload payments. The payments from the specified date upto the current date are reloaded.

Result: This operation restarts the server and thereby disconnects all clients during the restart.The clients are automatically reconnected again once the server has started.

6. Select “reload instruments” and click Send.

Result: This operation restarts the server and reloads all instruments during startup. The clientswill therefore be disconnected during this operation but they will be reconnected automatically whenthe server is restarted.

7. Select “reload trading statistics from a date” and click Send.

8. Enter the date from which you want to reload trading statistics. The trading statistics from thespecified date up to the current date are reloaded.

© Nasdaq, Inc. • 2016 43(48)

After Installation

Result: This operation restarts the server and thereby disconnects all clients during the restart.The clients are automatically reconnected again once the server is started.

9. Select “reload deliveries from a date” and click Send.

10. Enter the date from which you want to reload deliveries. The deliveries from the specified dateup to the current date are reloaded.

Result: This operation restarts the server and thereby disconnects all clients during the restart.The clients are automatically reconnected again once the server is started.

11. Select “reload margin requirements from a date” and click Send.

12. Enter the date from which you want to reload margin requirements. The margin requirements fromthe specified date up to the current date are reloaded.

Result: This operation restarts the server and thereby disconnects all clients during the restart.The clients are automatically reconnected again once the server has started.

13. Select “reload non trading days” and click Send.

Result: This operation restarts the server and reloads all non-trading days during startup. Theclients will therefore be disconnected during this operation but they will be reconnected automaticallywhen the server is restarted.

5.4.2 Refreshing the CW1 Database via AM CommandsIt is also possible to use the AM commands to refresh the database, and in the multi member case this is theonly way. This section targets customers who uses a Multi Member CW1 Server.

Single Member CW1 ServerUse this procedure to refresh the database used by the CW1 Server:

1. Open a DOS Command Prompt window by selecting Run on the Start menu in Windows.

2. Type CMD and click OK.

3. The Command window appears.

4. Enter the AM system and connect to the Genium INET application and correct instance. In the DOSCommand Prompt window, execute the following command:

am -appl omex -inst <exchange name>

44(48) © Nasdaq, Inc. • 2016


Example 2:

am –app omex –inst om

5. A help text with available commands can be listed with:

cw1_srv_2.xxxx <instance> show commands

The CW1 Server version, configuration and customer information can also be displayed with commands:

cw1_srv_2.xxxx <instance> show version

cw1_srv_2.xxxx <instance> show configuration

cw1_srv_2.xxxx <instance> show customer info

6. Choose desired command:

1. Type: cw1_srv_2.xxxx <instance> stop process

Result: This operation stops the CW1 Server which will then be restarted by the watchdog (i.e. arestart of the CW1 Server).

2. Type: cw1_srv_2.xxxx <instance> start cleanup

Result: This operation performs a cleanup on the database and removes old data such as expiredseries etc.

3. Type: cw1_srv_2.xxxx <instance> set omnet password

Result: This operation sets a new password for omnet log in (replaces the password entered wheninstalling the CW1 Server). The CW1 Server will then be restarted.

4. Type: cw1_srv_2.xxxx <instance> refresh db

Result: This operation clears the database and reloads all data.

5. Type: cw1_srv_2.xxxx <instance> reload trades <date> <commodity>

Result: Enter the date from which you want to load trades. The trades from the specified date upto the current date are reloaded. You can choose to select a specific commodity or all commodities.By selecting a commodity, only trades placed on derivative series for this commodity will be reloaded.This saves time compared to reloading all trades.

Note: This operation disconnects all clients from the server when the server reloads the trades andlets clients reconnect after the reload.

6. Type: cw1_srv_2.xxxx <instance> reload accounts

Result: This operation restarts the server and reloads all accounts during startup. It is not necessaryto use this function to reload accounts that have been added during the day. These are automaticallydownloaded.

7. Type: cw1_srv_2.xxxx <instance> reload payments <date>

Result: Enter the date from which you want to reload payments. The payments from the specifieddate up to the current date are reloaded. This operation restarts the server and thereby disconnectsall clients during the restart. The clients are automatically reconnected again once the server hasstarted.

8. Type: cw1_srv_2.xxxx <instance> reload instruments

© Nasdaq, Inc. • 2016 45(48)

After Installation

Result: This operation restarts the server and reloads all instruments during startup. The clientswill therefore be disconnected during this operation but they will be reconnected automatically whenthe server is restarted.

9. Type: cw1_srv_2.xxxx <instance> reload trading statistics <date>

Result: Enter the date from which you want to reload trading statistics. The trading statistics fromthe specified date up to the current date are reloaded. This operation restarts the server and therebydisconnects all clients during the restart. The clients are automatically reconnected again once theserver is started.

10. Type: cw1_srv_2.xxxx <instance> reload deliveries <date>

Result: Enter the date from which you want to reload deliveries. The deliveries from the specifieddate up to the current date are reloaded. This operation restarts the server and thereby disconnectsall clients during the restart. The clients are automatically reconnected again once the server isstarted.

11. Type: cw1_srv_2.xxxx <instance> reload margin <date>

Result: Enter the date fromwhich you want to reloadmargin requirements. Themargin requirementsfrom the specified date up to the current date are reloaded. This operation restarts the server andthereby disconnects all clients during the restart. The clients are automatically reconnected againonce the server has started.

12. Type: cw1_srv_2.xxxx <instance> reload trading days

Result: This operation restarts the server and reloads all non-trading days during startup. Theclients will therefore be disconnected during this operation but they will be reconnected automaticallywhen the server is restarted.

13. Type: exit

Result: Exit from the am prompt.

5.4.3 About HousekeepingThe built-in housekeeping facility cleans out old records in the CW1 Database. The number of days specified(at installation of the CW1 Server) for storing records might however not be exactly complied with, sincehousekeeping is not performed if current day or next day is a non-trading day. In this respect only Saturdayand Sunday are considered non-trading days.

5.4.4 Renewing the Database CompletelyIn some serious malfunction situations a complete cleanup of the database may be necessary. Perform theprocedure from a DOS Command Prompt window.

Use this procedure to empty the entire SQL database used by the CW1 Server:

1. Open the folder in which the CW1 Server executable resides.

2. Open a DOS Command Prompt window on your machine.

46(48) © Nasdaq, Inc. • 2016


3. Drag and drop the server executable file into the DOS Command Prompt window. If the path nameincludes spaces enclose all of it in double quotes:

1. Add a space and the argument –renewdb

2. Add a space and the instance number of the database to be replaced.

4. Press Enter.

5. A confirmation/warning window is displayed. Select the desired option.

Y The current CW1 database is emptied, and it will be reloaded next time the CW1 Server is started.

N Nothing will happen. The current database will be left as it is.

5.4.5 Shrinking the DatabaseTo reduce the size of the database it is possible to execute a manual command in the DOS Command Promptwindow.

Use this procedure to shrink the SQL database used by the CW1 server:

1. Open the folder in which the CW1 Server executable resides.

2. Open a DOS Command Prompt window on your machine.

3. Drag and drop the server executable file into the DOS Command Prompt window.

Note:

If the path name includes spaces enclose all of it in double quotes.

4. Add a space and the argument -shrinkdb.

5. Add a space and the instance number of the database to be replaced.

Example

C:\Program Files\NASDAQ\Genium INET ClearingWorkstation1\BinaryFiles\CW1_SRV_2.0.0210.exe"-shrinkdb -1

© Nasdaq, Inc. • 2016 47(48)

After Installation

6. Press Enter.

A confirmation message is displayed.

The current physical database is reduced as much as possible.

48(48) © Nasdaq, Inc. • 2016


Documents

ClearingWorkstation(CW1) InstallationGuide - NASDAQ · 2016. 7. 13. · The CW1 kit program performs the following actions: • Creates the directory structure under Program Files