Monday, September 1, 2014

E-WMS: Installation and configuration of Microsoft IIS on Windows 7 Introduction

This document describes how to install and configure Microsoft IIS for E-WMS ASP on Windows 8 or Windows 7.

Description

Installation of Microsoft IIS

  • Go to [Start/Control Panel/Programs and Features]
  • Click in the left panel on "Turn Windows features on or off”
  • Expand “Internet Information Services” and enable these options:
    • Web Management Tools, IIS6 Management Compatibility, check “II6 Scripting tools”
    • Web Management Tools, IIS Management console
    • Web Management Tools, IIS Management Scripts and Tools
    • Web Management Tools, IIS Management Service
  • At 'World Wide Web Services/ Application Development Features', enable :
    • .NET Extensibility
    • ASP
    • ASP.NET
  • At 'World Wide Web Services/Common Http features', enable:
    • Static Content
  • Click “OK” and let Windows update. This may take some time.

Configuration of IIS

  • Go to Start/Control Panel/Administrative Tools and start “Internet Information Services (IIS) Manager”
  • In the left pane, expand server name, “Sites”, “Default web site”
  • Right-click on “Default web site” and choose “Add Application …” (not: virtual folder)
  • Alias = the name where the WMS site would be available, for instance "WMS"
  • Physical path = The path where the IIS files for WMS ASP are located, for example C:\E-WMS\IIS
    (note: these ASP files have to be extracted from the Exact.WMS.Web.zip file which is downloaded with the Globe product update)
  • Click 'OK'.
  • Click on your WMS virtual directory in the left pane and double-click “Authentication” in the options screen, make sure that 'Anonymous Authentication'is enabled. WMS does not use the other authentication methods. 
  • Click on your WMS virtual directory in the left pane and now double-click "ASP.Net Globalization" in the upper part of the middle pane. In this screen you can determine what regional settings to apply on the 'hand terminal', by setting the options 'Culture' and 'IU Culture'. This is especially important for input of decimals and dates on the hand terminal.

    Set these options to "English (United States) (en-us)" if you want to use the 'dot' as decimal sign. Set these options to "Dutch (Netherlands) (nl-nl)" if you want use the 'comma' as decimal sign. Keep in mind that on a hand terminal the 'dot'
    is often a separate key on the keyboard. When entering dates on the hand terminal, the format YYYY-MM-DD (2010-12-31) will always work, regardless of regional settings.

    English Us = enter decimals as 5.5 on the mobile device
    Dutch (NL) = enter decimals as 5,5 on the mobile device

Application Pool

WMS ASP requires .NET Framework 3.5 to run properly. (shown as '.NET Framework v2.0.50727'). In this IIS version the .NET version is managed through the IIS 'Application pool'.

Create a new Application Pool

Start the IIS manager and expand the server name. Right click on "Application Pools" and select Add Application Pool. Name the Application Pool, for instance E-WMS.

Set .NET to 2.0.50727 ( = Framework 3.5 - Framework 4 is not supported yet)
Set 'Managed pipeline mode' to 'Classic'
Press OK to save this new Application Pool.

Application Pool advanced settings

In 64-bit Windows,it is necessary to define a specific setting, which is only available in the Application Pool settings.
Start the IIS manager and expand the server name. Click on "Application Pools", a list with available Application Pools will show. Select the pool you want to use for E-WMS and then press right click,Advanced Settings.

On a 64 bit server, change the setting "Enable 32-bit Applications" to True and press OK.
Also make sure 'Managed Pipeline Mode' is set to 'Classic'.



Link Application Pool to E-WMS web site

When a specific Application Pool was configured for E-WMS, it still has to be linked to the E-WMS web site.
Start IIS manager, expand the server name, expand "Sites", expand "Default web site". Click on the E-WMS web site and choose Basic settings in the far right panel. Click on Select and choose the specific Application Pool which was created in the previous step:



Press OK to save this configuration.