Resource Description Subcommands

Description

The RD subcommands allow an administrator a batch process to insert or replace RDs, merge RDs filtered by a view, retrieve RDs filtered by a view, delete RDs and count RDs.

Subcommands

The following table lists the subcommand in the first column with a brief description in the second column.

-d

Delete RDs.

-g

Retrieve RDs filtered by a view.

-m

Merge RDs filtered by a view.

-n

Count the RDs

-u

Insert or replace RDs. This subcommand is the default subcommand if none is stated.

-U

Dump database in search result to stdout.

-L

Lists selected fields from the database to stdout. Requires the -a att option.

If you enter rdmgr with no subcommand, the command assumes the -u subcommand. If you enter rdmgr with no subcommand and a query (-Q), the command assumes the -g subcommand.

Syntax

rdmgr [-u|m|g|d|n|U|L] [-ACSTNPq] [-a att,att,...] [-b number] [-c search.conf] [-i charset] [-o charset] [-j number] [-l number] [-p progress] [-r number] [-s schema] [-y dbname] [filename|-Q query]

Options

The following is a two-column table that lists the options or arguments in the first column with a brief description in the second column. The following options are supported:

-A

Do not use schema aliases in config/schema.rdm file in the default search directory. Use with the u and m subcommands.

-C

Do not create database if database is missing. Use with the u and m subcommands.

-S

Disable schema checking. Use with the u and m subcommands.

-T

Operate on the taxonomy. The taxonomy is used for browsing and classifying the database contents and is in the config/taxonomy.rdm file in the default search directory. Use with any resource description command.

-N

The function you specified in the command works only on the non-persistent data in the resource description. RDs in the database are a merge of persistent and non-persistent data.

-P

The function you specified in the command works only on the persistent data in the resource description. RDs in the database are a merge of persistent and non-persistent data.

-q

Delete search result input file on exit. Use with the u, m, g and d subcommands.

-a att, att...

Specifies attribute view list. The att names are not case sensitive and can be any attribute whether or not they are defined in the schema; for example, author or title. If you have a multi-valued att like class-1, class-2, and class-3, only enter class as the att name.

-b number

Set the indexing batch size to this number of RDs. Use with the u and m subcommands.

-c search.conf

Specify where the search.conf file is. If you do not use this option, the default is the config/search.conf file in the default search directory. Other wise, you have to give the full path to the file.

-i charset|-o charset

The -i option specifies the character set of the input search result stream.

The -o option specifies the character set of the output search result stream.

For example, ISO8859-1, UTF-8, UTF-16. Character sets ISO8859-1 through ISO8859-15 are supported. Use -i with the u, m, and d subcommands. Use -o with the g, U, and L subcommands.

-j number

Limits the number of retrieved results. Use with the u subcommand. If not stated, the default value is unlimited except with the Q option (default 20).

-l number

Set log level to number. A setting of 1 (default) logs all the rdmgr commands. The higher the number the more detail the log file contains. The possible levels are 1- 100. This works with all subcommands.

-p {stdout|stderr| filename}

Prints or displays progress to stdout, stderr or the filename file. This works with all subcommands. Timing information is reported in seconds.

-r number

Use with the progress option. A report is generated every number of RDs. The default is 500. Use with the u, m, g, d and U subcommands.

-s schema

Specifies the schema definition file. If you do not use this option, the default is the config/schema.rdm file in the search server instance directory.

-y dbname

Specifies the search database name. If you are running this command on any database other than the default one, you need to use this option. The default database is the database defined in the config/search.conf file labeled datbase-name=logicaldbname.

filename|-Q query

This input option is used with the u, m, g and d subcommands.

The filename is a file of RDs using the default schema (use -s option for any other schema) in search result format.

The query is any regular search query.

Examples

Example 1

In the following example, the entire default database of resource descriptions is printed out to stdout in UTF-8 search result format.

Set environment variable LD_LIBRARY_PATH to PortalServer-base/lib. In the /var/opt/SUNWportal/searchservers/search-server-id directory, type:

PortalServer-base/bin/rdmgr -U

Example 2

In the following example, all the resource descriptions that have java any where in them are deleted.

In the default search directory of /var/opt/SUNWportal/searchservers/search-server-id, type:

PortalServer-base/bin/rdmgr -d -Q java