Skip Headers
Oracle® Fusion Middleware Upgrade Guide for Oracle Identity Management
11g Release 1 (11.1.1)

Part Number E10129-09
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

12 Upgrading Oracle Adaptive Access Manager Environment

This chapter describes how to upgrade your existing Oracle Adaptive Access Manager 10g (10.1.4.5) to Oracle Adaptive Access Manager 11g Release 1 (11.1.1.5.0).

This chapter contains the following sections:

12.1 Overview

When you run Upgrade Assistant to upgrade from Oracle Adaptive Access Manager 10g, the Upgrade Assistant upgrades most of the Oracle Adaptive Access Manager 10g configuration to Oracle Adaptive Access Manager 11g. In some cases, you have to upgrade manually after you run the Upgrade Assistant.

When you run Upgrade Assistant to upgrade from Oracle Adaptive Access Manager 10g, the Upgrade Assistant upgrades the following:

The following components are not upgraded to the Oracle Adaptive Access Manager 11g environment when you run Upgrade Assistant to upgrade from Oracle Adaptive Access Manager 10g:

You must upgrade such configuration manually after running Upgrade Assistant. For more information, see Task 11: Complete Any Required Oracle Adaptive Access Manager Post-Upgrade Tasks, Oracle Fusion Middleware Administrator's Guide for Oracle Adaptive Access Manager, and Oracle Fusion Middleware Developer's Guide for Oracle Adaptive Access Manager.

12.2 Prerequisites

You must complete the following prerequisites for upgrading to the Oracle Adaptive Access Manager 11g environment:

12.3 Task 1: Decide Upon an Oracle Adaptive Access Manager Topology

Before you install Oracle Adaptive Access Manager 11g, consider the topology you currently have in Oracle Adaptive Access Manager 10g (10.1.4.5) with Bundle Patch 07, as well as any requirements for your Oracle Fusion Middleware 11g environment.

For more information, refer to Chapter 10, "Oracle Adaptive Access Manager Topologies".

12.4 Task 2: If Necessary, Upgrade the Oracle Database That Contains Oracle Adaptive Access Manager Schemas

If you are upgrading an Oracle Adaptive Access Manager environment, you must ensure that the version of the database where you plan to install the Oracle Adaptive Access Manager schemas is supported by Oracle Fusion Middleware 11g.

For instructions on verifying that your database meets the requirements of Oracle Fusion Middleware 11g, see "Upgrading and Preparing Your Databases" in the Oracle Fusion Middleware Upgrade Planning Guide.

12.5 Task 3: Run Repository Creation Utility to Create Schemas

Run the Repository Creation Utility to create the Oracle Meta Data Services (MDS) schema into a supported database and complete the following:

12.5.1 Running Repository Creation Utility in Preparation for an Oracle Adaptive Access Manager Upgrade

For information about running Repository Creation Utility to install the Oracle Adaptive Access Manager schema, refer to the following documents:

After you start the Repository Creation Utility, follow the instructions on the Repository Creation Utility screens to connect to the database and create the required schemas.

12.5.2 Selecting the Schemas Required for Oracle Adaptive Access Manager Upgrade

You can use Repository Creation Utility to install the schemas required for all of the Oracle Fusion Middleware software components that require a schema. However, there is no need to install all the schemas unless you plan to install a complete Oracle Fusion Middleware environment and you plan to use the same database for all the Oracle Fusion Middleware component schemas.

For Oracle Adaptive Access Manager upgrade, you must select the following schemas when prompted by the Repository Creation Utility:

  • Expand AS Common Schemas, and select Metadata Services and Audit Services.

    This schema supports Oracle Fusion Middleware Metadata Services (MDS), which is required by the Oracle Adaptive Access Manager component.

    Note:

    The MDS Schema can be installed in a database other than the one where the Oracle Adaptive Access Manager schema is installed. However, ensure that the Oracle Adaptive Access Manager Managed Server can access your MDS schema.

12.6 Task 4: Install Oracle Fusion Middleware

