Management Node Installation

Download the Backend VCL Code

Download VCL backend code from the Apache Subversion repository and save it to /usr/local/vcl

svn export https://svn.apache.org/repos/asf/incubator/vcl/trunk/managementnode/ /usr/local/vcl/

Install Required Perl Modules

The VCL Perl code running on management nodes requires several additional Perl modules.  These are available from CPAN - The Comprehensive Perl Archive Network. A search engine for CPAN modules is available at search.cpan.org.

The following list of modules should be installed in the order in which they appear:

• http://search.cpan.org/CPAN/authors/id/M/MA/MARKOV/MailTools-2.04.tar.gz
• http://search.cpan.org/CPAN/authors/id/T/TM/TMTM/Class-Data-Inheritable-0.08.tar.gz
• http://search.cpan.org/CPAN/authors/id/D/DR/DROLSKY/Devel-StackTrace-1.20.tar.gz
• http://search.cpan.org/CPAN/authors/id/D/DR/DROLSKY/Exception-Class-1.26.tar.gz
• http://search.cpan.org/CPAN/authors/id/J/JD/JDHEDDEN/Object-InsideOut-3.52.tar.gz
• http://search.cpan.org/CPAN/authors/id/K/KW/KWILLIAMS/Module-Build-0.30.tar.gz
• http://search.cpan.org/CPAN/authors/id/A/AG/AGROLMS/GSSAPI-0.26.tar.gz
• http://search.cpan.org/CPAN/authors/id/G/GA/GAAS/Digest-HMAC-1.01.tar.gz
• http://search.cpan.org/CPAN/authors/id/G/GB/GBARR/Authen-SASL-2.12.tar.gz
• http://search.cpan.org/CPAN/authors/id/R/RE/REATMON/XML-Stream-1.22.tar.gz
• http://search.cpan.org/CPAN/authors/id/H/HA/HACKER/Net-XMPP-1.02.tar.gz
• http://search.cpan.org/CPAN/authors/id/R/RE/REATMON/Net-Jabber-2.0.tar.gz
• http://search.cpan.org/CPAN/authors/id/I/IN/INGY/YAML-0.68.tar.gz
• http://www.cpan.org/modules/by-module/XML/XML-Parser-2.36.tar.gz
• http://search.cpan.org/CPAN/authors/id/R/RJ/RJRAY/RPC-XML-0.64.tar.gz
• http://www.cpan.org/modules/by-module/Crypt/Crypt-SSLeay-0.57.tar.gz
• http://search.cpan.org/CPAN/authors/id/T/TI/TIMB/DBI-1.609.tar.gz
• http://search.cpan.org/CPAN/authors/id/G/GA/GAAS/libwww-perl-5.827.tar.gz

How to Install a Perl Module Manually

1. Change directories to /tmp:
   cd /tmp 
2. Download the module's source package using wget:
   wget http://search.cpan.org/CPAN/authors/id/G/GA/GAAS/libwww-perl-5.827.tar.gz
3. Unpack the source package using tar:
   tar xzf libwww-perl-5.827.tar.gz
4. The previous command should have created a libwww-perl-5.827 directory, change to this directory:
   cd libwww-perl-5.827
5. Create a makefile with the following command:+
   perl Makefile.PL
6. Compile the module:
   make
7. Test the module:
   make test
8. Install the module:
   make install

How to Install a Perl Module Using CPAN

1. Enter the CPAN shell:
   perl -MCPAN -e shell
2. You will need to configure CPAN if it's the first time it is being run. Enter No at the first prompt to auto-configure the CPAN module.
3. Search for a module using the "m" command:
   m /Zlib/
   You should find the module you were looking for on a line like this:
   Module          Compress::Zlib  (P/PM/PMQS/IO-Compress-2.020.tar.gz)
4. Install the module:
   install Compress::Zlib
5. Answer yes if asked to install any prerequisite modules
   The last line you should see should be:
   /usr/bin/make install  -- OK

How to Test if Required Perl Modules are Installed

 Run the following command:

perl /usr/local/vcl/lib/VCL/utils.pm

A module is missing if you see any "Can't locate" lines:

Can't locate HTTP/Headers.pm in @INC (@INC contains:

Once all of the required modules are installed, you should see something like this:

BIN PATH: /usr/local/vcl/lib/VCL
pre-execution: config file being used: /etc/vcl/vcld.conf
Uncaught exception from user code:
        VCLD : /etc/vcl/vcld.conf does not exist, exiting --  No such file or directory
BEGIN failed--compilation aborted at /usr/local/vcl/lib/VCL/utils.pm line 616.
 at /usr/local/vcl/lib/VCL/utils.pm line 616