Skip Navigation Links | |
Exit Print View | |
Oracle Fusion Middleware Command-Line Usage Guide for Oracle Unified Directory 11g Release 1 (11.1.1) |
1. Server Administration Commands
Code Generated by the create-rc-script Command
Oracle Directory Server Enterprise Edition LDAP Connection Options
Replication Gateway Configuration Options
Oracle Directory Server Enterprise Edition Server Options
Replication Gateway Security Options
Oracle Unified Directory Server Options
Removing a Replication Gateway Server
Oracle Unified Directory Server Connection Options
Oracle Directory Server Enterprise Edition Server Connection Options
The ds2oud command manages the migration from Oracle Directory Server Enterprise Edition directory server to Oracle Unified Directory server.
ds2oud [options]
The ds2oud command enables you to manage the migration from Oracle Directory Server Enterprise Edition directory server to Oracle Unified Directory server. The ds2oud command first allows you to diagnose the targeted Oracle Directory Server Enterprise Edition directory server, and then performs the migration task. It is based on the premise that the existing Oracle Unified Directory instance is modified to be compatible with the Oracle Directory Server Enterprise Edition directory server to be migrated. The ds2oud command runs in interactive mode, if you do not specify options. Interactive mode works much like a wizard, walking you through every aspect of the migration.
You can run the ds2oud command in batch mode as well. It generates a batch file that comprises dsconfig commands, which are used to create equivalent Oracle Unified Directory configuration.
The ds2oud command accepts the following options.
Diagnoses the targeted Oracle Directory Server Enterprise Edition directory server.
Diagnoses the Oracle Directory Server Enterprise Edition directory server LDIF database file.
Specifies the user schema to be taken into consideration. It applies to -f subcommand.
Propagates schema and configuration elements from Oracle Directory Server Enterprise Edition directory server to Oracle Unified Directory server.
Propagates the User schema from Oracle Directory Server Enterprise Edition directory server to Oracle Unified Directory server.
Propagates configuration elements from Oracle Directory Server Enterprise Edition directory server to Oracle Unified Directory server.
Specifies the unique workflow element to use for all the naming contexts to migrate. It is used in context of -c subcommand.
DN to use to bind to the Oracle Directory Server Enterprise Edition server.
Oracle Directory Server Enterprise Edition bind password file.
Oracle Directory Server Enterprise Edition server hostname. The default value is localhost.
Oracle Directory Server Enterprise Edition server port number. The default value is 389.
Establishes an Oracle Directory Server Enterprise Edition SSL-encrypted connection.
Use the Oracle Directory Server Enterprise Edition trust store certificate in the specified path. This option is not needed if -X is used, although a trust store should be used when working in a production environment.
Use the password in the specified file to access the certificates in the Oracle Directory Server Enterprise Edition trust store. This option is only required if --odseeTrustStorePath is used and the specified trust store requires a password to access its contents (most trust stores do not require this).
Trust all certificate that the Oracle Directory Server Enterprise Edition server presents. This option can be used for testing purposes, but for security reasons, a trust store should be used to determine whether the Oracle Directory Server Enterprise Edition should accept the server certificate.
DN to use to bind to the Oracle Unified Directory server.
Oracle Unified Directory bind password file.
Oracle Unified Directory server hostname. The default value is localhost.
Oracle Unified Directory server port number. The default value is 389.
Oracle Unified Directory server administration port. The default value is 444.
Establishes an Oracle Unified Directory SSL-encrypted connection.
Use the Oracle Unified Directory trust store certificate in the specified path.
Use the password in the specified file to access the certificates in the Oracle Unified Directory trust store. This option is only required if --oudTrustStorePath is used and the specified trust store requires a password to access its contents (most trust stores do not require this).
Trust all certificate that the Oracle Unified Directory server presents. This option can be used for testing purposes, but for security reasons, a trust store should be used to determine whether the Oracle Unified Directory should accept the server certificate.
Use the non-interactive mode. If data in the command is missing, the user is not prompted and the tool fails.
Redirects the output into the specified output file.
Name of the output file that contains a set of dsconfig commands to execute to migrate the configuration.
Displays command-line usage information for the command and exit without making any attempt to stop or restart the directory server.
Displays the version information for the directory server.
The following examples show how to use the ds2oud command. For more information, see System Requirements and Certification in Oracle Fusion Middleware Installation Guide for Oracle Unified Directory.
Example 1-16 Viewing the Global Help Subcommands
The following command displays the available global Help subcommands:
$ ds2oud --help
Example 1-17 Running ds2oud in Interactive Mode From the Command Line
The ds2oud command can be run in interactive mode, where you are prompted for migration options. To run ds2oud in interactive mode, type the following command:
$ ds2oud What do you want to do ? 1) Diagnose an ODSEE directory server instance 2) Diagnose an ODSEE LDIF data file 3) Migrate all ( user schema + configuration ) 4) Migrate the user schema 5) Migrate global configuration parameters c) cancel
For each preceding action, you first have to provide connection options either on Oracle Directory Server Enterprise Edition directory server for diagnose purpose or both Oracle Directory Server Enterprise Edition and Oracle Unified Directory servers for migration purpose.
Example 1-18 Running ds2oud for Diagnosing Data
The following command is run to diagnose the data present in the Oracle Directory Server Enterprise Edition directory server:
$ ds2oud -f odseeDataFile.ldif -u 99user.ldif ******************************************************************************* * Diagnose ODSEE LDIF data file : odseeDataFile.ldif ******************************************************************************* The data were validated successfully regarding the OUD schema
Example 1-19 Migrating an Existing Oracle Directory Server Enterprise Edition Configuration to an Oracle Unified Directory Configuration
Use the following commands to migrate an existing Oracle Directory Server Enterprise Edition Configuration to a new Oracle Unified Directory Configuration
The following command migrates an existing Oracle Directory Server Enterprise Edition configuration and schema:
$ ds2oud --migrateAll -D "cn=directory manager" -j /tmp/pwd -h hostname -p ldapPort --oudBindDN "cn=directory manager" --oudBindPasswordFile /tmp/pwd --oudHostname hostname2 --oudPort ldapPort2 --oudAdminPort adminPort -n
The following command provides the path to a batch file containing a set of dsconfig commands to be executed to create a new Oracle Unified Directory configuration:
$ ds2oud --migrateConfiguration --batchFile batchFile -D "cn=directory manager" -j /tmp/pwd -h hostname -p ldapPort --oudBindDN "cn=directory manager" --oudBindPasswordFile /tmp/pwd --oudHostname hostname2 --oudPort ldapPort2 --oudAdminPort adminPort -n
Successful.
Unable to initialize arguments.
Cannot parse arguments because the provided arguments are not valid or there was an error checking the user data.
At least one step into the migration process has failed.
The user canceled the operation in interactive mode.
UNIX and Linux: instance-dir/OUD/bin/ds2oud
Windows: instance-dir\OUD\bat\ds2oud.bat