Stonehenge/Apache .NET ReadMe

Apache License

Licensed to the Apache Software Fo= undation (ASF) under one or more contributor license agreements. See the NOTICE file distributed th= is work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with t= he License. You may obtain a cop= y of the License at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writ= ing, software distributed under the License is distributed on an "AS IS&quo= t; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or impl= ied. See the License for the specific language governing permissions and limitat= ions under the License.

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.

Installing the Stonehenge/Apache .Net StockTrader Application

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; It is recommended that you use Tortoise (http://tortoisesvn.net/) to download = the entire source tree to C:\StockTraderDemo.

2.= Install Prerequisites, if you don’t have these requirements you can follow th= e Express Requirements Install Guide

&nbs= p; &= nbsp; &nbs= p; &= nbsp; a. &nb= sp; Internet Information Server (IIS) - Web Service Role with Static Content feature ena= bled

&nbs= p; &= nbsp; &nbs= p; &= nbsp; b. &nb= sp; Install Visual Studio 2008 or Visual Web Developer Express 2008

&nbs= p; &= nbsp; &nbs= p; &= nbsp; c. &nb= sp; Install .NET 3.5 SP1

&nbs= p; &= nbsp; &nbs= p; &= nbsp; d. &nb= sp; Install ASP.NET 3.5

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

i.= = Enable the sa account with a password. You will need the p= assword for sa later.

ii= . If SQL Server 2008 is already installed without mixed mode authentication and/= or sa is disabled:

a.= Open the SQL Server 2008 Management Studio

b.= Connect to SQL Server using windows authentication

c.= Right click the server name and choose properties

d.= Go to security tab. Change server authentication to “SQL Server and Wind= ows Authentication mode”

e.= Click OK and restart SQL Server

f.= = Go to SQL Server 2008 Management Studio

g.= Expand the server and choose security and expand logins

h.= Right click on sa, from properties modify the passwor= d and confirm password

&nbs= p; &= nbsp; &nbs= p; &= nbsp; f. &nb= sp; If you setup IIS before this you may need to run setup_ut= ilities\util\servicemodelreg64.cmd (or servicemodel.cmd if yo= u 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 c= ode. This may not be needed for a = single server install but if you are going to use more than one machine then this = is a good option.

3.= Seed the database and create accounts

&nbs= p; &= nbsp; &nbs= p; &= nbsp; a. &nb= sp; Open the solution setup_utilities\SetupActions\SetupActions.sln

&nbs= p; &= nbsp; &nbs= p; &= nbsp; b. &nb= sp; Open the App.config in your solution. When you build= the project this will be renamed to [program name].exe.con= fig.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; c. &nb= sp; If you checked-out the solution to a different directory then C:\StockTraderDe= mo, then update the installP= ath setting with the proper path.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; d. &nb= sp; Set the dbserver= key to point to your MSSQL instance. You might be able to set it to "<= strong>." 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; e. &nb= sp; Set the right dbPasswo= rd for the sa account.<= span style=3D'mso-spacerun:yes'> Run the project

&nbs= p; &= nbsp; &nbs= p; &= nbsp; f. &nb= sp; Press any key when the SetupActions has completed.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; g. &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.= Repeat for 9000

4.= Setup the website under IIS

&nbs= p; &= nbsp; &nbs= p; &= nbsp; a. &nb= sp; In IIS manager

&nbs= p; &= nbsp; &nbs= p; &= nbsp; b. &nb= sp; Right-click Default Website and choose Add a Virtual Directory

&nbs= p; &= nbsp; &nbs= p; &= nbsp; c. &nb= sp; Enter trade as the alias.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; d. &nb= sp; Select trader_client\trade as the physical path

&nbs= p; &= nbsp; &nbs= p; &= nbsp; e. &nb= sp; If your running vista, right-click the virtual directory and choose Convert to Application.

5.= Install the Test Certificates

&nbs= p; &= nbsp; &nbs= p; &= nbsp; a. &nb= sp; Install three certificates: setup_utilities\Util\ stocktraderpfxfile.pfx, BSLClient.pfx, OPSHost.= pfx

&nbs= p; &= nbsp; &nbs= p; &= nbsp; b. &nb= sp; Run mmc

&nbs= p; &= nbsp; &nbs= p; &= nbsp; c. &nb= sp; In mmc go to File -> Add/Remove Snap-in…<= /p>

&nbs= p; &= nbsp; &nbs= p; &= nbsp; d. &nb= sp; Add Certificates and select Computer Account and choose Next then choose Finish.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; e. &nb= sp; Push Ok to return to mmc

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

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

&nbs= p; &= nbsp; &nbs= p; &= nbsp; h. &nb= sp; This will bring up the Import wizard.

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

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

&nbs= p; &= nbsp; &nbs= p; &= nbsp; k. &nb= sp; Browse to and select the setup_utilities\util\stocktraderpfxfile.pfx file.

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

&nbs= p; &= nbsp; &nbs= p; m. &nb= sp; You will be prompted for a password. The password is ‘yyy’.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; n. &nb= sp; Click Next, Next, and Finish to import the certificate= to the \Local Computer\Trusted People certificate store.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; o. &nb= sp; Repeat for the BSLClient.pfx and OPSHost.pfx certificates.

&nbs= p; &= nbsp; &nbs= p; &= nbsp; p. &nb= sp; If you are running Windows Server 2003 or Windows XP you will need to repeat t= hese steps with the Local Computer\Trusted Root Certificate Authorities folder.<= /p>

6.= Build the solutions

&nbs= p; &= nbsp; &nbs= p; &= nbsp; a. &nb= sp; Double-click the BuidDotNet.cmd script to build the solution

&nbs= p; &= nbsp; &nbs= p; &= nbsp; b. &nb= sp; Binaries are copied by build to order_processor\bin\Debu= g, business_service\bin\Debug, trad= e_client\bin\Debug respectively

&nbs= p; &= nbsp; &nbs= p; &= nbsp; c. &nb= sp; If you specified a database instance name in the section 3, you will need to update the config files to point to the proper database instance. The config files are located in the same directory as the= .exe files, and they contain the extension .exe.config. If you are using the InProcess Access method of the .NET Website you will also need to update the database instance name in the web.config file in the Tra= de directory.

7.= Run the StockTrader demo

&nbs= p; &= nbsp; &nbs= p; &= nbsp; a. &nb= sp; Start the Order Processor and Business Service.&= nbsp;

i.= = Right click the RunServices.bat file and choose Run as Administrator.

ii= . Choose either a run mode of either Debug or Release.

ii= i. This will start both the OrderProcessorService and t= he BusinessService console applications.

Console App should remain open and active (do n= ot exit application!)

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

The default configuration for the .NET StockTrader Website is to use the DotNet_Http_WcfService for communicating with the Business Service, and ASync_Htt= p_MSecurity when processing orders. For m= ore information on configuration options see the Stonehenge Interoperability Walk-through.