Dwb Geography

31
7/18/2019 Dwb Geography http://slidepdf.com/reader/full/dwb-geography 1/31 Adobe  ®  Marketing Cloud Geography

description

Dwb Geography

Transcript of Dwb Geography

Page 1: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 1/31

Adobe ®  Marketing Cloud

Geography

Page 2: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 2/31

Contents

Data Workbench Geography Overview..........................................................................4

Installing Data Workbench Geography..........................................................................5

Installing the Geography Profile..................................................................................................................................5

Installing the Geography Lookup Files......................................................................................................................6

Installing the Terrain Images.cfg File..........................................................................................................................7

Working with Imagery Layers..........................................................................................8

Understanding Imagery Layers.....................................................................................................................................8

Working with Terrain Image Layers............................................................................................................................9

Specifying Projection Information for Terrain Images................................................................................................................12

Making a New Terrain Image Layer Available................................................................................................................................15

Working with Element Point Layers.........................................................................................................................15

Defining Element Point Layers Referencing Lookup Files.........................................................................................................15

Making a New Element Point Layer Available................................................................................................................................19

Working with Vector Layers.........................................................................................................................................19

Defining Vector Layers Referencing Vector Files..........................................................................................................................19

Vector Layers Referencing Tab Separated Values Files...............................................................................................................20

Making a New Vector Layer Available...............................................................................................................................................22

Working with Data Services...........................................................................................23

About the Data Services...............................................................................................................................................23

Installing a Data Service on a Data Workbench Server......................................................................................23

Installing the Data Service Profile.......................................................................................................................................................23

Installing the Data Service Lookup Files...........................................................................................................................................25

Updating Data Service Files.........................................................................................................................................26

Upgrading and Uninstalling Data Workbench Geography.........................................29

Upgrading Data Workbench Geography................................................................................................................29

GeographyLast updated 12/11/2013

Page 3: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 3/31

Uninstalling Data Workbench Geography.............................................................................................................29

Contact and Legal Information.....................................................................................31

GeographyLast updated 12/11/2013

Contents

Page 4: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 4/31

Data Workbench Geography OverviewData workbench Geography  is a geographical imagery and analysis software product that enables you to display topographicalimagery in data workbench.

For information about installing data workbenchGeography , see Installing Data Workbench Geography .

Data workbench Geography  consists of the Geography  profile, which includes default imagery layers and their related lookup

files as well as additional dimensions (City, Coordinates, Country, DMA, and Domain) for use in your analysis.

You also can add other layers and lookup files to expand your imagery capabilities. For more information about imagery layers,

see Working with Imagery Layers.

If you have licensed data workbenchGeography , you can subscribe to an optional data service that enables you to map IP

addresses on the globe or create visualizations showing geographically related dimensions of data (such as area code, time zone,

and MSA) that are based on IP address. For information about subscribing to these services, please contact Adobe. For information

about installing and working with data services, see Working with Data Services.

4Data Workbench Geography Overview

Page 5: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 5/31

Installing Data Workbench GeographyThis chapter provides the steps to install data workbenchGeography  on a data workbench server.

To complete these steps, you must have access to the files on the data workbench server.

If you have subscribed to one of the two optional data services, you also must install the data service profile and its lookup files.

For more information about these services, see Working with Data Services.

For information about the system requirements for installing, configuring, and operating data workbenchGeography , see the

 Minimum System Requirements document.

Adobe distributes the data workbenchGeography  software product as a .zip file. This file contains two folders (Lookups and

Profiles). To install data workbenchGeography  on a data workbench server, you must perform the following steps:

• Install the Geography  profile. See Installing the Geography Profile.

• Install the Geography  lookups. See Installing the Geography Lookup Files.

• (Optional) Install the Terrain Images.cfg file. See Installing the Terrain Images.cfg File.

 Note: You must install the files for data workbenchGeography  on the data workbench server machine on which you are

 processing and running your dataset profile. If you are running a data workbench server cluster, you must install the fileson the master server. For information about dataset profiles, see the Dataset Configuration Guide.

Installing the Geography Profile

The Geography  profile provided with data workbenchGeography  is an internal profile that provides additional functionality to your Adobe application.

As with all other internal profiles provided by Adobe, the Geography  profile should not be changed. All customization must

occur in your dataset or role-specific profiles or other profiles that you create.

The Geography  profile includes several transformation dataset include files (located in the

Dataset\Transformation\Geography  folder) that define geographical dimensions. Following is a list of the

transformation dataset include files provided with the Geography  profile:

• City.cfg

• Coordinates.cfg

• Country.cfg

• DMA.cfg

• Domain.cfg

Each of the files is named for the extended dimension that it defines. An additional file, IPLookup.cfg, defines several

geographical data fields that are used to define dimensions in the other transformation dataset include files.

For information about transformation dataset include files, see the Dataset Configuration Guide.

To install the Geography profile on the data workbench server

 Note: 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 workbenchGeography . If you

have not done so, see the Data Workbench User Guide.

5Installing Data Workbench Geography

Page 6: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 6/31

1. Open the Profiles folder from the .zip file provided to you by Adobe.

2. Copy the Geography folder to the Profiles folder in your data workbench server installation directory. You want to endup with a ...\Profiles\Geography folder on your data workbench server as shown in the following example. Thenames of the other folders within the Profiles folder may differ from the ones shown.

3. Use the following steps to update the profile.cfg file for each profile with which you want to use dataworkbenchGeography .

1. Open the Profile Manager.

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

column.

3. Right-click the newly created check mark and clickOpen > from the workbench. Theprofile.cfg window appears.

4. In the profile.cfg window, 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 thelist and click Add new  > Directory .

5. Type the name of the new directory:Geography .

6. Right-click (modified) at the top of the window and click Save.

7. In the Profile Manager, right-click the check mark forprofile.cfg in the User column, then click Save to > < profile