Before you upgrade to Oracle Fusion Middleware 11g, you must install and configure an Oracle Fusion Middleware environment that is similar to the topology you set up for Oracle Application Server 10g. To do so, complete the following steps:

  1. Installing Oracle WebLogic Server and Creating a Middleware Home

  2. Installing Oracle Adaptive Access Manager 11g Release 1 (11.1.1.5.0)

12.6.1 Installing Oracle WebLogic Server and Creating a Middleware Home

Before you can install Oracle Identity and Access Management 11g Release 1 (11.1.1) components, you must install Oracle WebLogic Server and create the Oracle Middleware Home directory.

For more information, see "Install Oracle WebLogic Server" in Oracle Fusion Middleware Installation Planning Guide.

In addition, see Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server for complete information about installing Oracle WebLogic Server.

12.6.2 Installing Oracle Adaptive Access Manager 11g Release 1 (11.1.1.5.0)

For information about installing Oracle Adaptive Access Manager 11g Release 1 (11.1.1.5.0), refer to "Installing OAAM" in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.

Note:

Do not configure the Oracle Adaptive Access Manager domain during the installation process.

12.7 Task 5: Use Upgrade Assistant to Upgrade the Oracle Adaptive Access Manager Schema

To upgrade the Oracle Adaptive Access Manager schema using Upgrade Assistant, perform the following steps:

  1. Enter the following command to start the Upgrade Assistant:

    On UNIX systems (Located at MW_HOME/Oracle_<IDM_Home>/bin):

    ./ua
    

    On Windows systems (Located at MW_HOME\Oracle_<IDM_Home>\bin):

    ua.bat
    

    The Oracle Fusion Middleware Upgrade Assistant Welcome screen is displayed, as shown in Figure 12-1.

    Figure 12-1 Upgrade Assistant Welcome Screen

    Description of Figure 12-1 follows
    Description of "Figure 12-1 Upgrade Assistant Welcome Screen"

  2. Click Next.

    The Specify Operation screen is displayed, as shown in Figure 12-2.

    Figure 12-2 Upgrade Assistant Specify Operation Screen

    Description of Figure 12-2 follows
    Description of "Figure 12-2 Upgrade Assistant Specify Operation Screen"

  3. Select the Upgrade Oracle Adaptive Access Manager Schema option.

  4. Click Next.

    The Prerequisites screen is displayed.

  5. Select the Database Schema backup completed and Database version is certified by Oracle for Fusion Middleware upgrade options.

    Note:

  6. Click Next.

    The Specify OAAM Source Database screen is displayed.

  7. Enter the following information:

    • Database Type: Select the database type from the drop-down list.

    • Connect String: Enter the connect string for the database.

      For example:

      host:port:sid

    • OAAM Schema User: Specify the Oracle Adaptive Access Manager 10g schema user name.

    • DBA User: Enter the user name for your database.

    • DBA Password: Enter the password for your database user.

  8. Click Next.

    The Examining Components screen is displayed.

    Upgrade Assistant examines the components and checks that the source and target schemas contain the expected columns.

    Under the Status column, the word succeeded should appear. If instead, the word failed appears, inspect the log file for details.

    Note:

    If you want to view the log file for the current session, click on the link at the bottom of the screen to view the ua.log file.
  9. Click Next.

    The Upgrade Summary screen is displayed.

  10. Click Upgrade.

    The Upgrade Progress screen is displayed. This screen provides the following information:

    • Status of the upgrade

    • Any errors or problems that occur during the upgrade

      See Also:

      "Troubleshooting Your Upgrade" in the Oracle Fusion Middleware Upgrade Planning Guide for specific instructions for troubleshooting problems that occur while running the Upgrade Assistant
  11. Click Next.

    The Upgrade Complete screen is displayed. This screen confirms that the upgrade was complete.

  12. Click Close.

12.8 Task 6: Configure Oracle Adaptive Access Manager in a New or Existing Oracle WebLogic Domain

To configure Oracle Adaptive Access Manager in a new or existing Oracle WebLogic domain, refer to the "Configuring Oracle Adaptive Access Manager" section in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management. When you run the Oracle Fusion Middleware Configuration Wizard ensure that you configure the Managed Servers and assign them to machine.

