Updating the Backend

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

Updating the Analytics components to a new version is quite easy.

If you are upgrading from ONE Automation from v12.0 to v12.1 and would like to install the Streaming Platform and the Event Engine refer to the manual installation guide for each individual component. After consider upgrading the existing Backend (i.e. what parts of the configuration need to be added)

To update an existing installation

  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.jarfrom the download package.
    • Copy to the webui-plugin-analytics.jarAWI_ROOT_FOLDER/WEBINF/autoinstall

    • 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.