Genium INET. Clearing Workstation (CW1) Installation Guide. NASDAQ OMX Nordic. Version:

Transcription

1 Genium INET Clearing Workstation (CW1) Installation Guide NASDAQ OMX Nordic Version:

2 Document ID: Documentation Release: Release Date: Publication Date: CW1_IG_6 GENIUM_Product_a Whilst all reasonable care has been taken to ensure that the details are true and not misleading at the time of publication, no liability whatsoever is assumed by OMX Technology AB, or any subsidiary of OMX Technology AB, with respect to the accuracy or any use of the information provided herein. Any license, delivery and support of software systems etc. require entering into separate agreements with OMX Technology AB. This document contains confidential information and may not be modified or reproduced, in whole or in part, or transmitted in any form to any third party, without the written approval from OMX Technology AB. Copyright 2014 OMX Technology AB. All rights reserved.

3 Table of Contents Table of Contents 1 Summary of Changes About this Manual References General Features Application Components Kit and Structure CW1 Server Kit CW1 Client Kit TCP/IP Address Resolution Folder Structure Registry Entries Installation and Configuration Prerequisites SW Requirements Installation Options Settings for New Installations and Upgrades Previous Installation Preparing the CW Preparing the CW1 Client Stopping the CW1 Server and CW1 Watchdog Installation Installing the CW1 Server and CW1 Client Creating a Database and an ODBC Connection Manually After Installation CW1 Server Startup CW1 Watchdog Control Viewing Startup Progress Changing OMnet Server Password CW1 Client Startup Client Icons Viewing Instance # Testing Logging On Analyzing and Reporting Problems New CW1 Client Users Adding New CW1 Application Users Database Maintenance Refreshing the CW1 Server via CW1 Client Refreshing the CW1 Database via AM commands About Housekeeping Renewing the Database Completely...50 The NASDAQ OMX Group, Inc (52)

4 Clearing Workstation (CW1) Installation Guide List of Figures Shrinking the Database...51 Figure 1: Existing Installed Instances Detected Window...14 Figure 2: Unable to Launch Database Dialog...32 Figure 3: Config Driver Failed Dialog...33 Figure 4: Command Prompt Window...43 Figure 5: Participant Interface Application Splash Window...45 Figure 6: Login Window (52) The NASDAQ OMX Group, Inc. 2014

5 Summary of Changes 1 Summary of Changes Changes between this version and version a1010 ( ). No 1 Changes Updated code track on front page. Comment The NASDAQ OMX Group, Inc (52)

6 Clearing Workstation (CW1) Installation Guide 6(52) The NASDAQ OMX Group, Inc. 2014

7 About this Manual 2 About this Manual This document describes how to manage the installation and related actions of all the components of the Genium INET Clearing Workstation References For more information, please refer to the following document: Clearing Workstation (CW1) User's Guide The NASDAQ OMX Group, Inc (52)

8 Clearing Workstation (CW1) Installation Guide 8(52) The NASDAQ OMX Group, Inc. 2014

9 General Features 3 General Features The Clearing Workstation 1 is part of Genium INET Clearing and is used by the members of the clearing organization. 3.1 Application Components The 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 OMnet and 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, the CW1 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 windows for the user to enter data to be sent to the Genium INET Clearing. Many CW1 clients within the same member can use the same CW1 server and the same database. 3.2 Kit and Structure CW1 Server Kit The Genium INET CW1 server will be installed as a service with no automatic start. To keep the CW1 server alive at all times, a CW1 Watchdog will be installed at the same time as the CW1 server. The CW1 Watchdog 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. The NASDAQ OMX Group, Inc (52)

