rgy_passwd

Creates or changes encrypted VOB tag registry password

Applicability

Product

Command type

VersionVault

command

Platform

UNIX

Linux

Windows

Synopsis

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

Description

UNIX and Linux systems

The rgy_passwd command places an encrypted password in the VOB tag password file: /var/adm/hcl/versionvault/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 VersionVault 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\WOW6432Node\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 and Linux: 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. 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.
Important: This is a security risk because the password remains visible.

UNIX and Linux files

/var/adm/hcl/versionvault/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/hcl/versionvault/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>