rgy_passwd

Creates or changes encrypted VOB tag registry password

APPLICABILITY

ProductCommand type
ClearCasecommand
ClearCase LTcommand

Platform
UNIX
Windows

SYNOPSIS

rgy_passwd [ –pas·sword tag-registry-password ]

DESCRIPTION

Note: In ClearCase LT, the registry server host is the ClearCase LT server host.

UNIX Systems

The rgy_passwd command places an encrypted password in the VOB tag password file: /var/adm/rational/clearcase/rgy/vob_tag.sec on the network's registry server host. This file need not already exist.

Knowledge of this password enables an administrator to create public VOBs. Nonprivileged users can mount public VOBs by using the ClearCase mount command. For more information about public VOBs, see the mkvob, mktag, and mount reference pages.

Windows Systems

The rgy_passwd command creates a Security subkey in the Windows Registry and places an encrypted VOB tag password in HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\Security\RegPasswd. The Security subkey and RegPasswd value exist only on the registry server host.

Knowledge of this password enables a user to create public VOBs. For more information about public VOBs, see the mkvob, mktag, and mount reference pages.

RESTRICTIONS

Identities

  • UNIX: If the vob_tag.sec file does not exist, you must be root. If the vob_tag.sec file exists, you must be the owner of that file.

    Note: rgy_passwd maintains the access mode of the vob_tag.sec file at 400. You need not use chmod(1) before or after entering rgy_passwd.

  • Windows: No special identity is required.

    Note: The administrator should apply a security access control list (ACL) to the Security subkey to prevent users from directly editing the password in the registry. We recommend that you assign full control to authorized users (users allowed to change the password; for example, the network administrator), and read permissions to all other users.

Locks

No locks apply.

Mastership

(Replicated VOBs only) No mastership restrictions.

Other

You must run rgy_passwd on the registry server host.

OPTIONS AND ARGUMENTS

By default, rgy_passwd prompts you to type the new password.

–pas·sword tag-registry-password
Specifies the password on the command line.

Caution: This is a security risk because the password remains visible.

UNIX FILES

/var/adm/rational/clearcase/rgy/vob_tag.sec

DIAGNOSTICS

rgy_passwd: Error: Not a registry server.

This command must be executed on the network's registry server host.

rgy_passwd: Error: Unable to open file
"/var/adm/rational/clearcase/rgy/vob_tag.sec": Permission denied. 

A vob_tag.sec file already exists, and you are not its owner.

EXAMPLE

  • Create a VOB tag registry password interactively.

    rgy_passwd 
    Password:
    <enter VOB tag password> 

SEE ALSO

mktag, mkvob, mount



Copyright© 2003 Rational Software. All Rights Reserved.