10 Clearing Workstation (CW1) Installation Guide Adds an icon in the start menu: Start, All Programs, NASDAQ OMX, Genium INET Clearing CW1 Client Kit The 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 OMX, Genium INET Clearing, CW1 for <Application Title> TCP/IP Address Resolution Make sure that the IP addresses and identifications of the CW1 Client and Gateway nodes are entered into the hosts file located on: C:\WINNT\system32\drivers\etc. Example 1: localhost Folder Structure The installation program creates the following default folder structure for the CW1 files if not customized by the user: The default root folder <ROOT> is Program Files Database Reports Interface Files Log Files Windows XP C:\Program Files\NASDAQ OMX\Genium INET CW1 Windows 7 C:\Users\Public\Nasdaq OMX\Genium Clearing Workstation1 <ROOT>\BinaryFiles the names of the CW1 Client, CW1 server and CW1 Watchdog reflect the instances. <ROOT>\DataBase\<instance #> <ROOT>\Reports\<instance #> <ROOT>\InterfaceFiles\<instance #> <ROOT>\LogFiles the names of the log files reflect the instances. Note: The folder structure above can be entirely customized Registry Entries Some registry settings are set up in Windows Registry during the installation. Genium INET CW1 specific registry settings are stored in: 10(52) The NASDAQ OMX Group, Inc. 2014

11 General Features HKEY_LOCAL_MACHINE\SOFTWARE\NASDAQ OMX\Genium INET\Clearing Workstation1\<INSTANCE> The parameters in the registry should not be modified. If modifications seem necessary, consult NASDAQ OMX personnel. The NASDAQ OMX Group, Inc (52)

12 Clearing Workstation (CW1) Installation Guide 12(52) The NASDAQ OMX Group, Inc. 2014

13 Installation and Configuration 4 Installation and Configuration Attention! Since the CW1 server starts as soon as it is installed, we strongly recommend that these actions take place outside trading hours because the download can affect the performance of potential trading applications sharing the same physical connection. 4.1 Prerequisites This section provides information and instructions needed before starting the installation SW Requirements Windows Server 2008 or Windows 7 Microsoft.Net MS SQL Server MS Visual studio 2010 Redistributable x Installation Options Using different application instances means that the installed application is opened with different installation settings. 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 identify these installed instances. The application instance number is included in the license key on the fourth position as described in the installation procedure. The different installation settings are stored in different folders in the Registry. The application executable files are stored in the <root>\ BinaryFiles folder with names reflecting their version. All other application files, such as database and reports, are stored in subfolders using the instance number. The NASDAQ OMX Group, Inc (52)

14 Clearing Workstation (CW1) Installation Guide Figure 1: Existing Installed Instances Detected Window Settings for New Installations and Upgrades Setting Instance # Omnet node and Socket Client IPC Socket number Application title Upgrading The old # should be used. The old node can be used only if it is upgraded to the new version. The old number can be used. The old number can be used. The old title can be used or changed. New version A new # must be used. A different node must be used upgraded to the new version. A new number must be used. A new number must be used (but the same number as the client IPC for the corresponding instance). A new title must be used. The other settings do not depend on instance or version Previous Installation If the CW1 server and/or CW1 Client has been previously installed, the CW1 Watchdog and all instances of the CW1 server must be manually stopped from the Control Panel/Services window as described below. Installation of a new version of the CW1 application will remove the old program files before installing the new files. Some of the old installation settings in the Registry will remain and appear in the installation windows, where they can be edited. 14(52) The NASDAQ OMX Group, Inc. 2014

15 Installation and Configuration Preparing the CW1 To 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 server node before the CW1 server is installed. EN/Win subsystem must be installed on a CW1 server node before the CW1 server is installed to provide integration with the supervision framework (PATROL and AppMind). Installing an SQL server requires that you have.net Framework 2.0 SP2 and Windows Installer 4.5 or higher installed on your computer. A Microsoft SQL server must be installed, either on the same computer on which you install your CW1 server, or on a different computer. The following two main settings are required in order for the CW1 installation to succeed in creating 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 NT AUTHORITY\SYSTEM. If you do not, the CW1 Server installation will not be allowed to create 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 CW1 server as well as all connected CW1 Clients. There must also be connectivity for Windows Domain network 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 CW1 server from the Control Panel/Services window. Attention! It is essential that the CW1 Watchdog be stopped before the CW1 server. The NASDAQ OMX Group, Inc (52)

16 Clearing Workstation (CW1) Installation Guide 5. The CW1 server installation installs ODBC, standards for database communication. For the installation to work properly shut down all active programs and all services in the Control Panel Preparing the CW1 Client To 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 CW1 server from the Control Panel/Services window as described below Stopping the CW1 Server and CW1 Watchdog Perform 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(52) The NASDAQ OMX Group, Inc. 2014

