===========================================================================
== 3.1     Checking for the modules
===========================================================================

POD comes with a script called 'servertest.pl' which can check your
server to see that you have the appropriate modules installed and that
you have version 5.004 or later of Perl.


===========================================================================
== 3.1.1   Setting the path to Perl
===========================================================================

First of all, you need to tell servertest.pl where your Perl interpreter
is. If you aren't sure where Perl is, have a look at 'Appendix A -
Finding Perl'.

Now load servertest.pl into your text editor, and look at the first line:
 #!/usr/bin/perl
change this to reflect where your Perl interpreter is.

For example, if
 Your Perl Interpreter is in:      Then this line needs to read:
 /usr/bin/perl                     #!/usr/bin/perl
 /usr/perl/perl                    #!/usr/perl/perl
 /bin/perl                         #!/bin/perl

Now upload the script to your webspace (using ftp) and run it. Ideally
it should be uploaded into your cgi-bin .


===========================================================================
== 3.1.2   Running servertest.pl
===========================================================================

Now you've uploaded servertest.pl to your webspace, you need to run it.

This is easiest done via the command line, so just telnet to your server,
login and go to the directory that you have uploaded servertest.pl
into. Now type the following command:
 perl servertest.pl
If that doesn't work, try subsituting 'perl' for the full path
of your Perl interpreter.

If all works out, you should get the following text appear:

 Checking PERL version... OK
 Checking for CGI...OK
 Checking for HTTP...OK
 Checking for LWP...OK
 Everything is in place and functional. You can run POD version 1.70d
 Perl version is XXXX. CGI version is YYYY
 
if you get another message, please see section '3.1.3 - Modules
not installed' for advice.

If it all works, you can now delete servertest.pl safe in the
knowledge that if POD goes wrong, it isn't due to the incorrect
modules or Perl version. If you do have problems with POD, please
ensure you know the Perl version number and CGI version number
which is reported by servertest ('XXXX' and 'YYYY' respectively)


===========================================================================
== 3.1.3   Modules not installed
===========================================================================

If you don't get the

 Checking PERL version... OK
 Checking for CGI...OK
 Checking for HTTP...OK
 Checking for LWP...OK
 Everything is in place and functional. You can run POD version 1.70d
 Perl version is XXXX. CGI version is YYYY
 
message when running servertest.pl, you should get one of these
messages:


This program requires at least PERL version 5.004 or greater

 Reason:
  Your Perl interpreter is a too earlier version to cope with either
  POD or the modules is needs.
 Diagnostics:
  Install (or, more preferably, get your server administrator to)
  the version 5.004 or later of Perl. This can be found at the
  official Perl website at http://www.perl.com - try not to
  download the developmental versions unless you really really
  want to (they probably contain minor bugs and mistakes and
  hence aren't release quality).


The CGI module could not be located.  You will need to grab this
module from ftp.cpan.org/pub/perl/CPAN/modules/by-module/CGI/
CGI.pm-2.56.tar.gz and install it
 
 Reason:
  Servertest.pl was unable to find the Perl module CGI.
 Diagnostics:
  Download and install the CGI module from:
  ftp.cpan.org/pub/perl/CPAN/modules/by-module/CGI/CGI.pm-2.56.tar.gz
  The module is also available via:
  http://stein.cshl.org/WWW/software/CGI/
  where installation information is also given.
  Installation is best done by your server administrator


Could not find the HTTP::Request module.  You will need to grab this
module from ftp.cpan.org/pub/perl/CPAN/modules/by-module/HTTP/
HTTP-Request-Form-0.5.tar.gz and install it

 Reason:
  Servertest.pl was unable to find the Perl module HTTP::Request.
 Diagnostics:
  Download and install the HTTP module from:
  ftp.cpan.org/pub/perl/CPAN/modules/by-module/HTTP/
                                       HTTP-Request-Form-0.5.tar.gz
  or the entire libwww-perl library which contains this module from:
  http://www.linpro.no/lwp/
  Installation is best done by your server administrator


Could not find the HTTP::Response module.  You will need to grab this
module from ftp.cpan.org/pub/perl/CPAN/modules/by-module/HTTP/
HTTP-Request-Form-0.5.tar.gz and install it

 Reason:
  Servertest.pl was unable to find the Perl module HTTP::Response.
 Diagnostics:
  Download and install the HTTP module from:
  ftp.cpan.org/pub/perl/CPAN/modules/by-module/HTTP/
                                       HTTP-Request-Form-0.5.tar.gz
  or the entire libwww-perl library which contains this module from:
  http://www.linpro.no/lwp/
  Installation is best done by your server administrator
  
  
Could not find the LWP::UserAgent module.  You will need to grab this
module from ftp.cpan.org/pub/perl/CPAN/modules/by-module/LWP/
libwww-perl-5.47.tar.gz and install it

 Reason:
  Servertest.pl was unable to find the Perl module LWP::UserAgent.
 Diagnostics:
  Download and install the HTTP module from:
  ftp.cpan.org/pub/perl/CPAN/modules/by-module/LWP/
                                       libwww-perl-5.47.tar.gz
  or the entire libwww-perl library which contains this module from:
  http://www.linpro.no/lwp/
  Installation is best done by your server administrator