Upgrading One Replica at a Time

16-10 Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management ■ Resetting the Replication DN Password

16.4.1.1 Changing the Replication DN Password

After you upgrade each replica, you must change the replication distinguished name DN password, using the Replication Environment Management Tool remtool, as follows: DESTINATION_ORACLE_HOME ldapbinremtool -pchgwalpwd -v -bind host:portrepl_dn_pwd Note that you must provide the existing password on the remtool command line. If you do not know the replication DN password, see Section 16.4.1.2, Resetting the Replication DN Password .

16.4.1.2 Resetting the Replication DN Password

If you do not know replication DN password, reset the replication DN password using the following command: DESTINATION_ORACLE_HOME ldapbinremtool -presetpwd -v -bind host:port If you are upgrading a fan-out replica, you must also reset the password of the replication DN at its supplier. To reset the password of replication DN at its supplier: 1. Create an LDIF file for example, modpwd.ldif, with following information: dn: cn=replication dn,orclreplicad=consumer_replicaid,cn=replication configuration changetype: modify replace: userpassword userpassword: new_password 2. Identify the replica ID of the replica to be upgraded by issuing following command: On Windows systems: SOURCE_ORACLE_HOME \bin\ldapsearch -h hostname_of_replica_being_upgraded -p port -D cn=orcladmin -w superuser_password -b -s base objectclass= orclreplicaid On UNIX systems: SOURCE_ORACLE_HOME binldapsearch -h hostname_of_replica_being_upgraded -p port -D cn=orcladmin -w superuser_password See Also: remtool in the Oracle Fusion Middleware User Reference for Oracle Identity Management for details about the arguments you can use with the remtool command, including the -pchgwalpwd and -presetpwd arguments Note: Before running the command, ensure that you set the ORACLE_INSTANCE environment variable. Performing an Oracle Identity Management Multimaster and Fan-Out Replication Upgrade 16-11 -b -s base objectclass= orclreplicaid 3. Create an LDIF file for example, modpwd.ldif, with following contents: dn: cn=replication dn,orclreplicad=consumer_replicaid,cn=replication configuration changetype: modify replace: userpassword userpassword: new_password 4. Apply the change at supplier using ldapmodify tool as shown below: ldapmodify -h supplier_hostname -p supplier_port_number -D cn=orcladmin -w super_user_password_of_supplier -f modpwd.ldif

16.4.2 Setting the orclreplicationid Attribute in the Upgraded 11g Directory

If you are upgrading a 10g Release 2 10.1.2 replica in an environment with fan-out replication, you must set the orclreplicationid in the Oracle Internet Directory attribute to a valid value. This procedure is not necessary if you are upgrading from 10g 10.1.4.0.1, because this is a new attribute that was introduced in Oracle Identity Management 10g 10.1.4.0.1. Oracle recommends that you set the value of this attribute so it matches the value of the existing orclagreementID attribute. To perform this task:

1. Identify the replica ID of the replica to be upgraded by issuing following

command: On Windows systems: SOURCE_ORACLE_HOME \bin\ldapsearch -h hostname_of_replica_being_upgraded -p port -D cn=orcladmin -w superuser_password -b -s base objectclass= orclreplicaid On UNIX systems: SOURCE_ORACLE_HOME binldapsearch -h hostname_of_replica_being_upgraded -p port -D cn=orcladmin -w superuser_password -b -s base objectclass= orclreplicaid 2. Create an LDIF file called id.ldif with the following content: dn: orclagreementid=000002,orclreplicaid=replicaid,cn=replication configuration changetype: modify replace: orclreplicationid orclreplicationid: 2 Note that in the above example, the first two lines should appear all in one line in the LDIF file. 16-12 Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management 3. Apply the LDIF file by using the following ldapmodify command: ldapmodify -p port -h host -D DN -w password -f id.ldif In this example, replace port, host, DN, and password with the appropriate values for your environment. See Also: The Replication Agreement Entry in the chapter, Oracle Internet Directory Replication Concepts in the Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory for information about the orclreplicationid attribute Oracle Internet Directory Data Management Tools in the Oracle Fusion Middleware User Reference for Oracle Identity Management for more information about using the ldapmodify command