Production Operations User Guide

Installing the Propagation Software

This chapter explains how to install the Propagation Utility and the Export/Import Utility.

This chapter includes the following sections:

Updating the Database

Note: You only need to perform a database update if you are upgrading your WebLogic Portal installation from an SP4 or older version.

Run the pf_update_system_data.sql script using your database's SQL command tool. This script is located in:

BEA_HOME/weblogic81/portal/db/data/required

Tip: The exact procedure for running this script depends on your database system. For example, if you use an Oracle database, start SQL*Plus and enter:

SQL>@pf_update_system_data.sql

Note: This script updates the default markup in the database. The default markup for books, pages, and desktops is used when new desktops, books, and pages are created with the Administration Portal or Visitor Tools. The script includes the $(markupName) token in the database. If this token is not added, SAXParseException errors are thrown when you import desktops, pages, or books that were created with the Administration Portal or Visitor Tools.

Installing the Propagation Utility

The Propagation Utility is a web application that you deploy into an existing WebLogic Portal application. You need to install the Propagation Utility into any existing portal application that you want to propagate.

Note: It is recommended that you deploy the Propagation Utility to the cluster, but only access it using the URL of one of the Managed Servers. This guarantees even in a failover situation that propagation is always run against the same node. If you deploy and run the Propagation Utility on an Administration Server, caches are not cleared across the cluster This is the reason that deploying the Propagation Utility to the Administration Server is not recommeded.

Note: If you are upgrading from SP4 or an older version of WebLogic Portal, you first need to run an SQL script to update your database, as explained in the previous section, Updating the Database.

Stop WebLogic Server if it is running.

Copy the propagation.war file from the BEA_HOME/weblogic81/portal/lib directory to the root directory of your Enterprise application.

In the root directory of your domain, open the config.xml file and add the following WebAppComponent tag to the Application tag for the Enterprise application you are propagating to or from:

<Application Name="myEnterpriseApp" ...>
     <WebAppComponent Name="propagation" Targets="portalServer" URI=
      "propagation.war"/>
</Application>

Note: You need to perform Step 3 for each new domain you create after the patch has been installed.

In the root directory of your Enterprise application, open the META-INF\application.xml file and add the following module if it is not already present:

<module>
     <web>
          <web-uri>propagation.war</web-uri>
          <context-root>propagation</context-root>
     </web>
</module>

Verifying the Propagation Utility Installation

Start WebLogic Server.

Open a Web browser.

Go to the following URL to start the Propagation Utility:

http://host:port/propagation

where host and port are the host name and port number that are configured for your WebLogic Server.
The main page of the Propagation Utility appears.

Click the View Configuration Details link and verify that the JAR files were installed.

Installing the Export/Import Utility

You only need to perform the following procedure if you intend to run the Export/Import Utility as a stand-alone application. If you only want to run the Propagation Utility, then the following procedure is unnecessary.

Before installing the Export/Import Utility, be sure you have Ant 1.5 in your PATH environment variable. Ant is part of the normal WebLogic Server installation. It is located in:

WEBLOGIC_HOME\server\bin\ant

Stop WebLogic Server if it is running.

Open the file BEA_HOME\weblogic81\portal\xip\build.xml, and edit the following properties in the Installer section to point to the appropriate locations:

Property	Description
`bea.dir`	Points to the BEA home directory
`wlp.lib.dir`	Points to the `WEBLOGIC_HOME\portal\lib\netuix` directory

Build the Export/Import Utility. To do this, run the following command from within the BEA_HOME\weblogic81\portal\xip directory:

ant jar

Running the Export/Import Utility

For detailed information about running and using the Export/Import Utility, see Using the Export/Import Utility.