Installing the Data Service Profile
The data service profiles (IP Geo-intelligence and IP Geo-location) are internal profiles that provide additional functionality to your Adobe application.
As with all other internal profiles provided by Adobe, these profiles should not be changed. All customization must occur in your dataset or role-specific profiles or other profiles that you create.
The data service profiles include the following dataset include files to be installed on a data workbench server:
- Profiles*profile name \Dataset\Log Processing\Traffic\IP.cfg: * Lists the c-ip field to be passed from log processing to transformation.
- Profiles*profile name \Dataset\Transformation\Geography\IPLookup.cfg: * Defines an IPLookup transformation that produces several fields of geographical data using the provided IP Geo-intelligence or IP Geo-location lookup file.
For information about transformation dataset include files, see the Dataset Configuration Guide .
In addition, each data service profile provides you with an element point layer file named IP Coordinates.layer. This layer file enables you to map locations in your dataset on the globe dynamically using IP addresses. After installation, the layer is stored in the Profiles*data service name*\Maps folder within the data workbench server installation directory.
The IP Coordinates.layer file references the Coordinates dimension, which is defined in the Coordinates.cfg file provided with the Geography profile and located in the Dataset\Transformation\Geography folder. Each element of the Coordinates dimension defined in your dataset is mapped on the globe using the latitude and longitude information contained in that element. For more information about element point layers that use dynamic points, see Defining Element Point Layers Using Dynamic Points .
If you installed the IP Geo-intelligence and IP Geo-location data service prior to version 5.1, your element point layer file references a lookup file instead of using dynamic points. Each layer file references the IP Geocodes lookup file and the IP Geocode dimension. The IP Geocodes lookup file contains a list of IP geocodes (geographical locations based on IP address) and the latitude and longitude for each. Each element of an IP Geocode dimension defined in your dataset is mapped on the globe using the latitude and longitude listed for that IP geocode in the IP Geocodes lookup file.
The name of the layer file and the files that it references differ for each data service:
- The IP Geocodes D.layer file is installed with the IP Geo-intelligence (Digital Envoy) profile. This element point layer references the IP Geocodes D yyyymmdd.txt lookup file (which you need to update periodically) and the IP Geocode D dimension.
- The IP Geocodes Q.layer file is installed with the IP Geo-location (Quova) profile. This element point layer references the IP Geocodes Q yyyymmdd.txt lookup file (which you need to update periodically) and the IP Geocode Q dimension.
For more information about element point layers that use lookup files, see Defining Element Point Layers Referencing Lookup Files .
To install the IP Geo-intelligence or IP Geo-location profile
The following installation instructions assume that you have installed data workbench and established a connection between data workbench and the data workbench Server on which you are installing data workbench Geography. If you have not done so, see the Data Workbench User Guide .
- Open the Profiles folder from the .zip file that you received from Adobe.
- Copy the IP Geo-intelligence or IP Geo-location folder to the Profiles folder in your data workbench server installation directory. You want to end up with a ...\Profiles\IP Geo-intelligence folder or a ...\Profiles\IP Geo-location on your data workbench server as shown in the following example. The names of the other folders within the Profiles folder may differ from the ones shown.
- Use the following steps to update the profile.cfg file for each profile with which you want to use the IP Geo-intelligence or IP Geo-location profile.
- Open the Profile Manager .
- Right-click the check mark next to profile.cfg and click Make Local . A check mark for this file appears in the User column.
- Right-click the newly created check mark and click Open > from the workbench . The profile.cfg window appears.
- In the profile.cfgwindow, right-click Directories and click Add new > Directory .To add the new directory to the end of the list of directories, right-click the number or name of the last directory in the list and click Add new > Directory .
- Type the name of the new directory: IP Geo-intelligence or I P Geo-location.
- Right-click (modified) at the top of the window and click Save .
- In the Profile Manager, right-click the check mark for profile.cfg in the User column, then click Save to > < profile name > .
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.