Installation Instructions
IMPORTANT NOTICE
Follow the installation instructions in the order they are presented. Some components must be installed before others for a successful installation.
Before beginning the installation
- It is recommended to create a snapshot of the VM or create a restore point (C:) of the system.
- Confirm the network configuration with your IT department (see Recommended Server Requirements).
Create a Service User (Optional)
During the installation of the SW, the user will be prompted to provide credentials for the user account that will run the service.
The Service user is a Windows user which will be associated with the myQA StarTrack3 and EcoSystem Services.
IMPORTANT NOTICE: THE ACCOUNT RUNNING THE MYQA STARTRACK3 SOLUTION CANNOT BE CHANGED
The user account running the myQA StarTrack3 Solution cannot be changed. If the user account is changed, it is not possible to run the myQA StarTrack3 Web App.
The password of the Service User can be updated in the Services application (see Update Service User Password).
- Before starting the installation, create a standard user (not an administrator) for running the Web App.
Operating the myQA StarTrack3 Web App under a restricted rights user is more secure. In the event that
the myQA StarTrack3 Web App is compromised through vulnerabilities, the potential harm would be mitigated as it would lack administrative privileges.
Update Service User Password
- Open the Services application and right-click IBADos.EcoSystem and IBADos.StarTrack respectively.
Under the Log On tab, update the account password and click OK.
Install myQA StarTrack3 Web App
Run the MSSQL application provided in the Installation file.
If a MSSQL 2022 Server is already installed on your system, just add an instance for EcoSystem and myQA StarTrack3.
Right-click the IBA EcoSystem application > Run as administrator.
- The IBA EcoSystem Setup Wizard opens. Click Next to continue.
Accept the terms and conditions. Click Next.
- Confirm the Installation requirements. Click Next.
- Confirm the Installation Folder. Click Next.
Click Install to begin installation of the main IBA Ecosystem software.
Click Finish.
Note: The myQA ECOSystem Configuration Manger should open automatically. The installation of the myQA StarTrack3 Web App can continue before configuring EcoSystem. See Section 1.3.1.
- Right-click myQA StarTrack3 application > Run as administrator.
The myQA StarTrack3 Setup Wizard opens. Click Next to continue.
- Confirm the User terminal requirements. Click Next.
- Confirm the installation folder. Click Next.
Click Install to begin the myQA StarTrack3 installation.
- Click Finish. The installation is now complete.
- Click Finish. The myQA StarTrack3 Configuration Manger should open automatically. See Section 1.3.2.
Configuration Managers
The myQA StarTrack3 Web App can be configured via the myQA ECOSystem Configuration Manger and myQA StarTrack3 Configuration Manger.
myQA ECOsystem Configuration Manager
The first tab shows the system Overview. Here the user can check the status of the databases, directory configurations, and server configuration.
Click on the Manage Service tab. Ensure that the service is stopped.
Click on the Database connections tab. Here the user can add or update the server information for each database.
Note: Databases are created automatically if entered in the Configuration Manager with the correct Server instance.
Click the Configure button to change database information and access. Click Ok to confirm the
changes.Click the Test connection button to test the database connection. Connection successful will appear if there are no connection issues.
- If any of the servers have been configured, please click the Save Changes button.
Click on Certificate Configuration tab. Here the user can add in the certificate, either from the Certificate Store or Certificate file.
Check the Enable HTTPS check box (1).
- Two Certificate Sources appear:
- Certificate Store: Select a certificate from the Windows Certificate Store
- Certificate File: Load certificate from *.pfx, *.p12, *.crt, or *.pem files.
If Certificate Store is selected, go to the Certificate Store tab (2) and select a certificate from the list
(3).Click Apply Settings (4) and then Validate Configuration (5) to check the certificate and save the
settings.If Certificate File is selected, go to the Certificate File tab (6) and click Browse (7).
Select the certificate file and click Open to upload it to the Configuration Manager.
Once the certificate file has been updated, enter the file password, click Apply Settings (8) and then Validate Configuration (9) to check the certificate and save the settings.
- The Web App can now be access securely via the HTTPS URL provided in the myQA StarTrack3 Configuration Manager - Hosting Configuration tab.
Click on Defaults tab. Here the user can restore all configuration settings to their default values. The
following will be reset:- The Database connection string
- EcoSystem HTTP URL configuration
- HTTPS certificate configuration (HTTPS will be disabled)
- Measurements and Templates directory paths
- Click the Reset to Defaults button.
myQA StarTrack3 Configuration Manager
The first tab shows the system Overview. Here the user can check the status of the databases, directory configurations, and server configuration.
Click on the Manage Service tab. Ensure that the service is stopped.
Click on the Database connections tab. Here the user can add or update the server information for each database.
Note: Databases are created automatically if entered in the Configuration Manager with the correct Server instance.
Click the Configure button to change database information and access. Click Ok to confirm the changes.
Click the Test connection button to test the database connection. Connection successful will appear if there are no connection issues.
- If any of the servers have been configured, please click the Save Changes button.
Click on the Ecosystem Configuration tab. Here the user can check and update the Ecosystem URL.
- If any of changes have been made, please click the Save Changes button.
Click on Certificate Configuration tab. Here the user can add in the certificate, either from the Certificate Store or Certificate file.
Check the Enable HTTPS check box (1).
- Two Certificate Sources appear:
- Certificate Store: Select a certificate from the Windows Certificate Store
- Certificate File: Load certificate from *.pfx, *.p12, *.crt, or *.pem files.
If Certificate Store is selected, go to the Certificate Store tab (2) and select a certificate from the list
(3).Click Apply Settings (4) and then Validate Configuration (5) to check the certificate and save the
settings.If Certificate File is selected, go to the Certificate File tab (6) and click Browse (7).
Select the certificate file and click Open to upload it to the Configuration Manager.
Once the certificate file has been updated, enter the file password, clickS Apply Settings (8) and then Validate Configuration (9) to check the certificate and save the settings.
- The Web App can now be access securely via the HTTPS URL provided in the myQA StarTrack3 Configuration Manager - Hosting Configuration tab.
Click on Defaults tab. Here the user can restore all configuration settings to their default values. The
following will be reset:- The Database connection string
- StarTrack HTTP URL configuration
- HTTPS certificate configuration (HTTPS will be disabled)
- Click the Reset to Defaults button.
Post-Installation Checks
In the Configuration Manager Apps, the user can check that the system is running correctly.
- Starting with the myQA ECOsystem Configuration Manager, go to the Overview tab.
Check that the appsettings.json file is valid. It will have a green dot next to it.
Check that the Service status is running. It will have a green dot next to it.
Check that the EcoSystem database is connected. A green checkmark will indicate that the connection
is successful.Check that the Measurements directory configuration is valid. A green checkmark will indicate that
the connection is successful.Check that the Templates directory configuration is valid. A green checkmark will indicate that the
connection is successful.- Check that the Kestrel Web Server Configuration is configured correctly.
A green checkmark will indicate that the HTTPS configuration is successful.
A yellow warning sign means that the HTTPS setting has not yet been configured.
If connecting through HTTP, the warning sign will appear. Click the arrow to open the configuration and see if the HTTP endpoint is valid. The Web App can still be accessed, but only locally by the hosting machine.
To configure HTTPS see Section 1.3.1
Open a browser and navigate to the URL provided in the myQA ECOsystem Configuration Manger > Hosting Configuration.
A page will load indicating that the IBA Ecosystem is running.
In the myQA StarTrack3 Configuration Manager, go to the Overview tab.
Check that the appsettings.json file is valid. It will have a green dot next to it.
Check that the Service status is running. It will have a green dot next to it.
Check that the StarTrack database is connected. A green checkmark will indicate that the connection is successful.
- Check that the Kestrel Web Server Configuration is configured correctly.
A green checkmark will indicate that the HTTPS configuration is successful.
SA yellow warning sign means that the HTTPS setting has not yet been configured.
If connecting through HTTP, the warning sign will appear. Click the arrow to open the configuration and see if the HTTP endpoint is valid. The Web App can still be accessed, but only locally by the hosting machine.
To configure HTTPS see Section 1.3.2
Check that the Ecosystem URL is configured correctly. A green checkmark will indicate that the connection is successful.
Open a browser and navigate to the URL provided in the myQA ECOsystem Configuration Manger > Hosting Configuration.
The Login page for the myQA StarTrack3 Web App will load indicating that the SW was successfully installed.