name>.

 Note: Do not save the modified configuration file to any of the internal profiles provided by Adobe (including the

Geography  profile), as your changes are overwritten when you install updates to these profiles.

Installing the Geography Lookup Files

Steps to install the Geography  lookup files on the data workbench server.

The lookup file (Lookups\Geography\DMA.txt) provided with the Geography  profile is a two-column tab-delimited

text file that lists DMA (designated market area) codes and the corresponding names.

6Installing Data Workbench Geography

Page 7: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 7/31

1. Open the Lookups folder from the .zip file provided to you by Adobe.

2. Copy the Geography folder to the Lookups folder in your data workbench server installation directory. You want to end upwith a ...\Lookups\Geography folder on your data workbench server as shown in the following example. The names of theother folders within the Lookups folder may differ from the ones shown.

Installing the Terrain Images.cfg File

Steps to install the Terrain Images.cfg file on the data workbench server.

 Note: You need to install the Terrain Images.cfg  file only if you want to make new terrain image layers to display 

on the globe visualization.

1. Copy the Terrain Images.cfg file from the .zip file provided to you by Adobe.

2. Paste the file in the Components folder in your data workbench server installation directory.

For information about configuringTerrain Images.cfg, see Working with Terrain Image Layers.

7Installing Data Workbench Geography

Page 8: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 8/31

Working with Imagery LayersConceptual information about creating and implementing layers.

Understanding Imagery Layers

Conceptual Information about the Geography  profile layers, types of imagery layers, and creating new layers.

• Types of Imagery Layers

• Geography Profile Layers

• Creating New Layers

Types of Imagery Layers

Data workbench Geography  enables you to view the following types of imagery layers in data workbench:

• Terrain image layer: This type of layer displays terrain imagery of the Earth, over which geographical data can be displayed.

The globe visualization in data workbench is an example of a terrain image layer. See Working with Terrain Image Layers.

• Element point layer: This type of layer displays one point on the globe for each element of a dimension. See Working with

Element Point Layers.• Vector layer: This type of layer displays vector data (line art) on the globe. See Working with Vector Layers.

In data workbench, you can select which of the these layers you want to display for a particular analysis task.

Geography Profile Layers

The Geography  profile provides you with a set of default imagery layers, which are stored in the Profiles\Geography\Maps

folder within the data workbench server installation directory:

• Blue Marble 2km: This terrain image layer creates a 3-D map of the world, which is what displays when you add the globe

 visualization to a workspace. When this layer is not selected, the globe is not visible but the other layers still display. TheBlue

Marble 2km.layer file references the Blue Marble 2km.tsi file.

For information about working with the globe visualization, see the Data Workbench User Guide.

• Zip Points: This element point layer enables you to map locations in your dataset using a United States ZIP Code. The Zip

Points.txt lookup file (provided by Adobe) contains a list of all United States ZIP Codes and each ZIP Code’s latitude

and longitude. The Zip Points.layer file references the Zip Points.txt file and the Zipcode.dim file and

contains the configuration parameters needed to display the locations on the globe. Each element of the ZIP Code dimension

(Zipcode.dim) that you define within your dataset is mapped on the globe using the latitude and longitude listed for that

ZIP Code in the Zip Points.txt lookup file.

For information about defining dimensions, see the Dataset Configuration Guide.

• Boundaries: This vector layer provides the major world political boundaries, such as countries, as well as the boundaries of 

natural physical features of the Earth, such as lakes and islands. TheBoundaries.layer file references one or more of themwcoast.vec,mwisland.vec,mwlake.vec,mwnation.vec,mwriver.vec,mwstate.vec,US states.vec,

and world boundaries.vec files.

• IP Coordinates: This element point layer uses dynamic points to enable you to map locations in your dataset using IP addresses.

TheIP Coordinates.layer file references the Coordinates dimension (Coordinates.dim) and specifies the Visitors

metric as the metric to use to determine the size of the points on the globe for each coordinate.

8Working with Imagery Layers

Page 9: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 9/31

Your Geography  profile or other profiles in your installation may contain additional imagery layers that Adobe provided or

your company created.

Creating New Layers

You can create new imagery layers by copying the appropriate type of layer file included in the Geography  profile into any 

Profiles\ profile name\Maps folder, then renaming and editing the file as appropriate. All new layers must meet the following

requirements:• The .layer file must adhere to the format of one of the supported layer types.

• The .layer file must reference the appropriate lookup and dimension files, if necessary.

• The referenced lookup file also must be stored within the data workbench server installation directory, and its path must be

specified accurately in the.layer file.

For more information about the format and parameters for each type of layer file and its associated files, see the section in this

chapter for the appropriate layer type.

Working with Terrain Image Layers

In data workbench, a terrain image layer displays terrain imagery of the Earth.

Terrain image layers are stored in the Geography  profile, in a custom format. These image layers can be generated by Adobe,

or data workbench server can transform your user-supplied terrain imagery into terrain layers suitable for use on the globe

 visualization.

 Note: To work with terrain image layers, you must install the Terrain Images.cfg  file provided by Adobe. For 

installation instructions, see Installing Data Workbench Geography .

To define a terrain image layer, you must have the following:

• One or more terrain image files containing the images to be displayed on the globe.

• A Terrain Images.cfg  file that specifies the terrain image file(s) to be used for the layer(s). The Terrain Images.cfg fileenables you to add one or more sources to create a terrain image layer. The format of your terrain image file determines the

type of source that you should add. The following table provides descriptions of the available terrain image layer sources,

including the supported terrain image file formats:

Terrain Image Layer Sources

DescriptionType

Creates terrain image layers from 24-bit headerless RGB files that are latitude-longitude aligned

(unprojected), where north is the top of the image, and east is the right.

Raw unprojected bitmap

