The article helps troubleshoot common login issues one might encounter during the trial of ETL Validator Complete assuming that you have already downloaded and installed it.


The trial download of ETL Validator Complete has the following components : 

  • ETL Validator Client : ETL Validator Client is a windows based application that provides the User Interface for creating Test Cases, Test Plans and managing their execution in the ETL Validator Server. ETL Validator Client also provides interface for administration of the solution.
  • ETL Validator Repository : ETL Validator Repository stores the metadata related to test cases, test plans, data source connections and users.  It requires an Oracle or Postgresql database. 
  • ETL Validator Workschema : ETL Validator Workschema stores the test data, benchmark data and the data validation results. It requires an Oracle or Postgresql database.
  • ETL Validator Server : ETL Validator server is a J2EE application running in Tomcat used for executing of Test Cases and Test Plans. It has a built in ETL engine for extracting and loading test data from heterogeneous data sources. It also has a scheduler for automatic execution of Test Plans at specified times.
  • ETL Validator Reports : ETL Validator Reports is a web based interface for viewing Test Case and Test Plan run results. In addition, it allows the user to download results in a PDF or Excel format. It is a Java based application that runs in Tomcat along with the ETL Validator Server

ETL Validator Complete trial download comes with an embedded Tomcat 7 for running ETL Validator Server / ETL Validator Reports and a PostgreSQL 9.3.7 database for ETL Validator Repository / Workschema. The Tomcat and PostgreSQL database are automatically deployed as Windows Services during the installation. Most of the login issues are because these services are not deployed or running properly. 

Prerequisites
Most of the installation issues can be resolved by making sure that the prerequisites are installed and the reinstalling ETL Validator Complete. ETL Validator Complete has the following prerequisites: 
Microsoft .Net Framework 4.6.1 (64-bit version) : https://www.microsoft.com/en-us/download/details.aspx?id=49981
Microsoft Visual Studio C++ Redistributable 2010 x86 : http://www.microsoft.com/download/en/details.aspx?id=5555
Troubleshooting Common Login Issues : 

Issue 1: 
During installation of ETL Validator Complete, a popup message is displayed asking for Microsoft .Net Framework to be installed
Cause: 
ETL Validator Client requires Microsoft .Net Framework 4.6.1 to be installed as prerequisite but your computer does not have it. 
Resolution: 
You can download Microsoft .Net Framework 4.6.1 from Microsoft website and install it (see prerequisites for more information). Once it has been installed, please uninstall ETL Validator Complete and reinstall it

Issue 2: 

During installation of ETL Validator Complete, a popup message is displayed “The program can’t start because MSVCR100.dll is missing from your computer.”

Cause: 

ETL Validator PostgreSQL repository requires Microsoft Visual Studio C++ Redistributable 2010 x86 to be installed as prerequisite but your computer does not have it. 

Resolution: 

You can download Microsoft Visual Studio C++ Redistributable 2010 x86 from Microsoft website and install it (see prerequisites for more information). Once it has been installed, please uninstall ETL Validator Complete and reinstall it


Issue 3: 
When the ETL Validator app is launched and login to the PostgresRepository, you get a "Please check the connectivity to Repository error"
Cause: 
This issue indicates that ETL Validator Client is not able to connect to the database where the Repository is located. 
Resolution: 
For the trial version, the default repository connection profile is called 'PostgresRepository'. This profile connects to the to a PostgreSQL database running locally using PGBouncer as a connection pooling software. The PostgreSQL database and PGBouncer software are automatically installed as a Windows Service when ETL Validator Complete is installed. 
  • Open Windows Services and check if the two Services 'DatagapsETLValidatorDatabase' and 'DatagapsETLValidatorpgbouncer' are running. If not, start them.


  • If you notice that the two services 'DatagapsETLValidatorDatabase' and 'DatagapsETLValidatorpgbouncer' are missing, this is most likely because the database services did not get installed properly due to permission issues in your computer. Please following these steps for resolving the issue: 

    • Open a command prompt with 'Run as Administrator' privilege
    • Navigate to C:\app\Datagaps\ETLValidator\pgsql folder and execute the following bat script :
      pg.bat install
    • Navigate to C:\app\Datagaps\ETLValidator\pgbouncer folder and execute the following bat script:
      pgbouncer.bat install

      You should see the two additional services after these steps.

  • If the services does not start, check if the database has been properly installed by following the steps below: 
  • Navigate to the folder 'C:\app\Datagaps\ETLValidator' and check if there are folders called 'pgsql' and 'pgbouncer'.
  • If these folders are missing, can you please extract the two zip files 'pgbouncer.zip' and 'postgresql.zip'. We need to use 'Extract Here' option otherwise the files are extracted to a child folder. Alternatively, copy them back to the upper level.
  • Try starting both the services now. 

Try to login again from the client. This should resolve the repository connectivity issue. 

Issue 4: 
During login, ETL Validator Client is stuck at 'Server Accessibility' check with an error saying 'Unable to connect to ETL Validator Server'.


Clicking on 'Edit' may show an error  : 


Cause: 

The issue indicates that the ETL Validator Server (tomcat) is either not running or the ETL Validator Client is not able to access it. 

Resolution: 

The trial version of ETL Validator uses Tomcat 8 for running the ETL Validator Server. The tomcat server process is automatically installed as a Windows Service called 'Datagaps ETL Validator Server'. It uses 6050 as the default port. 


If you are still encountering a issues, please log a new ticket. There are several Knowledge Base posts for Connection Issues in the support portal.