Com-Trader Installation Guide
Table of Contents 1 Introduction 1 1.1. Java Web Start 1 1.2. Download Time 1 1.3. Definitions and Abbreviations 2 2 Installation of Components 3 2.1 Connectivity Setup 3 2.2 Software Installation 3 2.3 The Java Runtime Environment 4 2.3.1 Installing Java jre1.6.0_14 4 2.3.2 Setup of Java Web Start 4 2.4 Installing the Client Certificate for Client Authentication 9 3 Com-Trader Operations 10 3.1 Launch of the Com-Trader Application 10 3.1.1 How to start 10 3.1.2 Connect Screen 10 3.1.3 Selecting the Client Certificate 12 3.2 Purging the Caches 13 3.2.1 Purge the Java Cache 13 3.2.2 Purging the Browser Cache (MS Internet Explorer) 14 2
1 INTRODUCTION This document describes how to install Com-Trader. The software installation comprises two steps: 1. Installation of Java runtime environment to set up Java Web Start. 2. Application download using Java Web Start. A client certificate provided by Deutsche Börse Systems AG (DBS) is necessary to connect to DBS servers. The following application is included in the software distribution: Com-Trader Only MS Windows is supported to run Com-Trader. 1.1. Java Web Start Java Web Start is an application developed by Sun Microsystems. The Technology underlying Java Web Start is the Java Network Launching Protocol & API (JNLP). Java Web Start is a helper application that gets associated with a Web browser. When a user clicks on a link that points to a special launch file (JNLP file), it causes the browser to launch Java Web Start, which then automatically downloads, caches, and runs the given Java Technology-based application. The entire process is typically completed without requiring any user interaction, except for the initial single click. Every time an application that uses Java Web Start is launched, the JNLP checks if a new version of the application is available on the server. In this case the new version is automatically downloaded and launched. Thus the user has always the most recent version of the application. 1.2. Download Time The size of the Com-Trader GUI is about 10MB. The duration of the application download depends on the bandwidth and the quality of the Internet connection. Typical download durations are: ISDN connection about 20 minutes, DSL connection about 3 minutes.
1.3. Definitions and Abbreviations DBS: Deutsche Börse Systems AG GUI: Graphical User Interface JRE: Java Runtime Environment J2SE: Java 2 Platform Standard Edition JNLP: Java Network Launching Protocol URL: Uniform Resource Locator Page 2
2 INSTALLATION OF COMPONENTS 2.1 Connectivity Setup Prior to installation of Com-Trader it is necessary to ensure that a TCP/IP connection to the Internet can be established from the client workstation. The TCP/IP connection can be a dial-up connection (ISDN or DSL) or a direct LAN connection via proxy server and/or firewall. At this stage the Internet connectivity should be checked by using the selected browser (e.g. MS Internet Explorer, Mozilla, Opera). 2.2 Software Installation The Java Runtime Environment has to be installed at the beginning. The installation is started with a download from following webpage 1 : http://tradingsystems.eex.de/comtrader/prod Fig. 1: Com-Trader Website Production 1 A similar http://tradingsystems.eex.de/comtrader/simu exists for the simulation environment. Page 3
2.3 The Java Runtime Environment 2.3.1 Installing Java jre1.6.0_14 If you already have installed jre1.6.0_14 and set-up Java WebStart continue with section 2.4. Please note: You need administrator rights to install the program. 1. On the webpage select the link to download JRE 1.6.0_14. You will receive the archive home page for Java 1.6.0_14. 2. Select the link to download the JRE Download JRE. 3. Select Windows as platform and accept the license. 4. Click on the link Windows Offline Installation and save the file in a temporary directory. 5. Go to the directory in which you saved file and double-click it. 6. Follow the installation instructions for the JRE. Select Standard (typical) installation (installation of java in the c:\program Files\Java\jre1.6.0_14 folder) 7. Create a shortcut for Java Web Start as follows: Select folder C:\Program Files\Java\jre1.6.0_14\bin -> right-click the file javaws.exe; select the Copy item. Right-click on desktop; select the Paste Shortcut item. Now proceed with setting up Java Web Start. 2.3.2 Setup of Java Web Start 1. Double click the Java Web Start icon on your desktop. If there is no icon you can either create one as described in bullet 7 above or open the file c:\program Files\Java\jre1.6.0_14\bin\ javaws.exe and select Edit Preferences or go to Start > Settings > Control Panel > Double click on the Java icon. The Java Control Panel will start (Fig. 2). Page 4
Fig. 2: Use browser settings 2. Click on the Network Settings button. The Network Settings dialog will shine up. Choose the Use browser settings Radio Button (Fig.3). Fig. 3: Use browser settings Page 5
3. Return to the Java Control Panel by pressing the OK button. On the Java Control Panel click on the Java tab ( Fig. 4). Fig. 4: Defining the Java Application Runtime Settings Page 6
4. Click on the "View " button for the runtime setting for Java applications (lower panel of the screen, Fig. 5) Fig. 5: Enabling the Java Runtime Engine 5. Check that the following version of the JRE is present and active in the User Tab: 1.6.0_14. 1.6.0_ If this not the case, then add it by using the "Find..." button of this panel. 6. Return to the Java Control Panel by pressing the OK button. On the Java Control Panel click on the Ad A vanced tab ( Fig. 6). Set the Security Properties as depicted. Copyright 2010 20 All rights reserved Page 7
Fig. 6: Recommended Security Settings 7. Press the OK button and close the Java Control Panel. Page 8
2.4 Installing the Client Certificate for Client Authentication The DBS provides a Client Certificate and a password to access the file. The information provided is security relevant. The information should NOT be disclosed to any person except the user who will be using the Web Access connection. The Client Certificate is handed out separately as a file, e,g, prod.intraday-power-trading.p12. Copy the file to a secure personal folder such as C:\Documents and Settings\mustermann\webaccess\<level> where level is <simu> or <prod>. Page 9
3 COM-TRADER OPERATIONS This chapter outlines operations for the Com-Trader application. To launch any of these components, the user needs to use the browser to start the application (please refer to section 3.1.1). The applications discussed here require certain parameters, e.g. proxy. These parameters are stored. For efficiency reasons the Java Web Start software caches the downloaded files. Normally, the cached files are compared to the versions held at the server and downloaded again if changes are observed. Also the webproxy (if present) and the browser use their own caches. Those caches only store data which are not supposed to change. All three cache instances may interfere with the requirement to have access to the latest version of the software. Please find in section 3.2 the necessary steps to purge all involved caches to enforce a complete download of the applicable software. 3.1 Launch of the Com-Trader Application As the Com-Trader GUI needs the Java Runtime Environment version 1.6.0_14, you will be asked after the application s download to download and install such Java JRE version if it is not yet installed. This task will be performed automatically by Java Web Start. 3.1.1 How to start 1. Start the browser. 2. Enter the following link to the Com-Trader download page: http://tradingsystems.eex.de/comtrader/prod. 3. Click on the Start ComTrader GUI link. (see section 2.2) 3.1.2 Connect Screen When the application is started the System Connection screen appears (Fig. 7). It should show you your default system proxy detected by Com-Trader. Page 10
Fig. 7: System Connection Window The connect screen has the following elements: - Direct Connection Checkbox: If this field is checked, the connection is made via internet - Leased Line check box: If this field is checked, the connection is made via leased line (only in PROD mode, requires dedicated leased lines). - Connection via Proxy Server: If this field is checked, the user is prompted to enter the user ID and password to authenticate against a local proxy server. - ProxyIP entry field: Enter the IP address of the proxy. If no proxy is used leave it blank. In case the proxy needs a Username and Passwords also those fields need to be filled Page 11
3.1.3 Selecting the Client Certificate After closure of the Connect Screen a file chooser appears to select the client certificate (Fig. 8). The Client Certificate is used for authenticating the client. The certificate is protected by a password, thus the user is asked to enter the password in a dialog if a certificate was chosen before (Fig. 8). Both certificate and password are provided by DBS, see chapter 2.4. The certificate password needs to be entered each time the ComTrader is launched whereas the location of the certificate file is memorized. Fig. 8: File Chooser for selecting the Client Certificate Fig. 9: Password for Client Certificate Page 12
3.2 Purging the Caches This section explains the necessary steps to purge the involved caches on the workstation. 3.2.1 Purge the Java Cache 1. - Go to "Start > Settings > Control Panel, double click on the Java icon, start the Java Control Panel and select Settings. The dialog window Temporary Files Settings will shine up, Fig. 10. Fig. 10: The File Settingf dialog 2. Press the button Delete Files Fig. 10 The File Setting dialog Fig. 11: Delete Files of Webstart Page 13
3.2.2 Purging the Browser Cache (MS Internet Explorer) 1. Start the MS Internet explorer and select Tools -> Internet Options 2. Select Delete (Fig 12) Fig. 12: Delete Files of Browser Page 14
3. Press button Delete all (Fig. 13) Fig. 13: Delete all temporary Browser Files Page 15