Supported image format(s): RAW

 Note: This source requires projection information. For information about projection

 formats, see Specifying Projection Information for Terrain Images.

Creates terrain image layers from 24-bit, latitude-longitude aligned (unprojected) image formats,

where north is the top of the image, and east is the right.

General image, unprojected

9Working with Imagery Layers

Page 10: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 10/31

DescriptionType

Supported image format(s): BMP, JPG, PNG, TIFF

 Note: This source requires projection information. For information about projection

 formats, see Specifying Projection Information for Terrain Images.

Creates terrain image layers from image formats that embed geodetic data in the image file. The

projection information is extracted from the image.

Image with embedded

projection

Supported image format(s): Erdas (IMG), GeoTIFF

 Note: This source usually does not require projection information but supports the addition

of such information if needed. For information about projection formats, see Specifying 

Projection Information for Terrain Images.

To define a terrain image layer

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 desired data workbench server and click Server Files.

3. In the Server Files Manager, click Components to view its contents. The Terrain Images.cfg file is located within

this directory.

4. Right-click the check mark in the server name column forTerrain Images.cfg, then click Make Local. A check mark 

appears in the Temp column for Terrain Images.cfg.

5. Right-click the newly created check mark in the Temp column and click Open > from the workbench. The Terrain

Images.cfg window appears.

6. In the Terrain Images window, click component to view its contents.7. Right-click Sources > Add new  and choose one of the following source types:

• Raw unprojected bitmap. (Once added, this source type is labeled RawTerrainSource in the Terrain Images window.)

• General image, unprojected. (Once added, this source type is labeled GDALTerrainSource in the Terrain Images window.)

• Image with embedded projection. (Once added, this source type is labeled GDALTerrainSource in the Terrain Images

window.)

8. Edit the parameters for the source as necessary using the following sample file and table of parameters as guides.

10Working with Imagery Layers

Page 11: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 11/31

Terrain Images.cfg: Sources

DescriptionParameter

Optional for all sources. Specifies gamma correction to be applied to the source image. This may 

be desirable due to the fact that data workbench normally runs with a high gamma setting. The

default value is 1.

Gamma

Required for raw unprojected bitmap images. The height of the source image in pixels.Height

Required for raw unprojected bitmap images and general images, unprojected, but supported

for images with embedded projection. Data workbenchGeography  supports latitude-longitude

Projection Info

projections and Transverse Mercator (TM) projections for terrain image layers. The default

projection format is the latitude-longitude projection (LatLonProjection).

11Working with Imagery Layers

Page 12: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 12/31

DescriptionParameter

For information about projection formats, see Specifying Projection Information for Terrain

Images.

Required for all sources. The name of the source image file. This may be a file name or a wildcard

pattern. Using a pattern may be useful if, for instance, images for the same region at different

Source Image

dates are uploaded, with no change in the associated metadata. Therefore a pattern like“Tysons

Corner *.raw” would create layers from Tysons Corner 050211.raw, Tysons

Corner 050218.raw, and so on as new images are added, with no additional configuration

necessary if the parameters for the files are otherwise identical.

Optional for all sources. For JPEG compression, an integer from 0 to 100 specifying how to

balance image size and quality. (The default value is zero.) A higher number results in better

image quality, but produces larger images and longer download times for data workbench users.

Tile Compression Quality 

Compressing images below 70 may result in image degradation.

Optional for all sources. Specifies what compression method is used to write output files. The

only currently supported methods are RAWRGB (the default, resulting in no compression) and

Tile Compressor

JPEG. Use JPEG compression to reduce the size of layers that are transmitted during profile

synchronization.

Required for raw unprojected bitmap images. The width of the source image in pixels.Width

9. Edit the Source Image Location, Temp Image Storage, and Write Layers To parameters using the following table as a guide.

These parameters apply to all of the terrain image sources that you define in the Sources section of this file.

Terrain Images.cfg: Additional Parameters

DescriptionParameter

Required. The directory that is scanned for images to translate into terrain layers. If it is not anabsolute path, it is interpreted relative to the data workbench server installation directory.

Source Image Location

Optional. The name of a directory that is used for storage of temporary files used in the translation

of source images to terrain layers. If it is not an absolute path, it is interpreted relative to the

data workbench server installation directory. The default location is the Temp directory.

Temp Image Storage

Required. The directory to which terrain layers are output. Ordinarily, this is the Maps

subdirectory of a profile directory, so that the Globe visualization can find the layers.

Write Layers To

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

11. To save updated file to the data workbench server machine, in the Server Files Manager, right-click the check mark for

Terrain Images.cfg in the Temp column, then click Save to > <server name>.

Specifying Projection Information for Terrain Images

Data workbench Geography  supports both latitude-longitude projections and Universal Transverse Mercator (UTM) projectionsfor all terrain image layer sources.

12Working with Imagery Layers

Page 13: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 13/31

Projection information is required for raw unprojected bitmaps and general images, unprojected. You can specify projection

information for images with embedded projection information, though it is usually not required because the parameters of the

projection are determined automatically from geodetic data embedded in the image itself. The following sections provide details

about specifying these projection formats in the Terrain Images.cfg file.

Latitude-Longitude Projections

The latitude-longitude projection format (LatLonProjection) in theTerrain Images.cfg file is defined by four parametersfor latitude and longitude.

To specify a LatLonProjection for unprojected images (raw unprojected bitmaps and general images, unprojected), you can

enter settings for the LatLonProjection within the Terrain Images.cfg window in data workbench. See To Specify a

LatLonProjection for Unprojected Images.

To specify a LatLonProjection for images with embedded projection information, you must open theTerrain Images.cfg

file in a text editor such as Notepad, set the Projection Info parameter to “LatLonProjection”, and add settings for the

LatLonProjection. See To Specify a LatLonProjection for Images Within Embedded Projection Information.

