Upgrading Analytics from 2018 to v10

Upgrade the Analytics subsystem by installing the v10 subsystem.

About this task

You will verify your configuration, create an ISO, and deploy the v10 OVA file into the VM. Due to changes in the v10 Analytics subsystem, you cannot restore your Analytics data from backup. You can configure Analytics settings after the upgrade is complete.

Procedure

  1. Obtain IBM® API Connect <version> Analytics for VMware from Fix Central, as described in Upgrading v2018 subsystems to v10.
  2. Use the v10 version of apicup to map your 2018 configuration settings from apiconnect-up.yml to the v10 configuration file apiconnect-up-v10.yaml: 
    apicup subsys get <subsystem_name>
    Note: If your subsystem name on 2018 was greater than 63 characters, and you did not manually shorten it prior to upgrading, the upgrade shortened it automatically. To view the new subsystem name: 
    apicup subsys list

    For more information, see Automatic shortening of subsystem names with greater than 63 characters

    Complete the following steps:

    1. Review the output from the command.
    2. Specify backup settings for v10. You cannot use the settings from 2018. See Configuring backup settings for Analytics.
    3. If your 2018 deployment included an extra-values-file, you must first convert the format of the file for v10. To review creation of extra-values files for v10, see Creating the analytics-extra-values file.
    4. Update the license value by running the following command: 
      apicup licenses accept <License_ID>

      The <License_ID> is specific to the API Connect program pame that you purchased. To view the supported license IDs, see API Connect licenses.

  3. Create your ISO file in the V2018 project directory that you copied from the old deployment. 
    apicup subsys install analyt --out analytplan-out

    The --out parameter and value are required. In this example, the ISO file is created in the myProject/analytplan-out/node-config directory.

  4. Deploy the file into the VM. See Deploying the Analytics subsystem OVA file
  5. Verify the deployment. See Verifying deployment of the Analytics subsystem
  6. Confirm the restore has completed successfully: 
    apicup subsys health-check <analytics_subsystem_name>

    When no problems are detected, the health-check commands returns silently with a 0 return code.

    If an error is encountered, see Upgrade Limitations.

  7. Configure the Analytics settings as explained in Enabling additional analytics features.
  8. Return to Upgrading v2018 subsystems to v10.