To install the FastClose Reader Web Application service follow the following instructions.

NB: Don't skimp on considering the pre-requisites - this requires considerable processing power which require consideration.

Step 1 - Prerequisites

Read the Install Prerequisites page first to gather the required files and install any supporting software.

Step 2 - Install

Choose to either host (run) the web app as a Windows service with the built-in Kestrel web server, or under IIS. Follow step 2a or 2b depending on your chosen hosting model and web server.

Step 2a - Run as a Windows Service using Kestrel Web Server

Run the MSI installer.

You will be able to change the port that the web server listens on.

Note: this can be changed later on, without a reinstall, see Configuration and Diagnostics.

If the installer fails, see the Application Logs section as more details may have been output in a log file.

Check the Service started successfully. Click Start if the service is not running.

Step 2b - Served by IIS

Extract the binaries zip file to a new folder on the server e.g., C:\ReaderWebApp\.

Microsoft has various guides on installing the ASP .NET Web App under IIS.

E.g., See: Host ASP.NET Core on Windows with IIS

IIS Configuration and Notes

• We recommend using the in-process hosting model.

• Do not enable Windows Authentication (if configured, this will be handled by the app)

• If you have been provided with an app settings file then place it in the following location:

  %PROGRAMDATA%\FastClose\ReaderWebAppServer\appsettings.customer.json
  

Application Pool Identity Configuration

The Application pool associated with the Website must have the following settings:

Restart the app pool and website and continue to Step 3.

Step 3 - Post-Install

You should be able to see see the web app running by visiting http://localhost/ on the server with a web browser.

• Confirm that logging is working: see the Application Logs page.

• Check that you can login, browse for a report and run it

• Check whether the server needs its firewall configuring to allow incoming requests to the port that the Reader is listening on

Notes

• The web app can run on Linux but that's out of the scope of this document. Please reach out to FastClose if you are interested in doing so.

• There is a Known Issues page if you are having any problems.