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:

Cygwin 1.0. Visit: http://sources.redhat.com/cygwin/
MKS Toolkit 5.1 or 6.0. Visit: http://www.datafocus.com/products/

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:

Exports Oracle Internet Directory schema. As it does this, it generates.dmp files--for example, attr_store.dmp--in $ORACLE_HOME/ldap/load directory
Backs up the Oracle Internet Directory subtree by using the ldifwrite utility. As it does this, it generates the file OID_userdata.ldif in $ORACLE_HOME/ldap/load. The subtree under cn=OracleSchemaVersion (if it exists) is also backed up as orcl_schemaver.ldif in the $ORACLE_HOME/ldap/load directory.

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:

Make sure that the directory server is not running.
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

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:

Cygwin 1.0. Visit: http://sources.redhat.com/cygwin/
MKS Toolkit 5.1 or 6.0. Visit: http://www.datafocus.com/products/

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:

Imports the Oracle Internet Directory schema from the dump files
Inserts the schema differences between the previous release and Release 9.0.2
Bulkloads the data from the LDIF file with the -restore option

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:

When there is insufficient disk space to install and upgrade OID 9.0.2.1.0 on the machine where the prior version of Oracle Internet Directory resides, or
When the amount of data in the prior Oracle Internet Directory version is huge, and it is more comfortable to do data export/import than to do database migration.

Note:
If the Oracle Internet Directory node is taking part in replication or is configured for replication, then this procedure should not be used to upgrade the 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

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

FILE=oid.data
OWNER=ods, odscommon
RANTS=y
ROWS=y

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

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

Create a new file, oidimp1.dat, containing the following:
```
 FILE=oid.data
 FROMUSER=ods
 TOUSER=ods
```
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.

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

 FILE=oid.data
 FROMUSER=odscommon
 TOUSER=odscommon

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

Launch the OID Configuration Assistant by running
$ORACLE_HOME/bin/oidca
Click Next at the Welcome Screen.
Select the option `Upgrade an existing OID' and click Next.
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
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.)
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.
Click Next. In the next step, Oracle-context-related information and the Oracle Directory Integration platform-related information will be upgraded.
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.
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.
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.

EUpgrading Oracle Internet Directory