New Installation Checklist
Applies to All
This checklist includes steps that must be undertaken for a fresh installation of the QEST Platform.
Contents
All Products
Step | Description |
---|---|
Prepare and provision test and production environments, including the necessary SQL instances. | Two separate environments will be required for the successful implementation of QEST Platform products. A test environment will be used for testing new releases and features of the software as these become available before being promoted to the production environment. Refer to the technical overview or product architecture diagrams for more information on the necessary infrastructure. |
A configured database will be provided for new QEST Platform installations. This database will need to be restored on the appropriate SQL Instance. | |
Select model for user access to database | User access to the QEST Platform database can be controlled by membership in an Active Directory group or SQL Authentication if a File DSN is used. A choice should be made with regard to the desired model. |
Register Microsoft Entra ID application if utilizing Microsoft Entra ID for authentication. | If Microsoft Entra ID is to be used for authentication (i.e. if multi-factor authentication is to be used), an application must be registered within the appropriate Entra ID instance for this purpose according to https://spectraqest.atlassian.net/wiki/spaces/QPD56/pages/3287613768. |
Configure user Mapping between QEST Platform and Microsoft Entra ID | If Microsoft Entra ID is to be used for authentication (i.e. if multi-factor authentication is to be used), users must be mapped between the two products. Spectra QEST has developed PowerShell scripts which can be scheduled to run periodically in order to achieve this. The work required is discussed in https://spectraqest.atlassian.net/wiki/spaces/QPD56/pages/3287614447 |
Verification
Step | Description |
---|---|
Verify user database access | Verify access with the chosen model above. |
QEST Web App and QESTField (Tests, Scheduler, Forms)
Step | Description |
---|---|
Obtain and configure SSL Certificate for desired QESTField URL(s) | If the URLs for any of the QEST Web App or QESTField products are to be accessible externally, appropriate SSL certificates must be obtained for the desired URLs. As of QEST Platform 5.6, the URLs for all products must share a common origin such that they comply with Same-origin policy. |
A service account that the QESTNet Windows service will run under. Requires db_owner rights to the QEST Platform database and the Hive Publish database (if Construction Hive publishing is being used). | |
The QESTNet service account needs to be able to listen on the QESTNet API address |
QESTField Scheduler Push Notifications
Push notifications require the use of centralized infrastructure which, in turn, requires the communication of secure information. To achieve this, Spectra QEST provides a key file that must be installed on QESTNet servers where push notifications are being used. These steps are only necessary if push notifications are desired from QESTField Scheduler.
Step | Description |
---|---|
This key file must be installed on the server running the QESTNet Windows service. This step is necessary whenever the QESTNet service is installed on a new server or when push notifications are first introduced into an existing implementation. | |
The service account running the QESTNet service requires access to the key file. This step is necessary whenever the QESTNet service is installed on a new server or the service account running the QESTNet service is changed. |
Construction Hive Publishing
Step | Description |
---|---|
Restore Hive Publish database | A configured HivePublish database will be provided for organizations utilizing Construction Hive publishing. This needs to be restored alongside the QEST Platform database. |
A service account that the Construction Hive service will run under. Requires db_owner rights to the the Hive Publish database (if Construction Hive publishing is being used). This account can be the same as the QESTNet service account. |
Next Steps
After the above have been completed return to the QEST Platform Installation Checklists page and follow the steps relevant to the products being updated.
Related content
Integrity | Curiosity | Empathy | Unity
The content of this page is confidential and for internal Spectra QEST use only. Do not share, duplicate or distribute without permission.