Install Reader Web App Service
To install the FastClose Reader Web App follow the following instructions.
Be sure to fully consider the prerequisites. This software requires adequate computing resources, and the necessary capacity should be assessed before deployment.
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:\FastCloseWebReader\.
The WebApp is a Microsoft ASP.NET Core app. Microsoft has various guides on installing an ASP.NET web app under IIS. E.g.
https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/?view=aspnetcore-8.0
IIS Configuration and Notes
Ensure you create a new Site or use the Default Web Site at the top-level (rather than adding a sub-Website to the Default Web Site).
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:
Setting | Value |
.NET CLR Version | No Managed Code |
Load User Profile | True |
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:5103/ 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
There is a Known Issues page if you are having any problems.
