Upgrading Insight to version 7.3.12 or later - Linux

Prior to upgrading from OnCommand Insight 7.3.5 - 7.3.11 to version 7.3.12 or later, you must run the OCI Data Migration Tool.

Background

OnCommand Insight version 7.3.12 utilizes underlying software that may be incompatible with previous versions. Insight version 7.3.12 includes a Data Migration Tool to assist with upgrading.

Note: OnCommand Insight versions 7.3.4 and earlier are no longer supported. If you are running one of these versions, you must upgrade to Insight version 7.3.5 or later (7.3.11 is strongly recommended) prior to upgrading to 7.3.12.

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.

Note: 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

  1. 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.
  2. Open a command window and navigate to your working folder.
    • Bash shell is recommended.
  3. Run the data migration tool using the following command:
    • sudo ./SANScreenDataMigrationTool.sh
  4. 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.

Note: In some Linux OnCommand Insight installations, the Elasticsearch REST port might not be running on the default 9200 port. in this case use the --port option to supply the value

-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 *