Skip Headers
Oracle® Fusion Middleware Oracle WebCenter Analytics Installation and Upgrade Guide (for Oracle WebCenter Interaction)
10g Release 3 (10.3.0.1)

Part Number E14438-03
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

4 Upgrade

This chapter includes information on how to upgrade Oracle WebCenter Analytics. It includes the following sections:

Upgrade Paths

The following table summarizes the supported database upgrade paths for Oracle WebCenter Analytics.

Table 4-1 Upgrade Paths

Upgrade Path Upgrade References

Oracle WebCenter Analytics 10.3 to Oracle WebCenter Analytics 10.3.0.1

Follow the procedures in Upgrading from Oracle WebCenter Analytics 10.3 to Oracle WebCenter Analytics 10.3.0.1.

AquaLogic Analytics 2.5 to Oracle WebCenter Analytics 10.3.0.1

Follow the procedures in Upgrading from AquaLogic Analytics 2.5 to Oracle WebCenter Analytics 10.3.0.1.

AquaLogic Analytics 2.1 to Oracle WebCenter Analytics 10.3.0.1

Follow the procedures in Upgrading from AquaLogic Analytics 2.1 to Oracle WebCenter Analytics 10.3.0.1.


Note:

We do not support upgrades from AquaLogic Analytics 1.x or 2.0 to Oracle WebCenter Analytics 10.3.0.1. To do so, you must first upgrade AquaLogic Analytics 1.0/1.1/2.0 to either 2.1 or 2.5, then perform the appropriate upgrade to Oracle WebCenter Analytics 10.3.0.1.

Upgrading from Oracle WebCenter Analytics 10.3 to Oracle WebCenter Analytics 10.3.0.1

To upgrade from Oracle WebCenter Analytics 10.3 to Oracle WebCenter Analytics 10.3.0.1:

  1. Back up the installation directory of the previously-installed version of the Analytics Services component, using the tool of your choice.

  2. Install the Analytics Console component. For details, see Installing the Analytics Console Component.

    If you are choosing the same location as the existing software, accept the default installation directory location when prompted.

    Note:

    When performing the installation process, ensure that the Oracle WebCenter Analytics database settings are correct in Oracle WebCenter Configuration Manager. However, do not configure any other Analytics Console settings in Oracle Configuration Manager at this time.
  3. Install the Analytics Collector component and configure Analytics Collector settings in Oracle WebCenter Configuration Manager. For details, see Installing the Analytics Collector Component.

  4. (Optional) If desired, cluster the BEA AL Analytics Collector service. For details, see Clustering the BEA AL Analytics Collector Service.

  5. Run the Analytics25Update.bat file:

    • Windows: install_dir\ptanalytics\10.3.0.1\bin\Analytics25Update.bat

    • UNIX/Linux: install_dir/ptanalytics/10.3.0.1/bin/Analytics25Update.sh

  6. On the machine on which you installed the Analytics Console component:

    1. Access Oracle WebCenter Configuration Manager.

    2. Click the + symbol next to the Analytics Console application name to view its components.

    3. Configure all Analytics Console settings.

  7. (Oracle databases only) Run your database's analyisis tool on both the Oracle WebCenter Analytics and portal databases to increase the efficiency of the databases.

  8. Back up the installation directory of the previously-installed version of the Interaction Analytics component, using the tool of your choice.

  9. Install the Interaction Analytics component and configure Analytics Communication settings in Oracle WebCenter Configuration Manager. For details, see Installing the Interaction Analytics Component.

  10. Install the Image Service component. For details, Installing the Image Service Component.

  11. Stop and restart BEA AL Analytics and BEA AL Analytics Collector services. For details, see Starting the BEA AL Analytics and BEA AL Analytics Collector Services.

  12. Install the Analytics Automation Jobs component and configure Analytics Jobs settings in Oracle WebCenter Configuration Manager. For details, see Installing the Analytics Automation Jobs Component.

  13. Add Analytics jobs to the Automation Service. For details, see Adding Analytics Jobs to the Automation Service.

Upgrading from AquaLogic Analytics 2.5 to Oracle WebCenter Analytics 10.3.0.1

To upgrade from AquaLogic Analytics 2.5 to Oracle WebCenter Analytics 10.3.0.1:

  1. Delete the \Analytics folder beneath the install_dir\common\container\tomcat\5.0.28\work directory.

  2. Back up the installation directory of the previously-installed version of the Analytics Services component, using the tool of your choice.

  3. (Linux/UNIX only) Grant user and group access rights to Oracle Inventory directories. For details, see Granting User and Group Access Rights to Oracle Inventory Directories.

  4. Install the Analytics Console component. For details, see Installing the Analytics Console Component.

    If you are choosing the same location as the existing software, accept the default installation directory location when prompted.

    Note:

    When performing the installation process, ensure that the Oracle WebCenter Analytics database settings are correct in Oracle WebCenter Configuration Manager. However, do not configure any other Analytics Console settings in Oracle Configuration Manager at this time.
  5. Register portal events. For details, see Registering Portal Events.

  6. Register Oracle WebCenter Collaboration events. For details, see Registering Oracle WebCenter Collaboration Events.

  7. (Oracle WebCenter Ensemble integration only) Register Oracle WebCenter Ensemble events. For details, see Registering Oracle WebCenter Ensemble Events.

  8. Install the Analytics Collector component and configure Analytics Collector settings in Oracle WebCenter Configuration Manager. For details, see Installing the Analytics Collector Component.

  9. (Optional) If desired, cluster the BEA AL Analytics Collector service. For details, see Clustering the BEA AL Analytics Collector Service.

  10. Back up the Oracle WebCenter Analytics database using the tool of your choice.

  11. Upgrade the Oracle WebCenter Analytics database by running the upgrade_2.5_to_10.3.1.sql script:

    • Windows: install_dir\ptanalytics\10.3.0.1\sql\database\upgrade_2.5_to_10.3.1.sql

    • UNIX/Linux: install_dir/ptanalytics/10.3.0.1/sql\database/upgrade_2.5_to_10.3.1.sql

  12. Run the Analytics25Update.bat file:

    • Windows: install_dir\ptanalytics\10.3.0.1\bin\Analytics25Update.bat

    • UNIX/Linux: install_dir/ptanalytics/10.3.0.1/bin/Analytics25Update.sh

  13. On the machine on which you installed the Analytics Console component:

    1. Access Oracle WebCenter Configuration Manager.

    2. Click the + symbol next to the Analytics Console application name to view its components.

    3. Configure all Analytics Console settings.

  14. (Oracle database only) Run your database's analyisis tool on both the Oracle WebCenter Analytics and portal databases to increase the efficiency of the databases.

  15. Back up the installation directory of the previously-installed version of the Interaction Analytics component, using the tool of your choice.

  16. Install the Interaction Analytics component and configure Analytics Communication settings in Oracle WebCenter Configuration Manager. For details, see Installing the Interaction Analytics Component.

  17. Install the Image Service component. For details, Installing the Image Service Component.

  18. Stop and restart BEA AL Analytics and BEA AL Analytics Collector services. For details, see Starting the BEA AL Analytics and BEA AL Analytics Collector Services.

  19. Install the Analytics Automation Jobs component and configure Analytics Jobs settings in Oracle WebCenter Configuration Manager. For details, see Installing the Analytics Automation Jobs Component.

  20. Add Analytics jobs to the Automation Service. For details, see Adding Analytics Jobs to the Automation Service.

Upgrading from AquaLogic Analytics 2.1 to Oracle WebCenter Analytics 10.3.0.1

