Data Workbench 6.0 to 6.1 Upgrade

IMPORTANT

Read more about Data Workbench’s End-of-life announcement.

Follow these steps to update to data workbench v6.1 from your data workbench v6.0x installation.

Step 1: Server upgrade

Step 2: Report Server upgrade

Step 3: Client upgrade

IMPORTANT

The server, report server, and client components are upgraded to run on 64-bit Windows operating systems.

Server Upgrade

Follow these steps to update the Server v6.1 components:

Using the Software and Docs profile, open the Start Here workspace and download all needed server packages to a local folder.
- Download Server Packages \ v6.1 zip folders and extract all files.
  
  The Server package includes Lookup and Profile folders with Base and Transform profiles to update the server.
  - Download the Profiles folders.
  - Download the Lookup folders.
  - Download the Report Server \ v6.1 package.
  - Download additional Sensor, Documentation, and Dashboard files as needed for your system.
Stop the Adobe Insight Server service.
From the downloaded Server package:
1. Replace the Server\Bin folder to update the InsightServer64.exe and supporting files.
2. Replace the Server\Profiles folder. You can overwrite all files.
3. Update the Server\Lookups folder. You will want to add the newly downloaded files to the custom files already located in the folder.
4. Replace the Server\Software folder to update Insight.exe and ReportServer.exe
5. Update the Server\Scripts folder to update TnTSend.exe.
If you employ DeviceAtlas, then you will need to update the bundle located in the Server\Lookups folder.
Configure the Profile.cfg file to ensure that the vector is updated to reflect the number of items for each profile.

For example, to enable the Predictive Analytics profile you will need to update this setting.
```
Directories = vector: 5 items
    0 = string: Base\\
    1 = string: Geography\\
    2 = string: Predictive Analytics\\
    3 = string: Adobe SC\\
    4 = string: Profile Name\\
```
Configure and save the PAServer.cfg file for the Predictive Analytics feature.

If you want to submit Predictive Analytics jobs to the servers, then you will need to configure the Server > Predictive Analytics > Dataset > PAServer.cfg file to manage server-side clustering submissions.

The custom profile should inherit the settings from the Predictive Analytics configuration profile, allowing you to configure and save the PAServer.cfg file based on your site’s implementation.
Define the Log Source ID.

The Recording of Rows per Log Source was added in v6.04 and defined in the custom profile’s Log Processing.cfg file by adding a uniquely named Log Source ID.
```
Log Processing.cfg
Log Source ID = string: <Name your ID Here>
```
If you do not have the Log Source ID defined, then you will get the following error:
```
Missing Log Source ID in log processing.cfg.
Log Source ID must be defined for all log sources.
```
Because the EventMessages.dll has been updated, it is required that you unregister and then register the Adobe Insight Server across the cluster.
- InsightServer64.exe /unregserver
- InsightServer64.exe /regserver
Start the Adobe Insight Server service across the cluster.

The server installation is now complete.

Report Server Upgrade

IMPORTANT

Before upgrading to Report Server v6.1, you must first upgrade to Server v6.1.

Using the Software and Docs profile, download v6.1 from the Report Server package to a local folder.
Copy Report Server 6.1 from the downloaded package and replace the profile packages.

NOTE

The Insight.zbin file in the install folder is a backup file used for localization, and must be present in the install directory. This file or other .zbin files will be used depending on the command-line settings passed when starting up.
(optional) Data workbench currently supports English (-en-us) and Chinese (-zh-cn). You need to set a font to support single and double-byte characters:
```
Report Server.cfg - Add Fonts
   Fonts = vector: 2 items
   0 = string: SimSun
   1 = string: Arial
```
The Windows operating system must also have the listed fonts installed.
Configure Report Server v6.1 for localization.
1. Stop the Adobe Insight Report Server service.
2. Launch a command prompt as an “Administrator”.
3. Navigate to the Report Server install folder.
4. Delete the Report Server service using the following command:
```
ReportServer.exe /unregserver
```
5. Start the service based on language settings:
```
ReportServer.exe -RegServer -Locale -en-us (English)
ReportServer.exe -RegServer -Locale -zh-cn (Simplified Chinese)
```
To verify that Report Server is running with the correct settings, open up Windows Service Manager and right-click Adobe Insight Report Server - Properties. The path to the executable will display the updated command-line settings.

The report server installation is now complete.

Client Upgrade

IMPORTANT

Before upgrading to Client v6.1, the administrator must first upgrade to Insight Server v6.1.

Launch Insight.exe but do not connect to any profiles.
Edit the Insight.cfg file.
```
Update Software = bool: true
```
Connect to your profile.

Allow the client to synchronize with the server and your client will be upgraded with the latest v6.1client profiles, executables, and configuration files.

NOTE

The Insight.zbin file in the install folder is a backup file used for localization and must be present. This file or other .zbin files will be used depending on the command-line settings passed when starting up.

See setting up localized languages to add an insight.zbin file required for localized settings.

Additional Client Settings

Before configuring Insight.exe and supporting files, you must exit the client application.

To install Simplified Chinese:

Create a shortcut that passes in the command-line setting to the Insight.exe file.
```
Insight.exe -zh-cn
```
Configure Insight.cfg to support single and double-byte font characters.

Data workbench currently supports both English and Simplified Chinese. You can select fonts to support both of these languages:
```
Fonts = vector: 2 items
0 = string: SimSun
1 = string: Arial
```
The Windows operating system must also have the requested fonts installed.
Launch the shortcut that you created to synchronize profiles and the updated . zbin file.

To employ the Input Method Editor (IME).

IME allows you to input international characters.

Update the Insight.cfg file with these settings:
```
Localized IME = bool: true
```
Launch the shortcut that you created to synchronize profiles and the updated .zbin file.

The client installation is now complete.