Upgrading Analytics

Important! This step is only necessary if you are upgrading CDA from v12.0 and higher.

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.

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.

See also: