Skip Headers

Oracle Business Intelligence Publisher Installation Guide
Release 10.1.3.4
Part Number E12690-01
Go to Table of Contents
Contents
Go to previous page
Previous
Go to next page
Next

Upgrading BI Publisher

Overview

Currently the Oracle BI Publisher installer does not include an upgrade option. Follow these steps to upgrade BI Publisher versions 10.1.3.2 and later to version 10.1.3.4.

This procedure applies to BI Publisher installations originally installed using the BI Publisher Installer or originally installed by following the manual install instructions in this guide. This procedure does not apply to installations completed using the Oracle Business Intelligence Enterprise Edition installer.

For installations completed using the Oracle Business Intelligence Enterprise Edition installer, refer to "About Re-Installing Oracle BI Components" in the Oracle Business Intelligence Infrastructure Installation and Configuration Guide.

The upgrade procedure requires you to manually deploy the new xmlpserver.ear or xmlpserver.war file to your application server and then copy over only the upgraded files to your existing BI Publisher repository location. This procedure will maintain your existing report repository, user repository, and configuration and integration settings.

Upgrading the Application:

  1. Identify the location of your BI Publisher repository.

    If you do not know the location of the BI Publisher repository: Connect to BI Publisher with Administrator privileges. Select the Admin tab, then select Report Repository from the list of System Maintenance options to see the path to your BI Publisher repository.

  2. Back up all the directories under the BI Publisher repository (for example: {Oracle_Home}/xmlp/XMLP).

  3. Back up your existing BI Publisher Scheduler schema.

  4. Shut down BI Publisher.

  5. Undeploy the BI Publisher application ("xmlpserver") from your J2EE application server. See your application server documentation for instructions on how to undeploy an application.

  6. Deploy the 10.1.3.4 xmlpserver.ear or xmlpserver.war to your application server. See Manually Installing BI Publisher to Your J2EE Application Server for guidelines for your application server type.

    Note that you only need to perform the steps required to deploy the xmlpserver.ear or xmlpserver.war file. Perform only the steps required to deploy the xmlpserver.ear or xmlpserver.war file.

Upgrading the Repository

  1. Manually copy the following files from the 10.1.3.4 install media to your existing BI Publisher Repository:

  2. Manually copy all files in the following directories from the 10.1.3.4 install media to your existing BI Publisher Repository :

  3. Update xmlp-server-config.xml to point to the repository:

    Open the xmlp-server-config.xml file located in the <application installation>/WEB-INF/ directory, where your application server unpacked the war or ear file.

    Example:

    In an Oracle AS/OC4J 10.1.3 deployment, the location is

    <ORACLE_HOME>/j2ee/home/applications/xmlpserver/xmlpserver/WEB-INF/xmlp-server-config.xml

    The file contains the following:

    <?xml version="1.0" encoding="UTF-8"?>
    <xmlpConfig xmlns="http://xmlns.oracle.com/oxp/xmlp">
    <resource>
      <file path="${oracle.home}/xdo/repository"/>
    </resource>
    </xmlpConfig>

    Replace ${oracle.home}/xdo/repository with the file path to the location where you copied the XMLP repository directory on your server.

    For example, if you copied the repository directory to /home/repository/XMLP, update the xmlp-server-config.xml file as follows:

    <?xml version="1.0" encoding="UTF-8"?>
    <xmlpConfig xmlns="http://xmlns.oracle.com/oxp/xmlp">
    <resource>
      <file path="/home/repository/XMLP"/>
    </resource>
    </xmlpConfig>

    Ensure to save the file after you update it.

  4. Restart the BI Publisher application (xmlpserver).