MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_NextPart_01C9B796.6A9EA8D0" This document is a Single File Web Page, also known as a Web Archive file. If you are seeing this message, your browser or editor doesn't support Web Archive files. Please download a browser that supports Web Archive, such as Windows® Internet Explorer®. ------=_NextPart_01C9B796.6A9EA8D0 Content-Location: file:///C:/EA821A05/ReadMe.htm Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset="us-ascii"

Stonehenge/Apache .Net ReadMe

Getting Started

Stonehenge .Net StockTrader for Apache is a subset and fork of Microsoft's .NET= StockTrader Sample Application on MSDN. The or= iginal StockTrader can be used as a reference. It is l= ocated at h= ttp://msdn.microsoft.com/en-us/netframework/bb499684.aspx.  A main difference is that this version does NOT include the configuration management features of the MSDN = .Net StockTrader. Configuration is done manually. The expected audience is an experienced developer with knowledge of C# and SOA = with WCF.

Install instructions for Stonehenge/Apache .Net <= span class=3DSpellE>StockTrader.

1.=       = Get software from https://svn.apache.org/repos/asf/incubator/stonehenge/trunk/s= tocktrader/dotnet/

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          a.   &nb= sp;  I recommend you use ank= hSVN and open project from VisualStudio

2.=       = As a prerequisite you should

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          a.   &nb= sp;  Install .net 3.5 SP1

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         b.   &nb= sp;  IIS - Web Service Role with Static Content feature enabled

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          c.   &nb= sp;  Install SQL Server 2008 with mixed mode authentication

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         d.   &nb= sp;  Enable the sa account with a password.

i.=       =    You will need to edit the SetupActions.exe.config file to add that password later

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         e.   &nb= sp;  Install asp.net 3.5 

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;           f.   &nb= sp;  If you setup IIS before this you may need to= run setup\util\servicemodelreg64.cmd (or servicemod= el.cmd if you run 32 bit)

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          g.   &nb= sp;  Optional: You may want to enable network discovery so you can browse to shares with code. this may not be needed for a single server install but if you are going to use m= ore than one machine then this is a good option.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         h.   &nb= sp;  Install Visual Studio 2008

3.=       = Seed the database and create accounts

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          a.   &nb= sp;  In the directory: C:\StockTraderDemo\setup_utilities\SetupActions

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         b.   &nb= sp;  Edit the .config= file to set the right "dbPassword" for the sa account.  This is App.c= onfig in your solution. When you build it is renamed to [program name].exe.config.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          c.   &nb= sp;  Set the dbserver variable to point to your MSSQL instance. You might be able to set it to &q= uot;." for the simplest case. If you use SQLExpress or a named instance= it will be different (eg. “.\SQLExpress<= /span>”).

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         d.   &nb= sp;  Compile the project

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         e.   &nb= sp;  From a console run SetupActions.exe (with elevated privilege - i.e. run as admin)

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;           f.   &nb= sp;  Open ports 8000 and 9000 on your firewall.

i.=       =    Control Panel->Windows Firewall->"Allow a program through the fire wall"

ii= .      = You will get to a dialog, choose exceptions Tab

ii= i.      Click Add Port

iv= .     Name it "8000" and put 8000 in the port Number field

v.=       = Ok

vi= .     Repeat for 9000

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          g.   &nb= sp;  Refresh the password in the trade account s/= b 'yyy'

i.=       =    In Microsoft SQL Server Management Studio

ii= .      = Security->Logins->Trade

ii= i.      Right click on trade->properties

iv= .     Edit password

4.=       = In IIS manager , Under Default Website, Add a Virtual Application  for TRADE and point it to C:\StockTraderDemo\trader_client\trade

