Prepare
1. Capture a snapshot
1. Back up MariaDB
1. Back up user and group data
1. Uninstall Nuix services (v9.10.x only)

Prepare

Perform the following steps to prepare your existing installation for upgrade.

Capture a snapshot

In your existing installation, ensure that a recent snapshot exists of your current configurations.

To capture a snapshot:

Select the Admin tab, then click Snapshots.

Verify that a recent snapshot exists under Saved Snapshots.

If there are no saved snapshots, click Create Snapshot to preserve your current configurations.

Back up MariaDB

Nuix recommends creating a backup of the MariaDB databases used by Nuix Investigate prior to performing any upgrade.

Use the following procedure to create a backup of your MariaDB databases.

Note: In a multi-node setup, if new SQL users were created with appropriate grants/privileges for remote connections, this backup will not capture those users.

Ensure that the MariaDB service is running.

From a terminal on the computer where MariaDB is installed, enter the following to create the backup:

<InstallDir>/Nuix-MariaDb/bin/mysqldump --databases ums wr --add-drop-database -r <PathToSave>/backup-file.sql --default-character-set=utf8mb4 -u<user> -p

Note: <user> is the MariaDB user that was specified when installing Nuix Investigate that has access with required privileges to both the UMS and WR databases. By default, this value is set to root, unless changed during installation.

Note: For additional information about mysqldump, visit https://mariadb.com/kb/en/mysqldump/.

Back up user and group data

To preserve the settings of existing manually created users after the upgrade, create a backup of the following data directories within your existing installation.

Group data

C:\Program Files\Nuix\Web Platform\Nuix-UMS\groupConfig

User data

C:\Program Files\Nuix\Web Platform\Nuix-UMS\users

Uninstall Nuix services (v9.10.x only)

If upgrading from Nuix Investigate v9.10.x, all Nuix services, except for the Nuix MariaDB service, must be uninstalled before proceeding.

Use the application removal services provided by your OS to remove the following Nuix services.

Important: Do not remove the Nuix MariaDB service at this time. Data from the MariaDB instance will be migrated after the upgrade is complete.

Nuix Configuration Utility

Nuix Gateway

Nuix Investigate Service

Nuix Registration

Nuix UMS Service

‎