svn commit: r938109 - in /websites/staging/vcl/trunk/content: ./ docs/VCL24InstallGuide.html

[bu...@apache.org]

Author: buildbot
Date: Wed Jan 28 21:43:28 2015
New Revision: 938109

Log:
Staging update by buildbot for vcl

Modified:
    websites/staging/vcl/trunk/content/   (props changed)
    websites/staging/vcl/trunk/content/docs/VCL24InstallGuide.html

Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Jan 28 21:43:28 2015
@@ -1 +1 @@
-1655473
+1655476

Modified: websites/staging/vcl/trunk/content/docs/VCL24InstallGuide.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/VCL24InstallGuide.html (original)
+++ websites/staging/vcl/trunk/content/docs/VCL24InstallGuide.html Wed Jan 28 21:43:28 2015
@@ -109,20 +109,13 @@ vcl-install.sh [-h|--help] [-d|--databas
 
 
 <p></code></pre></p>
-<p>This guide will provide the necessary steps to install and configure VCL software. 
-It covers the set up of the database, web portal, and management node.</p>
-<div class="toc">
-<ul>
-<li><a href="#scripted-installation">Scripted Installation</a></li>
-<li><a href="#database">Manual Installation</a></li>
-<li><a href="#web">Install and Configure the Web Components</a></li>
-<li><a href="#managementnode">Install &amp; Configure the Management Node Components</a></li>
-<li><a href="#initial-administration-steps-after-installing-vcl">Initial Administration Steps After Installing VCL</a></li>
-</ul>
-</div>
-<h1 id="database">Manual Installation</h1>
-<p>This section provides a list of commands for installing VCL if you prefer manually 
+<h1 id="manual-installation">Manual Installation</h1>
+<p>This section provides a list of commands for installing VCL if you prefer to manually 
 install it.</p>
+<p><a href="#database">Database Installation</a><br>
+<a href="#web">Web Portal Installation</a><br>
+<a href="#managementnode">Management Node Installation</a></p>
+<h2 id="database">Install and Configure Database</h2>
 <p>VCL currently supports the use of MySQL or MariaDB as the database.</p>
 <ol>
 <li>
@@ -210,6 +203,29 @@ Add the following to your iptables confi
 </li>
 </ul>
 </li>
+<li>
+<p>If the firewalld firewall is being used and the web server and management nodes 
+will be on different machines, port 3306 should be opened up to each of those nodes. 
+Add the following rules and reload the rule set.<br>
+<strong>Note:</strong> Insert your web server and management node IP address in the right locations.</p>
+<ul>
+<li>
+<p>Add these rules:</p>
+<div class="codehilite"><pre><span class="n">firewall</span><span class="o">-</span><span class="n">cmd</span> <span class="o">--</span><span class="n">zone</span><span class="p">=</span><span class="n">public</span> <span class="o">--</span><span class="n">permanent</span> <span class="o">--</span><span class="n">add</span><span class="o">-</span><span class="n">rich</span><span class="o">-</span><span class="n">rule</span><span class="p">=</span>&quot;<span class="n">rule</span> <span class="n">family</span><span class="p">=</span>&quot;<span class="n">ipv4</span>&quot; <span class="n">source</span> <span class="n">address</span><span class="p">=</span>&quot;<span class="o">&lt;</span><span class="n">web</span> <span class="n">server</span> <span class="n">IP</span><span class="o">&gt;</span>&quot; <span class="n">service</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">mysql</span>&quot; <span class="n">accept</span>&quot;
+<span class="n">firewall</span><span class="o">-</span><span class="n">cmd</span> <span class="o">--</span><span class="n">zone</span><span class="p">=</span><span class="n">public</span> <span class="o">--</span><span class="n">permanent</span> <span class="o">--</span><span class="n">add</span><span class="o">-</span><span class="n">rich</span><span class="o">-</span><span class="n">rule</span><span class="p">=</span>&quot;<span class="n">rule</span> <span class="n">family</span><span class="p">=</span>&quot;<span class="n">ipv4</span>&quot; <span class="n">source</span> <span class="n">address</span><span class="p">=</span>&quot;<span class="o">&lt;</span><span class="n">management</span> <span class="n">node</span> <span class="n">IP</span><span class="o">&gt;</span>&quot; <span class="n">service</span> <span class="n">name</span><span class="p">=</span>&quot;<span class="n">mysql</span>&quot; <span class="n">accept</span>&quot;
+</pre></div>
+
+
+</li>
+<li>
+<p>Restart iptables:</p>
+<div class="codehilite"><pre><span class="n">firewall</span><span class="o">-</span><span class="n">cmd</span> <span class="o">--</span><span class="n">reload</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
 </ul>
 </li>
 <li>
@@ -256,7 +272,7 @@ privileges on the database you just crea
 </li>
 </ol>
 <hr />
-<h1 id="web">Install and Configure the Web Components</h1>
+<h2 id="web">Install and Configure the Web Components</h2>
 <p><strong>Prerequisites</strong></p>
 <ul>
 <li>Apache VCL 2.4 had been downloaded</li>
@@ -354,6 +370,26 @@ config file:</p>
 </li>
 </ul>
 </li>
+<li>
+<p>If the firewalld firewall is being used, port 80 and 443 should be opened up:</p>
+<ul>
+<li>
+<p>Add these rules:</p>
+<div class="codehilite"><pre><span class="n">firewall</span><span class="o">-</span><span class="n">cmd</span> <span class="o">--</span><span class="n">zone</span><span class="p">=</span><span class="n">public</span> <span class="o">--</span><span class="n">add</span><span class="o">-</span><span class="n">service</span><span class="p">=</span><span class="n">http</span> <span class="o">--</span><span class="n">permanent</span>
+<span class="n">firewall</span><span class="o">-</span><span class="n">cmd</span> <span class="o">--</span><span class="n">zone</span><span class="p">=</span><span class="n">public</span> <span class="o">--</span><span class="n">add</span><span class="o">-</span><span class="n">service</span><span class="p">=</span><span class="n">https</span> <span class="o">--</span><span class="n">permanent</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Reload firewalld rules</p>
+<div class="codehilite"><pre><span class="n">firewall</span><span class="o">-</span><span class="n">cmd</span> <span class="o">--</span><span class="n">reload</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
 </ul>
 </li>
 <li>
@@ -365,7 +401,7 @@ page to download and verify apache-VCL-2
 </li>
 <li>
 <p>Extract the files:</p>
-<div class="codehilite"><pre><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>2<span class="p">.</span>3<span class="p">.</span>2<span class="p">.</span><span class="n">tar</span><span class="p">.</span><span class="n">bz2</span>
+<div class="codehilite"><pre><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>2<span class="p">.</span>4<span class="p">.</span><span class="n">tar</span><span class="p">.</span><span class="n">bz2</span>
 </pre></div>
 
 
@@ -521,7 +557,7 @@ Configuration</a></p>
 </li>
 </ol>
 <hr />
-<h1 id="managementnode">Install &amp; Configure the Management Node Components</h1>
+<h2 id="managementnode">Install &amp; Configure the Management Node Components</h2>
 <p><strong>Prerequisites</strong>
 The following management node installation instructions assume the instructions in these
 previous sections have been completed:</p>