Skip to main content

Setup & Deployment Guide

1. Prerequisites​

Software Requirements​

  • OS: Windows 10/11 (Required for IIS).
  • IDE: Visual Studio 2019 or 2022.
  • Runtime: .NET Framework 4.8 Developer Pack.
  • Database: SQL Server (Local or Network accessible).
  • Web Server: Internet Information Services (IIS) enabled.

Hosts File Configuration​

Add the following entries to C:\Windows\System32\drivers\etc\hosts:

127.0.0.1   bo.wep.local
127.0.0.1   crm.wep.local
127.0.0.1   omgt.wep.local
127.0.0.1   wepaccess.local
127.0.0.1   www.windrose.local
127.0.0.1   wssexpert.wep.local
127.0.0.1   api.wep.local

2. IIS Configuration​

The solution relies on Local IIS (not IIS Express) with specific Virtual Directory mappings to share content across applications.

Application Pool​

  • Name: WepNG (suggested)
  • CLR Version: v4.0
  • Pipeline Mode: Integrated
  • Identity: LocalSystem or User with Read/Write access to the project folder.

Site Bindings & Virtual Directories​

Map the following sites in IIS to the physical paths. Root Path Reference: Assumed to be C:\Projects\WepNG_MVC\ (Adjust to your actual clone path).

1. BackOffice (http://bo.wep.local)​

  • Physical Path: WepNG_BO
  • Virtual Directories:
    • /Content/wepcommon -> ..\EITWEP.WEPUtils\Content\themes\wep
    • /resources -> ..\WepNG_Public\Resources
    • /resources/Scripts -> ..\WepNG_Public\Scripts
    • /resources/Content -> ..\WepNG_Public\Content
    • /Uploads -> WepNG_BO\App_Data\Uploads (Self, but explicated)

2. CRM (http://crm.wep.local)​

  • Physical Path: WepNG_CRM
  • Virtual Directories:
    • /Content/wepcommon -> ..\EITWEP.WEPUtils\Content\themes\wep
    • /resources -> ..\WepNG_Public\Resources
    • /Uploads -> ..\WepNG_BO\App_Data\Uploads

3. Order Management (http://omgt.wep.local)​

  • Physical Path: WepNG_OMGT
  • Virtual Directories:
    • /Content/resources/wepcommon -> ..\EITWEP.WEPUtils\Content\themes\wep
    • /Content/resources/common -> ..\..\EIT_NET\EIT.Web.Resources\Content (External Dependency)
    • /Scripts/kendo -> ..\..\EIT_NET\EIT.Web.Resources\Scripts\kendo (External Dependency)
    • /Uploads -> ..\WepNG_BO\App_Data\Uploads

4. API (http://api.wep.local)​

  • Physical Path: WepNG_API
  • Note: Referenced in WepNG_API.csproj as UseIIS: True.

3. Configuration Files​

Shared Configuration​

  • File: EITWEP.WEPUtils/WEPConfigCommon.config
  • Purpose: Contains shared appSettings linked to all web projects via <appSettings file="...">.
  • Keys:
    • OWIN_COOKIE_DOMAIN: Set to .wep.local for Single Sign-On (SSO) across subdomains.

Database Connection​

  • Default Connection String: ConnectionString.SQL Server (SqlClient)
  • Target: localhost\SQLSERVER
  • Credentials: User ID=sa; Password=... (See Web.config for dev defaults).

4. Key Dependencies​

  • EIT_NET: Sibling repository expected at ../../EIT_NET.
  • EIT_EOFFICE: Sibling repository expected at ../../EIT_EOFFICE.
  • WSS: Sibling repository expected at ../../WSS (for wssexpert).

[!WARNING] Failure to clone sibling repositories in the expected relative paths will cause build failures and missing assets in IIS.