rgy_passwd
Creates or changes encrypted VOB tag registry password
Applicability
Product |
Command type |
|---|---|
ClearCase® |
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/devops/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\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/devops/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/devops/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>