Skip Headers

Oracle Internet Directory Administrator's Guide
Release 9.0.2

Part Number A95192-01
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

E
Upgrading Oracle Internet Directory

This chapter tells you how to upgrade from Oracle Internet Directory release 2.1.1.x or release 3.0.1.x to Oracle Internet Directory Release 9.0.2.1.0.

This appendix contains these topics:

Upgrading in a Single Node Environment

To upgrade on a single node, follow the instructions in the installation documentation for your operating system. See the Oracle Internet Directory section in Chapter 7 of the Oracle9i Application Server manual.

Upgrading in a Multi-Node Environment

Upgrading a multi-node Oracle Internet Directory system to Release 9.0.2 requires special attention.

See Also:

The section in Oracle9i Application Server Administrator's Guide about Oracle Internet Directory for more information

This section discusses LDIF-based upgrading for a multi-node Oracle Internet Directory system, which is normally not needed. Use this method when you cannot successfully run the database-based upgrade process.

LDIF-Based Upgrading

Oracle Corporation recommends that you use the LDIF-based backup procedure to backup your existing release of Oracle Internet Directory. This is explained in this section.

The LDIF-based upgrade process requires the following procedures on a node being upgraded:

Task 1: Backup the Older Version of Oracle Internet Directory

Be sure that the directory server is not running, then run the script backup_oid.sh located in the $ORACLE_HOME/ldap/install directory on the CD.


Note:

To run shell script tools on the Windows operating system, you need one of the following UNIX emulation utilities:


The syntax to run backup_oid.sh is:

backup_oid.sh -connect net_service_name -pass password_for_DB_account_`ods'

The backup_oid.sh script does the following:

If you plan to install Oracle Internet Directory Release 9.0.2 in the same ORACLE_HOME, then save these generated files in some other location.

Task 2: Perform a Fresh Installation of Oracle Internet Directory Release 3.0.1

See Also:

Installation documentation for your operating system

Task 3: Restore the User-Defined Schema and Data from the Previous Version of Oracle Internet Directory

To do this:

  1. Make sure that the directory server is not running.

  2. Copy the following files to $ORACLE_HOME/1dap/load:

    • Backed up Oracle Internet Directory schema dump files--that is, files with the extension.dmp

    • The file OID_userdata.ldif

  3. Run the script restore_oid.sh located in $ORACLE_HOME/ldap/install.


    Note:

    To run shell script tools on the Windows operating system, you need one of the following UNIX emulation utilities:


    The syntax for restore_oid.sh is:

    restore_oid.sh -connect net_service_name -pass password_for_DB_account_`ods'

The restore_oid.sh script does the following:

Task 4: Start Oracle Internet Directory Processes

Start OID Monitor and the directory server.

See Also:

Upgrading a Standalone Oracle Internet Directory Node

In certain circumstances, it can be awkward to attempt an upgrade for a standalone Oracle Internet Directory node:

To upgrade the directory in these circumstances, follow the steps in the sections listed here:

Task 1: Stop Oracle Directory Server on the Old Version Node

To stop the Oracle directory server, run the following command from $ORACLE_HOME/bin/ on the node:

oidctl connect=<db_connect_string> server=oidldapd instance=1 stop

Task 2: Backup the Sponsor Node by Using Export Utility

  1. Create a new file, oidexp.dat, containing the following:

    FILE=oid.data
    OWNER=ods, odscommon
    RANTS=y
    ROWS=y
    
    
  2. Run the following command (from $ORACLE_HOME/bin/) against the identified sponsor node:

    exp system/manager PARFILE=oidexp.dat
    


    Note:

    OID schema and data will be backed up in oid.data file. Move this file to the new node before performing the next task.


Task 3: Load Data into the New Node by Using the Import Utility

  1. Run the following SQL scripts:

     cd $ORACLE_HOME/ldap/admin/
     sqlplus system/manager @ldapdrop.sql
     sqlplus system/manager @ldapxact.sql
     sqlplus system/manager @ldapxsec.sql
    
    
  2. Create a new file, oidimp1.dat, containing the following:

     FILE=oid.data
     FROMUSER=ods
     TOUSER=ods
    
    
  3. Run the following commands against the new node:

     imp system/manager PARFILE=oidimp1.dat
    


    Note:

    Make sure the backup oid.data file is present in the
    current directory.


  4. Create a new file, oidimp2.dat, containing the following:

     FILE=oid.data
     FROMUSER=odscommon
     TOUSER=odscommon
    
    
  5. Run the following commands against the new node:

    imp system/manager PARFILE=oidimp2.dat
    


    Note:

    Make sure the backup oid.data file is present in the
    current directory.


Task 4: Perform Oracle Internet Directory Schema Upgrade

  1. Launch the OID Configuration Assistant by running
    $ORACLE_HOME/bin/oidca

  2. Click Next at the Welcome Screen.

  3. Select the option `Upgrade an existing OID' and click Next.

  4. The Database Migration Screen comes up. Here you are required to provide the information about the database to which Oracle Internet Directory data has been imported. (New version OID). Enter following information

    1. Database SID

    2. Passwords for the database users, `SYSTEM' and `ODS' respectively

    3. Oracle Home

    4. Location of the INIT.ORA file.

    5. Listener Port for the OID database

    6. Connect String for the OID database

  5. Click Next. (When this operation completes, the Oracle Internet Directory base schema has been upgraded to Oracle Internet Directory version 9.0.2.1.0.)

  6. In the next screen, provide the following information about the Oracle directory server:

    1. Non-SSL port on which the directory server needs to be started. The default value specified is 389.

    2. SSL port on which the directory server needs to be started. The default value specified is 636.

    3. The super-user distinguished name.

    4. The corresponding super-user password.

  7. Click Next. In the next step, Oracle-context-related information and the Oracle Directory Integration platform-related information will be upgraded.

  8. The Upgrading Subscriber screen appears. Here, you need to enter the distinguished name (DN) that identifies the root of your organization--for example, o=acme, dc=com. This domain is then upgraded to become the default subscriber.

  9. Click Next. The User Data Migration screen appears. This step might take a long time if you have a large directory. If you have a large directory--that is, more than 10,000 users--then Oracle Corporation recommends that you postpone your data migration and do it as a post-install step.

  10. However, if you want to do the user data migration as a part of this OID Configuration Assistant operation, select Yes and click Next. This completes the user data migration.

At the end of the upgrade, the directory server is running, listening to the specified Non-SSL and SSL ports.


Go to previous page Go to next page
Oracle
Copyright © 1999, 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index