4.4 catalog.sh

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 the catalog.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.

4.4.1 Syntax for catalog.sh

catalog.sh -connect connect_string {-add | -delete} {-attr attr_name |-file file_name}

4.4.2 Arguments forcatalog.sh

-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.

4.4.3 Tasks and Examples for catalog.sh

Using the catalog.sh tool, you can perform the following tasks:

• Adding a Single Attribute to the Index

• Adding Multiple Attributes to the Index at Once

• Removing a Single Attribute From the Index

4.4.3.1 Adding a Single Attribute to the Index

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

4.4.3.2 Adding Multiple Attributes to the Index at Once

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

4.4.3.3 Removing a Single Attribute From the Index

The following example shows how to remove a single attribute from the index. The catalog.sh tool will prompt you for the Oracle Internet Directory super user password.

Example:

catalog.sh -delete -attr orclGender

4.4.4 Related Command-Line Tools for catalog.sh

• N/A