The Address File Installed on Insight Server

The address file installed on Insight Server contains four pre-defined network locations.

The procedure in the next section describes how to configure this file.

Locations = vector: 4 items 
  0 = NetworkLocation: 
    Addresses = vector: 1 items
      0 = AddressDefinition: 
        Address = string: 
        Name = string: 
    Name = string: 
    Parent = string: 
  1 = NetworkLocation: 
    Addresses = vector: 0 items
    Name = string: Insight
    Parent = string: 
  2 = NetworkLocation: 
    Addresses = vector: 0 items
    Name = string: Insight Server
    Parent = string:
  3 = NetworkLocation: 
    Addresses = vector: 0 items
    Name = string: Report Server
    Parent = string:
  • NetworkLocation 0 is an empty, unnamed network location that you edit to associate the common name of your Insight Server to its IP address. If the server has multiple IP addresses, you create additional NetworkLocations.
  • NetworkLocation 1 is the Insight network location. If you do not explicitly set the NetworkLocation parameter, Insight resolves common names through this network location.
  • NetworkLocation 2 is the Insight Server network location. When Insight Servers operate in a cluster, they use this network location to resolve common names for inter-server communication.
  • NetworkLocation 3 is the Report Server network location. If you do not explicitly set the NetworkLocation parameter, Report resolves common names through this network location.

To Configure the Address File

The following procedure describes how to configure the address file to define a network location (or network locations) for your Insight Server.

  1. Navigate to the Addresses folder in the directory where you installed Insight Server (for example, C:\Adobe\Server\Addresses).
  2. Locate the server.address file and rename this file to reflect the server’s common name. For example, if the common name were server.mycompany.com, you would rename the file server.mycompany.com.address.
  3. Open the renamed file in a text editor such as Notepad.
  4. Edit NetworkLocation 0 to specify the common name and IP address of the Insight Server as shown below. If your server has multiple IP addresses, use NetworkLocation 0 to specify the server’s IP address on the local, non-routable network (for example, its location on the internal network).
    Locations = vector: 3 items
    0 = NetworkLocation:
      Addresses = vector: 1 items
        0 = AddressDefinition:
          Address = string: IPAddress
          Name = string: CommonName
      Name = string: NetworkLocationName
      Parent = string:
    
    For this value... Specify
    IP Address

    The numeric IP address of the Insight Server machine.

    Example: 192.168.124.176

    Common Name

    The common name assigned to the digital certificate for Insight Server.

    Example: server.mycompany.com

    Note: Be sure to type this name exactly as it appears on the certificate.

    Network Location Name

    The name you want to assign to the collection of common names and IP addresses that this NetworkLocation represents. The name must be unique within the address file.

    Example: Corporate Intranet

  5. If your Insight Server has additional IP addresses, create an additional NetworkLocation for each address. (An easy way to do this is to make a copy of the NetworkLocation you created above and update the IP address in the copy.)

    You can add the new NetworkLocation to the end of the address file or insert it between existing NetworkLocation definitions. (The position of a NetworkLocation within the address file is not significant; however, the Insight, Insight Server, and Report Server NetworkLocations are typically placed at the end of the file.)

    After you have added the necessary NetworkLocations, do the following to renumber the items in the file:
    1. Update the item count for the Locations structure to match the total number of NetworkLocation definitions in the file. For example, if your file contains four NetworkLocation definitions, the Locations line would look as follows:

      Locations = vector: 4 items
    2. Update the NetworkLocation item numbers so that NetworkLocations are numbered consecutively (starting from 0).

    For an example of an address file that defines an Insight Server with two IP addresses, see the example in this section.

  6. In the Insight and Report Server network locations, edit the Parent parameter as shown below to specify the name of the NetworkLocation that Insight and Report use as their default network locations. (For an example of what the Parent parameter looks like when it is configured, see the example in this section.)
    1 = NetworkLocation: 
      Addresses = vector: 0 items
      Name = string: Insight
      Parent = string: ClientDefaultNetworkLocation
    
    3 = NetworkLocation: 
      Addresses = vector: 0 items
      Name = string: Report Server
      Parent = string: ClientDefaultNetworkLocation

    If your Insight Server has a single IP address and, therefore, has only one NetworkLocation, point the Parent parameter to that NetworkLocation. If your Insight Server has multiple IP addresses, point the Parent parameter to the NetworkLocation that defines the address to which your Insight and Report clients connect most frequently.

  7. In the Insight Server network location, edit the Parent parameter as shown below to point to the NetworkLocation that the server uses to resolve common names of other Insight Servers when it operates in a cluster. (Although this network location is not used unless an Insight Server operates in a cluster, it is a good practice, even in a single server configuration, to point the Parent parameter to a network location that identifies the server’s internal IP address.)
    2 = NetworkLocation: 
      Addresses = vector: 0 items
      Name = string: Insight Server
      Parent = string: ServerDefaultNetworkLocation
The following example shows a completed address file. This file defines five network locations.
  • NetworkLocation items 0 and 1 define network locations named “MyCorporateIntranet” and “Internet.” These network locations define two different IP addresses for a server named VS01.myCompany.com.
  • NetworkLocation item 2 is the Insight network location. This is the default network location used by Insight. In this example, the Insight network location inherits its AddressDefinitions from the “Internet” NetworkLocation.
  • NetworkLocation item 3 is the Insight Server network location. This is the default network location Insight Server uses when it communicates with other servers in a cluster. In this example, the Insight Server network location inherits its AddressDefinitions from the “MyCorporate Intranet” NetworkLocation.
  • NetworkLocation item 4 is the Report Server network location. This is the default network location used by Report. In this example, the Report Server network location inherits its AddressDefinitions from the “Internet” NetworkLocation.
    Locations = vector: 5 items
      0 = NetworkLocation: 
        Addresses = vector: 1 items
          0 = AddressDefinition: 
            Address = string: 10.2.1.70
            Name = string: VS01.myCompany.com
        Name = string: MyCorporateIntranet
        Parent = string: 
    
      1 = NetworkLocation: 
        Addresses = vector: 1 items
          0 = AddressDefinition: 
            Address = string: 65.196.125.167
            Name = string: VS01.myCompany.com
        Name = string: Internet
        Parent = string:
    
      2 = NetworkLocation: 
        Addresses = vector: 0 items
        Name = string: Insight
        Parent = string: Internet
    
      3 = NetworkLocation: 
        Addresses = vector: 0 items
        Name = string: Insight Server
        Parent = string: MyCorporateIntranet
    
      4 = NetworkLocation: 
        Addresses = vector: 0 items
        Name = string: Report Server
        Parent = string: Internet