Installing Loqate on Windows

How to:

Loqate is used to enable address cleansing operations in the Data Quality Workbench. Loqate must be installed on the system where Omni-Gen is currently running. Loqate must be installed with an associated license key based on your purchase of Omni-Gen MDM Edition or DQ Edition. If you do not have a license key for Loqate, then contact iWay Customer Support.

Procedure: How to Install Loqate on Windows

You must stop Omni-Gen Server and all Omni-Gen services before installing Loqate. To install Loqate on Windows platforms:

  1. Create the following folder on your file system:
    C:\loqate
  2. Open a Windows command prompt, and make sure to run it as administrator.
  3. Type the following to change directories and press Enter.
    cd \omnigen\omniserver
  4. Type the following command and press Enter.
    omni stop-all
  5. Right-click the provided setup_64.exe installation file for Loqate, and select Run as Administrator from the context menu.

    The GBG Loqate Setup installation wizard opens and initially displays a Welcome screen, as shown in the following image.

  6. Click Next.

    The License Agreement screen opens, as shown in the following image.

  7. Select I accept the terms of the license agreement and then click Next.

    The Select Components screen opens, as shown in the following image.

  8. Accept all of the components that are selected by default for installation and then click Next.

    The Choose Destination Location screen opens, as shown in the following image.

    Note: The recommended installation location (destination folder) is C:\loqate, which matches the default location that is specified in the Data Quality (DQ) cleansing plans that are prepackaged with Omni-Gen™ for Customer. If you choose a different installation location, then you will have to manually update the Loqate step in each DQ cleansing plan with your specific path.

  9. Ensure that C:\loqate is specified as the destination folder and then click Next.

    The Start Copying Files screen opens, as shown in the following image.

  10. Click Next.

    The Installing screen opens and displays a progress bar for the Loqate installation, as shown in the following image.

    During the installation, the Data Installation screen opens, as shown in the following image.

  11. Click Next to continue.

    A Microsoft Visual C++ 2005 Redistributable (x64) pop-up dialog may open, which you can ignore, as shown in the following image.

    When the installation is complete the Loqate Install Wizard Complete screen opens, as shown in the following image.

  12. Click Finish.

    Verify that your system PATH environment variable has been updated to include the Loqate installation location (for example, C:\loqate).

    You are now ready to install Global Knowledge Repository data on your system.

  13. On your file system, navigate to the Loqate installation directory. For example:
    C:\loqate
  14. Right-click the InstallManager.bat file, and select Run as Administrator from the context menu.

    The Installation Manager v10.0.0 wizard opens and initially displays a Welcome screen, as shown in the following image.

  15. Click Next.

    The Choose Data Installation Location screen opens, as shown in the following image.

  16. Click Select.

    The Select Data Install Folder screen opens.

  17. Navigate to (and select) the following directory:
    C:\loqate\data
  18. Click OK.

    You are returned to the Choose Data Installation Location screen.

  19. Click Next to continue with the installation.

    The Enter License Information screen opens, as shown in the following image.

  20. Enter the license key that is included with your purchase of Loqate, and then click Next.

    For more information about obtaining a license key, contact iWay Customer Support.

    The License Details screen opens, as shown in the following image.

    Note: The list of products that is displayed will vary depending on your license.

  21. Confirm the license details and then click Next.

    The Data Pack Selection screen opens, as shown in the following image.

  22. Click Select.

    In the dialog that opens navigate to (and select) the location of the data pack download folder. For example:

    C:\loqate\download
  23. Click OK to close the dialog and then click Next on the Data Pack Selection screen to continue.
  24. Deselect the Select All check box, as shown in the following image.

    Note: The list of products that is displayed will vary depending on your license.

  25. In the list of data packs, select only the data packs that are shown in the following image.
  26. Click Next to continue.
  27. Deselect all CASS library data packs, and then click Next, as shown in the following image.

    The Install Options screen opens, as shown in the following image.

    The download proceeds and displays its progress.

  28. Wait for the download to complete, which can take a few minutes, and then click Next to continue.

    The License Agreement screen opens, as shown in the following image.

  29. Select I accept the terms of the license agreement and then click Next.

    The installation of the selected country data packs begins, which is indicated by a progress bar, as shown in the following image.

  30. When the installation is complete, click Finish.

    After you have finished downloading and installing the country data packs for Loqate, you must install the address cleansing metadata for Omni-Gen to enable address cleansing operations within Data Quality Workbench.

    Note: If Omni-Gen Server was running during the Loqate installation, then Omni-Gen Server must be restarted and you must restart all Omni-Gen services.

    The address cleansing metadata consists of the following two files:

    • complex_address_cleanse_STRING.comp
    • complex_address_cleanse_STRING.xml
  31. Download these files from the Technical Support Center (https://techsupport.informationbuilders.com/) along with the appropriate Omni-Gen installer.
  32. Copy these two files from the download location to the following folder:
    <OmniHome>\OmniGenData\OmniDesigner\.repositoryservice\Operations\cleanse\complex
  33. Start Omni-Gen Server.