Changeset 13797


Ignore:
Timestamp:
01/23/12 22:20:57 (4 weeks ago)
Author:
GeorgeClark
Message:

Item11467: Restore Perl deps to SystemRequirements

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/core/data/System/SystemRequirements.txt

    r13122 r13797  
    2424A complete list of the required and optional Perl modules can be found in =lib/DEPENDENCIES=. 
    2525 
     26The following CPAN modules are not shipped with Foswiki. Note that Foswiki extensions may add additional requirements. 
     27Modules marked as Required may still be optional if certain default core features are not used. 
     28 
     29| *Module* | *Required/Optional* | *Description* | 
     30| CGI::Session | Required | Sessions support is usually required. | 
     31| HTML::Entities | Required | Used for [[Foswiki:Extensions.WysiwygPlugin][WYSIWYG Editing]] | 
     32| HTML::Parser | Required | Used for [[Foswiki:Extensions.WysiwygPlugin][WYSIWYG Editing]] | 
     33| HTML::Tree | Required | Used by CompareRevisionAddOn. | 
     34| URI | Required | Used for email notifications of topic changes. [[Foswiki::Extensions.MailerContrib][MailerContrib]] | 
     35| LWP | Required | Used by the Configure Extensions Installer, and for external URL based INCLUDEs | 
     36| Digest::SHA | Optional | Required to use SHA1 password encoding, since Perl 5.9.3 part of core | 
     37| Crypt::PasswdMD5 | Optional | Required to use Apache or Crypt MD5 password encoding, and crypt encoding on Windows | 
     38| Digest::SHA1 | Optional | Required by the Foswiki FileCache feature | 
     39| Win32::Console | Optional | May be required for I18N on Windows | 
     40| Archive::Tar | Optional | Required by the Extensions Installer in configure if command line tar or unzip is not available, since Perl 5.9.3 part of core. | 
     41| Archive::Zip | Optional | Alternative to Archive::Tar, used by the Extensions Installer if Archive::Tar and command line tar and unzip also unavailable | 
     42| Net::SMTP::SSL | Optional | Required by Net::SMPT to send email over SSL to providers such as gmail. | 
     43| Authen::SASL | Optional | Required by Net::SMTP if email server requires authentication. | 
     44 
     45 
    2646Most of them will probably already be available in your installation. You can check version numbers with the =configure= script, or if you're still trying to get to that point, check from the command line like this: 
    2747<verbatim class="bash"> 
    2848perl -e 'use FileHandle; print $FileHandle::VERSION."\n"' 
    2949</verbatim> 
     50For more detailed dependency information, try the script =dependencies_installer.pl= located in the =tools= directory, which makes perl module installation easier. Run it with option =-h= to understand basics. This script requires confirmation before it actually does something. 
    3051 
     52---++ Specific distribution details 
     53<noautolink> 
     54%TWISTY{ showlink="Show Debian / Ubuntu information" hidelink="Hide Debian details"}% 
     55---+++!! Ubuntu and other Debian derived distributions 
     56 
     57Install apache and rcs ==apt-get install apache2 rcs== 
     58 
     59| *Perl Module* | *Package to install* | *Notes* | 
     60| CGI::Session | =libcgi-session-perl= | | 
     61| HTML::Parser | =libhtml-parser-perl= | | 
     62| HTML::Entities | | included with HTML::Parser | 
     63| HTML::Tree | =libhtml-tree-perl= | | 
     64| LWP | =libwww-perl= | | 
     65| Digest::SHA | =libdigest-sha-perl= | | 
     66| Digest::SHA1 | =libdigest-sha1-perl= | | 
     67| URI | =liburi-perl= | | 
     68| Crypt::PasswdMD5 | =libcrypt-passwdmd5-perl= | | 
     69| Net::SMTP::SSL | =libnet-smtp-ssl= | | 
     70| Authen::SASL | =libauthen-sasl= | note, broken on Ubuntu 11.10 x64.  Install using CPAN! | 
     71 
     72After expanding the Foswiki archive, change the ownership of the files: 
     73   * Debian, Ubuntu, Kubunto: =chown -R www-data:www-data /path/to/foswiki= 
     74 
     75%ENDTWISTY{}% 
     76 
     77%TWISTY{ showlink="Show RetHat, SuSE and other RPM details" hidelink="Hide RPM details"}% 
     78---+++!! RedHat, SuSE, CentOS and other RPM based distributions 
     79 
     80Install apache2, rcs, and perl-CPAN 
     81 
     82| *Perl Module* | *Package to install* | *Notes* | 
     83| CGI::Session | =perl-CGI-Session= | | 
     84| HTML::Parser | =perl-HTML-Parser= | | 
     85| HTML::Entities | | included with HTML::Parser | 
     86| HTML::Tree | =perl-HTML-Tree= | | 
     87| LWP | =perl-libwww-perl= | | 
     88| Digest::SHA | =perl-Digest-SHA= | | 
     89| Digest::SHA1 | =perl-Digest-SHA1= | | 
     90| URI | =perl-URI= | | 
     91| Crypt::PasswdMD5 | =perl-Crypt-PasswdMD5= | | 
     92| Net::SMTP::SSL | =perl-Net-SMPT-SSL= | | 
     93| Authen::SASL | =perl-Authen-SASL= | | 
     94 
     95After expanding the Foswiki archive, change the ownership of the files: 
     96   * RedHat, Fedora, CentOS Mandriva: chown -R apache:apache /path/to/foswiki= 
     97   * Suse: =chown -R wwwrun:www /path/to/foswiki= 
     98 
     99%ENDTWISTY{}% 
     100 
     101</noautolink> 
    31102#ClientRequirements 
    32103---++ Client Requirements 
Note: See TracChangeset for help on using the changeset viewer.