Author: buildbot
Date: Fri Aug 3 19:07:46 2012
New Revision: 827887
Log:
Staging update by buildbot for vcl
Modified:
websites/staging/vcl/trunk/content/ (props changed)
websites/staging/vcl/trunk/content/docs/VCL23Installation.html
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Aug 3 19:07:46 2012
@@ -1 +1 @@
-1369163
+1369165
Modified: websites/staging/vcl/trunk/content/docs/VCL23Installation.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/VCL23Installation.html (original)
+++ websites/staging/vcl/trunk/content/docs/VCL23Installation.html Fri Aug 3
19:07:46 2012
@@ -84,6 +84,7 @@
<ul>
<li><a href="#database">Install & Configure the Database</a></li>
<li><a href="#web">Install and Configure the Web Components</a></li>
+<li><a href="#managementnode">Install & Configure the Management Node
Components</a></li>
</ul>
</div>
<h1 id="database">Install & Configure the Database</h1>
@@ -336,8 +337,10 @@
</li>
<li>
<p>Set the owner of the .ht-inc/maintenance directory to the web server user
(normally 'apache'):</p>
-<p>:::BashLexer
- chown apache maintenance</p>
+<div class="codehilite"><pre><span class="nb">chown</span> <span
class="n">apache</span> <span class="n">maintenance</span>
+</pre></div>
+
+
</li>
<li>
<p>Open the testsetup.php page in a web browser:</p>
@@ -371,7 +374,7 @@
</ul>
</li>
<li>
-<p>Add a Management Node to the Database</p>
+<p><strong>Add a Management Node to the Database</strong></p>
<ul>
<li>Click the Management Nodes link<ul>
<li>Click Add</li>
@@ -402,7 +405,92 @@
</li>
</ul>
</li>
+<li>
+<p><strong>Install & Configure phpMyAdmin (Optional):</strong>
+<a href="http://www.phpmyadmin.net/";>phpMyAdmin</a> is a free and optional
tool which allows <a href="http://www.mysql.com/";>MySQL</a> to be administered
using a web browser. It makes administering the VCL database easier. This tool
can be installed on the VCL web server.
+To install phpMyAdmin, follow the instructions on: VCL 2.3 phpMyAdmin
Installation & Configuration</p>
+</li>
+</ol>
+<hr />
+<h1 id="managementnode">Install & Configure the Management Node
Components</h1>
+<p><strong>Prerequisites</strong>
+The following management node installation instructions assume the
instructions on the following pages have previously been completed:</p>
+<div class="codehilite"><pre><span class="o">*</span> <span
class="n">VCL</span> <span class="mf">2.3</span> <span
class="n">Database</span> <span class="n">Installation</span>
+<span class="o">*</span> <span class="n">VCL</span> <span
class="mf">2.3</span> <span class="n">Web</span> <span class="n">Code</span>
<span class="n">Installation</span>
+</pre></div>
+
+
+<p><strong>Supported Operating Systems:</strong>
+The VCL management node daemon (vcld) has been developed to run on an
operating system based on Red Hat Enterprise Linux (RHEL). It has been tested
on the following:</p>
+<p>Red Hat Enterprise Linux 4.x
+Red Hat Enterprise Linux 5.x
+Red Hat Enterprise Linux 6.x
+CentOS 5.x
+CentOS 6.x</p>
+<p><strong>Required Linux Packages:</strong>
+The VCL management node daemon (vcld) requires the following Linux packages
and Perl modules in order to run (see step 2 below for installation
instructions):</p>
+<p>expat - A library for parsing XML
+expat-devel - Libraries and include files to develop XML applications with
expat
+gcc - Various compilers (C, C++, Objective-C, Java, ...)
+krb5-libs - The shared libraries used by Kerberos 5
+krb5-devel - Development files needed to compile Kerberos 5 programs
+libxml2 - Library providing XML and HTML support
+libxml2-devel - Libraries, includes, etc. to develop XML and HTML applications
+mysql - MySQL client programs and shared libraries
+nmap - Network exploration tool and security scanner
+openssh - The OpenSSH implementation of SSH protocol versions 1 and 2
+openssl - The OpenSSL toolkit
+openssl-devel - Files for development of applications which will use OpenSSL
+perl - The Perl programming language
+perl-DBD-MySQL - A MySQL interface for perl
+xmlsec1-openssl - OpenSSL crypto plugin for XML Security Library</p>
+<p><strong>Required Perl Modules:</strong>
+The VCL management node daemon (vcld) is written in Perl and has been tested
on Perl 5.8.x. The following Perl modules available from CPAN are also required
(see step 2 below for installation instructions):</p>
+<p>DBI - Generic Database Interface
+Digest::SHA1 - NIST SHA message digest algorithm
+Mail::Mailer - Simple mail agent interface
+Object::InsideOut - Comprehensive inside-out object support
+RPC::XML - A set of classes for core data, message and XML handling
+YAML - YAML Ain't Markup Language</p>
+<ol>
+<li>
+<p><strong>Install the VCL Management Node Code - Perl Daemon</strong></p>
+<ul>
+<li>
+<p>If you have not already done so, download and extract the source files on
the web server:</p>
+<div class="codehilite"><pre><span class="n">wget</span> <span
class="n">http:</span><span class="sr">//</span><span class="n">www</span><span
class="o">.</span><span class="n">apache</span><span class="o">.</span><span
class="n">org</span><span class="sr">/dist/</span><span
class="n">vcl</span><span class="o">/</span><span class="n">apache</span><span
class="o">-</span><span class="n">VCL</span><span class="o">-</span><span
class="mf">2.3</span><span class="o">.</span><span class="n">tar</span><span
class="o">.</span><span class="n">bz2</span>
+<span class="n">tar</span> <span class="o">-</span><span class="n">jxvf</span>
<span class="n">apache</span><span class="o">-</span><span
class="n">VCL</span><span class="o">-</span><span class="mf">2.3</span><span
class="o">.</span><span class="n">tar</span><span class="o">.</span><span
class="n">bz2</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Copy the managementnode directory to the location where you want it to
reside (typically /usr/local):</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span
class="o">-</span><span class="n">r</span> <span class="n">apache</span><span
class="o">-</span><span class="n">VCL</span><span class="o">-</span><span
class="mf">2.3</span><span class="sr">/managementnode /</span><span
class="n">usr</span><span class="sr">/local/</span><span class="n">vcl</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+<li>
+<p>Install the Required Linux Packages & Perl Modules</p>
+<ul>
+<li>
+<p>Run the install_perl_libs.pl script located in the bin directory:</p>
+<div class="codehilite"><pre><span class="n">perl</span> <span
class="sr">/usr/</span><span class="nb">local</span><span
class="sr">/vcl/</span><span class="n">bin</span><span class="o">/</span><span
class="n">install_perl_libs</span><span class="o">.</span><span
class="n">pl</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
</ol>
+<p>The last line of the install_perl_libs.pl script output should be:
+COMPLETE: installed all components
+Note: The script will hang or terminate if it encounters a problem. If this
occurs, you will need to troubleshoot the problem by looking at the output. </p>
+<p>The install_perl_libs.pl script included in the VCL distribution will
attempt to download and install the required Linux packages and Perl modules.
It uses the yum utility to install the required Linux packages. The required
Perl modules are available from CPAN - The Comprehensive Perl Archive Network.
The install_perl_libs.pl script attempts to download and install the required
Perl modules by using the CPAN.pm module which is included with most Perl
distributions. </p>
+<p>The yum utility should exist on any modern Red Hat-based Linux distribution
(Red Hat, CentOS, Fedora, etc). If yum isn't available on your management node
OS, you will need to download and install the required Linux packages manually
or by using another package management utility. After installing the required
Linux packages, attempt to run the install_perl_libs.pl script again.</p>
</div>
<div id="footer">
