APG DOCUMENTATION


[ ADEL'S HOMEPAGE | APG HOME | DOCUMENTATION | DOWNLOAD | LINKS | THANKS | APG ONLINE ]

Installation for *NIX

There are 2 types of installation: (1) standalone, (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 standalone:

% 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
[ ADEL'S HOMEPAGE | APG HOME | DOCUMENTATION | DOWNLOAD | LINKS | THANKS | APG ONLINE ]