Updating Data Service Files

If you subscribe to either data service, you periodically must update the data service files provided by Adobe.

To do so, you must have access to the files on the data workbench server.

To load IP Geo-location or IP Geo-intelligence data files, you must complete the following procedures.

Replacing the Data File

1. In data workbench, on the Admin > Dataset and Profile tab, click the Servers Manager thumbnail to open the Servers Manager workspace.

2. Within the Servers Manager window, right-click the icon of the data workbench server onto which you want to load the files and click Server Files.

3. In the Server Files Manager, right-click in the Temp column for Lookups\IP Geo-location or Lookups\IP Geo-intelligence and click Open > < folder>.

4. Copy the .bin data file provided by Adobe to the Lookups\IP Geo-location or Lookups\IP Geo-intelligence folder window.

5. Save the file to the data workbench server machine by right-clicking the Temp column for the data file and clicking Save to > < server name>.

   If you are running a cluster, upload the files to the master data workbench server in the cluster.

Updating the IPLookup Transformation

1. In the Profile Manager, click Dataset, Transformation, and Geography.

2. Right-click the check mark next to IP Lookup.cfg and click Make Local. A check mark for this file appears in the User column.

3. Right-click the new check mark and click Open > from the workbench. A transformation configuration window appears.

4. In the window, click Transformation, then click Transformations.

5. Locate and click either IPLookup Quova or IPLookup Digital Envoy.

6. For the File parameter, update the name of the file to match the name of the new data ( .bin) file provided by Adobe.

7. Save the transformation configuration file by right-clicking (modified) at the top of the configuration window and clicking Save.

8. Save the modified configuration file to each profile that uses the data service by right-clicking the check mark next to IP Lookup.cfg in the User column and clicking Save to > < profile name>. Retransformation of the data begins after synchronization of the dataset profile.

   For information about retransformation of your dataset, see the Reprocessing and Retransformation chapter of the Dataset Configuration Guide.

   NOTE

   Do not save the modified configuration file to any of the internal profiles provided by Adobe (including the IP Geo-location or IP Geo-intelligence profile), as your changes are overwritten when you install updates to these profiles.

If you installed the IP Geo-intelligence and IP Geo-location data service for version 5.1 or later, you have completed the data service update. However, if you installed the IP Geo-intelligence and IP Geo-location data service prior to version 5.1, you must complete the following additional procedures.

Replacing the Lookup File

You should complete the following steps only if you installed the IP Geo-intelligence and IP Geo-location data service prior to version 5.1.

1. In the Server Files Manager, click either Profiles > IP Geo-intelligence or Profiles > IP Geo-location, then click Maps to view its contents.

2. Right-click in the Temp column for Maps and click Open > < folder>.

3. Copy the new .txt file provided by Adobe to the Maps folder window.

4. Save the file to the data workbench server machine by right-clicking the check mark in the Temp column for the .txt file and clicking Save to > < server name>.

Updating the Layer Files

Complete these steps for every layer ( .layer) file that references the IP Geo-intelligence or IP Geo-location lookup ( .txt) file.

1. In the Profiles*data service name*\Maps folder within the data workbench server installation directory, open the .layer file in a text editor such as Notepad.

2. In the Data Paths vector, update the name of the .txt lookup file to match the name of the new .txt file provided by Adobe, as shown highlighted in the following file sample:

   Layer = ElementPointLayer:
     Data Paths = vector: 1 items
       0 = Path: Maps\\LookupFileName.txt
     Longitude Column = string: LongitudeColumnName
     Latitude Column = string: LatitudeColumnName
     Name Column = string: LocationColumnName
     Key Column = string: KeyColumnName
     Dimension = ref: wdata/model/dim/DimensionName
     Metric = ref: wdata/model/metric/MetricName
   

3. Save the updated layer file.

4. Repeat Steps 2 and 3 for every .layer file that references the IP Geo-intelligence or IP Geo-location .txt file.