Adding a Global Geocoding Module Database Resource

Whenever you install a new database resource or modify an existing database resource you must define it in the Management Console in order for it to become available on your system. This procedure describes how to add or modify a Global Geocoding Module database resource.

  • Before configuring multiple database resources, confirm if there are any applications using the REST API from GGM. REST API calls will need to be modified to include the database name so it does not conflict with any new database resources.
  • If you want to use this capability and you have existing data flows, review and update any data flow database resources. Otherwise, no changes to data flow database resources are necessary.
    Note: In terms of backwards compatibility, when older flows are imported, they will default to the latest database created on 2019.1.
  1. If you haven't already done so, install the dataset files on your system, using the command line interface (CLI) commands. For instructions on installing databases, see the Spectrum™ Technology Platform Installation Guide.
  2. In Management Console, under Resources, choose Spectrum Databases.
  3. To create a new database resource, click the Add button . To make changes to an existing database resource, select it, then click the Edit button . To delete a database resource, select it, then click the Delete button .
    Note: You can copy a Global Geocoding database resource to use for another installed module; however, a copy of a database resource cannot be made for the Global Geocoding Module since it can only have one database resource.
  4. If you are creating a new database resource, on the Add Database page, enter a name for the database resource in the Name field.
  5. In the Pool size field, specify the maximum number of concurrent requests you want this database to handle.

    The optimal pool size varies by module. You will generally see the best results by setting the pool size between one-half to twice the number of CPUs on the server, with the optimal pool size for most modules being the same as the number of CPUs. For example, if your server has four CPUs you may want to experiment with a pool size between 2 (one-half the number of CPUs) and 8 (twice the number of CPUs) with the optimal size possibly being 4 (the number of CPUs).

    Tip: You should conduct performance tests with various settings to identify the optimal pool size and runtime instance settings for your environment.
  6. In the Module field, select GlobalGeocode. In the Type field, use the default shown, Global Geocode Dataset.
    If you had extracted your .SPD files and placed them in the \server\app\dataimport folder, Spectrum would automatically add them to the \repository\datastorage folder. You will see a list of datasets in the Add Database screen.
  7. Select the dataset(s) you want to add to the database as a resource. Use the Filter text box to search for a dataset when you have a long list.
  8. Save the database.
  9. If you have a custom dictionary you wish to geocode against, click the Add button and provide a name, country and path to the dictionary. Do not use the Add button to add datasets to the standard database.
    A custom database is a user-defined database that contains addresses and latitude/longitude coordinates that you can use for geocoding.
    Note: You must have a licensed standard database on your system in order to configure and geocode to a custom dictionary.
  10. If there are any open Enterprise Designer sessions, click the refresh button to see the new stage.
Note: If the database fails to configure due to insufficient resources, you may need to increase the Java Virtual Machine (JVM) initial heap size (Xms) and/or add the max heap size (Xmx) in the java.vmargs file. This file is located in the SpectrumDirectory\server\modules\GlobalGeocode folder, where SpectrumDirectory is your Spectrum installation directory.