Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction to Oracle WebLogic Server SmartUpgrade

• 1.1 What Is Oracle WebLogic Server SmartUpgrade?
• 1.2 Using SmartUpgrade As Part of Your Oracle Fusion Middleware Upgrade
• 1.3 About the SmartUpgrade Report
• 1.4 About SmartUpgrade Artifact Generation
  • 1.4.1 Generation of Deployment Descriptors
  • 1.4.2 Generation of Web Services Artifacts
• 1.5 SmartUpgrade Oracle JDeveloper Integration and Command-Line Interface
• 1.6 Downloading and Installing SmartUpgrade
  • 1.6.1 Deinstalling SmartUpgrade Release 1.0
  • 1.6.2 Obtaining the SmartUpgrade ZIP Files
  • 1.6.3 Installing the Oracle JDeveloper SmartUpgrade Extension
  • 1.6.4 Installing the SmartUpgrade Command-Line Interface
  • 1.6.5 Obtaining the Latest Documentation

2 Using SmartUpgrade with Oracle JDeveloper

• 2.1 Verifying the Oracle JDeveloper SmartUpgrade Extension Installation
• 2.2 Starting and Using the Java EE Upgrade Wizard
  • 2.2.1 Starting the Java EE Upgrade Wizard
    • 2.2.1.1 Using the Java EE Upgrade Application Wizard
    • 2.2.1.2 Using the Java EE Upgrade Project Wizard
  • 2.2.2 Using the Java EE Upgrade Wizard
    • 2.2.2.1 Summary of the Java EE Upgrade Wizard Pages
    • 2.2.2.2 Types of Archives and Projects Supported by the SmartUpgrade Oracle JDeveloper Extension
    • 2.2.2.3 Limiting the Analysis to Specific SmartUpgrade Rule Categories
    • 2.2.2.4 Analyzing Applications Deployed on Oracle Application Server 10g Release 2 (10.1.2)
  • 2.2.3 Setting Properties When Upgrading OC4J Web Services with SmartUpgrade
    • 2.2.3.1 Learning About Each of the Web Services Artifact Generation Options
    • 2.2.3.2 Setting the Mandatory Target Server Home Directory Option
    • 2.2.3.3 Generating Instrumented Code for Performance Analysis
    • 2.2.3.4 Packaging the Upgraded Web Services Artifacts as a Deployable Enterprise Archive
  • 2.2.4 Continuing with the Upgrade of Web Services Artifacts
• 2.3 Using a SmartUpgrade Report
  • 2.3.1 Viewing a SmartUpgrade Report
  • 2.3.2 Using the Upgrade Findings Toolbar to Filter SmartUpgrade Findings
  • 2.3.3 Using the Structure Window to Sort and Filter SmartUpgrade Findings

3 Using the SmartUpgrade Command Line

• 3.1 Using the SmartUpgrade Java Command-Line
  • 3.1.1 Verifying Prerequisites and Locating the smartupgrade.jar File
  • 3.1.2 Basic Syntax of the SmartUpgrade Command-Line Interface
  • 3.1.3 Getting Help on the SmartUpgrade Command-Line Options
  • 3.1.4 Summary of the SmartUpgrade Command-Line Options
    • 3.1.4.1 List of SmartUpgrade Command-Line Interface Options
    • 3.1.4.2 Identifying a SmartUpgrade Locator
    • 3.1.4.3 Specifying More Than One Locator on the SmartUpgrade Command Line
    • 3.1.4.4 Summary of the SmartUpgrade Optional Command-Line Options
  • 3.1.5 Summary of the SmartUpgrade Command-Line Options Specific to Web Services Artifact Generation
  • 3.1.6 Examples of Using the SmartUpgrade Command-Line Interface
    • 3.1.6.1 Using the SmartUpgrade Command-Line Interface to analyze an Enterprise Archive (EAR) File
    • 3.1.6.2 Using the SmartUpgrade Command-Line Interface to Generate Oracle WebLogic Server Artifacts
    • 3.1.6.3 Using the SmartUpgrade Command-Line Interface to Generate an HTML Report
    • 3.1.6.4 Limiting the Findings to Specific Rule Categories from the SmartUpgrade Command-Line Interface
    • 3.1.6.5 Using the SmartUpgrade Command-Line Interface to Analyze 10g Release 2 (10.1.2) Applications
• 3.2 Integrating SmartUpgrade with Apache Ant

4 Using SmartUpgrade Generated Artifacts

• 4.1 Locating the Artifacts Generated by SmartUpgrade
  • 4.1.1 Locating the Generated Artifacts and Output Folders
  • 4.1.2 Locating the Generated Artifacts in Oracle JDeveloper
• 4.2 Using Web Application Deployment Descriptor Artifacts Generated by SmartUpgrade
  • 4.2.1 Differences Between OC4J and Oracle WebLogic Server Deployment Descriptors
  • 4.2.2 List of Deployment Descriptor Elements Generated by SmartUpgrade
  • 4.2.3 Using the Generated Web Application Deployment Descriptor Elements
• 4.3 Using Web Services Artifacts Generated by SmartUpgrade
  • 4.3.1 Differences Between OC4J and Oracle WebLogic Server Web Services
  • 4.3.2 How Web Services Artifact Generation Differs From Deployment Descriptor Generation
  • 4.3.3 Capabilities of the SmartUpgrade Web Services Upgrade
  • 4.3.4 About the Content of the Generated Web Services Output Directories
  • 4.3.5 Using Artifacts Generated for a Dedicated Web Services Application
  • 4.3.6 Using Artifacts Generated for an Application with Both Web Services and Other Java EE Elements
• 4.4 Analyzing the Performance Impact of the Web Services Glue Code Generated by SmartUpgrade