Upgrade Data Studio

The recommended upgrade process consists of three parts:

1. Backing up your current Data Studio repository.
2. Uninstalling the old version.
3. Installing the new one (run the executable as an administrator).

Back up your repository

1. Stop the service:
   • Search for services from the start menu or go to Control Panel > System and Security > Administrative Tools > Services.
   • Locate the Experian Aperture Data Studio Database Server service.
   • Right-click on the service and select Stop.
2. Back up: Copy and save the following files/folders to a separate location:
   • The Aperture Data Studio folder (by default, C:\ApertureDataStudio). This contains all your data, workflows and caches. You can choose to back up individual sub-folders as well:
     • import (if you have any files imported)
     • content (if you're using auto data tagging)
     • drivers (if you're using any custom JDBC drivers)
     • if you have snapshots: copy all the required ones (by default, C:\ApertureDataStudio\data\resource\table\workflow\`{UUID}_{Snapshot Name}`)
     • sampledata folder (if you use sample data or tutorials).
   • Server properties file (by default, C:\Program Files\Experian\Aperture Data Studio {version}\server.properties). This contains all your settings defined in Configuration.
   • Filedatastores properties file (by default, C:\Program Files\Experian\Aperture Data Studio {version}\filedatastores.properties). Back this up if you have set up any data stores, use sample data or tutorials.
   • workflowTriggers.json file (by default, C:\Program Files\Experian\Aperture Data Studio {version}\workflowTriggers.json). Back this up if you have any workflow triggers defined.
   • Virtual Machine Parameters={memory usage} setting, if not using the default JVM setting (by default, C:\Program Files\Experian\Aperture Data Studio {version}\Aperture Data Studio Service 64bit.ini).
   • If you have custom steps:
     • addons folder (by default, C:\Program Files\Experian\Aperture Data Studio {version}\addons)
   • If you are licensed for Experian Batch:
     • License key file (by default, C:\ProgramData\Experian\batchkeys.ini)
     • Qawserve file (by default, C:\ProgramData\Experian\addressValidate\runtime\qawserve.ini)
     • Qaworld file (by default, C:\ProgramData\Experian\addressValidate\runtime\qaworld.ini)

Uninstall the old version

1. Search for remove program from the start menu or go to Control Panel > Programs > Programs and Features.
2. Find Experian Aperture Data Studio.
3. Right-click, select Uninstall, then click Yes.

The uninstaller will delete:

• C:\ProgramData\Experian\addressValidate
• C:\Program Files\Experian\Aperture Data Studio {version} (includes custom steps, server settings, custom drivers, etc.)

The uninstaller will not touch:

• C:\ProgramData\Experian (licenses for Data Studio and Experian Batch, might also contain other Experian files).
• C:\ApertureDataStudio (contains workflows, users, import folders, etc.)

Install the new version

1. Stop the service, and replace the mandatory files noted above. Restart the service.

   Note that it's not necessary to replace the repository itself if you are using it in the default location.

2. (optional) If your server had been configured to use a repository in a non-standard location:

   • Stop the service
   • Delete the newly created C:\ApertureDataStudio
   • Replace your backed-up repository and server.properties file in their old locations
   • Restart the service

3. Install the new version as usual. Get the latest Data Studio version.

   If you're using a remote instance of the Find duplicates server, you may have to upgrade it as well. Firstly, check the release notes that the version of the server you're running is the latest. If not, install the latest Find duplicates server.

Clean install

If you want to install a new version on a machine that has/had Data Studio installed:

1. Uninstall any remaining instances of Data Studio.
2. Manually delete C:\ProgramData\Experian and C:\ApertureDataStudio.

   Note that this will remove your existing license.

3. Install a new version as usual.