Contents

Overview

QEST Web App is a react web application which is hosted via Microsoft Internet Information Services (IIS). It communicates with the QEST Web App, IIS and firewalls must be configured to permit this. The QEST Web App will require a connection to an instance of the QESTNet service, through which it can connect to the QEST Platform database.

Installation guide

Prerequisites

The following must be present in the target environment to install QEST Web App.

Machine

• Windows Server 2008 R2, Windows 7 or later (64-bit).

• Microsoft .NET Framework 4.6.1 or later. If required, this will be installed via the QEST Worksheets installer if the environment has internet access.

• Internet Information Services 7.0 or later with default features plus ASP.NET v4.5.

• Internet Information Services extension URL Rewrite 2.1 or later.

Services

• QEST Web App v4.91 or higher

• QESTNET v4.91 or higher, accessible via TCP or HTTP

Installation Files

• Installer QEST Web App Setup Ma.Mi.B.R.exe where Ma, Mi, B and R are the major version, minor version, build and revision numbers. E.g. QEST Web App Setup 4.91.4595.26827.exe

Installation Process

1. If Microsoft .NET Framework 4.6.1 requires installation, internet access is required during the QEST Web App installation process.

2. Run the provided installer.

3. If required, click on Options to change the installation options listed in the section below.

4. Agree to the terms and conditions and click Install. The installer will install and turn on any required Windows features before installing the QEST Web App.

5. Depending on the options set above, the QEST Platform website may need to be manually configured and/or started via the IIS Manager before the QEST Web App can be accessed.

QEST Web App is now installed and ready for use.

Installation Options

Configuration guide

No configuration should be required.

Troubleshooting guide

Installation

Unspecified Error

The following installation error ‘0x80072ee7 – Unspecified Error’,  is most likely due to the installer being unable to download and install .Net Framework 4.6.1.

The issue can be confirmed by viewing the log file and looking for the following: Failed attempt to download URL: 'http://go.microsoft.com/fwlink/?LinkId=671728' to: 'C:\Windows\Temp{B321459C-617D-4C9F-8C70-15AEEE5945CF}\NetFx461Web'

Fix: To install the QEST Web App, download .NET Framework 4.6.1 and install it prior to installing the QEST Web App. The .NET Framework 4.6.1 Installer can be found here: https://support.microsoft.com/en-au/help/3102436/the--net-framework-4-6-1-offline-installer-for-windows

URL Rewrite 2.1 Required

If the IIS extension URL Rewrite is missing or has not been installed correctly, the installer will show an error during installation, stating that it cannot find URL Rewrite. The URL Rewrite Installer can be found here: https://www.iis.net/downloads/microsoft/url-rewrite

Additional Errors

The following error 'could not load file or assembly system.management.automation' when attempting to restart QESTNET via the QEST Web App, is due to not having the correct version of Powershell installed.

This can be confirmed by determining which version of Powershell is installed and if it is version 2.0, then upgrading to version 4.0 should fix the issue.

Configuration Changes

When changing the config files that are part of the installed QEST Platform IIS website, be sure to Stop and Start the QEST Platform site to reload the website with the changes. Simply clicking Restart the config changes will not be loaded.

Reporting Errors

If the information above has not resolved the issue, please contact Spectra QEST to report the problem.