17 Installation and Configuration 4.2 Installation Installing the CW1 Server and CW1 Client Perform 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_ _0 B045.exe 2. The Preparing Setup window appears. 3. The Welcome window opens. The NASDAQ OMX Group, Inc (52)

18 Clearing Workstation (CW1) Installation Guide 4. Read the text, click Next. 5. The Registration window opens, used for set-up choice and for registration. 18(52) The NASDAQ OMX Group, Inc. 2014

19 Installation and Configuration 6. Select the option: Install both Genium INET CW1 Client and CW1 Server. 7. Enter registration information. Field Name Company License Key Description Specify user name. Enter company name. Application license key provided by the exchange. 8. Click Next. 9. A Registration Information box appears. The NASDAQ OMX Group, Inc (52)

20 Clearing Workstation (CW1) Installation Guide 10. The Server Settings 1 window opens. Enter the settings for the CW1 server connections according to the table. 20(52) The NASDAQ OMX Group, Inc. 2014

21 Installation and Configuration Field/Button Description OMnet OMnet node Enter OMnet gateway host name. On this node the central Clearing database from which the CW1 server retrieves information to store locally in the CW1 database is located. The OMnet node must be configured for the same Genium INET version as the version being installed. Socket number Node and Socket Select a set of node and socket and click Add. Enter the socket number/port number of the OMnet gateway. The information is copied to the OMnet Node and Socket number fields. Add Remove Up Down Clicking Add copies the node in the OMnet node field to the Node list. Clicking Remove will delete the selected node from the Node list. Will move the selected node up in the Node list. Will move the selected node down in the Node list. Note: One set of OMnet node and Socket number is mandatory but more than one set can be specified. If the server cannot log in to OMnet using the first set, it tries to connect using the next set until all sets have been tried. User Enter the OMnet member Interface User ID, the trading code. The server will be dedicated to the member to whom the trading code relates. Note: The OMnet user ID and password are defined in PD. Password Confirm Keep existing password Enter the OMnet user password. Confirm the OMnet password. Select this check box to use a password which is already in use (update). Client IPC Socket number for client connection Enter the socket number/port number of the The NASDAQ OMX Group, Inc (52)

22 Clearing Workstation (CW1) Installation Guide Field/Button Description CW1 server user which corresponds to the socket number/port number for the CW1 Client settings. Note: If several instances are installed on the same machine, each instance must use a unique number. Otherwise the client may (try to) connect to an unintended server instance. 11. Click Next. 12. The Server Settings 2 window opens. Specify settings for the CW1 server. 22(52) The NASDAQ OMX Group, Inc. 2014

23 Installation and Configuration Field/Button Logfiles Description Max no of logfiles to keep Max no of days to keep logfiles Number of logfiles to keep in the logfiles directory. Enter number of days to keep the logfiles. The server deletes the logfiles that are older than this. Create HTML files Create HTML files automatically Select this box if the Server should create HTML indexfiles for reports and interface files Reports Number of days to keep reports Number of days to keep the reports before they are deleted. ISDN Connection to OMnet via ISDN Select this box if the Server connects to OMnet via ISDN. 13. Click Next. 14. The Server Settings 3 window opens. The NASDAQ OMX Group, Inc (52)

24 Clearing Workstation (CW1) Installation Guide 15. Specify settings for the Database, Startup, and Interface files. Fields/Buttons Database Description Nbr of days to keep Positions for Expired Series This is the number of calendar days trades and clearing information are kept in the CW1 database. After this, they are deleted permanently from the database. Changing this value affects the size of the database. 24(52) The NASDAQ OMX Group, Inc. 2014

25 Installation and Configuration Fields/Buttons Description (Positions on the other hand, are kept as long they are kept in the central system, but never longer than what this parameter specifies.) Remove Trades and Clearing info based on: option option Expiration date of series Trade date Nbr of days to keep Trading and Clearing info Days to keep trading statistics, clearing info, payments and margins This is the number of trading days this information is kept in the Genium INET Clearing CW1 database after the information was first stored. Changing this value affects the size of the database. Startup Server start time Server stop time This is the time when the CW1 server is starting up in the morning. It has to have the format hhmmss, for example, for 09:30 This is the time when the CW1 server is exiting and restarted in the evening. It has to have the format hhmmss, for example, for 23:30. Interface Files Create interface files automatically Days to keep interface files When you select this box, the interface files supported by Genium INET Clearing CW1 are created by the Server at start-up and during after business. Enter number of days the interface files will remain on disk before they are deleted. The NASDAQ OMX Group, Inc (52)

