Follow these steps to upgrade to Data Workbench v6.3.
Upgrade Requirements and Recommendations
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
- Update the
Meta.cfg file (E:\..\<your custom
profile>\Context\meta.cfg)to set updated password encryption for
the FSU server.
- Open the
- Change the data type
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.
18 = SourceListServer:
URI = string: /SourceListServer/
Listing Interval = int: 10 (new)
- Disk Files.cfg
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
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
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
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
0 = DelimitedDecoder:
Delimiter = string: \t
Fields = vector: x items
5 = string:
5 = string: x-hit_source
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
- Once your server has been
updated, your client can update automatically if the
Insight.cfg file is configured properly:
- Edit the
Update Software = bool: true
Exit and launch the client.
Connect to the profile.
The client will automatically upgrade to Data Workbench 6.3.
- Exit out of the
Proxy Password = string:
Proxy Password = EncryptedString:
Remove the value of the previous Proxy Address and Proxy
- Launch the client.
- 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.
- Connect to the
- 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:
- MS Gothic
- MS Mincho
Note: SimSun can be used for Chinese and Japanese. If
attempting to write in half-byte characters in Japanese, you also need to
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
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.