Oracle® Identity Management User Reference
10g Release 2 (10.1.2) B15883-01 |
|
Previous |
Next |
Oracle Internet Directory uses indexes to make attributes available for searches. When Oracle Internet Directory is installed, the cn=catalogs
entry lists available attributes that can be used in a search. You can index only those attributes that have:
An equality matching rule
Matching rules supported by Oracle Internet Directory (see "Matching Rules")
If you want to use additional attributes in search filters, then you must add them to the catalog entry. You can do this at the time you create the attribute by using Oracle Directory Manager. However, if the attribute already exists, then you can index it only by using the Catalog Management Tool (catalog.sh
).
Before running catalog.sh
, be sure that the directory server is either stopped or in read-only mode.
Caution: Do not use thecatalog.sh -delete argument on indexes created by the Oracle Internet Directory base schema. Removing indexes from base schema attributes can adversely impact the operation of Oracle Internet Directory.
|
catalog.sh -connect connect_string {-add | -delete} {-attr attr_name |-file file_name}
-connect connect_string
Required. The directory database connect string. If you already have a tnsnames.ora
file configured, then this is the net service name specified in that file, which is located in $
ORACLE_HOME
/network/admin
.
-add | -delete
Required. The operation to perform. The -add
argument indexes the specified attribute. The -delete
argument drops the index for the specified attribute.
-attr attr_name | -file file_name
Required. The attribute or attributes to catalog. Use the -attr
argument to specify a single attribute name on the command-line. Use the -file
argument to provide the full path and file name of a file that contains a list of several attribute names.
Using the catalog.sh
tool, you can perform the following tasks:
The following example shows how to add a single attribute to the index. The catalog.sh
tool will prompt you for the Oracle Internet Directory super user password.
Example:
catalog.sh -add -attr orclGender
The following example shows how to add multiple attributes to the index at once by supplying a file that contains a list of attribute names. The catalog.sh
tool will prompt you for the Oracle Internet Directory super user password.
Example:
catalog.sh -add -file ~/myfiles/attrs.txt