Install Guide
  • 04 Aug 2022
  • 4 Minutes to read
  • PDF

Install Guide

  • PDF

Overview

Installing Validatar consists of two steps:

Completing Installation

Est. Time to Complete: ~ 1 hour

Install Process Diagram(3)

Prerequisites


    1. Access needed to complete install
      • Admin access to the operating system to run the installer
      • Admin access to the web server
      • Admin access to the database Validatar will use on the back end
    2. Web server. We recommend a range of 4 - 16 GB of memory. 2- 8 cores.
      • HDD: 50 GB (the web application files take up roughly 150 MB)
      • RAM: 8 GB
      • CPU: 2.0 GHz or faster
      • The server must have Internet Information Services installed, including the following highlighted options:

IIS services.png

To add and configure IIS:

  1. Type Server Manager in the Windows search bar
  2. Click Add Roles & Features
    • Also found under Manage in the top-right corner
  3. Click Next for every page until you reach the Server Roles section
  4. In Server Roles check Web Server (IIS) then Add Features
  5. Click Next
  6. In the Role Services section
    • Scroll down the web services list, expand Security, check Windows Authentication
    • Expand Application Development, check Application Initialization
    • Click Next, then Install



Be sure to select the Hosting Bundle option.

 


  • Create a DNS record for the Validatar website so that Validatar can be accessed using something other than the web server name or IP Address (optional)
  1. Database server (SQL Server or PostgreSQL)
    • Supported versions
      • SQL Server 2019 (no older than 2014)
      • PostgreSQL 14.1
      • SQL Server 2019 Express (no older than 2014) - only recommended for proof of concepts or trials
    • Common Specifications
      • HDD: 50 GB
      • SQL Drive: allocate 50 GB total for the Validatar metadata data/log files
      • RAM: 16 GB
      • CPU: 2.0 GHz or faster
    • Create a new database named "Validatar"
    • Minimum security permissions for the Validatar Service Account 
      • At least db_owner database role in the Validatar database
    • If using Windows Authentication instead of SQL Server authentication for connections created in Validatar to the databases you’re testing, your IT will need to create an Active Directory service account and provide the account credentials. That domain account should then be used when configuring the Validatar application pool in IIS during the install process.
  2. SMTP credentials – used for password reset and other notification emails. If the SMTP settings are not known, check with your IT administrator or Network administrator for this information.
  3. SSL Certificate - We encourage obtaining an SSL certificate from a certificate authority. Install the certificate on the web server to encrypt network traffic. After installing Validatar, use IIS to assign the certificate to the Validatar site. Find the steps to assign the certificate below.

Installation

  1. Download the installer from https://admin.validatar.com/releases
  2. Run the installer. If the user does not have the operating system administrator role, they will need to Run as Administrator.
  3. Enter IIS application pool identity information – this will be the account that Validatar runs under. This must be a domain account if database connections use Windows authentication instead of SQL Server Authentication.
  4. Enter IIS website information for the Validatar website. The port number should typically be 80 unless you already have another website listening on that port.
  5. Finish install.
  6. In IIS, verify that the default site is stopped and the Validatar website is running.

Are you running into issues? View common installation issues at the bottom of the page.

Assigning an SSL Certificate

Complete the following steps to assign an SSL certificate to the Validatar site to secure network traffic.

  1. Open IIS.
  2. In the Connections tree, expand the server, then expand Sites.
  3. Select the Validatar site.
  4. In the Actions pane on the right, under Edit Site, select Bindings...
  5. In the Site Bindings window, select the https binding, then click Edit.
  6. In the SSL certificate drop-down, select your newly installed SSL certificate.
  7. Select OK.

Configuration

  1. For New Installations
    1. In a web browser, navigate to the Validatar URL
    2. Select the database engine and enter the connection string to the Validatar database
    3. Enter the information for the Validatar global administrator user
    4. Click the “Complete Setup” button
    5. Login using the credentials of the administrator user you just created
  2. Activate your license
    1. Navigate to Settings > Licenses
    2. Select “Activate License”
    3. Read the Validatar End-User License Agreement and select “I Agree”
    4. Fill out the license information form.
    5. Click the “Activate” button
  1. Configure SMTP
    1. Navigate to Settings > Configuration > SMTP
    2. Enter required SMTP settings
    3. Click the "Send Test Email" button to test out your changes
    4. Click the "Save" button


Common Installation Issues

IssuePossible Solution
Installer rolls back and failsRun the installer via command-line and produce a log file using the following steps:

  1. Open the Command Prompt
  2. Execute the following command, replacing “C:\tmp” to reflect where the installer is saved:
    msiexec /i "C:\tmp\validatar-setup.msi" /L*V "C:\tmp\validatar-setup.log"
  3. If the install is unsuccessful, send the log file created in C:\tmp\validatar-setup.log to support@validatar.com.

Installer ended prematurely

  1. Verify the installer is run either by a web server admin or Run As Administrator.
  2.  In IIS, verify that the default site is stopped and the Validatar site is started.

Error 404 appears when attempting to navigate to the Validatar server address in a browser, or the user is brought to IIS when navigating to the Validatar server address in a browser

In IIS, verify that the default site is stopped and the Validatar site is started.

Error 500.19 appears when attempting to navigate to the Validatar server address in a browser

  1.  Verify that the Hosting Bundle for ASP.NET Core was installed instead of the Windows x64 version.
  2. Stop and restart application pools in IIS.

After logging into Validatar, the user only sees Project Data Sources and Tools under Project Settings

Verify that the license key is activated.

Was this article helpful?