Getting Started


This section describes how to deploy the OData Service Validation tool in local environment.

Download Source Code

Download the Source Code to a desired folder by GIT, e.g C:\ODataValidation

Build

  1. Browse to C:\ODataValidation\src and open ODataValidationTool.sln solution. This should bring up the project as well as its dependency projects:
    • ODataValidator.ODataValidationService.csproj contains the source code for Web frontend.
    • ODataValidator.RuleEngine.csproj contains the source code for the rule engine.
    • ODataValidator.XMLRules.csproj contains the XML based rules.
    • ODataValidator.CodeRules.csproj contains the code based rules.
  2. Build the ODataValidationService project
  3. Browse to C:\ODataValidator\src\ODataValidationService\deploy folder and run DeployLocal.bat. This will copy all the necessary binaries under the C:\ODataValidator\src\ODataValidationService\bin folder.

Configure IIS

  1. Create a new Windows account named ValidationService on the deployment machine. Make it an administrator account.
  2. Launch IIS Manager, and then create a new Virtual Directory named ODataValidator. Point the physical path to C:\ODataValidation\src\ODataValidationService\bin. (IIS Manager->Machine Name->Default Web Site->(On the Actions pane) View Virtual Directory->Add Virtual Directory)
  3. Create a new Application Pool named ValidationServicePool and select .NET 4.0 for the .NET Framework version. Use the ValidationService account for the Identity. (IIS Manager->Machine Name->Application Pool->Add Application Pool)
  4. Convert the Virtual Directory ODataValidator to an application. Select the ValidationServicePool for the application pool.
  5. Enable the Anonymous Authentication. Depending on your security requirement, you can choose to enable other authentication and disable the Anonymous Authentication. (IIS Manager->Machine Name->Default Web Site->OdataValidator->Authentication)

Deploy the Database

  1. Install SQL Server Standard Edition with basic management tools (eg: SQL Server 2008 R2 Standard)
  2. Launch SQL Server Management Studio. Make sure you run in admin mode (Right click and Launch it with “Run as Administrator”).
  3. Click File, click Open, and then click File.
  4. Browse to C:\ODataValidator\src\ODataValidationService\sql and then select CreateODataValidationSuiteDB.sql.
  5. Hit F5 to execute the T-SQL script. This will create the OdataValidationSuite database.
  6. Create a new SQL Login for the ValidationService user account (Obj explorer root->Security->Logins)
  7. Map this account to ODataValidationSuite database as dbowner.

Note: If SQL Server is on a remote machine, in addition to the above steps, you will need to modify the C:\ODataValidation\ODataValidationService\web.config to point to remote SQL Server instance.

Verify Deployment

  1. Launch your internet browser and browse to http://localhost/ODataValidator
  2. Enter http://services.odata.org/Northwind/Northwind.svc/ in the textbox and click the Validate button
  3. You should be able to see the validation results for the ATOM/XML payload format.
  4. Click the JSON radio button and click Validate again.
  5. You should be able to see the validation results for the JSON payload format.

Last edited Apr 23, 2014 at 1:33 AM by howang, version 2