Command Line Interface Utilities : btadmin
 
btadmin
Description
The btadmin tool 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, the supplied default is admin with an empty password.
Use btadmin to add more administrators:
% btadmin [-p password] [a+] username
This tool creates a record in the file btpasswd for user username with password password (if the option -p is not used, then you are asked to enter a password). If a user already exists, then the 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-.