Contents

List of Examples

List of Tables

Title and Copyright Information

Preface

• GlassFish Server Documentation Set
• Related Documentation
• Typographic Conventions
• Symbol Conventions
• Default Paths and File Names
• Documentation, Support, and Training
• Searching Oracle Product Documentation
• Documentation Accessibility

1 GlassFish Server Upgrade Compatibility Issues

• Binary-Compatible Releases For GlassFish Server 3.1.2
• New Default Installation Directory
• Changes to Group Management Service Settings
• Application Client Interoperability
• Node Agent Support
• HADB and hadbm Command Support
• Command Line Interface: The asadmin Command
  • Deprecated asadmin Subcommands
  • Deprecated, Unsupported, and Obsolete Options
• Applications That Use Java DB
• Applications That Use Persistence
• HTTP Service to Network Service Changes
  • Changes to Dotted Names
  • Changes to asadmin Subcommands
  • Remapping of HTTP Service Attributes and Properties
  • New Network Service Elements and Attributes
• NSS Cryptographic Token Support

2 Upgrading an Installation of Application Server or GlassFish Server

• Upgrade Overview
  • Upgrade Paths
  • Upgrade Terminology
  • Summary of Upgrade Tools and Procedures
    • Summary of Tools for Performing an Upgrade
    • Summary of Procedure for Upgrading With Upgrade Tool
    • Summary of Procedure for Upgrading With Update Tool
    • Summary of Procedure for Upgrading With the Software Update Notifier
    • Summary of Procedure for Upgrading With the pkg Utility
  • Supported Releases for Upgrade to GlassFish Server 3.1.2
  • Upgrading From Version 8.x or Older Product Releases
  • Upgrading GlassFish Server Inside a Closed Network
• Performing a Side-By-Side Upgrade With Upgrade Tool
  • Upgrade Tool Summary
  • Upgrade Tool Functionality
    • Migration of Deployed Applications
    • Upgrade of Clusters
    • Upgrade Verification
  • To Upgrade From the Command Line Using Upgrade Tool
  • To Upgrade Using the Upgrade Tool Wizard
• Performing an In-Place Upgrade With the Update Center Tools
  • Update Center Tool Procedures
  • To Upgrade Using the Update Tool GUI
  • To Upgrade Using the Software Update Notifier
  • To Upgrade From the Command Line Using the pkg Utility
• Upgrading Installations That Use NSS Cryptographic Tokens
  • To Prepare for the Upgrade
  • To Perform Post-Upgrade Configuration
  • To Upgrade PKCS#11 Hardware Tokens
• Upgrading Clusters and Node Agent Configurations
  • Overview of Cluster and Node Agent Upgrade Procedures
  • To Correct the Configuration of a Node After an Upgrade
  • To Re-Create a Cluster
• Correcting Potential Upgrade Problems
  • Cluster Profile Security Setting
  • Cluster Profile Upgrade on Windows
  • asupgrade Fails Without Internet Connection