Note:

Ensure that you specify the Oracle Adaptive Access Manager 10g database details in the screen where it prompts you to enter the Oracle Adaptive Access Manager 11g database details. You must enter the 10g credentials because there is no separate 11g database. It checks the database for a few system tables, which will not be present in Oracle Adaptive Access Manager 10g database. You can ignore these errors and complete the Oracle Adaptive Access Manager 11g installation.

12.9 Task 7: Configure Node Manager to Start Managed Servers

For information about configuring Node Manager, refer to the "Configuring Node Manager to Start Managed Servers" section in the Oracle Fusion Middleware Administrator's Guide.

12.10 Task 8: Stop the Administration Server and Oracle Adaptive Access Manager Managed Servers

If you have started the Oracle Adaptive Access Manager Administration Server and the Oracle Adaptive Access Manager Managed Servers, then you must stop the Oracle Adaptive Access Manager Administration Server and Managed Servers by running the following command on the command line:

Windows

stopManagedWebLogic.cmd oaam_admin_server1
stopManagedWebLogic.cmd oaam_server_server1

UNIX

stopManagedWebLogic.sh oaam_admin_server1
stopManagedWebLogic.sh oaam_server_server1

12.11 Task 9: Use Upgrade Assistant to Upgrade Oracle Adaptive Access Manager Middle Tier

To upgrade the Oracle Adaptive Access Manager middle tier:

Note:

You can also use the Upgrade Assistant command-line interface to upgrade your Oracle Application Server 10g Oracle homes. For more information, see "Using the Upgrade Assistant Command-Line Interface" in the Oracle Fusion Middleware Upgrade Planning Guide.
  1. If you have started the Oracle Adaptive Access Manager Managed Servers, then they will auto-generate symmetric keys required for encryption or decryption. You must delete keys before performing middle tier upgrade. To do so, complete the following steps:

    1. Log in to Oracle Enterprise Manager.

    2. Expand the WebLogic Domain on the left pane, and select the OAAM domain.

      The OAAM domain page is displayed.

    3. From the OAAM Domain, select Security, and then Credentials.

      The Credentials page is displayed.

    4. Expand oaam and delete the symmetric key related entries.

  2. Run the following command to launch Upgrade Assistant:

    On UNIX systems (Located at MW_HOME/Oracle_<IDM_Home>/bin):

    ./ua
    

    On Windows systems (Located at MW_HOME\Oracle_<IDM_Home>\bin):

    ua.bat
    

    The Oracle Fusion Middleware Upgrade Assistant Welcome screen is displayed, as shown in Figure 12-3.

    Figure 12-3 Upgrade Assistant Welcome Screen

    Description of Figure 12-3 follows
    Description of "Figure 12-3 Upgrade Assistant Welcome Screen"

  3. Click Next.

    The Specify Operation screen is displayed, as shown in Figure 12-4.

    Figure 12-4 Upgrade Assistant Specify Operation Screen

    Description of Figure 12-4 follows
    Description of "Figure 12-4 Upgrade Assistant Specify Operation Screen"

  4. Select Upgrade Oracle Adaptive Access Manager Middle Tier.

    The options available in Upgrade Assistant are specific to the Oracle home from which it started. When you start Upgrade Assistant from an Oracle Application Server Identity Management Oracle home, the options shown on the Select Operation screen are the valid options for an Oracle Application Server Identity Management Oracle home.

  5. Click Next.

    The Specify Source Details screen is displayed.

  6. Enter the following information:

    • Click Browse and enter the directory location for Oracle Adaptive Access Manager Adaptive Strong Authenticator Web Application 10g (ASA) and Adaptive Risk Manager Web Application 10g (ARM) applications.

    • Database Type: Select the database type from the drop-down list.

    • Connect String: Enter the name of the server where your database is running. Use one of the following format for Oracle Database:

      //host:port/service or host:port:sid

    • Schema User Name: Enter the user name for the schema.

    • Schema Password: Enter the password for the schema.

  7. Click Next.

    The Specify WebLogic Server screen is displayed.

  8. Enter the following information about your Oracle WebLogic Server domain:

    • Host: The host name of the Oracle WebLogic Server domain.

    • Port: The listening port of the administration server. The default administration server port is 7001.

    • Username: The user name that is used to log in to the administration server. This is the same username you use to log in to the Administration Console for the domain.

    • Password: The password for the administrator account that is used to log in to the administration server. This is the same password you use to log in to the Administration Console for the domain.

    • Click Next.

    The Specify Upgrade Options screen is displayed.

  9. Select Start destination components after successful upgrade, and click Next.

    The Examining Components screen is displayed.

    Note:

    Ensure that Node Manager is running, before you select Start destination components after successful upgrade.
  10. Click Next.

    The Upgrade Summary screen is displayed.

  11. Click Upgrade.

    The Upgrade Progress screen is displayed. This screen provides the following information:

    • The status of the upgrade

    • Any errors or problems that occur during the upgrade

      See Also:

      "Troubleshooting Your Upgrade" in the Oracle Fusion Middleware Upgrade Planning Guide for specific instructions for troubleshooting problems that occur while running the Upgrade Assistant.
  12. Click Next.

    The Upgrade Complete screen is displayed. This screen confirms that the upgrade was complete.

  13. Click Close.

