6.2 odisrvreg

The odisrvreg command-line tool registers an Oracle Directory Integration and Provisioning server with Oracle Internet Directory. This tool creates an entry in the directory and sets the password for the directory integration and provisioning server. If the registration entry already exists, then you can use the tool to reset the existing password. The odisrvreg tool also creates a local file called odisrvwallet_hostname in ORACLE_HOME/ldap/odi/conf. This file acts as a private wallet for the directory integration and provisioning server, which uses it on startup to bind to the directory.

6.2.1 Syntax for odisrvreg

odisrvreg -h oid_hostname -p port -D bindDN -w password  [-U SSL_auth_mode -W wallet_location –P wallet_password]

6.2.2 Arguments for odisrvreg

-h oid_hostname

Optional. The host name of the Oracle Internet Directory server. If not provided then the name of the local host is used.

-p port

Optional. The LDAP listening port of Oracle Internet Directory. The default is 389.

-D "bindDN"

The DN of the directory super user (cn=orcladmin).

-w password

The password used to bind to the directory.

-U SSL_auth_mode

Optional. The SSL authentication mode:

1 for no authentication required.
2 for one way authentication required. You must also supply a wallet location and wallet password.
3 for two way authentication required. You must also supply a wallet location and wallet password.

-W wallet_location

Required if using one way or two way SSL authentication (-U 2|3). The location of the wallet file that contains the server's SSL certificates.

Example for UNIX:

-W "file:/home/my_dir/my_wallet"

Example for Microsoft Windows:

-W "file:C:\my_dir\my_wallet"

-P wallet_password

Required if using one way or two way SSL authentication (-U 2|3). The wallet password for the wallet specified in the -W argument.

6.2.3 Tasks and Examples for odisrvreg

Using the odisrvreg command-line tool, you can perform the following tasks:

Registering the Oracle Directory Integration and Provisioning Server With Oracle Internet Directory

6.2.3.1 Registering the Oracle Directory Integration and Provisioning Server With Oracle Internet Directory

The following example shows how to register the Oracle Directory Integration and Provisioning server with Oracle Internet Directory using SSL for secure communications.

Example:

odisrvreg -h myhost.company.com -p 3040 -D "cn=orcladmin" -w welcome1 -U 2  -W "file:/home/my_dir/my_wallet" –P walpasswd123

6.2.4 Related Command-Line Tools for odisrvreg

See "schemasync"