Upgrading the Backend

This section guides you through the steps required to update your Analytics installation.

This page includes the following:

Note: If you are upgrading from CA Automic ONE Automation from v12.0 to v12.1 and would like to install the Streaming Platform and the Event Engine, see the manual installation document for each individual component. After consider upgrading the existing Backend (i.e. what parts of the configuration must be added)

To Update an Existing Installation from 2.1.0 to 2.2.0

  1. Read the release notes and check if the properties files require any change.
  2. Update the Analytics Backend:
    1. Stop the Backend
    2. Upgrade the AE
    3. Replace the 2.1.0 Analytics Backend jar file with the 2.2.0 jar file

    4. Start the IA Agent

      • Analytics Backend will start up and run as part of the IA Agent
      • Analytics Datastore is migrated to the new schema (CAUTION: this can take some time)
      • Agent will establish the connection to the AE mentioned in the INI file
    5. Upgrade AWI
    6. Install new Analytics UI Plug-in (and Rules UI Plug-in if needed
      • Extract the webui-plugin-analytics.jar from the download package.
      • Copy to the webui-plugin-analytics.jar AWI_ROOT_FOLDER/WEBINF/autoinstall

    Important!

    • The existing webui-plugin-analytics.jar file must be removed before copying the new one.
    • If required, update the configuration in AWI_ROOT_FOLDER/config/awi-plugins-reporting/reporting.properties.

To Update an Existing Installation from 2.0.0 to 2.2.0

  1. Read the release notes and check if the properties files require any change.
  2. Update the Analytics Backend:
    1. Stop the Backend
    2. Upgrade the AE
    3. Replace the 2.0.0 Analytics Backend jar file with the 2.2.0 jar file

    4. Start the IA Agent

      • Analytics Backend will start up and run as part of the IA Agent
      • Analytics Datastore is migrated to the new schema (CAUTION: this can take some time)
      • Agent will establish the connection to the AE mentioned in the INI file
    5. Upgrade AWI
    6. Install new Analytics UI Plug-in (and Rules UI Plug-in if needed
      • Extract the webui-plugin-analytics.jar from the download package.
      • Copy to the webui-plugin-analytics.jar AWI_ROOT_FOLDER/WEBINF/autoinstall

    Important!

    • The existing webui-plugin-analytics.jar file must be removed before copying the new one.
    • If required, update the configuration in AWI_ROOT_FOLDER/config/awi-plugins-reporting/reporting.properties.

To Update an Existing Installation from 1.0.2 to 2.0.0

  1. Read the release notes and check if the properties files require any change.
  2. Update the Analytics Backend:
    1. Stop the Backend
    2. Upgrade the AE
    3. Replace the 1.0.2 Analytics Backend jar file with the 2.0.0 jar file

    4. Update the application.properties file

      • it is recommended to use the new applcation.properties.sample file shipped with ANOP 2.0.0 and manually adapt it.
      • collectors.enabled=true - needs to be configured to have the data collection enabled.
      • migrate collector settings to the new format which allow individual settings per collector (collector.<name of the collector>.<setting> instead of global collector.<setting>).

    5. Add and adapt the ucxeddaini file to configure the AE connection

      • name - name of the agent
      • cp - communication process used to connect

    6. Add the uc.msl file

    7. Start the IA Agent

      • Analytics Backend will start up and run as part of the IA Agent
      • Analytics Datastore is migrated to the new schema (CAUTION: this can take some time)
      • Agent will establish the connection to the AE mentioned in the INI file
    8. Upgrade AWI
    9. Install new Analytics UI Plug-in (and Rules UI Plug-in if needed
      • Extract the webui-plugin-analytics.jar from the download package.
      • Copy to the webui-plugin-analytics.jar AWI_ROOT_FOLDER/WEBINF/autoinstall

    Important!

    • The existing webui-plugin-analytics.jar file must be removed before copying the new one.
    • If required, update the configuration in AWI_ROOT_FOLDER/config/awi-plugins-reporting/reporting.properties.