26 Clearing Workstation (CW1) Installation Guide Fields/Buttons Description Download preliminary margin vector files. Specifies whether preliminary vector files should be downloaded or not. 16. Click Next. The Folder window opens. Fields/Buttons Dual Positions Description Select the Dual Positions box if the exchange is intended to keep positions for current clearing date and next clearing date. Folders to install files Default To accept the default <root> for the setup program to install all Genium INET Clearing CW1 files, do nothing. 26(52) The NASDAQ OMX Group, Inc. 2014

27 Installation and Configuration Fields/Buttons Browse Description To specify a specific <root> click Browse. The Choose Folder window opens: Customize Click Customize to select specific folders for all file groups that the set-up program will use for installing files: Program files Database (only for CW1 server) Reports Interface files Log files The Folder Customize window looks like below: Report and interface files (only for CW1 server when HTML files are created, because in this case these files must be located to the same folder). The NASDAQ OMX Group, Inc (52)

28 Clearing Workstation (CW1) Installation Guide Fields/Buttons Description SQL Server\Instance This is an editable field. This field will be automatically filled with information by the system. If, instead, you want to fill in the name of a computer yourself, you can do so in this field. You must enter the name of the computer on which the SQL server is stored as well as the Instance name for the SQL server if you are using an SQL Express version; for regular SQL Server only the server name has to be entered without any instance name. 17. Click Next. The Client Settings window opens. 28(52) The NASDAQ OMX Group, Inc. 2014

29 Installation and Configuration 18. Enter the settings according to the table. Fields Description Server Connection Server node Socket number Enter CW1 Server node name. Enter identification of the node where the CW1 server will be running. Enter the socket number used by the CW1 server. Use the socket number correlated to the intended instance of the CW1 server. If you are installing both server and client at the same time, the correct number will be automatically suggested as entry. Note: If several instances are installed on the same machine, each instance must use a unique number. Otherwise the client may (try to) connect to an unintended server instance. Application Title Text in application title: For example: Company name and version Enter a text of your choice to appear on the application title bar of the windows and on the start icon. Use different application titles for different instances. The NASDAQ OMX Group, Inc (52)

30 Clearing Workstation (CW1) Installation Guide Fields Description Note: Avoid using the following characters in the title, they are not supported by Windows: \? > < : / * " 19. Click Next. The Ready to Install window opens. 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. 30(52) The NASDAQ OMX Group, Inc. 2014

31 Installation and Configuration 22. The installation is completed. The Genium INET Clearing Workstation 1 Setup Complete window appears. The NASDAQ OMX Group, Inc (52)

32 Clearing Workstation (CW1) Installation Guide In order for the CW1 installation to be successful and an SQL database to be created, the SQL server has 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 SW1 installation, the following dialog will now appear: Figure 2: Unable to Launch Database Dialog 1. In this dialog, click OK. The following dialog will appear: 32(52) The NASDAQ OMX Group, Inc. 2014

33 Installation and Configuration Figure 3: Config Driver Failed Dialog 2. Again, click OK. Note: These errors will not affect the general installation of the CW1 application. Since you will create the 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 information about this, see Section Creating a Database and an ODBC Connection Manually on page Click Finish. 24. If, for some reason, the installation is not entirely successful, a window will appear, informing you that you must restart your computer before the installation is completed. Note: The installation will not be complete until you have actually restarted your computer. The NASDAQ OMX Group, Inc (52)

34 Clearing Workstation (CW1) Installation Guide 25. Click Finish. The installation is now completed Creating a Database and an ODBC Connection Manually The CW1 installation is currently configured for SQL Express 2008, but the option to use any other SQL version exists. If you should opt to use an SQL version other than SQL Express 2008, and which is not installed on the same computer as your CW1 application, you must however create the database and ODBC connection manually. To create a database and an ODBC connection manually, follow these steps: 1. Go to C:\Program Files\NASDAQ OMX\Genium INET Clearing Workstation1\DataBase\1, which is the default path to the folder in which the script file that is supplied in the CW1 installation is stored, to fetch this script file. You may have to edit this file before you can start to create the database. If the instance number is not 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. 3. In this window, click on the System DSN tab. Under that tab, click Add. The Create New Data Source window appears. 34(52) The NASDAQ OMX Group, Inc. 2014

