Upgrade Guide

Overview of the Upgrade Process from WebLogic Portal 7.0 SP2 to 8.1

Definitions

Portal Version 7.0 SP2 to 8.1 Upgrade Process Overview

Comparing Supported Features

Look and Feel

Stylesheets

Properties

Scripts

Images

Skeletons

JSP

Layouts

Layout Definition

Group Portals

Webflow Support and Limitations

Exceptions

Page Flows

Portal Services

Security

Commerce and Personalization

Struts

How to Upgrade Existing Applications

Compatibility Domain

Upgrading to Weblogic Portal 8.1

Conversion of Portal and Portlet Definition Files

Portal Web Applications

Look and Feel Components

Version 8.1 Compatibility Domain

Hosting 7.0 Applications in 8.1 Compatibility Domain

Compatibility Explained

Features and Limitations of the Compatibility Domain

Development Issues

XA - Transaction Level Support

MBean Configuration Mechanism

Runtime and Administrative Issues

Listing Parent Groups

Authentication Providers in Portal Compatibility Domain

User and Group Management

Procedure for Hosting in Compatibility

Creating a Portal Compatibility Domain

Before You Begin

Step 1: Create New Portal Domain

Step 2: Edit Start Script

Step 3: Configure the New Domain

Step 4: Configure the Database

Upgrade Existing Data

Security Upgrade

Install and Configure the RDBMS Authentication Provider

Upgrading the Enterprise Application

Before You Begin

Procedure for Each Enterprise Application

Content Management Configuration

Modify Code

Upgrade Application-Sync Files

Final Adjustments to the Domain

Add Users to PortalSystemAdministrators Group

Upgrade CustomerRole in SSPI to Point to RDBMS Groups

Users and Groups Specified in fileRealm.properties

Upgrading to WebLogic Portal 8.1

Upgrading from Compatibility Mode to WebLogic Portal 8.1

Before You Begin

Procedure for Upgrading from Compatibility

Adding Catalog Administration

Group Portals

Struts Support

Struts Applications in WebLogic Portal 7.0

Support for Struts in WebLogic Portal 8.1

Upgrading Struts applications to Page Flows in WebLogic Portal 8.1

JSP Tag Replacements

Upgrading Database and Metadata Files from 7.0 to 8.1

Step 1: Upgrade PointBase Triggers

Step 2: Upgrade WebLogic Portal 7.0 Schema

Step 3: Upgrade Application-Sync Files

Step 4: Upgrade Portal and Portlet Files

Step 5: Upgrade ENTITLEMENT_RULESET Records

Step 6: Upgrading Existing Behavior Tracking Data

Upgrading 8.1 to Service Pack

Step 1: Upgrade an Existing Domain or Create a New SP2 Domain

Upgrading an Existing domain

Creating a New SP2 Domain

Step 2: Upgrade Existing Applications and Projects

Before You Begin - About UUP

Update the Portal Libraries

Step 3: Redeploy the Upgraded Application

Upgrading to Service Pack

The Service Pack Upgrade Process

Step 1: Upgrade an Existing SP2 Domain or Create A New SP3 Domain

Upgrading an Existing SP2 domain

WebLogic Portal Upgrade Installer

WebLogic Portal Full Installer

Creating a New SP3 Domain

Step 2: Upgrade Existing Database Schema

Upgrading a PointBase Database

Remove OLD_ Tables After Upgrade (Optional)

Upgrading a Sybase Database

Remove OLD_ Tables After Upgrade (Optional)

Upgrading a SQL Server Database

Remove OLD_ Tables After Upgrade (Optional)

Upgrading an Oracle or DB2 Database

Remove OLD_ Tables After Upgrade (Optional)

Step 3: Upgrade Existing Applications

Re-encrypting Password

Encrypting Passwords

Note on Changing Passwords

Before You Begin - About UUP

Update the Portal Libraries

Step 4: Redeploy the Upgraded Application

Upgrading to Service Pack

The Service Pack Upgrade Process

Step 1: Upgrade an Existing SP2 or SP3 Domain or Create A New SP4 Domain

Upgrading an Existing SP2 or SP3 domain

WebLogic Portal Upgrade Installer

WebLogic Portal Full Installer

Creating a New SP4 Domain

Step 2: Upgrade Existing Database Schema

Upgrading a PointBase Database

Upgrading a Sybase Database

Upgrading a SQL Server Database

Upgrading an Oracle or DB2 Database

Step 3: Upgrade Existing Applications

Re-Configure Third-Party Content Management Systems

Re-Encrypting Passwords for WSRP Producers

Encrypting Passwords

Note on Changing Passwords

Updating Portal Libraries

Before You Begin - About UUP

Update the Portal Libraries

Step 4: Redeploy the Upgraded Application

Step 5: Review Functional Changes for SP4

Functional Changes for SP4

Aggressive Control Tree Persistence

Content Management Portlet

URL Template File Updates

Creating New Portals Using Administration Portal

URL Template File Update for WSRP

Updates for Java Portlets

Portlet Preferences Behavior on Server Restart

Entitlements Data Source

Storage of Policy Reference Data in RDBMS

Using Role Caching with Entitlements

Setting up JDBC Connection Polling

Creating Complex Content Queries

Performance

Using the NOT (!) Operator

Querying Multi-Valued Properties

Changes to Visitor Tools for SP4

Functional Changes

Code Changes

Internationalization

Moving JavaScript to .js Files

Changes to JSP Files

Changes to Java Files

Unchanged Files

Database Changes for SP4

Entitlement Policy Reference

Portal Framework

Sybase Database Changes

SQL Server Database Changes

DB2 Database Changes

Database Changes for SP3

Virtual Content Management

Web Services for Remote Portlets (WSRP)

WebLogic Commerce Services (CMV)

Portal Framework

Framework Reference for Portal Upgrades from 7.0 to 8.1

Security

Security Framework JSPs

Authentication Providers

Unified User Profile (UUP)

Connecting to an Active Directory Server

Portal Properties

Portal Component Properties

Desktop Properties

Header and Footer Properties

Book and Page Properties

Placeholder Properties

Portlet Type Properties

Portlet Instance Properties

Framework File Reference

Framework Files

JSP Reference

JSP Tag Changes

JSP Tag Libraries

Notes on Individual JSP Tags