1.0.0.0

Page 1 of 14 / Working copy if printed
C:\Users\conor.brannigan\Documents\Documetation STO\Web Service - Manual Installation Guide.doc
 Measuresoft Development Ltd. / Version: 1.0.0.0

Web Service – Manual Installation Guide

Contents

1.Installing and Configuring IIS

1.1.Installation

1.2.Feature Delegation

1.3.Application Pool

2.Installing Web Service Files

3.Web Service Setup in IIS

3.1.Create Application

3.2.Configure Handler Mappings

3.3.Remove Hidden Segment – Request Filtering

4.Application Testing

4.1.Product Logo

1.Installing and Configuring IIS

1.1.Installation

  • Go to Start/Control Panel/ Programs & Features
  • Navigate to the left-hand panel of the Window and select “Turn Windows Features on or off”

  • Under Internet Information Services,
  • Click the drop down for Web Management Tools and check IIS Management console.
  • Check everything in World Wide Web services and then click OK.

1.2.Feature Delegation

  • Open IIS
  • From the IIS menu, scroll down to the management section and click on “Feature Delegation”

  • Enable all features to Read/Write mode or Configuration Read/Write mode where applicable.

1.3.Application Pool

  • When using a 64-bit system, the application will not be able to display by default as this is a 32-bit application.
  • Expand the top menu and select “Application Pools”

  • Select DefaultAppPool, Right-Click and choose Advanced Settings

  • In the menu, under the General tab, set Enable 32-bit applications to True.

2.Installing Web Service Files

  • Copy Service.dll to the root of the product directory – C:\<PRODUCT_NAME>
  • Copy Mod_Gsoap.dll to the bin directory - – C:\<PRODUCT_NAME>\BIN
  • Copy zlib1.dll and PThreadVC2.dll and place them into the ScadaPro root menu and bin, if not located there already.
  • The zlib1.dll and PThreadVC2.dll files also need to be added into C:\Windows\System32\inetsrv folder and C:\Windows\SysWOW64\inetsrv for 64-bit operating systems.

3.Web Service Setup in IIS

3.1.Create Application

  • Create the <PRODUCT_NAME> application in IIS – right click on Default Web Site and select Add Application – enter the details for <PRODUCT_NAME>.

3.2.Configure Handler Mappings

  • Select the <PRODUCT_NAME> application and choose Handler Mappings.
  • If you see the disabled section with two greyed out items – CGI-exe and ISAPI-dll, right click and select “Edit Feature Permissions” - Check Execute within that dialog.
  • Within the Actions Pane on the right hand side select “Add Script Map” and enter details as per dialog below remembering to select the Executable location as per the product name:
  • Click Request Restrictions – On the Mapping Tab tick “Invoke handler only if request is mapped to:”
  • On the Access tab tick “Execute”.
  • Click Ok and then Ok on the Add Script Map dialog. The following warning will appear:

Click Yes to allow the ISAPI Extention.

3.3.Remove Hidden Segment – Request Filtering

  • Select the <PRODUCT_NAME> application and select Request Filitering.
  • Enter the third tab Hidden Segments and delete the bin segment.

4.Application Testing

  • Open Internet Explorer and enter the following web address taking care to subsitute the IP address for your own machine, and the product name to your own product.
  • The following web page should appear:

4.1.Product Logo

  • The product logo will not load if the image is not in the proper directory.
  • Locate the product.bmp file, located in <PRODUCT_NAME>/BINand open with Paint.
  • Resize the object to approximately 390 pixels by 180.
  • Save the resized image as “product_small.bmp”.
  • Place the image into the BIN folder in <PRODUCT_NAME>

Page 1 of 14 / Working copy if printed
C:\Users\conor.brannigan\Documents\Documetation STO\Web Service - Manual Installation Guide.doc
 Measuresoft Development Ltd. / Version: 1.0.0.0