Global Search
  • 20 Mar 2024
  • 2 Minutes to read
  • PDF

Global Search

  • PDF

Article Summary

Overview

Easily find tests, jobs, and metadata objects using the search bar in the menu header. Not only can you search by object name, but you can search by Data Source, the SQL script used in a test, who created a test, and more.

Prerequisites

There are a few steps to complete before Global Search can be used.

  1. Install & Configure Apache Solr
  2. Configure Global Search settings in Validatar
Search Bar Display

The search bar will not appear in the Validatar header if Global Search isn't configured.

Solr Install for Windows

1. Install Java

If not already installed,

  1. Download Java: https://download.oracle.com/java/17/latest/jdk-17_windows-x64_bin.msi
  2. Install the downloaded MSI
  3. Create a JAVA_HOME system environment variable that references the root Java folder from the above install.

image.png

2. Install Solr

  1. Download Solr from here: https://solr.apache.org/downloads.html. Use the link for the latest binary release zip file (https://www.apache.org/dyn/closer.lua/lucene/solr/8.11.2/solr-8.11.2.zip?action=download)
  2. Unzip the Solr file
  3. Open a command line prompt, navigate to the folder where you unzipped Solr, and start Solr using the following command:
bin\solr.cmd start

image.png

  1. At this point, you should be able to open a browser on that server and navigate to http://localhost:8983 to open the Solr UI
Server Restart Note

This command will need to be run any time the server restarts, so you’ll probably want to create a task using Windows Task Scheduler with a trigger of “At startup”.

image.png

3. Add Validatar core to Solr

  1. A “core” in Solr is where the data indexed by Validatar resides. If you’re using one instance of Solr for multiple Validatar instances (dev and prod), you’ll want to use a different core for each instance.

  2. Create a "validatar" folder for the new core inside the Solr root folder. If you use a different folder name, replace any reference to "validatar" in this step and the following steps.

  3. Download the following file: https://admin.validatar.com/assets/releases/2023-2/solr-root.zip

  4. Copy the “conf” folder from the zip file into the “validatar” folder. The folder should look like this:
    image.png

  5. Open a browser on the server and navigate to: http://localhost:8983/solr/#/~cores

  6. Enter “validatar” in the name and instanceDir text boxes, then click the “Add Core” button

Configure Global Search in Validatar

  1. Open a browser and navigate to Validatar
  2. Go to Settings > Configuration > Global Search
  3. Enter http://localhost:8983/solr in the Solr Endpoint URL textbox and “validatar” in the Solr Core Name textbox. Leave the username/password fields empty.
  4. Click the Validate Settings button to verify that everything is configured correctly. If everything is valid, you’ll see two green checkboxes

image.png

  1. Scroll up and check the Enable Indexing box, then click the Save button at the top.
  2. After a few seconds, Validatar will start indexing data. You can see the indexing progress by clicking the refresh button to the right of the Indexing Statistics heading.

image.png

Indexing Statistics Note

The indexed objects include archived and disabled objects in the Validatar Database.


Was this article helpful?