After changing the configuration, choose Apply.
Managing System Configuration Attributes 9-15
5.
To get to a domain, use the cd command. For example: cdoracle.as.management.mbeans.register
or cdoracle.as.oid
If you type ls, you see a list of MBeans in that domain. There are three MBeans related to Oracle Internet Directory configuration under
oracle.as.management.mbeans.register and two under oracle.as.oid.
Table 9–7 lists them.
INSTANCE and COMPONENT_NAME refer to the Oracle instance where your Oracle Internet Directory component is located and the name of the component,
respectively.
6.
To get to a specific MBean, type: cdMBEAN_NAME
For example, if you are in the domain oracle.as.management.mbeans.register, and you want to manage the
Root Proxy MBean for Oracle Internet Directory component oid1 in Oracle instance instance1, type:
cdoracle.as.management.mbeans.register:type=OID,name=oid1,instance=instance1
7.
Once you have navigated to the desired MBean, you can get the current value for an attribute by typing:
getATTRIBUTE_NAME
Table 9–7 Oracle Internet Directory-Related MBeans
MBean Name MBean Domain
MBean Format in ls Output
Root Proxy MBean oracle.as.management.mbeans
.register oracle.as.management.mbeans.register:type=comp
onent,name=COMPONENT_NAME,instance=INSTANCE Non-SSL Port
MBean oracle.as.management.mbeans
.register oracle.as.management.mbeans.register:type=comp
onent.nonsslport,name=nonsslport1,instance=INS TANCE
,component=COMPONENT_NAME Audit MBean
oracle.as.management.mbeans .register
oracle.as.management.mbeans.register:type=comp onent.auditconfig,name=auditconfig1,instance=I
NSTANCE ,component=COMPONENT_NAME
SSL Port MBean oracle.as.oid
oracle.as.oid:type=component.sslconfig,name=ss lport1,instance=INSTANCE,component=COMPONENT_
NAME Key Store MBean
oracle.as.oid oracle.as.oid:type=component.keystore,name=key
store,instance=INSTANCE,component=COMPONENT_ NAME
Note: The Audit MBean is shown here for completeness, but you use
different commands for managing auditing by using wlst. See Managing Auditing by Using WLST
on page 22-5.
9-16 Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory
For example, to get the value for orclserverprocs, type: getorcldebugflag
8.
Before you make any changes to attributes, you must ensure that the MBean has the current server configuration. To do that, load the configuration from Oracle
Internet Directory server to the mbean. Type:
invokeload,jarray.array[],java.lang.Object,jarray.array[],java.lang.Strin g
9.
Then you can use the set command to set a specific attribute. Type: setATTRIBUTE_NAME, ATTRIBUTE_VALUE
For example, to set orclserverprocs = 12, type: setorcldebugflag, 12
10.
After making changes, you must save the MBean configuration to the Oracle Internet Directory server. Type:
invokesave,jarray.array[],java.lang.Object,jarray.array[],java.lang.Strin g
Managing System Configuration Attributes by Using LDAP Tools
From the command line, you can modify most system configuration attributes by using ldapmodify and list most system configuration by using ldapsearch.
Setting System Configuration Attributes by Using ldapmodify
You can modify most attributes in Table 9–1
, Table 9–2
, and Table 9–3
by using the command-line:
ldapmodify -D cn=orcladmin -q -p portNum -h hostname -f ldifFile The contents of the LDIF file depends on the DN and the operation being performed.
The LDIF file for changing the value of the orclgeneratechangelog attribute in the instance-specific entry to 1 would be:
dn: cn=componentname,cn=osdldapd,cn=subconfigsubentry changetype: modify
replace: orclgeneratechangelog orclgeneratechangelog: 1
The LDIF file for adding the orclinmemfiltprocess attribute to the DSA configuration entry would be:
dn: cn=dsaconfig, cn=configsets, cn=oracle internet directory changetype: modify
add: orclinmemfiltprocess orclinmemfiltprocess: objectclass=inetorgpersonorclisenabled=TRUE
Managing System Configuration Attributes 9-17
Listing Configuration Attributes with ldapsearch
You can use ldapsearch to list most attributes.
Instance-Specific Configuration Entry If the component name for a server instance is oid1,then you can list the attributes in
the instance-specific configuration entry with a command line such as:
ldapsearch -p 3060 -h myhost.example.com -D cn=orcladmin -q \ -b cn=oid1,cn=osdldapd,cn=subconfigsubentry -s base objectclass=
DSA Configuration Entry You can list the attributes with the command line:
ldapsearch -p 3060 -h myhost.example.com -D cn=orcladmin -q \ -b cn=dsaconfig,cn=configsets,cn=oracle internet directory \
-s base objectclass=
DSE You can list the attributes with the command line:
ldapsearch -p 3060 -h myhost.example.com -D cn=orcladmin -q \ -b -s base objectclass=
Notes:
■
In 11g Release 1 11.1.1, consecutive settings of orcldebugflag and of orcloptracklevel are additive.
■
Restart the server after changing orclskiprefinsql, orclskewedattribute, orclserverprocs,
orcldispthreads, orclmaxcc, orclpluginworkers, or any attribute with a name that begins with orclssl or orclsasl.
■
After changing orclnonsslport or orclsslport by using LDAP tools or ODSM, restart the server and run opmnctl
updatecomponentregistration, as described in Updating
the Component Registration of an Oracle Instance by Using opmnctl
on page 8-8.
See Also:
■
The Oracle Internet Directory chapter of Oracle Fusion Middleware Performance and Tuning Guide for more examples of
LDIF files
■
The ldapmodify command-line tool reference in Oracle Fusion Middleware Reference for Oracle Identity Management for a more
detailed discussion of ldapmodify, and a list of its options
■
The Oracle Identity Management LDAP Attribute Reference in Oracle Fusion Middleware Reference for Oracle Identity
Management for descriptions of the modifiable system configuration attributes.
9-18 Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory
Managing System Configuration Attributes by Using ODSM Data Browser
Oracle Enterprise Manager Fusion Middleware Control is the recommended graphical user interface for managing system configuration attributes. You can also use ODSM
to manage system configuration attributes, which can be useful if Fusion Middleware Control is not available or if you must modify an attribute that has no Fusion
Middleware Control interface.
See Managing Entries by Using Oracle Directory Services Manager
on page 13-1 for detailed instructions for changing the attributes of a directory entry. The following
sections explain how to get to the entries that contain system configuration attributes in ODSM.
Navigating to the Instance-Specific Configuration Entry
On the Data Browser tab, in the navigation tree, expand subconfigsubentry, then osdldapd. Then select the name of the Oracle Internet Directory component you want
to manage.
Navigating to the DSA Configuration Entry
On the Data Browser tab, in the navigation tree, expand oracle internet directory, then configsets, then select the entry dsaconfig.
Navigating to the DSE Root
On the Data Browser tab, click Root in the navigation tree to select the DSE.
10
Managing IP Addresses 10-1
10
Managing IP Addresses
This chapter discusses how to manage Oracle Internet Directorys IP addresses. It contains the following sections:
■
Introduction to Managing IP Addresses
■
Configuring an IP Address for IP V6, Cold Failover Cluster, or Virtual IP
Introduction to Managing IP Addresses
When you install Oracle Internet Directory on a dual stack IPV4IPV6 host, Oracle Internet Directory listens on both addresses. You cannot install Oracle Internet
Directory on a host with only an IPV6 address because the Oracle Database requires an IPV4 address to connect to.
If you install Oracle Internet Directory on an IPV4 host and then change the hosts address to IPV6, you must configure Oracle Internet Directorys IP address separately
to the IPV6 address by changing the orclhostname attribute in the instance-specific configuration entry.
If you must have Oracle Internet Directory listen on a specific address for some other reason, you also do that by changing the orclhostname attribute in the
instance-specific configuration entry.
Configuring an IP Address for IP V6, Cold Failover Cluster, or Virtual IP
Perform the following steps to configure Oracle Internet Directory to listen on a specific IP address:
1.
Create an LDIF file similar to this: dn: cn=COMPONENT_NAME, cn=osdldapd, cn=subconfigsubentry
changetype: modify replace: orclhostname
orclhostname: IP_address
2.
Execute the following ldapmodify command: ldapmodify -D cn=orcladmin -q -p portNum -h hostname -f ldifFile
3.
Restart Oracle Internet Directory by using opmnctl, as follows: opmnctl stopall
opmnctl startall
10-2 Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory
4.
Update the registration of the Oracle Internet Directory component, as described in
Updating the Component Registration of an Oracle Instance by Using opmnctl on page 8-8. For example:
ORACLE_INSTANCEbinopmnctl updatecomponentregistration \ -adminHost myhost \
-adminPort 7001 \ -adminUsername weblogic \
-componentType OID \ -componentName oid2\
-Port 3061
If you fail to perform this step, you will be unable to use Fusion Middleware Control or wlst to manage that component.
You can also use ODSM to change the orclhostname attribute in the instance-specific configuration entry. See
Managing System Configuration Attributes by Using ODSM Data Browser
on page 9-18.
11
Managing Naming Contexts 11-1
11
Managing Naming Contexts
To enable users to search for specific naming contexts, you can publish those naming contexts. This section contains these topics:
■
Introduction to Managing Naming Contexts
■
Searching for Published Naming Contexts
■
Publishing a Naming Context
Introduction to Managing Naming Contexts
See Naming Contexts
on page 3-14 for a description of naming contexts. To publish a naming context, you specify the topmost entry of each naming context as
a value of the namingContexts attribute in the root DSE. For example, suppose you have a DIT with three major naming contexts, the topmost entries of which are c=uk,
c=us, and c=de. If these entries are specified as values in the namingContexts attribute, then a user, by specifying the appropriate filter, can find information about
them by searching the root DSE. The user can then focus the search—for example, by concentrating on the c=de naming context in particular.
Searching for Published Naming Contexts
To search for published naming contexts, perform a base search on the root DSE with objectClass = specified as a search filter. The retrieved information includes those
entries specified in the namingContexts attribute. For example:
ldapsearch -p 3060 -q -D cn=orcladmin -b -s base -L objectclass= \ namingcontexts
Before you publish a naming context, be sure that:
■
You are a directory administrator with the necessary access to the root DSE.
■
The topmost entry of that naming context exists in the directory.
Note: This command will not return anything unless naming
contexts have been published.
11-2 Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory
Publishing a Naming Context
You use ldapmodify to publish a naming context. The namingContexts attribute is multi-valued, so you can specify multiple naming contexts.
You can modify namingContexts by using the command-line: ldapmodify -D cn=orcladmin -q -p portNum -h hostname -f ldifFile
The following sample LDIF file specifies the entry c=uk as a naming context. dn:
changetype: modify add: namingcontexts
namingcontexts: c=uk
12
Managing Accounts and Passwords 12-1
12
Managing Accounts and Passwords
This chapter contains these topics:
■
Introduction to Managing Accounts and Passwords
■
Managing Accounts and Passwords by Using Command-Line Tools
■
Managing Accounts and Passwords by Using the Self-Service Console
■
Listing and Unlocking Locked Accounts by Using Oracle Directory Services Manager
■
Changing the Superuser Password by Using Fusion Middleware Control
■
Creating Another Account With Superuser Privileges
■
Managing the Superuser Password by Using ldapmodify
■
Changing the Oracle Internet Directory Database Password
■
Changing the Password for the EMD Administrator Account
■
Changing the Password for the ODSSM Administrator Account
Introduction to Managing Accounts and Passwords
This chapter describes some administrative tasks related to accounts and passwords.
Using command-line tools or the Self-Service console, you can temporarily disable a users account, then enable it again. If you are a member of the Security
Administrators Group, then you can unlock an account without resetting the user
See Also:
■
Chapter 13, Managing Directory Entries
■
Chapter 28, Managing Password Policies
■
Changing the Replication Administrators Password for Advanced Replication
on page 41-26
Note: All references to the Self-Service console in this chapter refer to
the console included with Oracle Delegated Administration Services 10g 10.1.4.3.0 or later, which is compatible with Oracle Internet
Directory 11g Release 1 11.1.1. See Oracle Identity Management Guide to Delegated Administration in the 10g 10.1.4.0.1 Library for more
information.
12-2 Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory
password. This saves you from having to explicitly tell the user the new password. The user can simply log in using the old password.
Using command-line tools, you can force users to change their passwords when they log in for the first time.
If you forget your password or become locked out of your account, then you can reset your password. You do this by using the Self-Service Console. This involves
identifying yourself to the server by providing values for a set of password validation attributes. This takes the form of answering a password hint question to which you
had earlier specified an answer.
The Superuser is a special directory administrator with full access to directory information. The default user name of the superuser is orcladmin. The password is
set by the administrator during installation.
You can use either Oracle Enterprise Manager or ldapmodify to administer the Superuserpassword.
Another privileged account is the administrator, cn=emd admin,cn=oracle internet directory. This account is used for starting and stopping Oracle
Internet Directory server manageability information collection. It is also used by Oracle Enterprise Manager Fusion Middleware Control to make configuration changes
to Oracle Internet Directory. These changes are made over a secure connection.
The only way you can change this accounts password is to use the procedure documented in
Changing the Password for the EMD Administrator Account on
page 12-7. There is no support in the oidpasswd tool for changing this password.
Managing Accounts and Passwords by Using Command-Line Tools
This section contains these topics:
■
Enabling and Disabling Accounts by Using Command-Line Tools
■
Unlocking Accounts by Using Command-Line Tools
■
Forcing a Password Change by Using Command-Line Tools
Enabling and Disabling Accounts by Using Command-Line Tools
You can temporarily disable a users account, then enable it again, by using command-line tools.
To permanently disable the account, set the orclisenabled attribute to DISABLED. Setting this attribute to any other value enables the account.
To enable the account after you have disabled it, delete this attribute from the entry. To enable the account for a specific period, set the orclActiveStartDate and
orclActiveEndDate attributes in the user entry to the proper value in UTC Coordinated Universal Time format. For example, you could use a command line
such as:
Note: Oracle recommends that you change the password
immediately after installation.
See Also: Chapter 29, Managing Directory Access Control
for information on how to set access rights
Managing Accounts and Passwords 12-3
ldapmodify -p port -h host -D cn=orcladmin -q -v -f my.ldif where my.ldif contains:
dn:cn=John Doe,cn=users,o=my_company,dc=com orclactivestartdate:20030101000000z
orclactiveenddate: 20031231000000z
In this example, John Doe can log in only between January 1, 2003 and December 31, 2003. He cannot login before January 1, 2003 or after December 31, 2003. If you want to
disable his account for the period between these dates, then set the orclisenabled attribute to DISABLED.
Unlocking Accounts by Using Command-Line Tools
If you are a member of the Security Administrators Group, then you can unlock an account without resetting the user password. This saves you from having to explicitly
tell the user the new password. The user can simply log in using the old password.
To unlock an account, set the orclpwdaccountunlock attribute to 1. The following example unlocks the account for user John Doe.
ldapmodify -p port -h host -D cn=orcladmin -q -v -f file.ldif where file.ldif contains:
dn: cn=John Doe,cn=users,o=my_company,dc=com changetype: modify
add: orclpwdaccountunlock orclpwdaccountunlock: 1
Forcing a Password Change by Using Command-Line Tools
You can force users to change their passwords when they log in for the first time. To do this, set the pwdMustChange attribute in the pwdpolicy entry to 1, and then reset
the password. If you do this, you must explicitly tell the user the new password so that the user can log in to change that password.
Managing Accounts and Passwords by Using the Self-Service Console
For administrators, Oracle Directory Services Manager is the primary tool for managing users and passwords.
You can also use Oracle Identity Manager to centralize user and account provisioning to Oracle Internet Directory 11g Release 1 11.1.1. For end user self-service, Oracle
Identity Manager is the recommended solution. The Oracle Identity Manager documentation is available on Oracle Technology Network at:
http:www.oracle.comtechnologydocumentationoim.html
See Also:
■
Resetting Your Own Password by Using the Oracle Internet Directory Self-Service Console
on page 12-4for instructions on resetting passwords
■
Setting Password Policies by Using Command-Line Tools on
page 28-12 for instructions on setting attributes of a password policy
12-4 Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory
Customers who already have Oracle Delegated Administration Services in their environment can use it for end user self-service with Oracle Internet Directory 11g
Release 1 11.1.1. However, 10g is the terminal release for Oracle Delegated Administration Services, and the component is deprecated in 11g and later releases.
This section contains these topics:
■
Enabling and Disabling Accounts by Using the Oracle Internet Directory Self-Service Console
■
Unlocking Accounts by Using the Oracle Internet Directory Self-Service Console
■
Resetting Your Own Password by Using the Oracle Internet Directory Self-Service Console
Enabling and Disabling Accounts by Using the Oracle Internet Directory Self-Service Console
You can temporarily disable a users account, then enable it again, by using the Oracle Internet Directory Self-Service Console.
Unlocking Accounts by Using the Oracle Internet Directory Self-Service Console
If you are a member of the Security Administrators Group, then, if an account becomes locked, you can unlock it without resetting the user password. This saves you from
having to explicitly tell the user the new password. The user can simply log in by using the old password.
Resetting Your Own Password by Using the Oracle Internet Directory Self-Service Console
If you forget your password or become locked out of your account, then you can reset your password. This involves identifying yourself to the server by providing values
for a set of password validation attributes. This takes the form of answering a password hint question to which you had earlier specified an answer.
Listing and Unlocking Locked Accounts by Using Oracle Directory Services Manager
You can use Oracle Directory Services Manager to list and unlock locked accounts.
1.
Invoke Oracle Directory Services Manager as described in Invoking Oracle
Directory Services Manager on page 7-9, and
See Also: The section on managing accounts in Oracle Identity
Management Guide to Delegated Administration in the 10g 10.1.4.0.1 library for instructions on enabling and disabling accounts by using
the Oracle Internet Directory Self-Service Console
See Also:
The section on managing accounts in Oracle Identity Management Guide to Delegated Administration in the 10g 10.1.4.0.1
library for instructions on using the Oracle Internet Directory Self-Service Console to unlock accounts
See Also: The section on resetting your password if you forget it
in Oracle Identity Management Guide to Delegated Administration in the 10g 10.1.4.0.1 library for instructions on using the Oracle
Internet Directory Self-Service Console to reset your password
Managing Accounts and Passwords 12-5