DSRUTIL utility

Syntax

DSRUTIL db-name -C ACTION[Server | Agent][name | ALL]
[ -Passphrase ]

DSRUTIL db-name -C ACTION[Server | Agent][name | ALL]
[ -Passphrase ] [-Pin]

Parameters

db-name

Specifies the name of the database on which to perform the action. It must be the first argument and a valid name.

-C action

Specifies the action to be performed on the database. You can supply the qualifiers described in Table 1.

Server | Agent

Specifies that the action will be performed on the OpenEdge Replication server or the OpenEdge Replication agent.

name | ALL

Specifies that the action will be performed on either OpenEdge Replication agent (name) or all OpenEdge Replication agents (ALL). Each OpenEdge Replication server maintains a list of named OpenEdge Replication agents with which it is communicating. The agent name must be valid.

-Passphrase

For encryption-enabled databases only, specifies to prompt for a passphrase to authenticate the keystore.

CAUTION: If your database is enabled for TDE and configured for manual start, you must specify -Passphrase every time the database is opened.

For more information on encryption and keystore authentication, see Manage the OpenEdge Database.

-Pin

After you enable HSM as a secondary authentication requirement for a TDE-enabled database, both passphrase and PIN are required to authenticate the keystore.

The command actions and modifiers you can use with the DSRUTIL utility are listed in the following table and described in the following sections.