Migration Guide

 

Welcome to the BEA Migration Guide! This migration document describes the changes that affect developers as they upgrade their code to the lastest release. This document covers migration to WebLogic Commerce Server and WebLogic Personalization Server versions 3.1, 3.2, and 3.5, and to WebLogic Portal 4.0.

---

 

 

Planning Your Migration

Migrating to 3.1.1, 3.2, or 3.5

Before You Begin Migrating

Installation

Supported Platforms

Manual Migration Process

Migration Scripts for Migrations up to 3.5

Getting Started

Migrating From 3.5 to 4.0

Before You Begin Migrating

Getting the Latest Migration Information

Installation

Supported Platforms

Migration Tool Overview

Getting Started

Getting Supplementary and Updated Migration Documentation

 

Migrating From WebLogic Commerce Server Version 3.5 to WebLogic Portal Version 4.0

Getting Started With the Migration Tool

Migration Checklist for 3.5 to 4.0

How the Migration Tool Works

Migration Tool Overview

What the Tool Migrates

Helper Files in the Migration Directory

Pre-Migration Steps

Check Release Notes for Main Release and Service Packs

Starting BEA WebLogic Portal 4.0

Making a Complete Backup

Getting the Latest Migration Files

Checking Migration Environment

Editing the 4.0 set-environment bat file and migration_install.properties File

Migrating Data From 3.5 to 4.0

Before You Begin

How the Data Migration Works

Descriptions of Data Migration Tool Tasks

Specifying Unneeded Migration Tasks

Removing Anonymous Constraints

Migrating Your Data

Manual Migration for Previously Customized Items

Migrating Databases You Have Changed

Migrating JNDI_HOME_NAME and PROPERTY_SET

When to Drop 3.5 Tables

Migrating Code From 3.5 to 4.0

Before You Begin

Excluding Unmodified BEA Example Files From the Migration Process

Team Migration Guidelines

Migrating Code

Migrating JSPs

Manual Migration Tasks for 3.5 to 4.0

Moving New and Migrated Data Files to Your 4.0 Directory

Migrating Deployment Descriptors and Other Configuration Files

Entering Information Formerly Stored in weblogiccommerce.properties

Updating Integrations With CyberCash and TAXWARE

Migrating Webflow and Pipeline

Setting up Webflow

Migrating to the New Webflow Editor

Migrating non-User and non-Group Configurable Entity Successor Property Values

Migrating Events

Deciding Whether to Migrate Events

Migrating Events Data

Migrating Your Event Data Analysis Tool

Compare EBCC .evt Property Set Files to Migrated Events

Re-creating Portals and Portlets

Checking for Additional Migration Steps

Syncing Data to the Server

Verifying the Migration From 3.5 to 4.0

General Verification

EBCC Data Verification

Final Verification

What's Next: Getting Started With BEA WebLogic Portal 4.0

Licenses

Getting Started

Migration Reference Information

How to Use This Information

Enhancements in This Release

Database Changes

Finding Information on 4.0 Schemas

Transition From Databases to XML File Data Storage

Selected Descriptions of Data Converted to XML

3.5 and 4.0 Data Storage

Data Setup and Deployment Through EBCC

Coordinating Client and Server Data

New Client and Server Directory Structures

Deploying Rule Sets

Code Changes

JSP Tags

Location of .tld Files for Example Templates

JSP Tag <ph:placeholder> and name Attribute

General Changed and New JSP Tags

Webflow Tags

Personalization Tags

Example JSP Templates

Application Scoping

Naming and Renaming Rules for Placeholders and Other Items

Cybercash and TAXWARE

Behavior Tracking

User Group Hierarchy

Time Lag in Entitlements Updating

The User Group Hierarchy Changes

Notes on Managing the User Group Hierarchy Changes

Effect on LDAP Configuration

Changes to User Management

Change to UserManagement Components User, Group, and UserManager

Separation of Authentication and Authorization

CachedProfileBean Has Been Removed

User/Group Profile Managers

User/Group Manager Session Beans

Realm Integration

Unified Profile Types

LDAP Entity Property Manager

Realm Configuration Session Bean

User/Group Profile Tags