5.=       = Installing a Test Certificate per Documentation\Configuration.pdf page 49.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          a.   &nb= sp;  Install three certificates: \\[stocktrader installation dir]\setup utilities\util\stocktra= derpfxfile.pfx, BSLClient.pfx, OPSHost.pfx

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         b.   &nb= sp;  Use mmc ->Certificates and choose Computer account (to access the computer accou= nt you will need to start mmc as an administrator)=

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          c.   &nb= sp;  Now, open the Certificates Folder, and then = open the Trusted People folder.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         d.   &nb= sp;  Right click on the Trusted People folder, and choose All Tasks, Import.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         e.   &nb= sp;  This brings up the Import wizard.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;           f.   &nb= sp;  Choose Next, then= click Browse.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          g.   &nb= sp;  Make sure to change the displayed file types= to “Personal Information Exchange (*.pfx; *p12) file types.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         h.   &nb= sp;  Browse to and select the \[stocktrader installation dir]\setup_utilities\util\stocktraderpfxfile.pfx file.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;            i.   &nb= sp;  Click Next.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;           j.   &nb= sp;  You will be prompted for a password.  The password is ‘yyy’. This is the StockTra= der db password NOT the sa password.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          k.   &nb= sp;  Click Next, Next and Finish to import the certificate to the \local computer\Trusted People certifi= cate store.

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;            l.   &nb= sp;  Repeat for BSLClient.pfx, OPSHost.pfx certificates

6.=       = Build The solutions - It is expected that you have Visual Studio 2008 installed

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          a.   &nb= sp;  It is strongly recommended you use this tree structure or else you will have to change the post build commands

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         b.   &nb= sp;  Build in order

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          c.   &nb= sp;  OrderProcessorSolution.sln

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         d.   &nb= sp;  BusinessServiceSolution.sln

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         e.   &nb= sp;  StockTraderWebAppSolution.sln

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;           f.   &nb= sp;  Binaries are copied by build to order_processor\bin\Debug, busin= ess_service\bin\Debug, trade_client\bin\Debug respectively

7.=       = To run 

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          a.   &nb= sp;  You will need to create a virtual application directory for our web app. (Step 4 above)

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         b.   &nb= sp;  Default setup will be M= sec_http (all config files will be in sync for this)

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;          c.   &nb= sp;  In a console (with elevated privilege - i.e.= run as admin), In the ..\order_= processor\bin\Debug directory run  Trade.OrderProcessorConsoleHost.exe

i.&n= bsp;       Con= sole App should remain open and active (do not exit application!)

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         d.   &nb= sp;  In a console(with elevated privilege - i.e. run as admin), in the   ..\business_service\bin\Debug directory run  Trade.BusinessServiceConsole.exe

i.&n= bsp;       Con= sole App should remain open and active (do not exit application!)

&nbs= p;            &= nbsp;           &nbs= p;            &= nbsp;         e.   &nb= sp;  In a browser, run the Web app http://localhost/trade/

II= .      Configuration:

You must have a configuration setup to use StockTr= ader

As built this StockTrader = version supports four modes of operation. These are configurable via the config files in the C directories listed below

·         "Http_WebService_MSecurity= ": This is WS* with security and is the Default Configuration

·         "Http_WebService&qu= ot;: This is normal HTTP.

·         “InProcess": In this mode all the processes run inside the web application process.

·         "Http_WSO= 2_WebService_MSecurity": This is a hook left for various connections with WSO2 components. [Is this deprecated since the WSO2 implementation is WS-* compliant now isn’t = it? If so shouldn’t the document state that this is deprecated and should= not be used?]

 

To change a configuration:

In general you edit the configurations, save them and restart the applications

Http_WebService_MSecurity: This is the defa= ult configuration and the config files are setup ou= t of the box to use this.

·         Edit the \trader_client= \Trade\Web.config   

<add key=3D"ACCESS_MODE" value= =3D"Http_WebService_MSecurity"/>

<add key=3D"ORDER_PROCESSING_MODE&quo= t; value=3D"ASync_Http_MSecurity"/>

·         Edit the \business_service\bin\debug\Trade.BusinessServiceConsole.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value= =3D"ASync_Http_MSecurity" />

·         Edit the \order_processor\bin\debug\Trade.OrderProcessorConsoleHost.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value= =3D"ASync_Http_MSecurity" />

Http_WebService:

·         Edit the \trader_client= \Trade\Web.config   

<add key=3D"ACCESS_MODE" value= =3D"Http_WebService"/>

<add key=3D"ORDER_PROCESSING_MODE&quo= t; value=3D"ASync_Http"/>

·         Edit the \business_service\bin\debug\Trade.B= usinessServiceConsole.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value= =3D"ASync_Http" />