35 Installation and Configuration 4. In this window, select the ODBC driver that matches your SQL server and click Finish. The Create New Data Source to SQL Server window appears: The NASDAQ OMX Group, Inc (52)

36 Clearing Workstation (CW1) Installation Guide 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. This name will be saved in the registry under the CW1 installation under the key CL_PIS_DSN and will usually be entitled CW1 SQL DB 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. Note: If you want to use an SQL Express server, the instance name also has to be present, such as TX0159\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. If possible, click the With Integrated Windows authentication option. 8. Click Next. The Change Default Database window appears: 36(52) The NASDAQ OMX Group, Inc. 2014

37 Installation and Configuration 9. In this window, change the default database to the one you created with the script file in step 1. In other words, select the Change the default database to box to enable the field and select the correct database. The window now looks as follows: The NASDAQ OMX Group, Inc (52)

38 Clearing Workstation (CW1) Installation Guide 10. Click Next. The Create Data Source Change Settings window appears: 38(52) The NASDAQ OMX Group, Inc. 2014

39 Installation and Configuration 11. As a rule, you do not have to make any changes in this window, so just click Finish to continue. The Server Setup Confirmation confirmation window appears: 12. In this window, click Test Data Source... to verify that the connection is working correctly. The SQL Server ODBC Data Source Test window appears: The NASDAQ OMX Group, Inc (52)

40 Clearing Workstation (CW1) Installation Guide 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, but you may want to check the log files to make sure that it really is working correctly. On occasion, the Clearing Workstation 1 server is not allowed to connect through the ODBC connection that 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 Server1 and 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: 40(52) The NASDAQ OMX Group, Inc. 2014

41 Installation and Configuration 2. Click the This Account option and enter new log-in data of your choice and then click OK. The NASDAQ OMX Group, Inc (52)

42 Clearing Workstation (CW1) Installation Guide 42(52) The NASDAQ OMX Group, Inc. 2014

43 After Installation 5 After Installation This chapter describes actions to be taken after the installation. 5.1 CW1 Server Startup CW1 Watchdog Control The CW1 server is started and restarted automatically by the Watchdog process. The Watchdog is restarted when 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 and today s instruments into the database. This may take some time. Attention! We strongly recommend that the first startup take place outside trading hours since the download can affect the performance of potential trading applications sharing the same physical connection Viewing Startup Progress The 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 process is complete, the CW1 server prints Init is complete. Doing the main loop Changing OMnet Server Password The OMnet server password is set during the installation. Use this procedure if you like to change it after the installation: 1. Open the folder in which the CW1 server executable resides. 2. Start a DOS command prompt window on your machine. Figure 4: Command Prompt Window The NASDAQ OMX Group, Inc (52)

44 Clearing Workstation (CW1) Installation Guide 3. Drag and drop the server executable file onto the DOS prompter window. If the path name includes spaces enclose all of it 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]. 7. 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 Client Icons As part of the installation, the program group NASDAQ OMX, Genium INET Clearing was added to the Start menu. The program name became CW1 for <Application Title>, where <application title> was entered during the installation in the Client Settings window Viewing Instance # To figure out to which instance # the application title relates, perform the following steps: 1. On Windows Start menu, select Programs, NASDAQ OMX, Genium INET Clearing, CW1 for <Application Title>. 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 # Testing Logging On Perform this procedure if you want to start and log on to the CW1 application. 1. Switch on your workstation and start windows. 44(52) The NASDAQ OMX Group, Inc. 2014

45 After Installation 2. On Windows Start menu, select Programs, NASDAQ OMX, Genium INET Clearing, CW1 for <Application Title>. 3. The Genium INET splash screen is presented followed by the Login - Genium INET Clearing window. Figure 5: Participant Interface Application Splash Window Figure 6: Login Window 4. Enter your OMnet Username and Password. Username Password Your OMnet CW1 user identification, trading code Your OMnet CW1 user password Note: The OMnet CW1 user identification and password are defined in the PD. 5. Click OK. The NASDAQ OMX Group, Inc (52)

