INSTALL

Installation

There are 2 types of installation: (1) stand-alone, (2) client-server
(See README for details). You can use each type separetly or you can
use them together.

The simplest way to install this package is:
1. untar the distribution and cd to the top:

    % gzip -d -c apg-2.X.XX.tar.gz | tar xf -
    % cd apg-2.X.XX

If you are reading this file, you probably have already done this!

2. Edit the Makefile

3. make the software:

   For stand-alone:

      % make standalone

   For client-server:

      % make cliserv

   For both:

     % make all

During the make process compiler will generate some warnings
Just ignore this fact. I'm working to fix them.

4. install the binaries and man pages. You may need to be superuser
to do this (depending on where you are installing things):

     % su
     # make install

5. You can remove the program binaries and object files from the
source code directory by typing

     % make clean

NOTE: THE REST IS FOR CLIENT-SERVER INSTALLATION ONLY !!!

6. Modify your /etc/inetd.conf file to contain the line below.
You may have to modify it to support your version of the file.

     pwdgen stream tcp nowait nobody /usr/local/sbin/apgd apgd [options]

or
     pwdgen stream tcp nowait nobody /usr/sbin/tcpd /usr/local/sbin/apgd [options]

if you use tcp_wrapers. (for options see apgd(8) manpage)

For all OS versions you must modify, your /etc/services file needs
to include the following line:

     pwdgen     129/tcp        # PWDGEN service

7. Restart inetd with a

    # kill -HUP inetdpid

8. Configure your syslogd daemon to handle events `daemon.info' and
`daemon.debug' see syslogd(8) and syslog.conf(5)

9. Check that apgd is working

    % telnet your.host.name 129

or

    % telnet your.host.name pwdgen

10. Customize your apgcli.pl - APG client
Edit apgcli.pl file that can be found in src/perl directory of
source distribution tree

----------------------------------> src/perl/apgcli.pl
#!/usr/bin/perl -w                 # Put here the real location of perl
$host = "localhost";               # Put here the name of your APG server
use IO::Socket;
$remote = IO::Socket::INET->new(
    Proto => "tcp",
    PeerAddr => $host,
    PeerPort => "pwdgen(129)",
    )
    or die "cannot connect to pwdgen port at $host";
while ( <$remote> ) { print }
----------------------------------> src/perl/apgcli.pl

END