Install of FastClose Server in Internet Information Services (IIS)

Introduction

FastClose Server is written in ASP.NET Core, currently v6.0. The instructions listed below aren’t the only way to configure FastClose in IIS, but they are the steps which we have tested. You could create a separate website with a different port number rather than using the default website, it’s completely up to you.

Installing FastClose Server under IIS is optional: the installation includes a built-in web server, so can simply run as a Windows service, and many of our customers are happy with this. Only install under IIS if you require TLS for https connections, for example.

Prerequisites

To run FastClose server inside IIS you should:

• Install IIS if not already installed on the server.

  • Add IIS via "Turn Windows Features On/Off"

  • As part of this ensure Internet Information Services > World Wide Web Services > Application Development Features > WebSocket Protocol is enabled.

  • Also include the Dynamic Content Compression option, under Performance

When completed, verify the installation with http://localhost

• Then install Microsoft’s ASP.NET Core Runtime 6.0.x Windows Hosting Bundle from Download .NET 6.0.

  There are a number of downloads on that page, so make sure you select the Hosting Bundle. The design and contents of this page will change over time of course, but at the time of writing it looks like this:

• We do not recommend running FastClose Server on the same server as your ERP web server as we have not verified that the hosting bundle will not have an effect on the ERP. Given that the hosting bundle is provided by Microsoft, we are confident that it won’t have any issues but we cannot be sure.

• You should install IIS before installing the ASP .NET Hosting Bundle

FastClose Server Install

Double click the FastClose Server installer. You can either install to:

• [DriveLetter]:\Program Files\FastClose\FastCloseServer

  • This is the default location but you may have to grant IIS Read and Execute permissions to this folder

• [DriveLetter]:\inetpub\wwwroot\FastClose

  • This will not require additional permissions.

• Once installed, open Windows Services, stop the FastClose Server service and change its Startup Type to "Disabled".

• In Windows Explorer, browse to the FastClose Server install folder selected above. Edit the file appsettings.customer.json using Notepad, run as administrator. If this file does not exist, create it by copying and renaming the file appsettings.customersettings.json. Within the file, change the setting "IsHostedByIIS" from false to true and save it.

IIS Configuration

Create IIS Website

• Start "Internet Information Services (IIS) Manager" from the Windows Start Menu

• Right Click on the "Sites" item, and select "Add Website" configuring as below:

  

Note that the Physical Path should match the install location you specified when installing FastClose Server.

The Port can be any value you want that is free on your web server.

Amending the Application Pool

• Amend the BasicSettings of the AppPool that were automatically created with the website:

• Change the .NET CLR version to read, "No Managed Code"

Permissions

If you installed FastClose Server anywhere other than in [DriveLetter]:inetput\wwwroot, then you will have to set Read and Execute permissions on the folder for the “IIS Users” user.

• Right Click on your FastClose Website and choose “Edit Permissions...”. Select the "Security" tab in the properties window displayed

  

Click "Edit..." and then "Add..."

Add the "IIS Users" and ensure it has "Read & Execute" permission.

• Similarly, using Windows Explorer, navigate to the directory C:\ProgramData\FastClose - and set the permissions on this folder such that the IIS_ISRS user has full control of it.

Testing

• Click on your FastClose Website, select "Manage Website" and then "Browse" as below

  

  This will launch the default web browser and if all goes well you should see this:

There may be a message stating the the repository requires upgrading. If so, click the link and then click the “Upgrade Repository” button.

Once the repository is upgraded, you can log in with the Administrator user. The default password is supplied separately and we recommend changing this as soon as possible.

Completing the Install - Clients, Templates and Firewalls

As your desired port is not usually open, it will probably be necessary to open it on the server firewall.

It is also necessary to install the templates, and desktop clients on user machines.

Instructions as to how to do all of this can be found in the standard installation instructions here.