Release Notes
Upgrading Insight to version 7.3.12 or later - Linux
Suggest changes
PDFs
Prior to upgrading from OnCommand Insight 7.3.10 - 7.3.11 to version 7.3.12 or later, you must run the OCI Data Migration Tool.
Background
OnCommand Insight versions 7.3.12 and later utilize underlying software that may be incompatible with previous versions. Insight versions 7.3.12 and later include a Data Migration Tool to assist with upgrading.
|
OnCommand Insight versions 7.3.9 and earlier are no longer supported. If you are running one of these versions, you must upgrade to Insight version 7.3.10 or later (7.3.11 is strongly recommended) prior to upgrading to 7.3.12 or later. |
What Does The Data Migration Tool Do?
The migration tool performs an initial compatibility check and then follows one of three different upgrade paths. The path selected is based on the data compatibility of your current version.
|
|
Prior to upgrading, you must run the Data Migration Tool and follow the recommended steps. |
Before you Begin
-
It is strongly recommended to back up your OnCommand Insight system prior to running the Data Migration Tool.
-
The Elasticsearch service on the server needs to be up and running.
-
The Data Migration Tool must be run for the database and any performance archives before you upgrade Insight.
Running the Data Migration Tool
-
Download the latest version of the Data Migration Tool (for example, SANScreenDataMigrationTool-x86-7.3.12-97.zip) to your Insight server, as well as the appropriate Insight installer file. Unzip into a working folder. Downloads can be found on the NetApp Support Site.
-
Open a command window and navigate to your working folder.
-
Bash shell is recommended.
-
-
Run the data migration tool using the following command:
-
`sudo ./SANScreenDataMigrationTool.sh`
-
-
Follow the instructions as needed. The following is an example.
sudo ./SanscreenDataMigrationTool.sh
NetApp SANScreen Data Migration Tool 7.3.12-132
OCI 7.3.10.8.139 is installed
Elasticsearch REST port = 9200
Checking Elasticsearch service...
Elasticsearch service is up
Checking for obsolete (version 5) indexes...
Found 54 obsolete indexes. Of these,
54 indexes may be migrated with OCI server running,
the most recent of which is for 2021-05-13
Verifying migration component is present...
SANscreen Server service is Running
Proceed with online migration of 54 indexes (y or [n])?:
The Data Migration Tool will check for the presence of obsolete indexes on your system and report if any are found. If none are present the tool will exit.
Some indexes may be migrated while the SANscreen Server service is running. Others may only be migrated when the server is stopped. If there are no indexes that may be migrated the tool will exit. Otherwise follow the instructions as prompted.
After the Data Migration Tool completes it will recheck for obsolete indexes. If all indexes have been migrated, the tool will inform you that upgrade to OnCommand Insight 7.3.12 is supported. You can now proceed with upgrading Insight.
sudo ./SanscreenDataMigrationTool.sh NetApp SANScreen Data Migration Tool 7.3.12-132 OCI 7.3.10.8.139 is installed Elasticsearch REST port = 9200 Checking for obsolete (version 5) indexes... Found 76 obsolete OCI indexes. Of these, 76 indexes may be migrated with OCI server running SANscreen Server service is running Proceed with online migration of 76 indexes (y or [n])? y If you supply performance archive location, entries for any dates with migrated indexes will be replaced. Each orginal entry will be renamed and you may delete it after migration is completed. When prompted enter the archive location including the site-name directory. Enter the location of the performance archive or blank if none: Performance archive entries will not be updated Running the migration application with options -u http://localhost:9200 --online -sa - Preparing to migrate oci-timeseries-disk-2021-03-22: copied; backup; delete old; restore new; cleanup; done. Preparing to migrate oci-timeseries-internalvolume-2021-03-22: copied; backup; delete old; restore new; cleanup; done. Preparing to migrate oci-timeseries-port-2021-03-22: copied; backup; delete old; restore new; cleanup; done. ... Preparing to migrate oci-timeseries-disk-2021-03-27: copied; backup; delete old; restore new; cleanup; done. Execution time 0:08:17 Checking for obsolete (version 5) indexes... No obsolete indexes found. Upgrade and Inline Upgrade to 7.3.12+ are supported
If you were prompted to stop the SANScreen service, restart it before upgrading Insight.
Validation failures
In the event that index validation fails, the migration tool will inform you of the problem before quitting.
OnCommand Insight is not present:
./SanscreenDataMigrationTool.sh NetApp SANScreen Data Migration Tool V1.0 Checking OnCommand Insight Installation... ERROR: OnCommand Insight is not installed
Invalid Insight version:
./SanscreenDataMigrationTool.sh NetApp SANScreen Data Migration Tool 7.3.12-105 Checking OnCommand Insight Installation... OnCommand Insight 7.3.4 (126) is installed ERROR: The OCI Data Migration Tool is intended to be run against OCI 7.3.5 - 7.3.11
Elasticsearch service is not running:
./SanscreenDataMigrationTool.sh NetApp SANScreen Data Migration Tool 7.3.12-105 Checking OnCommand Insight Installation... OnCommand Insight 7.3.11 (126) is installed Getting installation parameters... Elasticsearch Rest Port: 9200 Checking Elasticsearch service... ERROR: The Elasticsearch service is not running Please start the service and wait for initialization to complete Then rerun OCI Data Migration Tool
Command-line options
The Data Migration Tool includes some optional parameters that affect its operation.
Option (Linux) |
Function |
||
-s | --silent |
Suppress all prompts |
||
-a | --archive |
If specified, existing archive entries for any date whose index(es) are migrated will be replaced. The path should point to the directory containing the archive entry zip files. An argument of '-' may be specified to indicate there is no performance archive to be updated. If this argument is present, the prompt for the archive location will be suppressed. |
||
-c | --check |
If present, the script will exit immediately after reporting the index counts. |
||
-d | --dryrun |
If present, then the migration executable will report the actions that would be taken (to migrate data and update archive entries) but will not perform the operations. |
||
-p | --port |
If present, use the supplied value as Elasticsearch's REST port. If absent, obtain the value from the installation if possible; otherwise use the default value of 9200.
|
||
-h | --help |
Display usage information |
Troubleshooting
If archive entries were updated, you must make sure that the ownership and permissions on the updated archives are correct. They should be ocisys ocisys 644. If they are not, navigate into the performance archive folder and run the following commands:
chown ocisys * chgrp ocisys * chmod 644 *