• To Specify a LatLonProjection for Unprojected Images

• To Specify a LatLonProjection for Images Within Embedded Projection Information

To Specify a LatLonProjection for Unprojected Images

1. Open the Terrain Images.cfg file in data workbench and add a terrain image layer source as described in To define

a terrain image layer .

2. Edit the Projection Info parameters using the following parameters table as a guide:

LatLonProjection Parameters

DescriptionParameter

The latitude of the top edge of the image, in degrees, where 90 is the North Pole and -90 is the South

Pole.

Lat0

The latitude of the bottom edge of the image.Lat1

The longitude of the left-hand edge of the image, in degrees, where positive numbers are east and

negative numbers are west longitudes.

Lon0

The longitude of the right-hand edge of the image.Lon1

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

4. To save the locally made changes to the data workbench server machine, in the Server Files Manager, right-click the check 

mark for Terrain Images.cfg in the Temp column, then click Save to > <server name>.

To Specify a LatLonProjection for Images Within Embedded Projection Information

1. In the Server Files Manager, click Components to view its contents. The Terrain Images.cfg file is located within

this directory.

2. Right-click the check mark in the server name column forTerrain Images.cfg, then click Make Local. A check mark 

appears in the Temp column for Terrain Images.cfg.

3. Right-click the newly created check mark in the Temp column and click Open >in Notepad. TheTerrain Images.cfg

file appears in a Notepad window.

13Working with Imagery Layers

Page 14: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 14/31

4. Edit the Projection Info parameters using the following sample file fragment as a guide. Be sure to specify the projection

type as highlighted below. For descriptions of the parameters, see the LatLonProjection Parameters table in the previous

procedure.

Projection Info = LatLonProjection:Lat0 = double: 90

  Lat1 = double: -90  Lon0 = double: -180  Lon1 = double: 180

Universal Transverse Mercator Projections

The Universal Transverse Mercator (UTM) projection is defined by eight parameters.

When specifying a Universal Transverse Mercator projection for a terrain image layer, your terrain image files must be aligned

with false (projected) north towards the top of the image, and false east to the right of the image.

To specify a UTM projection for any terrain image source, you must open theTerrain Images.cfg file in a text editor

such as Notepad, set the Projection Info parameter to “TransverseMercatorProjection”, and add settings for the UTM projection.

To specify a Universal Transverse Mercator projection

1. In the Server Files Manager, click Components to view its contents. The Terrain Images.cfg file is located withinthis directory.

2. Right-click the check mark in the server name column for Terrain Images.cfg, then click Make Local. A check mark 

appears in the Temp column for Terrain Images.cfg.

3. Right-click the newly created check mark in the Temp column and click Open >in Notepad. TheTerrain Images.cfg

file appears in a Notepad window.

4. Edit the Projection Info parameters using the following sample file fragment and parameters table as guides. Be sure to

specify the projection type as highlighted below.

Projection Info = TransverseMercatorProjection:  Ellipsoid Inverse Flattening = double: 294.9786982139006  Ellipsoid Semimajor Axis = double: 6378206.4000000004  False Easting = double: 500000

  False Northing = double: 0  Northwest Corner Coordinates = v3d: (550339, 5.42059e+006, 0)  Prime Meridian = double: -123  Scale Factor = double: 0.9996  Southeast Corner Coordinates = v3d: (555099, 5.41356e+006, 0)

TransverseMercatorProjection Parameters

DescriptionParameter

The parameters of the ellipsoid used for the projection. The semimajor axis is specified

in meters.

Ellipsoid Inverse Flattening, Ellipsoid

Semimajor Axis

The false easting of the central meridian of the projection, in meters. For UTM, this

is always 500,000.

False Easting

The false northing of the equator in the projection, in meters. For UTM, this is 0 for

northern hemisphere zones and 10,000 for southern hemisphere zones.

False Northing

The coordinates (in projected meters) of the top left and bottom right corners of the

image.

Northwest Corner Coordinates,

Southeast Corner Coordinates

14Working with Imagery Layers

Page 15: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 15/31

DescriptionParameter

The longitude of the central meridian of the projection, specified in degrees east of 

Greenwich. Negative numbers may be used to specify degrees west.

Prime Meridian

The ratio of the radius of the projection cylinder to the semimajor axis of the ellipsoid.

For Universal Transverse Mercator (UTM) projections, this is always 0.9996.

Scale Factor

Making a New Terrain Image Layer Available

Steps to make a new terrain layer available to display on the globe visualization.

1. In the Profiles\ profile name\Maps folder within the Insight Server installation directory, place the layer file and the supportingimage files.

2. Edit theorder.txt file in the Profiles\ profile name\Maps folder to reflect the order in which you want the layers to display.By default, layers appear in lexicographic order by their names.

 Note: When editing the order.txt file, take care not to cover up map layers that you want to show.

For more information about using order.txt files, see the Configuring Interface and Analysis Features chapter of theData Workbench User Guide.

3. In data workbench, select the desired profile by right-clicking the workspace title bar and clickingSwitch Profile > < profilename>.

4. Right-click the workspace title bar and click Work Online. An X appears next to Work Online.

5. Open a workspace and on a globe visualization, right-click and select the new layer. An X appears next to the layer name.

Working with Element Point Layers

In data workbench, an element point layer displays one point on the globe for each element of a dimension.

The size of the point displayed on the globe is determined by evaluating a specified metric over the dimension whose elements

you want to plot. Therefore, larger metric values correspond to larger points on the globe.

Defining Element Point Layers Referencing Lookup Files

When creating an element point layer that references a lookup file to obtain latitude and longitude data, the location of the pointis obtained by retrieving each element and its associated latitude and longitude from the lookup file.

Instead of using a lookup file, you can use the Dynamic Points functionality, which embeds the latitude and longitude of a

