Login

Stores the username and password for the datastore back end in a file in the administrator's home directory. This username and password can then be used in future invocations of pgtool.

The credentials are stored in a file named .apocpass in the administrator's home directory. If this file already exists and it does not have the correct permissions, then the command exits with an error. If a username is entered, the administrator is prompted for a password, otherwise the administrator is prompted for a username and a password. The username and password is authenticated using anonymous access to the datastore. If anonymous access is not supported, then the administrator is prompted to enter an authorized username and a password. If authentication by the authorized username fails, then the command exits with an error. Once authenticated, the user/password pairs are stored in the administrator's .apocpass file. The password is stored using a key made up of a combination of host/port/base bootstrapping information and the username. The bootstrapping file may be specified as an option argument, otherwise the bootstrapping information may be specified using the other options above. If neither methods are used, then the bootstrapping information is obtained from the default bootstrapping file installed with the pgtool. If bootstrapping information is not available or the credentials file cannot be created then the command exits with an error. If the credentials file is successfully created, then it is not necessary to specify username and password for subsequent pgtool commands using this storage back end: the username and password details stored in the credentials file are used.

Syntax

login [--username=<name>] [--file=<bootsrap file>] [--hostname=<hostname>] [--port=<portnumber>] [--base=<base name>] [--type=<type of back end>]

--username=<name> : the username of the administrator in the format used by the configuration repository, for example "jmonroe".

--file=<bootstrap file> : fully qualified path to a bootstrapping file.

--hostname=<hostname> : name of the host for the required storage back end. This is used instead of corresponding information supplied by the bootstrapping file.

--port=<port number> : port number used by this storage back end.

--base=<base name> : base for this storage back end, e.g. baseDN for an LDAP back end.

--type=<type of back end> : defaults to LDAP.

Example 3–7 Login

% pgtool login --username=jmonroe [Enter the correct password when prompted]

A file called ~/.apocpass created with entry for “jmonroe” and “password”, file has permissions 600