12.12 Task 10: Start the Administration Server and Oracle Adaptive Access Manager Managed Servers

You must start the Oracle Adaptive Access Manager Administration Server and the Oracle Adaptive Access Manager Managed Servers by running the following command on the command line:

Windows

startManagedWebLogic.cmd oaam_admin_server1
startManagedWebLogic.cmd oaam_server_server1

UNIX

startManagedWebLogic.sh oaam_admin_server1
startManagedWebLogic.sh oaam_server_server1

12.13 Task 11: Complete Any Required Oracle Adaptive Access Manager Post-Upgrade Tasks

You must perform the following additional post-upgrade tasks after upgrading your Oracle Adaptive Access Manager 10g environment to Oracle Adaptive Access Manager 11g:

12.14 Task 12: Verify the Oracle Adaptive Access Manager Upgrade

To verify that your Oracle Adaptive Access Manager upgrade was successful:

  1. Run Upgrade Assistant again, and select Verify Instance on the Specify Operation page.

    Follow the instructions on the screen for information about how to verify that specific Oracle Fusion Middleware components are up and running.

  2. Use the following URL to verify that Oracle Adaptive Access Manager 11g is up and running:

    Oracle Adaptive Access Manager Administration Server:

    http://hostname:oaam_admin_port/oaam_admin/ping 
    

    Oracle Adaptive Access Manager Managed Server:

    http://hostname:oaam_server_port/oaam_server/ping
    

    Alternatively, you can check the upgrade log file for any error messages or use Fusion Middleware Control to verify that Oracle Adaptive Access Manager and any other Oracle Identity Management components are up and running in the Oracle Fusion Middleware environment.

    For more information, see "Getting Started Using Oracle Enterprise Manager Fusion Middleware Control" in the Oracle Fusion Middleware Administrator's Guide.

  3. To verify that the Symmetric keys are created in CSF, perform the following:

    1. Log in to Oracle Enterprise Manager.

    2. Expand the WebLogic Domain on the left pane, and select OAAM domain.

      The OAAM domain page is displayed.

    3. From the OAAM Domain, select Security, and then Credentials.

      The Credentials page is displayed.

    4. Verify that oaam is listed in the Credential Store Provider table. Expand oaam and ensure that it includes the DESede_db_key_alias and DESede_config_key_alias entries.

  4. Check the Oracle Adaptive Access Manager schema version, to ensure that the schema upgrade was successful.

  5. Log in to the Oracle Adaptive Access Manager Administration Console as an existing user and ensure that you are able to access it.

  6. To verify that you can search and view existing Sessions, perform the following:

    1. Log in to the Oracle Adaptive Access Manager Administration Console.

    2. In the Navigation tree, select Sessions. The Sessions search page is displayed.

    3. Search for the session by the details you are interested in.

    For more information, see the chapter "Using Session Details" in Oracle Fusion Middleware Administrator's Guide for Oracle Adaptive Access Manager.