location in the name of each element of a dimension. See Defining Element Point Layers Using Dynamic Points.

To define an element point layer that references a lookup file, you must create or already have available the following:

• A dimension defined in the Transformation.cfg file or a transformation dataset include file. For information about

transformation configuration files, see the Dataset Configuration Guide.

• A lookup file containing the data used to plot each data point. This file must contain at least three columns of data for each

data point: the key, the longitude, and the latitude. For more information about the required format of the lookup file, see

Element Point Lookup File Format .

15Working with Imagery Layers

Page 16: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 16/31

• A layer file that specifies the location of the lookup file and identifies the related dimension and metric as well as the key,

longitude, and latitude column names in the lookup file. For more information about the required format of the layer file, see

Element Point Layer File Format .

 Note: The Zip Points.layer  file, provided with the Geography  profile, is an element point layer that identifies the

Zipcode.dim file, theSessions.metric file, theZip Points.txt lookup file, and the names of the key, longitude,

latitude, and name columns in the lookup file.

Element Point Lookup File Format

Information about the element point layer columns.

The element point layer lookup file must contain at least the following three columns:

• Key column: This column should contain common key data, which enables the data workbench server to connect the data in

the lookup file to that in the dataset. The Key  column must be the first column in the lookup file. Each row in this column

identifies an element of the dimension.

• Longitude column: This column should contain the longitude for each data point in the Key  column.

• Latitude column: This column should contain the latitude for each data point in the Key  column.

• Name column: (Optional). If you want to specify a name to be displayed on the map for each data point, you can include a

Name column in the lookup file.

Each row in the Zip Points.txt lookup file contains a ZIP Code in the first column followed by the longitude, latitude,

and associated city name.

tude, and associated city name.ZIP_CODE LATITUDE LONGITUDE NAME00210 +43.005895 -071.013202 PORTSMOUTH, NH00211 +43.005895 -071.013202 PORTSMOUTH, NH...

Element Point Layer File Format

Formatting information about the element point layer file.

Each element point layer .layer file that references a lookup file must be formatted using the following template:

Layer = ElementPointLayer:  Data Paths = vector: 1 items  0 = Path: Maps\\Lookup File Name.txt  Longitude Column = string: Longitude Column Name  Latitude Column = string: Latitude Column Name  Name Column = string: Location Column Name  Key Column = string: Key Column Name  Dimension = ref: wdata/model/dim/Dimension Name  Metric = ref: wdata/model/metric/Metric Name  Scale = double: Scale  Color = v3d: RGB Color Vector  Rendering Mode = int: Mode Number

Element Point Layer Parameters: Lookup Files

DescriptionParameter

Path to the lookup file containing latitude and longitude data.Data Paths

The name of the column in the lookup file containing the longitude data.Longitude Column

The name of the column in the lookup file containing the latitude data.Latitude Column

16Working with Imagery Layers

Page 17: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 17/31

DescriptionParameter

Optional. The name of the column in the lookup file containing the names of the locations

represented by the latitude and longitude data.

Name Column

The name of the column in the lookup file containing the common key data, which enables the

data workbench server to integrate the data in the lookup file into the dataset. This must be the

first column in the lookup file.

Key Column

Each row in this column is an element of a dimension. This dimension must be defined in the

Transformation.cfg file or a transformation dataset include file and specified in the

Dimension parameter of this file. For more information about transformation configuration files,

see the Dataset Configuration Guide.

The name of the dimension (defined in a transformation configuration file) containing elements

that correspond to the data rows in the Key  column.

Dimension

The name of the metric that is evaluated over the dimension specified in the Dimension parameter.Metric

Optional. Value used to size the points in the layer. The default value is 100. Larger values make

the points bigger, and smaller values make them smaller.

Scale

Optional. The RGB color vector, which is expressed as (red,green,blue). For each color in the

 vector, you can enter a value from 0.0 to 1.0. For example, (1.0, 0.0, 0.0) is bright red, and (0.5,

0.5, 0.5) is gray.

Color

Optional. Integer value representing the rendering mode to use for the layer. The three available

modes are as follows:

Rendering Mode

• Rendering Mode 1. Points size is defined in screen space (points stay a constant size relative to

the computer screen). Points are rendered using polygons, so there is no upper limit on point

size. This is the default rendering mode.

• Rendering Mode 2. Point size is defined in world space (points stay a constant size relative tothe globe). Points are rendered using polygons, so there is no upper limit on point size.

• Rendering Mode 3. Point size is defined in screen space. Points are rendered using OpenGL

smooth points.

The Zip Points.layer file is formatted as follows:

Layer = ElementPointLayer:  Data Paths = vector: 1 items  0 = Path: Maps\\Zip Points.txt  Longitude Column = string: LONGITUDE  Latitude Column = string: LATITUDE  Name Column = string: NAME

  Key Column = string: ZIP_CODE  Dimension = ref: wdata/model/dim/Zipcode  Metric = ref: wdata/model/metric/Sessions

Defining Element Point Layers Using Dynamic Points

When creating an element point layer using dynamic points, the latitude and longitude data is embedded in each element of the dimension.

To define an element point layer using dynamic points, you must create or already have available the following:

17Working with Imagery Layers

Page 18: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 18/31

• A dimension, defined in the Transformation.cfg file or a transformation dataset include file, in which each element

contains the string “latitude,longitude” or “latitude,longitude,name.”

For steps to create a dimension, see the Dataset Configuration Guide.

• A layer file  that specifies the related dimension.

For more information about the required format of the layer file, see Element Point Layer File Format .

 Note: When using Dynamic Points , it is essential to ensure that the cardinality of the dimension specified in the layer file

is reasonable. If every row of a dataset has a different latitude and longitude, the dimension quickly fills up and most rows

 fall into a Small Elements element. Because the Small Elements element does not have a latitude and longitude, it does not 

