Note: A similar, but arguably better, script can be found in the Bulk Case Migration repository. In time this script will likely be archived in favor of that one.

View the GitHub project here or download the latest release here.

Written By: Jason Wells

This script migrates a list of Nuix cases to the version of Nuix running the script (as necessary). This script is the automated equivalent of opening each case one by one in Nuix Workstation (the GUI) and allowing Nuix to migrate a case whenever it prompted you to do so.

The script opens each case via the API, giving Nuix permission to migrate the case as necessary. This is done by providing a value of true for the setting migrate when opening the case via CaseFactory.open:

migrate: If the case requires migration and this parameter is set to true, migrates the case if required, otherwise an exception occurs and the script will terminate. Migration occurs silently in the console.

Begin by downloading the latest release of this code. Extract the contents of the archive into your Nuix scripts directory. In Windows the script directory is likely going to be either of the following:

• %appdata%\Nuix\Scripts - User level script directory
• %programdata%\Nuix\Scripts - System level script directory

When ran, the script will prompt you to make some choices:

• You will be prompted whether or not to make backups
  • If you decide to make backups, you will be prompted for the directory to store the backups
• You will be prompted about how you would like to specify the cases to migrate
  • If you choose "Locate Cases in Directory", you will be prompted to select a root search directory, all cases found will be used
  • If you choose "Provide Text File with Case Paths", you will be prompted to select a text file with one case directory per line

While running, this script will produce 2 files in the same directory as the script.

• {TIMESTAMP}_Log.txt : This will containg a log of all output that is shown in the console
• {TIMESTAMP}_Report.csv : This will contain a listing of cases which succeeded and failed, with error messages for the failures

Output written to log file is also written to script console.

Copyright 2020 Nuix

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.