46 Clearing Workstation (CW1) Installation Guide 6. If the login was successful, the Genium INET CW1 main menu appears. If the Logon was not Successful First 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? Analyzing and Reporting Problems Information on application problems is stored in the process log files located in: <ROOT>\LogFiles. Process CW1 server CW1 Client CW1 Watchdog Log File Name cw1_srv_<version>_<instance>_<node>.log cw1_client<version>_<instance>_<node>.log cw1_wtchdg<node>.log When reporting problems of any kind to NASDAQ OMX Genium INET personnel, please send the contents of the log files directory in the problem report. When reporting improvement suggestions, this is not necessary. 5.3 New CW1 Client Users Adding New CW1 Application Users New users can be added from the PD, or in the CW1 application by a user with administrator's rights from the menu User Admin. 5.4 Database Maintenance This chapter describes some database maintenance activities. Note: All procedures described in this chapter affect the database used by the Genium INET Clearing CW1 Server 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. 46(52) The NASDAQ OMX Group, Inc. 2014

47 After Installation Refreshing the CW1 Server via CW1 Client Use the CW1 to perform this procedure. 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 want to load trades. The trades from the specified date up to 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 and lets 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 necessary to use this function to reload accounts that have been added during the day. These are automatically downloaded when the user clicks Search in the Account Detail window and when the server is started. 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 up to the current date are reloaded. The NASDAQ OMX Group, Inc (52)

48 Clearing Workstation (CW1) Installation Guide 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 clients will therefore be disconnected during this operation but they will be reconnected automatically when the 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 the 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 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 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 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 from the 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. The clients will therefore be disconnected during this operation but they will be reconnected automatically when the server is restarted Refreshing the CW1 Database via AM commands It is also possible to use the AM commands to refresh the database, and in the multi member case this is the only way. This section targets customers who uses a Multi Member CW1 Server. Single Member CW1 Server Use 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. 48(52) The NASDAQ OMX Group, Inc. 2014

49 After Installation 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 DOS Command Prompt window, execute the following command: am -appl genium inet -inst <exchange name> Example 2: am app genium inet 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. a restart 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 expired series 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 when installing 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 up to 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 and lets 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 necessary to use this function to reload accounts that have been added during the day. These are automatically downloaded. The NASDAQ OMX Group, Inc (52)

50 Clearing Workstation (CW1) Installation Guide 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 specified date up to the current date are reloaded. This operation restarts the server and thereby disconnects all clients during the restart. The clients are automatically reconnected again once the server has started. 8. Type: cw1_srv_2.xxxx <instance> reload instruments Result: This operation restarts the server and reloads all instruments during startup. The clients will therefore be disconnected during this operation but they will be reconnected automatically when the 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 from the specified date up to the current date are reloaded. This operation restarts the server and thereby disconnects all clients during the restart. The clients are automatically reconnected again once the server 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 specified date up to the current date are reloaded. 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. Type: cw1_srv_2.xxxx <instance> reload margin <date> Result: Enter the date from which you want to reload margin requirements. The margin requirements from the specified date up to the current date are reloaded. This operation restarts the server and thereby disconnects all clients during the restart. The clients are automatically reconnected again once 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. The clients will therefore be disconnected during this operation but they will be reconnected automatically when the server is restarted. 13. Type: exit Result: Exit from the am prompt About Housekeeping The 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, since housekeeping is not performed if current day or next day is a non-trading day. In this respect only Saturday and Sunday are considered non-trading days Renewing the Database Completely In some serious malfunction situations a complete cleanup of the database may be necessary. Perform the procedure from a DOS Command Prompt window. 50(52) The NASDAQ OMX Group, Inc. 2014

51 After Installation 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. 3. Drag and drop the server executable file into the DOS Command Prompt window. If the path name includes 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 Shrinking the Database To reduce the size of the database it is possible to execute a manual command in the DOS Command Prompt window. 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 OMX\Genium INET Clearing Workstation1\BinaryFiles\CW1_SRV_ exe" -shrinkdb -1 The NASDAQ OMX Group, Inc (52)

52 Clearing Workstation (CW1) Installation Guide 6. Press Enter. A confirmation message is displayed. The current physical database is reduced as much as possible. 52(52) The NASDAQ OMX Group, Inc. 2014