appear on the globe.

Element Point Layer File Format

Each element point layer file using dynamic points must be formatted using the following template:

Layer = ElementPointLayer:  Dimension = ref: wdata/model/dim/Dimension Name  Metric = ref: wdata/model/metric/Metric Name

  Dynamic Points = bool: true  Scale = double: Scale  Color = v3d: RGB Color Vector  Rendering Mode = int: Mode Number

Element Point Layer Parameters: Dynamic Points

DescriptionParameter

The name of the dimension (defined in a transformation configuration file), which must contain

elements with the string “latitude,longitude” or “latitude,longitude,name” as shown in the following

examples:

Dimension

• 37.5181,-77.1903

• 35.3317,-77.8126,Somewhere

The name of the metric that is evaluated over the dimension specified in the Dimension parameter.Metric

Enables Dynamic Points. Set to true.Dynamic Points

Optional. Value used to size the points in the layer. The default value is 100. Larger values make the

points bigger, and smaller values make them smaller.

Scale

Optional. The RGB color vector, which is expressed as (red,green,blue). For each color in the vector,

you can enter a value from 0.0 to 1.0. For example, (1.0, 0.0, 0.0) is bright red, and (0.5, 0.5, 0.5) is

gray.

Color

Optional. Integer value representing the rendering mode to use for the layer. The three available modes

are as follows:

Rendering Mode

• Rendering Mode 1. Points size is defined in screen space (points stay a constant size relative to the

computer screen). Points are rendered using polygons, so there is no upper limit on point size. This

is the default rendering mode.

• Rendering Mode 2. Point size is defined in world space (points stay a constant size relative to the

globe). Points are rendered using polygons, so there is no upper limit on point size.

18Working with Imagery Layers

Page 19: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 19/31

DescriptionParameter

• Rendering Mode 3. Point size is defined in screen space. Points are rendered using OpenGL smooth

points.

The IP Coordinates.layer file is formatted as follows:

Layer = ElementPointLayer:  Dimension = ref: wdata/model/dim/Coordinates  Metric = ref: wdata/model/metric/Visitors  Dynamic Points = bool: true

Making a New Element Point Layer Available

Steps to make an element point layer available to display on the globe visualization.

1. In the Profiles\ profile name\Maps folder within the data workbench server installation directory, place the layer file and itsrelated lookup file.

2. If you defined a new dimension for your element point layer and have not yet retransformed your dataset, retransform yourdataset now.

3. Edit theorder.txt file in the Profiles\ profile name\Maps folder to reflect the order in which you want the layers to display.By default, layers appear in lexicographic order by their names.

 Note: When editing the order.txt file, take care not to cover up map layers that you want to show.

For more information about using order.txt files, see the Configuring Interface and Analysis Features chapter of the

Data Workbench User Guide.

4. In data workbench, select the desired profile by right-clicking the workspace title bar and clickingSwitch Profile > < profilename>.

5. Right-click the workspace title bar and click Work Online. An X appears next to Work Online.

6. Open a workspace and on a globe visualization, right-click and select the new layer. An X appears next to the layer name.

Working with Vector Layers

In data workbench, a vector layer displays static vector data (line art) on the globe.

You can use vector layers to display outlines of geographic regions, such as states, countries, islands, or bodies of water.

Defining Vector Layers Referencing Vector Files

You can create a vector layer that references one or more vector (.vec) files, which contains the data that defines the vectorsto be drawn on the globe.

To define a vector layer that references one or more.vec files, you must have the following:

• One or more .vec files that contain the data used to draw the vectors on the globe.

 Note: To obtain .vec files to use with your vector layers, contact Adobe.

• A layer file that specifies the location of the .vec files. For more information about the required format of the layer file, see

Vector Layer File Format .

19Working with Imagery Layers

Page 20: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 20/31

 Note: The Boundaries.layer  file, provided with the Geography  profile, is a vector layer that references the

mwnation.vec , mwstate.vec , mwcoast.vec , mwlake.vec , and mwisland.vec files.

Vector Layer File Format

Each vector layer file referencing.vec files must be formatted using the following template:

Layer = VectorLayer:  Vec Files = vector: n items  0 = string: Maps\\.vec file 1  1 = string: Maps\\.vec file 2  . . .  n-1 = string: Maps\\.vec file n  Color = v3d: color vector  Alpha = double: alpha  Width = double: width  Error Factor = double: error factor

Vector Layer Parameters: .vec Files

DescriptionParameter

Path(s) to the .vec file(s) containing the vector data.Vec Files

The RGB color vector, which is expressed as (red,green,blue). For each color in the vector, you can enter

a value from 0.0 to 1.0. For example, (1.0, 0.0, 0.0) is bright red, and (0.5, 0.5, 0.5) is gray.

Color

Controls the transparency of the vectors shown on the globe. The range is 0 to 1, with 0 being the most

transparent.

Alpha

Optional. Sets the width of the data in pixels. The recommended range is 1 to 4.Width

Controls how accurately the vectors are drawn. For larger values, the vectors are drawn less accurately 

but faster. The default value is 5.

Error Factor

The Boundaries.layer file is formatted as follows: Boundaries.layer file is formatted as follows:Layer = VectorLayer:  Vec Files = vector: 5 items  0 = string: Maps\\mwnation.vec  1 = string: Maps\\mwstate.vec  2 = string: Maps\\mwcoast.vec  3 = string: Maps\\mwlake.vec  4 = string: Maps\\mwisland.vec  Color = v3d: (.5,.5,1)  Alpha = double: .5  Error Factor = double: 4

Vector Layers Referencing Tab Separated Values Files

When creating a vector layer that references a tab separated values (.tsv) file, the vector data is obtained by retrieving drawinginstructions as well as longitude and latitude data from the .tsv file.

