install module

2. Installing Perl Modules

LiveJournal requires several Perl modules to be installed. Installing these modules requires a fully working perl and C development environment (including a C compiler and make tool).

Note

Some modules such as GD and Compress::Zlib require certain system libraries to be pre-installed on your machine. Please read the author-provided README files for each module before proceeding further.

This may mean particular development packages need to be installed on your system, before a Perl module will install in CPAN. For example, on a Debian system, to install the optional Math::BigInt::GMP module, you should install libgmp3-dev first. Similarly, you may need to install the “development” packages for MySQL and GD on your system, before attempting to install the related Perl modules. The names of these packages varies between Linux distributions, but are often called -dev. Installing binary packages of modules provided through your Linux distribution is the easier option.

Table 6.1. Required Perl Modules

DateTime	libdatetime-perl
DBI	libdbi-perl
DBD::mysql	libdbd-mysql-perl
Class::Autouse	libclass-autouse-perl
Digest::MD5	libmd5-perl
Digest::SHA1	libdigest-sha1-perl
HTML::Template	libhtml-template-perl
Image::Size	libimage-size-perl
MIME::Lite	libmime-lite-perl
MIME::Words	libmime-perl
Compress::Zlib	libcompress-zlib-perl
Net::DNS	libnet-dns-perl
URI::URL	liburi-perl
HTML::Tagset	libhtml-tagset-perl
HTML::Parser	libhtml-parser-perl
LWP::Simple	libwww-perl
LWP::UserAgent	libwww-perl
GD	libgd-gd2-perl
Mail::Address	libmailtools-perl
Unicode::MapUTF8	libunicode-maputf8-perl
XML::Simple	libxml-simple-perl
IO::WrapTie	libio-stringy-perl
Unicode::CheckUTF8
Captcha::reCAPTCHA	libcaptcha-recaptcha-perl
Digest::HMAC_SHA1	libdigest-hmac-perl

Optional modules

GD::Graph, libgd-graph-perl

Required for making graphs for the statistics page.

Proc::ProcessTable, libproc-process-perl

Better reliability for starting daemons necessary for high-traffic installations.

RPC::XML, librpc-xml-perl

Required for outgoing XML-RPC support

SOAP::Lite, libsoap-lite-perl

Required for XML-RPC support.

XML::RSS, libxml-rss-perl

Required for retrieving RSS off of other sites (syndication).

String::CRC32, libstring-crc32-perl

Required for palette-altering of PNG files. Only necessary if you plan to make your own S2 styles that use PNGs, not GIFs.

XML::Atom, libxml-atom-perl

Required for Atom API support.

Math::BigInt::GMP, libmath-bigint-gmp-perl

Aides Crypt::DH so it is not crazy slow.

URI::Fetch, liburi-fetch-perl

Required for OpenID support.

Crypt::DH, libcrypt-dh-perl

Required for OpenID support.

Image::Magick, perlmagick

Required for the userpic factory.

Class::Accessor, libclass-accessor-perl

Required for TheSchwartz job submission.

Class::Trigger, libclass-trigger-perl

Required for TheSchwartz job submission.

Class::Data::Inheritable, libclass-data-inheritable-perl

Required for TheSchwartz job submission.

GnuPG::Interface, libgnupg-interface-perl

Required for email posting.

Mail::GnuPG, libmail-gnupg-perl

Required for email posting.

Text::vCard, libtext-vcard-perl

Used to generate user vCards.

IP::Country::Fast,

Required for country lookup with IP address.

GTop,

Required for Apache per-request database logging.

Debian Install. If you are using Debian the following command should retrieve and build every required module. If there are any modules not yet packaged in Debian, you can use CPAN to install those — Unicode::CheckUTF8 is an example.:

# apt-get install libdatetime-perl libdbi-perl libdbd-mysql-perl \
libclass-autouse-perl libmd5-perl libdigest-sha1-perl \
libhtml-template-perl libimage-size-perl libmime-lite-perl \
libmime-perl libcompress-zlib-perl libnet-dns-perl \
liburi-perl libhtml-tagset-perl libhtml-parser-perl \
libwww-perl libwww-perl libgd-gd2-perl \
libmailtools-perl libunicode-maputf8-perl libxml-simple-perl \
libio-stringy-perl  libcaptcha-recaptcha-perl \
libdigest-hmac-perl 

And likewise for the optional modules:

# apt-get install libgd-graph-perl libproc-process-perl librpc-xml-perl \
libsoap-lite-perl libxml-rss-perl libstring-crc32-perl \
libxml-atom-perl libmath-bigint-gmp-perl liburi-fetch-perl \
libcrypt-dh-perl perlmagick libclass-accessor-perl \
libclass-trigger-perl libclass-data-inheritable-perl libgnupg-interface-perl \
libmail-gnupg-perl libtext-vcard-perl  \
 

Using CPAN.  Alternatively, you can use CPAN to install the modules:

From the root prompt on your server, invoke the CPAN shell:

# perl -MCPAN -e shell

Once the Perl interpreter has loaded (and been configured), you can install modules with: install MODULENAME.

The first thing you should do is upgrade your CPAN:

cpan> install Bundle::CPAN

Once it is completed, type:

cpan> reload cpan

Now, enter the following command to retrieve all of the required modules:

cpan> install DateTime
cpan> install DBI
cpan> install DBD::mysql
cpan> install Class::Autouse
cpan> install Digest::MD5
cpan> install Digest::SHA1
cpan> install HTML::Template
cpan> install Image::Size
cpan> install MIME::Lite
cpan> install MIME::Words
cpan> install Compress::Zlib
cpan> install Net::DNS
cpan> install URI::URL
cpan> install HTML::Tagset
cpan> install HTML::Parser
cpan> install LWP::Simple
cpan> install LWP::UserAgent
cpan> install GD
cpan> install Mail::Address
cpan> install Unicode::MapUTF8
cpan> install XML::Simple
cpan> install IO::WrapTie
cpan> install Unicode::CheckUTF8
cpan> install Captcha::reCAPTCHA
cpan> install Digest::HMAC_SHA1

And likewise for the optional modules:

cpan> install GD::Graph
cpan> install Proc::ProcessTable
cpan> install RPC::XML
cpan> install SOAP::Lite
cpan> install XML::RSS
cpan> install String::CRC32
cpan> install XML::Atom
cpan> install Math::BigInt::GMP
cpan> install URI::Fetch
cpan> install Crypt::DH
cpan> install Image::Magick
cpan> install Class::Accessor
cpan> install Class::Trigger
cpan> install Class::Data::Inheritable
cpan> install GnuPG::Interface
cpan> install Mail::GnuPG
cpan> install Text::vCard
cpan> install IP::Country::Fast
cpan> install GTop

Note

Be aware that after freshly installing make / gcc, your perl installation will not necessarily detect it. This means module installation will still fail during the 'make' stage. You may need to invoke the CPAN shell and run the setup routine again, to point to the location of make:

# perl -MCPAN -e shell CPAN

cpan> o conf make /usr/bin/make

cpan> o conf commit

Tip

You can find out the locations of the various tools the CPAN setup routine (o conf) will ask you about by using the whereis command, at a command prompt. For example:

$ whereis gzip

To make sure you have the necessary modules run the included tool: $LJHOME/bin/checkconfig.pl --needed-debs --only=modules

If checkconfig.pl does not detect all of the required modules, it will tell you which ones you are missing. You should install those.