·         Edit the \order_processor\bin\debug\Trade.Or= derProcessorConsoleHost.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value= =3D"ASync_Http" />

 

InProcess:  In this mode all the proce= sses run inside the web application process. (Note you can have alternate combinations of configuration modes between Business Service Layer and Order Processing Service in these modes)

·         Edit the \trader_client= \Trade\Web.config   

<add key=3D"ACCESS_MODE" value= =3D"Http_InProcess"/>

<add key=3D"ORDER_PROCESSING_MODE&quo= t; value=3D"Sync_Inprocess"/>

·         Edit the\business_service\bin\debug\Trade.Bu= sinessServiceConsole.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value= =3D" Sync_Inprocess" />

·         Edit the \order_processor\bin\debug\Trade.Or= derProcessorConsoleHost.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value= =3D" Sync_Inprocess" />

 

Http_WSO2_WebService_MSecurity: This is left for hooks into various connections with WSO2 components.

These are place holders f= or any WSO2 configuration desired.

·         Edit the \trader_client= \Trade\Web.config   

<add key=3D"ACCESS_MODE" value=3D"Http_WebService_WSO2_MSecurity"/>

<add key=3D"ORDER_PROCESSING_MODE&quo= t; value=3D"ASync_WSO2_Http_MSecurity"/>

·         Edit the \business_service\bin\debug\Trade.B= usinessServiceConsole.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value=3D"ASync_WSO2_Http_MSecurity" />

·         Edit the \order_processor\bin\debug\Trade.Or= derProcessorConsoleHost.exe.config

<add key=3D"ORDER_PROCESSING_MODE" value=3D"ASync_WSO2_Http_MSecurity" />

 

