Upgrading 6.2 to 6.3

Follow these steps to upgrade to Data Workbench v6.3.

Upgrade Requirements and Recommendations

Upgrade Server:
Note: If you have customized profiles that take precedence over the default files provided in the Base package, then you will need to update these customized files:
  • Update the Meta.cfg file (E:\..\<your custom profile>\Context\meta.cfg)to set updated password encryption for the FSU server.
    1. Open the meta.cfg file.
    2. Change the data type for Proxy Password from "string" to "EncryptedString" in the Workstation Configuration section.
      Proxy User Name = string:
      Proxy Password = EncryptedString:   (from Proxy Password = String)
      Use Address File = bool: true
  • Update configuration files to take advantage of Fast Merge improvements during a transformation phase.
    • Communications.cfg (E:\Server\Components\Communications.cfg)
      18 = SourceListServer: 
          URI = string: /SourceListServer/
          Listing Interval = int: 10 (new)
    • Disk Files.cfg (at E:\Server\Components and E:\Server\Components for Processing Servers)
      Disk Cache Size (MB) = double: 1024 (from double: 256)
      Disk Cache Read Limit (MB) = double: 768 (new)
    • Log Processing Mode.cfg (E:\Server\Profiles\<your profile>\Dataset\Log Processing Mode.cfg)
      Batch Bytes = int: 268435456
      Cloud Bytes = int: 268435456
      Real Time FIFO Bytes = int: 268435456
      Cache Bytes = int: 32000000
      Fast Input Decision Ratio = double: 200
      Fast Input FIFO Bytes = int: 268435456
      FIFO Hash Mask = int: 16383
      Fast Merge Buffer Bytes = int: 536870912
      Slow Merge Buffer Bytes = int: 268435456
      Fast Merge Fan In = int: 64
      Key Cache Size Logarithm = int: 21
      Max Seeks = int: 512
      Output Old Buffer Bytes = int: 536870912
      Overflow FIFO Bytes = int: 67108864
      Paused = bool: false
    Note: To take advantage of the Fast Merge improvements, make sure you have at least 8 GBs of RAM per DPU.
  • A new export file, ExportIntegration.exe, replaces the existing TnTSend.exe file on the Insight Server (E:\Server\Scripts\TnTSend.exe). This new export file supports both Adobe Target integration and coordination with the new Master Marketing Profile (MMP) and Adobe Audience Manager.

    You will need to update the following commands for TnT exports.

    Command = string: TnTSend.exe


    Command = string: ExportIntegration.exe

  • In the Adobe SC profile, changes to the Exclude Hit.cfg file require a field to be declared in the associated Decoding Instructions.cfg file.

    Note: If your Adobe SC profile includes a customized Decoding Instructions.cfg file, you will need to include a DelimitedDecoder argument to your customized file.
    0 = DelimitedDecoder:
       Delimiter = string: \t
       Fields = vector: x items
          5 = string:
    Changed to:
          5 = string: x-hit_source

    Adding the DelimitedDecoder field allows you to take advantage of feature updates and to avoid possible Log Processing problems resulting from these updates.

  • To run Best Fit Attribution with in Data Workbench, you need to update your server certificate (.pem file) to support Adobe Analytics Premium. The new certificate will have this entry:
    Product = Premium
Upgrade Client:
  • Once your server has been updated, your client can update automatically if the Insight.cfg file is configured properly:
    1. Edit the Insight.cfg file.
      Update Software = bool: true

      Then Save.

    2. Exit and launch the client.

    3. Connect to the profile.

      The client will automatically upgrade to Data Workbench 6.3.

    4. Exit out of the client.
    5. Edit Insight.cfg

      • Change Proxy Password = string:

        to Proxy Password = EncryptedString:

        Remove the value of the previous Proxy Address and Proxy Password.

      • Save.
    6. Launch the client.
    7. Edit Insight.cfg.
      • Enter Proxy Password for all the servers and Save.
      • Enter the Proxy Address for all the servers and Save.
        Important: The Proxy Address and Proxy Password must be entered and saved from within the client.
    8. Connect to the profile.
    • Follow the exact upgrade sequence in order to avoid an account lockout. If the account is locked, please perform all the required changes in the exact sequence listed, save your work, and exit out of the client. Wait for the lockout to release (about 45 minutes), then launch the client again.
    • The password modification should be performed in the client only due to the fact that the passwords are saved in Windows Credential Vault.
  • Recommendation: New Windows Aero Themes.

    Upgrade the look of your client application using any of the many Windows Aero Themes.

  • Recommendation: Fonts for Chinese and Japanese versions:


    • Arial
    • SimSun


    • MS Gothic
    • Meiryo
    • MS Mincho
    • Arial
    • SimSun
    Note: SimSun can be used for Chinese and Japanese. If attempting to write in half-byte characters in Japanese, you also need to include MS Mincho. To enable these fonts in Insight.cfg, you can add these parameters.
    0 = string: Arial
    1 = string: SimSun
    2 = string: MS Mincho

    These fonts should be listed in the workstation configuration file: Insight.cfg.

Upgrade Report Server
  • To run Best Fit Attribution with Report Server in Data Workbench, you need to update your Report Server certificate (.pem file) to support Adobe Analytics Premium. The new certificate will have this entry:
    Product = Premium
Upgrade to Adobe Analytics Premium
  • If using Best Fit Attribution, you will need to add Premium to your custom Profile.cfg for the client and receive new certificates from Adobe ClientCare for Server and Report Server.