To define a vector layer that references a.tsv files, you must have the following:

• A .tsv file that contains the data used to draw the vectors on the globe, including longitude and latitude data. For more

information about the required format of the .tsv file, see Vector TSV File Format .

20Working with Imagery Layers

Page 21: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 21/31

• A layer file that specifies the location of the .tsv file. For more information about the required format of the layer file, see

Vector Layer File Format .

• Vector TSV File Format 

• Vector Layer File Format 

Vector TSV File Format

The .tsv file must contain the following three tab separated columns:

• Begin: This column should indicate whether to begin a new line. Values in this column can be either 0 (do not begin a new 

line) or 1 (begin a new line).

• Longitude: This column should contain longitude values.

• Latitude: This column should contain latitude values.

 Note:  Any additional columns are ignored.

Following is a sample .tsv file that contains data for a vector layer:

Vector Layer File Format

Each vector layer file referencing.tsv files must be formatted using the following template:

Layer = VectorLayer:  TSV Files = vector: n items  0 = string: Maps\\File Name.tsv  1 = string: Maps\\File Name.tsv  . . .  n-1 = string: Maps\\File Name.tsv  Color = v3d: color vector  Alpha = double: alpha  Width = double: width  Error Factor = double: error factor

Vector Layer Parameters: .vec Files

DescriptionParameter

Path(s) to the .tsv file(s) containing the vector data.TSV Files

Example:Maps\\USVectorData.tsv

The RGB color vector, which is expressed as (red,green,blue). For each color in the vector, you can enter

a value from 0.0 to 1.0. For example, (1.0, 0.0, 0.0) is bright red, and (0.5, 0.5, 0.5) is gray.

Color

21Working with Imagery Layers

Page 22: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 22/31

DescriptionParameter

Controls the transparency of the vectors shown on the globe. The range is 0 to 1, with 0 being the most

transparent.

Alpha

Optional. Sets the width of the data in pixels. The recommended range is 1 to 4.Width

Controls how accurately the vectors are drawn. For larger values, the vectors are drawn less accurately but

faster. The default value is 5.

Error Factor

Making a New Vector Layer Available

Steps to make a vector layer available to display on the globe visualization.

1. In the Profiles\ profile name\Maps folder within the data workbench server installation directory, place the layer file and the.vec or .tsv files.

2. Edit theorder.txt file in the Profiles\ profile name\Maps folder to reflect the order in which you want the layers to display.By default, layers appear in lexicographic order by their names.

 Note: When editing the order.txt file, take care not to cover up map layers that you want to show.

For more information about using order.txt files, see the Configuring Interface and Analysis Features chapter of the

Data Workbench User Guide.

3. In data workbench, select the desired profile by right-clicking the workspace title bar and clickingSwitch Profile > < profile

name>.

4. Right-click the workspace title bar and click Work Online. An X appears next to Work Online.

5. Open a workspace and on a globe visualization, right-click and select the new layer. An X appears next to the layer name.

22Working with Imagery Layers

Page 23: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 23/31

Working with Data ServicesGeneral information about data services, including installing and updating files.

About the Data Services

Information about data service options for mapping IP addresses.

If you are using an Adobe application, have licensed data workbenchGeography , and want to map IP addresses on the globe or

create visualizations showing geographically related dimensions of data (for example, area code, time zone, MSA) that are based

on IP address, you can subscribe to one of two optional data services:

• IP Geo-intelligence data service (offered by Adobe, provided by Digital Envoy)

• IP Geo-location data service (offered by Adobe, provided by Quova)

Each data service provides you with a profile containing additional dimensions of data (such as Area Code, MSA, and Time

Zone) and the supporting lookup files that contain the elements of those dimensions. You can use these additional dimensions

in your analysis workspaces in data workbench.

Installing a Data Service on a Data Workbench Server

Information about installing a data service on a data workbench server.

If you are using the IP Geo-intelligence data service or the IP Geo-location data service, you must install either the IP

Geo-intelligence or IP Geo-location profile and the related lookup files on your data workbench server. You must complete

the following procedures after you have installed the data workbenchGeography  profile. See Installing Data Workbench Geography .

If you have not installed data workbench, follow the instructions in the Data Workbench User Guide before proceeding.

 Note: To install the data service files, you must have access to the files on the data workbench server.

Adobe distributes the IP Geo-intelligence and IP Geo-location data services as.zip

 files. Each.zip

 file contains two folders:Lookups and Profiles. To install a data service on the data workbench server, you must perform the following steps:

• Install the data service profile. See Installing the Data Service Profile.

• Install the data service lookups. See Installing the Data Service Lookup Files.

 Note: You must install the data service profile and lookup files on the data workbench server machine on which you are

 processing and running your dataset profile. If you are running a data workbench server cluster, you must install the files

on the master server. For information about dataset profiles, see the Dataset Configuration Guide.

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:

23Working with Data Services

Page 24: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 24/31

• 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.

TheIP 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.

 Note: 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 theIP 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

theIP 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 LookupFiles.

To install the IP Geo-intelligence or IP Geo-location profile

 Note: 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 workbenchGeography . If you

have not done so, see the Data Workbench User Guide.

1. Open the Profiles folder from the .zip file that you received from Adobe.

2. 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 dataworkbench server as shown in the following example. The names of the other folders within theProfiles folder may 

differ from the ones shown.

24Working with Data Services

Page 25: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 25/31

3. Use the following steps to update the profile.cfg file for each profile with which you want to use the IP Geo-intelligenceor IP Geo-location profile.

a. Open the Profile Manager.

b. Right-click the check mark next toprofile.cfg and click Make Local. A check mark for this file appears in the User

column.

c. Right-click the newly created check mark and clickOpen > from the workbench. Theprofile.cfg window appears.

d. In the profile.cfg window, 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 .