------=_NextPart_01C9B796.6A9EA8D0 Content-Location: file:///C:/EA821A05/ReadMe_files/item0001.xml Content-Transfer-Encoding: quoted-printable Content-Type: text/xml ------=_NextPart_01C9B796.6A9EA8D0 Content-Location: file:///C:/EA821A05/ReadMe_files/props0002.xml Content-Transfer-Encoding: quoted-printable Content-Type: text/xml ------=_NextPart_01C9B796.6A9EA8D0 Content-Location: file:///C:/EA821A05/ReadMe_files/themedata.thmx Content-Transfer-Encoding: base64 Content-Type: application/vnd.ms-officetheme UEsDBBQABgAIAAAAIQCCirwT+gAAABwCAAATAAAAW0NvbnRlbnRfVHlwZXNdLnhtbKyRy2rDMBBF 94X+g9C22HK6KKXYzqJJd30s0g8Y5LEtao+ENAnJ33fsuFC6CC10IxBizpl7Va6P46AOGJPzVOlV XmiFZH3jqKv0++4pu9cqMVADgyes9AmTXtfXV+XuFDApmaZU6Z45PBiTbI8jpNwHJHlpfRyB5Ro7 E8B+QIfmtijujPXESJzxxNB1+SoLRNegeoPILzCKx7Cg8Pv5DCSAmAtYq8czYVqi0hDC4CywRDAH an7oM9+2zmLj7X4UaT6DF9jNBDO/XGD1P+ov5wZb2A+stkfp4lx/xCH9LdtSay6Tc/7Uu5AuGC6X t7Rh5r+tPwEAAP//AwBQSwMEFAAGAAgAAAAhAKXWp+fAAAAANgEAAAsAAABfcmVscy8ucmVsc4SP z2rDMAyH74W9g9F9UdLDGCV2L6WQQy+jfQDhKH9oIhvbG+vbT8cGCrsIhKTv96k9/q6L+eGU5yAW mqoGw+JDP8to4XY9v3+CyYWkpyUIW3hwhqN727VfvFDRozzNMRulSLYwlRIPiNlPvFKuQmTRyRDS SkXbNGIkf6eRcV/XH5ieGeA2TNP1FlLXN2Cuj6jJ/7PDMMyeT8F/ryzlRQRuN5RMaeRioagv41O9 kKhlqtQe0LW4+db9AQAA//8DAFBLAwQUAAYACAAAACEAa3mWFoMAAACKAAAAHAAAAHRoZW1lL3Ro ZW1lL3RoZW1lTWFuYWdlci54bWwMzE0KwyAQQOF9oXeQ2TdjuyhFYrLLrrv2AEOcGkHHoNKf29fl 44M3zt8U1ZtLDVksnAcNimXNLoi38Hwspxuo2kgcxSxs4ccV5ul4GMm0jRPfSchzUX0j1ZCFrbXd INa1K9Uh7yzdXrkkaj2LR1fo0/cp4kXrKyYKAjj9AQAA//8DAFBLAwQUAAYACAAAACEAlrWt4pYG AABQGwAAFgAAAHRoZW1lL3RoZW1lL3RoZW1lMS54bWzsWU9v2zYUvw/YdyB0b2MndhoHdYrYsZst TRvEboceaYmW2FCiQNJJfRva44ABw7phhxXYbYdhW4EW2KX7NNk6bB3Qr7BHUpLFWF6SNtiKrT4k Evnj+/8eH6mr1+7HDB0SISlP2l79cs1DJPF5QJOw7d0e9i+teUgqnASY8YS0vSmR3rWN99+7itdV RGKCYH0i13Hbi5RK15eWpA/DWF7mKUlgbsxFjBW8inApEPgI6MZsablWW12KMU08lOAYyN4aj6lP 0FCT9DZy4j0Gr4mSesBnYqBJE2eFwQYHdY2QU9llAh1i1vaAT8CPhuS+8hDDUsFE26uZn7e0cXUJ r2eLmFqwtrSub37ZumxBcLBseIpwVDCt9xutK1sFfQNgah7X6/W6vXpBzwCw74OmVpYyzUZ/rd7J aZZA9nGedrfWrDVcfIn+ypzMrU6n02xlsliiBmQfG3P4tdpqY3PZwRuQxTfn8I3OZre76uANyOJX 5/D9K63Vhos3oIjR5GAOrR3a72fUC8iYs+1K+BrA12oZfIaCaCiiS7MY80QtirUY3+OiDwANZFjR BKlpSsbYhyju4ngkKNYM8DrBpRk75Mu5Ic0LSV/QVLW9D1MMGTGj9+r596+eP0XHD54dP/jp+OHD 4wc/WkLOqm2chOVVL7/97M/HH6M/nn7z8tEX1XhZxv/6wye//Px5NRDSZybOiy+f/PbsyYuvPv39 u0cV8E2BR2X4kMZEopvkCO3zGBQzVnElJyNxvhXDCNPyis0klDjBmksF/Z6KHPTNKWaZdxw5OsS1 4B0B5aMKeH1yzxF4EImJohWcd6LYAe5yzjpcVFphR/MqmXk4ScJq5mJSxu1jfFjFu4sTx7+9SQp1 Mw9LR/FuRBwx9xhOFA5JQhTSc/yAkArt7lLq2HWX+oJLPlboLkUdTCtNMqQjJ5pmi7ZpDH6ZVukM /nZss3sHdTir0nqLHLpIyArMKoQfEuaY8TqeKBxXkRzimJUNfgOrqErIwVT4ZVxPKvB0SBhHvYBI WbXmlgB9S07fwVCxKt2+y6axixSKHlTRvIE5LyO3+EE3wnFahR3QJCpjP5AHEKIY7XFVBd/lbobo d/ADTha6+w4ljrtPrwa3aeiINAsQPTMR2pdQqp0KHNPk78oxo1CPbQxcXDmGAvji68cVkfW2FuJN 2JOqMmH7RPldhDtZdLtcBPTtr7lbeJLsEQjz+Y3nXcl9V3K9/3zJXZTPZy20s9oKZVf3DbYpNi1y vLBDHlPGBmrKyA1pmmQJ+0TQh0G9zpwOSXFiSiN4zOq6gwsFNmuQ4OojqqJBhFNosOueJhLKjHQo UcolHOzMcCVtjYcmXdljYVMfGGw9kFjt8sAOr+jh/FxQkDG7TWgOnzmjFU3grMxWrmREQe3XYVbX Qp2ZW92IZkqdw61QGXw4rxoMFtaEBgRB2wJWXoXzuWYNBxPMSKDtbvfe3C3GCxfpIhnhgGQ+0nrP +6hunJTHirkJgNip8JE+5J1itRK3lib7BtzO4qQyu8YCdrn33sRLeQTPvKTz9kQ6sqScnCxBR22v 1VxuesjHadsbw5kWHuMUvC51z4dZCBdDvhI27E9NZpPlM2+2csXcJKjDNYW1+5zCTh1IhVRbWEY2 NMxUFgIs0Zys/MtNMOtFKWAj/TWkWFmDYPjXpAA7uq4l4zHxVdnZpRFtO/ualVI+UUQMouAIjdhE 7GNwvw5V0CegEq4mTEXQL3CPpq1tptzinCVd+fbK4Ow4ZmmEs3KrUzTPZAs3eVzIYN5K4oFulbIb 5c6vikn5C1KlHMb/M1X0fgI3BSuB9oAP17gCI52vbY8LFXGoQmlE/b6AxsHUDogWuIuFaQgquEw2 /wU51P9tzlkaJq3hwKf2aYgEhf1IRYKQPShLJvpOIVbP9i5LkmWETESVxJWpFXtEDgkb6hq4qvd2 D0UQ6qaaZGXA4E7Gn/ueZdAo1E1OOd+cGlLsvTYH/unOxyYzKOXWYdPQ5PYvRKzYVe16szzfe8uK 6IlZm9XIswKYlbaCVpb2rynCObdaW7HmNF5u5sKBF+c1hsGiIUrhvgfpP7D/UeEz+2VCb6hDvg+1 FcGHBk0Mwgai+pJtPJAukHZwBI2THbTBpElZ02atk7ZavllfcKdb8D1hbC3ZWfx9TmMXzZnLzsnF izR2ZmHH1nZsoanBsydTFIbG+UHGOMZ80ip/deKje+DoLbjfnzAlTTDBNyWBofUcmDyA5LcczdKN vwAAAP//AwBQSwMEFAAGAAgAAAAhAA3RkJ+2AAAAGwEAACcAAAB0aGVtZS90aGVtZS9fcmVscy90 aGVtZU1hbmFnZXIueG1sLnJlbHOEj00KwjAUhPeCdwhvb9O6EJEm3YjQrdQDhOQ1DTY/JFHs7Q2u LAguh2G+mWm7l53JE2My3jFoqhoIOumVcZrBbbjsjkBSFk6J2TtksGCCjm837RVnkUsoTSYkUigu MZhyDidKk5zQilT5gK44o49W5CKjpkHIu9BI93V9oPGbAXzFJL1iEHvVABmWUJr/s/04GolnLx8W Xf5RQXPZhQUoosbM4CObqkwEylu6usTfAAAA//8DAFBLAQItABQABgAIAAAAIQCCirwT+gAAABwC AAATAAAAAAAAAAAAAAAAAAAAAABbQ29udGVudF9UeXBlc10ueG1sUEsBAi0AFAAGAAgAAAAhAKXW p+fAAAAANgEAAAsAAAAAAAAAAAAAAAAAKwEAAF9yZWxzLy5yZWxzUEsBAi0AFAAGAAgAAAAhAGt5 lhaDAAAAigAAABwAAAAAAAAAAAAAAAAAFAIAAHRoZW1lL3RoZW1lL3RoZW1lTWFuYWdlci54bWxQ SwECLQAUAAYACAAAACEAlrWt4pYGAABQGwAAFgAAAAAAAAAAAAAAAADRAgAAdGhlbWUvdGhlbWUv dGhlbWUxLnhtbFBLAQItABQABgAIAAAAIQAN0ZCftgAAABsBAAAnAAAAAAAAAAAAAAAAAJsJAAB0 aGVtZS90aGVtZS9fcmVscy90aGVtZU1hbmFnZXIueG1sLnJlbHNQSwUGAAAAAAUABQBdAQAAlgoA AAAA ------=_NextPart_01C9B796.6A9EA8D0 Content-Location: file:///C:/EA821A05/ReadMe_files/colorschememapping.xml Content-Transfer-Encoding: quoted-printable Content-Type: text/xml ------=_NextPart_01C9B796.6A9EA8D0 Content-Location: file:///C:/EA821A05/ReadMe_files/filelist.xml Content-Transfer-Encoding: quoted-printable Content-Type: text/xml; charset="utf-8" ------=_NextPart_01C9B796.6A9EA8D0--