This is an old revision of the document!


A Working Perl Installation is Required

Regardless of the OS, you must have a working Perl installation to use the cross-platform version of POPFile.

  • Windows users must have Perl 5.8.0 or above, available from ActiveState
  • All other users must have Perl 5.6.0 or above, available from Perl Org (Perl 5.7.3 or above, if you want Japanese/Korean language support)

Certain Perl Modules are Required

POPFile uses certain modules that may not be installed on your system by default. All of these modules are easily located at CPAN and can typically be installed using the following commands;

  ppm
  ppm>install Modulename
  ppm>quit

  
  • Other OS Users (Note: You should be logged in as root (superuser) when installing these modules).
  perl -MCPAN -e shell
  cpan>install Modulename
  cpan>quit

Note: If you get a “Not OK” error on the “Make” during install see the following SuSE example. SuSE sample walkthru here

The current list of modules that you may need to install includes the following:

  1. DBD::SQLite (if you are using the default SQLite for the backend database)
    1. IMPORTANT NOTE: There are two incompatible flavours of SQLite: 2.x and 3.x. POPFile 1.1.0 (or later) uses SQLite 3.x therefore it requires DBD::SQLite v1.00 or later (1.1.0 was tested using v1.13 and v1.14). POPFile 0.25.0 to 1.0.1 used SQLite 2.x and requires DBD::SQLite v0.31 which is the last version of DBD::SQLite based upon SQLite 2.x. (To use that old version, you will need to specify the full path when you install from CPAN, e.g., cpan> install M/MS/MSERGEANT/DBD-SQLite-0.31.tar.gz) More detail can be found here
  2. DBD::SQLite2 (if you are using any POPFile version between 0.22.5 and 1.0.1 or upgrading to 1.1.0 (or later) from 0.22.0, 0.22.1, 0.22.2, 0.22.3, 0.22.4, 0.22.5, 1.0.0 or 1.0.1)
  3. DBD::mysql (if you are using MySQL for the backend database)
  4. Date::Parse (all platforms except Windows)
  5. Text::Kakasi (if you want Japanese language support)
  6. Encode (if you want Japanese/Korean language support)
  7. IO::Socket::Socks (if you want to use a SOCKS proxy)
  8. IO::Socket::SSL (if you want to use SSL)
  9. Net::SSLeay (if you want to use SSL)
  10. TimeDate (on Windows only)
  11. SOAP::Lite (if you want to use XMLRPC)

If you want to use SSL you'll also need OpenSSL (http://www.openssl.org/). Windows users just need two OpenSSL DLLs (ssleay32.dll and libeay32.dll).

Checking to See if a Module is Already Installed

To check and determine whether or not a particular module is already installed on your system, issue the following Perl one-liner. If you get a version number back, it's installed. If you get a Perl message Can't locate Modulename.pm in @INC back, then it is not installed (or you have a typo).

   perl -MMIME::Base64 -e 'print $MIME::Base64::VERSION'
   perl -MMIME::QuotedPrint -e 'print $MIME::QuotedPrint::VERSION'

Checking Your Version of Perl

To check the version of Perl that is installed on your system, issue the following one-line command;

   perl -v

Sample ActivePerl-5.8.4.810 (ActiveState) Win32 Basic Install

Install ActivePerl-5.8.4.810 Switch to the /perl/bin directory Type PPM

  PPM>Install DBI
  PPM>Install timedate
  PPM>Install html-template
  PPM>Install dbd-sqlite2
  PPM>q

Install Popfile 0.22.1 and adjust configuration for SQLite2. There is a detailed explanation of the SQLite2 and SQLite3 issue here

You now have a functional Popfile configuration. If you plan to use additional Popfile modules or services you may have to add additional perl modules.

Sample SuSE 9.1 Personal Basic Install

SuSE 9.1 Personal does not come with Development Utilities e.g., “make”. The “Not OK” error from a cpan install is a sign in any distro that “make” is missing or not found.

Install Gcc and make (including dependencies) with YAST2.

Configure CPAN to find “make” from the console as a super user.

  perl -MCPAN -e shell
  cpan>o conf init  (note:the default for all questions works as long as "make" is found)
  cpan>quit

Then install modules from the console as a super user.

  perl -MCPAN -e shell
  cpan>install DBI
  cpan>install DBD::SQLite2
  cpan>install HTML::Template
  cpan>install Date::Parse
  cpan>quit

Install Popfile 0.22.1 and adjust configuration for SQLite2. There is a detailed explanation of the SQLite2 and SQLite3 issue here

You now have a functional Popfile configuration. If you plan to use additional Popfile modules or services you may have to add additional perl modules.

 
howtos/allplatformsrequireperl.1241387180.txt.gz · Last modified: 2009/05/03 23:46 (external edit)

Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.

Recent changes RSS feed Donate Driven by DokuWiki
The content of this wiki is protected by the GNU Fee Documentation License