To upgrade from AquaLogic Analytics 2.1 to Oracle WebCenter Analytics 10.3.0.1:

  1. Delete the \Analytics folder beneath the install_dir\common\container\tomcat\5.0.28\work directory.

  2. Back up the installation directory of the previously-installed version of the Analytics Services component, using the tool of your choice.

    Note:

    In AquaLogic Analytics 2.1, the Analytics Services component installation consisted of the BEA AL Analytics service, the core Analytics application files, and the BEA AL Analytics Collector service. The default installation directory for Analytics Services was install_dir\ptanalytics (Windows) and install_dir/ptanalytics (UNIX and Linux).

    In 10.3.0.1, installing the Analytics Console component installs only the BEA AL Analytics service and the core Oracle WebCenter Analytics application files. Installing the Analytics Collector component installs only the BEA AL Analytics Collector service.

  3. (Linux/UNIX only) Grant user and group access rights to Oracle Inventory directories. For details, see Granting User and Group Access Rights to Oracle Inventory Directories.

  4. Install the Analytics Console component. For details, see Installing the Analytics Console Component.

    If you are choosing the same location as the existing software, accept the default installation directory location when prompted.

    Note:

    When performing the installation process, ensure that the Oracle WebCenter Analytics database settings are correct in Oracle WebCenter Configuration Manager. However, do not configure any other Analytics Console settings in Oracle Configuration Manager at this time.
  5. Register portal events. For details, see Registering Portal Events.

  6. Register Oracle WebCenter Collaboration events. For details, see Registering Oracle WebCenter Collaboration Events.

  7. (Oracle WebCenter Ensemble integration only) Register Oracle WebCenter Ensemble events. For details, see Registering Oracle WebCenter Ensemble Events.

  8. Install the Analytics Collector component and configure Analytics Collector settings in Oracle WebCenter Configuration Manager. For details, see Installing the Analytics Collector Component.

  9. (Optional) If desired, cluster the BEA AL Analytics Collector service. For details, see Clustering the BEA AL Analytics Collector Service.

  10. Back up the Oracle WebCenter Analytics database using the tool of your choice.

  11. Upgrade the Oracle WebCenter Analytics database by running the upgrade_2.1_to_10.3.1.sql script:

    • Windows: install_dir\ptanalytics\10.3.0.1\sql\database\upgrade_2.1_to_10.3.1.sql

    • UNIX/Linux: install_dir/ptanalytics/10.3.0.1/sql\database/upgrade_2.1_to_10.3.1.sql

  12. Run the Analytics25Update.bat file:

    • Windows: install_dir\ptanalytics\10.3.0.1\bin\Analytics25Update.bat

    • UNIX/Linux: install_dir/ptanalytics/10.3.0.1/bin/Analytics25Update.sh

  13. On the machine on which you installed the Analytics Console component:

    1. Access Oracle WebCenter Configuration Manager.

    2. Click the + symbol next to the Analytics Console application name to view its components.

    3. Configure all Analytics Console settings.

  14. (Oracle database only) Run your database's analyisis tool on both the Oracle WebCenter Analytics and portal databases to increase the efficiency of the databases.

  15. Back up the installation directory of the previously-installed version of the Interaction Analytics component, using the tool of your choice.

  16. Install the Interaction Analytics component and configure Analytics Communication settings in Oracle WebCenter Configuration Manager. For details, see Installing the Interaction Analytics Component.

  17. Install the Image Service component. For details, Installing the Image Service Component.

  18. Stop and restart BEA AL Analytics and BEA AL Analytics Collector services. For details, see Starting the BEA AL Analytics and BEA AL Analytics Collector Services.

  19. Install the Analytics Automation Jobs component and configure Analytics Jobs settings in Oracle WebCenter Configuration Manager. For details, see Installing the Analytics Automation Jobs Component.

  20. Add Analytics jobs to the Automation Service. For details, see Adding Analytics Jobs to the Automation Service.

  21. (Optional) Create and set up the ALUI Security database and migrate data from the portal database's security tables to the ALUI Security database.

    Note:

    You do not need to perform these steps if AquaLogic Pathways 1.5 is installed. Performing a clean (non-upgrade) install of AquaLogic Pathways 1.5 requires creating the ALUI Security database. Upgrading from AquaLogic Pathways 1.0 to AquaLogic Pathways 1.5 requires creating the ALUI Security database and migrating data from the portal database's security tables to the ALUI Security database.
    1. Create and set up the ALUI Security database. For details, see Configuring the ALUI Security Database.

    2. On the machine on which the previous version of the BEA AL Analytics service is installed, run the security-upgradetool.bat or security-upgradetool.sh file, located in install_dir\ptanalytics\10.3.0.1\bin.

      Performing this step migrates data from the portal database's security tables to the ALUI Security database.