Configure IIS as server for Pull mode

From SpinetiX Support Wiki

Jump to: navigation, search

Introduction

This tutorial explains how to configure the Internet Information Services (IIS) 7 as a WebDAV server to be used for Pull mode.

  • IIS 7 is a fully featured web server that comes bundled with Windows 7 and Windows 2008.
  • This tutorial is also applicable to Windows Server 2008 R2 running IIS 7.5.

Requirements:

  • One or more HMP devices (tested with firmware 2.2.5).
  • PC running IIS 7 / 7.5 and member of a domain (required to use Digest authentication).

Steps

  • From the Control Panel > Administrative Tools > Computer Management snap-in, create a new user on the machine that the HMP will use to access the WebDAV server (IIS does not support WebDAV using anonymous access). Leave the user in the default "Users" group.

Newuser.png

  • Upon installation, IIS will have created a folder structure under the root, in a folder called "inetpub". These steps will create a new web site and folder for simplicity, but you can use the existing path and/or site if you wish. Create a folder to house your project and set the permissions appropriately. Add the user you have just created with full access, being sure to select the correct location when searching for users (on a domain machine, the default location will be the domain and the local user will not be visible).

Setpermissions.png

Permissions2.png

  • Copy your project contents into the new folder. There should be at least the index.svg file directly in the new folder.
  • Open the IIS Management Console via Administrative Tools. Create a new site with a separate port, and set the physical path to the folder you created above. Leave all other settings as default.

Newsiteiis.png

  • Click ok and verify that the new site starts immediately (there should not be a stop sign on the globe icon of the site).
  • Click on the site, and click "Content View" (button on the bottom of the window). Check the content matches that of the folder just created. This example uses the "corporate" solution example from SpinetiX.com.

Content.png

  • Switch back to Features View and double click Authentication. If the PC is connected to a domain, set Digest Authentication as enabled and all other options as disabled. For PCs not connected to domains, choose Basic Authentication, and all other options disabled.
    • Warning: do not deploy a production server using basic authentication without employing SSL to encrypt the connection.

Auth.png

  • Next open MIME Types. Add SVG as a MIME type by pressing "Add.." in the top-right corner, and filling the dialogue in as below:

Addmimetype.png

  • Next open Directory Browsing and click "Enable". This is required for the HMP to get the list of file on the server.

Enablebrowsing.png

  • Next open WebDAV authoring rules and click "Enable".

Enablewebdav.png

  • In WebDAV authoring rules, then click "Add Authoring Rule..." and add a new rule as below:

Webdavsettings.png

  • Open a browser and visit the site address (on the local machine this can be http://127.0.0.1:83 if you are using the same port as instructed.) You should see a login dialog, and be able to login with the "spx" username and password created earlier. After login, the directory content should be listed. If you do not see the directory content or login fails for any reason, fix the authentication issue before continuing as the HMP will not be able to pull content.
  • Open a browser on another PC on the same network to test access via the firewall. You may need to configure the Windows Firewall (or another firewall) to allow TCP traffic inbound on port 83.
  • On the HMP, add the credentials for the new site under Network Settings.

Hmpcredentials.png

  • Trigger a pull of content by setting the pull location to the address of your server, and the time in the last hour.

Pullmodesetup.png

  • Open Logs > uploader.log and verify that the content begins to download. Here you will see any negative HTTP responses from the server (e.g. 401: Unauthorised) if the configuration is not correct.
This page was last modified on 30 January 2017, at 20:07.