How Changes Are Migrated

HttpSession Timeouts and PipelineSession Input Processor

Changes to weblogiccommerce.properties File

Caching

Webflow and Pipeline

New Webflow Features

Significant Webflow and Pipeline Changes

Webflow and Pipeline Editor

Events

Content Management Link on Tools Administration Site

WebLogic Portal 4.0

Message Catalog Framework

Viewing Code Changes Using the Migration Viewer Tool

Installation Instructions

Starting the Migration Viewer

Using the Migration Viewer

Viewing Information in the Main Window

Searching by Keyword in the Find Window

 

Migrating WebLogic Commerce Server From Version 3.2 to 3.5

Migration Checklist for 3.2 to 3.5

Important Migration Tips and Strategies

Migration Steps

What's New in 3.5

Support for WebLogic Server 6.0

Introducing the E-Business Control Center

Changes to the Rules Editor in Release 3.5

Custom Tags

Migrating Code from 3.2 to 3.5

Migrating Your System for Use With WebLogic Server 6.0

Update Directory Structure Based on Changes to the WebLogic Commerce Server Directory Structure

Put All Pages in a Web Application

Replacing the Rules Manager With the E-Business Control Center

Migrating JSP Tags

Changed or Removed Tags

New Tags

Migrating Data from 3.2 to 3.5

Make a Backup

Validate Data

Upgrade Current Tables to New Schema

Drop Any Backup Tables

Add New Tables to Bring the Schema Current

Verify the Upgrade

Starting the Server

Migrating Your Rules

Migrating Your WLCS License

Verifying the Migration to 3.5

What's Next: Getting Started With 3.5

 

Migrating WebLogic Commerce Server From Version 3.1.1 to Version 3.2

Migration Checklist for 3.1.1 to 3.2

What's New in 3.2

New Java 2 SDK for Enhanced Performance

New Third-Party Integrations

International Tax Support from TAXWARE

E-Marketing Analysis Using Broadbase

Content Management with Interwoven Content Express

New Webflow and Pipeline Editor

Custom Tags

New Custom Tags

Changed Custom Tags

Migrating Code From 3.1.1 to 3.2

Use New Java 2 SDK for Enhanced Performance

Use New Webflow and Pipeline Editor

New JSP Tags and Migrating Existing JSP Tags

Changed Custom Tags

New Custom Tags

Migrating Data From 3.1.1 to 3.2

2.0.1 to 3.2: WebLogic Personalization Server

3.1.1 to 3.2: WebLogic Commerce Server and WebLogic Personalization Server

Upgrade the WebLogic Personalization Server Schema

Upgrade the Commerce services Schema

Verify the Upgrade

Starting the Server

Remove Temporary Tables

Verifying the Migration to 3.2

What's Next: Getting Started With 3.2

 

Migrating WebLogic Personalization Server From Version 2.0.1 to Version 3.1

Migration Checklist for 2.0.1 to 3.1

What's New in 3.1

New Custom Tags

Navigating With Flow Manager

Changes to the Personalization Advisor

Changes to the Rules Editor in Release 3.1

Changes to Content Management

Migrating Code From 2.0.1 to 3.1

Migrating to Flow Manager

About Flow Manager

Migrating to the Flow Manager

Accessing Your Application via the Flow Manager

Migrating the Personalization Advisor

JSP Tags Ported to Use the New Advisor

Deprecated Personalization Advisor Classes

Changes in Advisor APIs

Terminology Change: Agents Changed to Advislets

Migrating the Rules Editor

Relationship Between Rules and Property Sets

The Use of AND or OR to Connect Expressions

Change the Word `Rule Sheet' to `Rule Set'

Migrating Content Management

New Features in <cm:select> and <cm:selectById> Tags

Changes to EJB Deployment Descriptors

Changes to Object Interfaces

Changes to the BulkLoader

New Custom Tags and Migrating Custom Tags

Migrating Existing JSP Tags

Additional Notes About Existing JSP Tags

New JSP Tags in Release 3.1

Migrating Data From 2.0.1 to 3.1

Verifying the Migration to 3.1

What's Next: Getting Started With 3.1