keyutil

Process Keys

Allows user to view security key status, load keys, or delete keys for NPAC associations.

Keyword

keyutil

Permission

The user must be logged in with the user name lsmsadm.

Syntax

$LSMS_TOOLS_DIR/keyutil -r <region> -k {public|private} [-d] [-l <filename>] [-x <listid>] [-s <listid>, <keyid>] [-y]

Required Flags

-r <region>
Perform the function specified by another option for keys for the specified region, where <region> has one of the following values:
  • Canada
  • Midwest
  • MidAtlantic
  • Southeast
  • Southwest
  • Northeast
  • Western
  • WestCoast
-k {public|private}
Perform the function specified by another option for keys of either public type or private type.

One of the following options must be specified:

-d
Display all keys.
-l <filename>
Load keys from the specified <filename>.
-x <listid>
Delete keys in the specified list.
-s <listid>, <keyid>
Set the active key. All private keys for the specified region that occur in the specified list before the specified key are expired; all private keys for that region that occur in the specified list after the specified key are made valid.

Optional flags:

-y
Make changes without prompting.

Sample Output

$ keyutil -r Midwest -k public -l ../../TKLC.1.public.key
Customer ID: TKLC
List ID: 1
Ok to make changes? y
$

Related Commands

None.

Response Notes

None.

Possible Errors

Error Messages: keyutil

Exit Code

Error Message

Cause

Suggested Recovery

-1

SyntaxError

The command was entered with incorrect syntax.

Try the command again with correct syntax.

1

FileError

The key file to be opened could not be found.

Verify the file path. If necessary, correct the path and try the command again. If the problem persists, contact the My Oracle Support (MOS).

2

SaidNo

User answered no when prompted for changes.

No action necessary.

3

NoKeysFound

User specified keys to delete, but those keys were not found.

Contact the My Oracle Support (MOS).

4

DbError

Database exception occurred; contact Oracle.

Contact the My Oracle Support (MOS).

5

InvalidUser

A user who is not lsmsadm attempted to run this command.

Contact the My Oracle Support (MOS).

6

UnknownError

Not known.

Contact the My Oracle Support (MOS).