Installing Universal Addressing Databases

Note: This section is valid only for users of UAM- US , UAM- Canada, UAM- International, Loqate, and Validate Address Global.

You can download and install Universal Addressing (UAM) databases in the Spectrum Product Database (SPD) format. You cannot install older databases or vintages. After upgrading to Spectrum Technology Platform version 2020.1 from any previous version, you must delete and reconfigure all the previously configured databases using SPDs.

This procedure describes how to download and install Universal Addressing databases in the Spectrum Product Database (SPD) format from the Precisely.

Disk Space

The disk space requirements for extracted and non-extracted SPD bundles are:
  • Extracted bundles (all SPD) - 50 GB
  • Non-extracted bundles (all SPD) - 20 GB

To download and install a Universal Addressing database resource in the Spectrum Product Database (SPD) format:

  1. Download your Spectrum Product Database (SPD) format files from Precisely using the link provided in the Precisely communication or from data.precisely.com.
  2. Install the SPD files:
    1. Place the SPD files in SpectrumDirectory/server/import. This is the default location for SPD files. The Spectrum Technology Platform server monitors this folder and looks for new files in two-second intervals.
      You can change the location of the data import directory by altering the spectrum.import.dir property in the SpectrumDirectory/server/conf/spectrum-container.properties file.
    2. When the server detects new SPD files, the server automatically extracts the SPD files to SpectrumDirectory/server/ref-data.
      You can change the location of the data storage folder by altering the spectrum.data.manager.storage.dir property in the Data Manager settings section of the SpectrumDirectory/server/conf/spectrum-container.properties file.
    3. By default, the SPD files will be archived in SpectrumLocation/server/archive/ref data.
  3. At this point the data will become available and you can add it as a Spectrum database resource in the Spectrum Databases section of Management Console.
  4. After you install the database files, use either the Database Resource tool in the Management Console or the Administration Utility database commands to define the database as a resource.
  5. After the SPD files are extracted and are no longer needed, use the CLI commands to delete the SPD files. Do not manually delete the SPD files from the location where the server extracted the SPD files. Instead, use these CLI commands to delete the SPD files. For more information about the Product Data CLI commands, see Administration Utility in your Spectrum Technology Platform Administration Guide.
    1. Run the productdata list command to view the details for the currently installed SPD files. The results provide current information without having to access the file system. We suggest that you run this command before you run the productdata delete command, to make an informed decision about the data to delete.
    2. Run the productdata delete command to delete the SPD files from the Spectrum Technology Platform.

      Example

      productdata delete --p productName --c productComponent --q qualifier --v dataVintage

      spectrum> productdata delete --p "Universal Addressing Module" --c c6p --q UAM-CAN --v SEP2019