btadmin

The btadmin utility is used to create and update the flat file btpasswd, which stores user names and passwords for authentication of PSQL users. Users given administrator rights can monitor engine status and configure the engine remotely.

Synopsis

btadmin [ -p password] [a+] [a-] [-r] username

Options


-p	Specify the password. If this option is not specified, you will be prompted to enter the password.
a+	Gives administrator rights for this user.
a-	Removes administrator rights for this user.
-r	Remove user name from btpasswd file.

username
Creates or updates the username in the btpasswd file. If username does not exist in this file, an entry is added. If it does exist, the password is changed.

See Also

butil(1)

Notes

To administer the engine from a remote workstation, you must supply a user name and password. Upon initial installation of PSQL v12, the supplied default is admin with an empty password.

Use btadmin to add more administrators:

% btadmin [-p password] [a+] username

This utility creates a record in btpasswd for user username with password password (if option -p is not used, then you will be asked to enter a password). If a user already exists, then his password is changed as specified.

By default a user is created without administration permissions. You can use the a+ option to give administration rights to the user. You can remove this right by using a-.

To remove a user record from the password file, enter:

% btadmin -r username

Every time the btpasswd file is changed, the previous version is backed up to btpasswd-.