e. Type the name of the new directory: IP Geo-intelligence or IP Geo-location.

f. Right-click (modified) at the top of the window and click Save.

g. In the Profile Manager, right-click the check mark forprofile.cfg in the User column, then click Save to > < profile

name>.

 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.

Installing the Data Service Lookup Files

Steps to install the IP Geo-intelligence or IP Geo-location lookup files.

The lookup file (Lookups\ profile name\data file name) provided with the data service profile is a binary file (.bin) that contains

geographically related data based on IP address. You must replace this file periodically to ensure that you have the most recent

geographic data. See Updating Data Service Files.

To install the IP Geo-intelligence or IP Geo-location lookup files

 Note:  All of your IP Geo-location or IP Geo-intelligence data files must fit in the available physical memory of your data

workbench server.

25Working with Data Services

Page 26: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 26/31

1. Open the Lookups folder from the .zip file that you received from Adobe.

2. Copy the IP Geo-intelligence or IP Geo-location folder to the Lookups folder in your data workbench server installationdirectory (you want to end up with a ...\Lookups\IP Geo-intelligence or a ...\Lookups\IP Geo-location folder on your dataworkbench server as shown in the following example. The names of the other folders within the Lookups folder may differfrom the ones shown.

 Note: Periodically, Adobe sends you files containing updated IP Geo-intelligence orIP Geo-location lookup files. When

 you receive these files, you need to load them onto your data workbench server as directed by Adobe. For instructions,

see the following section.

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

• Updating the IPLookup Transformation

• Replacing the Lookup File

• Updating the Layer Files

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 orLookups\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.

26Working with Data Services

Page 27: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 27/31

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 toIP 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 clickOpen > 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 toIP

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>.

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

Updating the Layer Files

 Note: 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.

27Working with Data Services

Page 28: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 28/31

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.

28Working with Data Services

Page 29: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 29/31

Upgrading and Uninstalling Data Workbench GeographyInformation about upgrading and uninstalling your data workbenchGeography  software.

 Note: Be aware that when data workbenchGeography  is upgraded or uninstalled, the dataset automatically reprocesses.

Upgrading Data Workbench Geography

Steps to upgrade the Geography  profile and update the Geography  lookups on your data workbench server.

 Note: If the profile with which you are using data workbenchGeography  is running on a data workbench server cluster,

upgrade the Geography  profile on the master data workbench server in the cluster.

To upgrade the Geography profile on the data workbench server

1. Open the Profiles folder from the new .zip file provided to you by Adobe.

2. Copy the Geography folder to the Profiles folder in your data workbench server installation directory to replace the existing

Geography folder.

To update the Geography lookups on the data workbench server

1. Open the Lookups folder from the new .zip file provided to you by Adobe.

2. Copy the Geography folder to the Lookups folder in your data workbench server installation directory to replace the existing

Geography folder.

Uninstalling Data Workbench Geography

Steps to uninstall data workbenchGeography .

 Note: If the profile with which you are using data workbenchGeography  is running on a data workbench server cluster,

uninstall the Geography  profile from the master data workbench server in the cluster.

1. Use the following steps to update the profile.cfg file for each profile with which you were using dataworkbenchGeography .

1. Open the Profile Manager.

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

column.

3. Right-click the newly created check mark and clickOpen > from the workbench. Theprofile.cfg window appears.

4. In the profile.cfg window, delete the Geography  profile entry from the Directories vector.

5. If you have been using a data service, delete the IP Geo-intelligence orIP Geo-location profile entry from the Directories

 vector.

6. Right-click (modified) at the top of the window and click Save.

7. In the Profile Manager, right-click the check mark forprofile.cfg in the User column, then click Save to > < profilename>.

2. Delete the Geography folder from the Profiles folder in your data workbench server installation directory.

3. If you have been using a data service, delete the IP Geo-intelligence or IP Geo-location folder from the Profiles folder inyour data workbench server installation directory.

29Upgrading and Uninstalling Data Workbench

Geography

Page 30: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 30/31

4. Delete the Geography folder from the Lookups folder in your data workbench server installation directory.

5. If you have been using a data service, delete the IP Geo-intelligence or IP Geo-location folder from the Lookups folder inyour data workbench server installation directory.

6. If you created new terrain images, delete the Terrain Images.cfg file from the Components folder in your dataworkbench server installation directory.

30Upgrading and Uninstalling Data Workbench

Geography

Page 31: Dwb Geography

7/18/2019 Dwb Geography

http://slidepdf.com/reader/full/dwb-geography 31/31

Contact and Legal InformationInformation to help you contact Adobe and to understand the legal issues concerning your use of this product and documentation.

Help & Technical Support

The Adobe Marketing Cloud Customer Care team is here to assist you and provides a number of mechanisms by which they 

can be engaged:• Check the Marketing Cloud help pages for advice, tips, and FAQs

• Ask us a quick question on Twitter @AdobeMktgCare

• Log an incident in our customer portal 

• Contact the Customer Care team directly 

• Check availability and status of Marketing Cloud Solutions

Service, Capability & Billing

Dependent on your solution configuration, some options described in this documentation might not be available to you. As

each account is unique, please refer to your contract for pricing, due dates, terms, and conditions. If you would like to add to

or otherwise change your service level, or if you have questions regarding your current service, please contact your Account

Manager.

Feedback 

We welcome any suggestions or feedback regarding this solution. Enhancement ideas and suggestions for the Analytics suite

can be added to our Customer Idea Exchange.

Legal

© 2013, Adobe

All rights reserved.

Published by Adobe Systems Inc.

Terms of Use | Privacy Center 

A trademark symbol (®,™, etc.) denotes an Adobe trademark.

All third-party trademarks are the property of their respective owners. Updated Information/Additional Third Party Code

Information available at http://www.adobe.com/go/thirdparty .

06052013

31Contact and Legal Information