Table of Contents


Installation Manual for the passwdd/passwdc Package


Extracting the software

The distribution of passwdd is in the form of a gzipped tar file. The name of the file will be something like passwdd-0.06.tar.gz. To extract, you can use either the GNU tar command as follows:

nova:~$ tar xzf tarfile.tar.gz

If you do not have GNU tar, you can do the following:

nova:~$ gunzip -c tarfile.tar.gz | tar xf -

In either case, a new directory will be created under which the distribution will be extracted. The directory it creates will be passwdd- followed by the version number.

Configure

Once the distribution has been extracted, change to the newly created directory. In this directory you will need execute the configure program:

nova:~/passwdd-0.07$ ./configure

This program will attempt to determine what your particular system can and can't do.

The following options are recognized:

--with-cgi-bin-dir=DIR Where to install the cgi-bin scripts.
--with-html-dir=DIR Where to put the html forms for the cgi scripts.
--with-html-rel-dir=DIR The forms directory from the viewpoint of the web server.
--exec-prefix=DIR Base directory for architecture dependent files.
--prefix=DIR Base directory for architecture independent files.
--enable-PLAIN_PASSWORDS Disable using crypted passwords in the process of authentication.

The installation process will copy all PERL programs and modules in the directory supplied with the --with-cgi-bin-dir=DIR option to the configure script. An HTML form for every utility will be copied to the directory given with the --with-html-dir=DIR parameter. In addition to the above option you have to use the option --with-html-rel-dir=DIR.

Compile

The configure program will have created Makefiles in all the important directories. Now build the complete system with:

nova:~/passwdd-0.07$ make

(Relax for a while...)

Install

Everything should have built at this point. For the installation process to complete successfully you need to gain super-user rights.

nova:~$ su
Password: <password>

To install the server and console client, you need to execute:

nova:/home/alex/passwdd-0.07# make install

To install the cgi client, you need to execute:

nova:/home/alex/passwdd-0.07# make install-cgi

Note: There is a little chance that the cgi and document directories of your http server will match the defaults for the install script. If you are planning to use the cgi client give the necessary options to the configure script.

On each server, on which you are installing the package, generate crypto keys:

nova:/home/alex/passwdd-0.07# rsakeys

On each destination host edit the appropriate configuration file:

nova:/home/alex/passwdd-0.07# vi /etc/passwdd.conf
nova:/home/alex/passwdd-0.07# vi /etc/passwdc.conf