You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@vcl.apache.org by bu...@apache.org on 2015/04/03 21:52:53 UTC
svn commit: r946230 - in /websites/staging/vcl/trunk/content: ./
docs/VCL241InstallGuide.html docs/VCL242InstallGuide.html
Author: buildbot
Date: Fri Apr 3 19:52:53 2015
New Revision: 946230
Log:
Staging update by buildbot for vcl
Added:
websites/staging/vcl/trunk/content/docs/VCL242InstallGuide.html
Removed:
websites/staging/vcl/trunk/content/docs/VCL241InstallGuide.html
Modified:
websites/staging/vcl/trunk/content/ (props changed)
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Apr 3 19:52:53 2015
@@ -1 +1 @@
-1671138
+1671140
Added: websites/staging/vcl/trunk/content/docs/VCL242InstallGuide.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/VCL242InstallGuide.html (added)
+++ websites/staging/vcl/trunk/content/docs/VCL242InstallGuide.html Fri Apr 3 19:52:53 2015
@@ -0,0 +1,927 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+ <link href="/css/vcl.css" rel="stylesheet" type="text/css">
+ <link href="/css/code.css" rel="stylesheet" type="text/css">
+ <title>Apache VCL - VCL 2.4.1 Installation Guide</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+
+<body>
+ <div id="sitetitle">
+ <table width="100%" border="0" cellspacing="0" cellpadding="5">
+ <tr>
+ <td><a href="/index.html"><img src="/img/vcl-logo.png" height="100" align="left" alt="Apache VCL logo"></a></td>
+ <td><a href="http://www.apache.org"><img src="/img/asf-logo.png" align="right" alt="Apache Software Foundation logo"></a></td>
+ </tr>
+ </table>
+ </div>
+
+ <div id="navigation">
+ <ul>
+<li><a href="/index.html">Information</a><ul>
+<li><a href="/info/features.html">Features</a></li>
+<li><a href="/info/architecture.html">Architecture</a></li>
+<li><a href="/downloads/download.cgi">Download</a></li>
+<li><a href="/info/license.html">License</a></li>
+</ul>
+</li>
+<li><a href="/docs/index.html">Documentation</a><ul>
+<li><a href="https://cwiki.apache.org/confluence/x/yQdG">Using VCL</a></li>
+<li><a href="https://cwiki.apache.org/confluence/x/ywdG">Administration</a></li>
+<li><a href="/docs/installation.html">Installation</a></li>
+</ul>
+</li>
+<li><a href="/comm/index.html">Community</a><ul>
+<li><a href="/comm/index.html#getInvolved">Getting Involved</a></li>
+<li><a href="/comm/index.html#mail-list">Mailing Lists</a></li>
+<li><a href="/comm/wiki.html">Wiki</a></li>
+<li><a href="/dev/index.html">Development</a><ul>
+<li><a href="/dev/jira.html">Issue Tracking</a></li>
+<li><a href="/dev/code-documentation.html">Code Documentation</a></li>
+<li><a href="/dev/roadmap.html">Roadmap</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="http://www.apache.org">Apache Software Foundation</a><ul>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+</ul>
+</li>
+</ul>
+ </div>
+
+ <div id="content">
+ <h1 class="title">VCL 2.4.1 Installation Guide</h1>
+ <h1 id="scripted-installation">Scripted Installation</h1>
+<p>VCL 2.4.1 is the first release to include an installation script. All you need to install
+VCL is the script. It will download and validate the VCL software and then install it.
+The script can be used to install all three parts of VCL (database, web portal, and
+management node) or to install each part individually.</p>
+<p><a href="https://www.apache.org/dist/vcl/2.4.1/vcl-install.sh">Download Install Script (vcl-install.sh)</a></p>
+<p>Validate script:</p>
+<div class="codehilite"><pre><span class="n">wget</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span>2<span class="p">.</span>4<span class="p">.</span>1<span class="o">/</span><span class="n">vcl</span><span class="o">-</span><span class="n">install</span><span class="p">.</span><span class="n">sh</span><span class="p">.</span><span class="n">sha1</span>
+<span class="n">sha1sum</span> <span class="o">-</span><span class="n">c</span> <span class="n">vcl</span><span class="o">-</span><span class="n">install</span><span class="p">.</span><span class="n">sh</span><span class="p">.</span><span class="n">sha1</span>
+<span class="n">wget</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">KEYS</span>
+<span class="n">gpg</span> <span class="o">--</span><span class="n">import</span> <span class="n">KEYS</span>
+<span class="n">wget</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span>2<span class="p">.</span>4<span class="p">.</span>1<span class="o">/</span><span class="n">vcl</span><span class="o">-</span><span class="n">install</span><span class="p">.</span><span class="n">sh</span><span class="p">.</span><span class="n">asc</span>
+<span class="n">gpg</span> <span class="o">--</span><span class="n">verify</span> <span class="n">vcl</span><span class="o">-</span><span class="n">install</span><span class="p">.</span><span class="n">sh</span><span class="p">.</span><span class="n">asc</span>
+</pre></div>
+
+
+<p>Running the installation script with no arguments will step you through installing all
+three parts of VCL. Alternatively, the following explains optional arguments. If
+installing the management node part of VCL, it will also prompt you to agree to the
+installation of various system level requirements needed for the code to run.
+<pre><code></p>
+<div class="codehilite"><pre><span class="n">vcl</span><span class="o">-</span><span class="n">install</span><span class="p">.</span><span class="n">sh</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="o">|--</span><span class="n">help</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">d</span><span class="o">|--</span><span class="n">database</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">w</span><span class="o">|--</span><span class="n">web</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">m</span><span class="o">|--</span><span class="n">managementnode</span><span class="p">]</span>
+ <span class="p">[</span><span class="o">--</span><span class="n">dbhost</span> <span class="o"><</span><span class="n">hostname</span><span class="o">></span> <span class="o">--</span><span class="n">dbpass</span> <span class="o"><</span><span class="n">password</span><span class="o">></span><span class="p">]</span>
+ <span class="p">[</span><span class="o">--</span><span class="n">mnhost</span> <span class="o"><</span><span class="n">hostname</span><span class="o">></span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">webhost</span> <span class="o"><</span><span class="n">hostname</span><span class="o">></span><span class="p">]</span>
+
+<span class="o">-</span><span class="n">d</span><span class="o">|--</span><span class="n">database</span> <span class="o">-</span> <span class="n">install</span> <span class="n">database</span> <span class="n">server</span> <span class="n">components</span>
+ <span class="o">--</span><span class="n">dbpass</span><span class="p">,</span> <span class="o">--</span><span class="n">mnhost</span><span class="p">,</span> <span class="o">--</span><span class="n">mnip</span><span class="p">,</span> <span class="o">--</span><span class="n">webhost</span><span class="p">,</span> <span class="n">and</span> <span class="o">--</span><span class="n">adminpass</span> <span class="n">must</span> <span class="n">also</span> <span class="n">be</span> <span class="n">specified</span>
+
+<span class="o">-</span><span class="n">w</span><span class="o">|--</span><span class="n">web</span> <span class="o">-</span> <span class="n">install</span> <span class="n">web</span> <span class="n">server</span> <span class="n">components</span>
+ <span class="o">--</span><span class="n">dbhost</span> <span class="n">and</span> <span class="o">--</span><span class="n">dbpass</span> <span class="n">must</span> <span class="n">also</span> <span class="n">be</span> <span class="n">specified</span>
+
+<span class="o">-</span><span class="n">m</span><span class="o">|--</span><span class="n">managementnode</span> <span class="o">-</span> <span class="n">install</span> <span class="n">management</span> <span class="n">node</span> <span class="p">(</span><span class="n">vcld</span><span class="p">)</span> <span class="n">components</span>
+ <span class="o">--</span><span class="n">dbhost</span><span class="p">,</span> <span class="o">--</span><span class="n">dbpass</span><span class="p">,</span> <span class="n">and</span> <span class="o">--</span><span class="n">adminpass</span> <span class="n">must</span> <span class="n">also</span> <span class="n">be</span> <span class="n">specified</span>
+
+<span class="o">--</span><span class="n">dbhost</span> <span class="o"><</span><span class="n">hostname</span><span class="o">></span> <span class="o">-</span> <span class="n">hostname</span> <span class="n">of</span> <span class="n">database</span> <span class="n">server</span> <span class="p">(</span><span class="n">default</span><span class="p">=</span><span class="n">localhost</span><span class="p">)</span>
+
+<span class="o">--</span><span class="n">dbpass</span> <span class="o"><</span><span class="n">password</span><span class="o">></span> <span class="o">-</span> <span class="n">password</span> <span class="n">VCL</span> <span class="n">will</span> <span class="n">use</span> <span class="k">for</span> <span class="n">accessing</span>
+ <span class="n">database</span> <span class="p">(</span><span class="n">default</span><span class="p">=</span><span class="n">random</span><span class="p">)</span>
+
+<span class="o">--</span><span class="n">mnhost</span> <span class="o"><</span><span class="n">hostname</span><span class="o">></span> <span class="o">-</span> <span class="n">hostname</span> <span class="n">of</span> <span class="n">management</span> <span class="n">node</span> <span class="p">(</span><span class="n">default</span><span class="p">=</span><span class="n">localhost</span><span class="p">)</span>
+
+<span class="o">--</span><span class="n">webhost</span> <span class="o"><</span><span class="n">hostname</span><span class="o">></span> <span class="o">-</span> <span class="n">hostname</span> <span class="n">of</span> <span class="n">web</span> <span class="n">server</span> <span class="p">(</span><span class="n">default</span><span class="p">=</span><span class="n">localhost</span><span class="p">)</span>
+
+<span class="o">--</span><span class="n">adminpass</span> <span class="o"><</span><span class="n">password</span><span class="o">></span> <span class="o">-</span> <span class="n">password</span> <span class="k">for</span> <span class="n">VCL</span> <span class="n">admin</span> <span class="n">user</span>
+</pre></div>
+
+
+<p></code></pre></p>
+<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>
+<p>Download and Extract the Apache VCL Source</p>
+<ul>
+<li>
+<p>If you have not already done so, follow the instructions on the <a href="/downloads/download.cgi">download</a>
+page to download and verify apache-VCL-2.4.1.tar.bz2, and put it in /root</p>
+</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>4<span class="p">.</span>1<span class="p">.</span><span class="n">tar</span><span class="p">.</span><span class="n">bz2</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+<li>
+<p>Install MySQL Server or MariaDB Server</p>
+<ul>
+<li>
+<p>Install MySQL or MariaDB Server</p>
+<div class="codehilite"><pre><span class="n">yum</span> <span class="n">install</span> <span class="n">mysql</span><span class="o">-</span><span class="n">server</span> <span class="o">-</span><span class="n">y</span>
+</pre></div>
+
+
+<p>or</p>
+<div class="codehilite"><pre><span class="n">yum</span> <span class="n">install</span> <span class="n">mariadb</span><span class="o">-</span><span class="n">server</span> <span class="o">-</span><span class="n">y</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Configure the database daemon to start automatically:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">chkconfig</span> <span class="o">--</span><span class="n">level</span> 345 <span class="n">mysqld</span> <span class="n">on</span>
+</pre></div>
+
+
+<p>or</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">chkconfig</span> <span class="o">--</span><span class="n">level</span> 345 <span class="n">mariadb</span> <span class="n">on</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Start the database daemon:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">service</span> <span class="n">mysqld</span> <span class="n">start</span>
+</pre></div>
+
+
+<p>or</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">service</span> <span class="n">mariadb</span> <span class="n">start</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>If the iptables 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 to your iptables config and restart iptables service.<br>
+<strong>Note:</strong> Insert your web server and management node IP address in the right locations.</p>
+<div class="codehilite"><pre><span class="n">vi</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">sysconfig</span><span class="o">/</span><span class="n">iptables</span>
+</pre></div>
+
+
+<ul>
+<li>
+<p>Add these rules:</p>
+<div class="codehilite"><pre><span class="o">-</span><span class="n">A</span> <span class="n">RH</span><span class="o">-</span><span class="n">Firewall</span><span class="o">-</span>1<span class="o">-</span><span class="n">INPUT</span> <span class="o">-</span><span class="n">m</span> <span class="n">state</span> <span class="o">--</span><span class="n">state</span> <span class="n">NEW</span> <span class="o">-</span><span class="n">s</span> <span class="o"><</span><span class="n">web</span> <span class="n">server</span> <span class="n">IP</span><span class="o">></span> <span class="o">-</span><span class="n">p</span> <span class="n">tcp</span> <span class="o">--</span><span class="n">dport</span> 3306 <span class="o">-</span><span class="nb">j</span> <span class="n">ACCEPT</span>
+<span class="o">-</span><span class="n">A</span> <span class="n">RH</span><span class="o">-</span><span class="n">Firewall</span><span class="o">-</span>1<span class="o">-</span><span class="n">INPUT</span> <span class="o">-</span><span class="n">m</span> <span class="n">state</span> <span class="o">--</span><span class="n">state</span> <span class="n">NEW</span> <span class="o">-</span><span class="n">s</span> <span class="o"><</span><span class="n">management</span> <span class="n">node</span> <span class="n">IP</span><span class="o">></span> <span class="o">-</span><span class="n">p</span> <span class="n">tcp</span> <span class="o">--</span><span class="n">dport</span> 3306 <span class="o">-</span><span class="nb">j</span> <span class="n">ACCEPT</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Restart iptables:</p>
+<div class="codehilite"><pre><span class="n">service</span> <span class="n">iptables</span> <span class="n">restart</span>
+</pre></div>
+
+
+</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>"<span class="n">rule</span> <span class="n">family</span><span class="p">=</span>"<span class="n">ipv4</span>" <span class="n">source</span> <span class="n">address</span><span class="p">=</span>"<span class="o"><</span><span class="n">web</span> <span class="n">server</span> <span class="n">IP</span><span class="o">></span>" <span class="n">service</span> <span class="n">name</span><span class="p">=</span>"<span class="n">mysql</span>" <span class="n">accept</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">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>"<span class="n">rule</span> <span class="n">family</span><span class="p">=</span>"<span class="n">ipv4</span>" <span class="n">source</span> <span class="n">address</span><span class="p">=</span>"<span class="o"><</span><span class="n">management</span> <span class="n">node</span> <span class="n">IP</span><span class="o">></span>" <span class="n">service</span> <span class="n">name</span><span class="p">=</span>"<span class="n">mysql</span>" <span class="n">accept</span>"
+</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>
+<p>Create the VCL Database</p>
+<ul>
+<li>
+<p>Run the MySQL command-line client:</p>
+<div class="codehilite"><pre><span class="n">mysql</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Create a database:</p>
+<div class="codehilite"><pre><span class="n">CREATE</span> <span class="n">DATABASE</span> <span class="n">vcl</span><span class="p">;</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Create a user with SELECT, INSERT, UPDATE, DELETE, and CREATE TEMPORARY TABLES
+privileges on the database you just created (<strong>NOTE Use your own password</strong>):</p>
+<div class="codehilite"><pre><span class="n">GRANT</span> <span class="n">SELECT</span><span class="p">,</span><span class="n">INSERT</span><span class="p">,</span><span class="n">UPDATE</span><span class="p">,</span><span class="n">DELETE</span><span class="p">,</span><span class="n">CREATE</span> <span class="n">TEMPORARY</span> <span class="n">TABLES</span> <span class="n">ON</span> <span class="n">vcl</span><span class="o">.*</span> <span class="n">TO</span> <span class="s">'vcluser'</span><span class="p">@</span><span class="s">'localhost'</span> <span class="n">IDENTIFIED</span> <span class="n">BY</span> <span class="s">'vcluserpassword'</span><span class="p">;</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Exit the MySQL command-line client</p>
+<div class="codehilite"><pre><span class="n">exit</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Import the vcl.sql file into the database. The <strong>vcl.sql</strong> file is included in the
+<strong>mysql</strong> directory within the Apache VCL source code</p>
+<div class="codehilite"><pre><span class="n">mysql</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>2<span class="p">.</span>4<span class="p">.</span>1<span class="o">/</span><span class="n">mysql</span><span class="o">/</span><span class="n">vcl</span><span class="p">.</span><span class="n">sql</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+</ol>
+<hr />
+<h2 id="web">Install and Configure the Web Components</h2>
+<p><strong>Prerequisites</strong></p>
+<ul>
+<li>Apache VCL 2.4.1 had been downloaded</li>
+<li>VCL database has been installed and configured</li>
+</ul>
+<p><strong>Web Server:</strong></p>
+<ul>
+<li>Apache HTTP Server v1.3 or v2.x with SSL enabled</li>
+<li>PHP 5.0 or later</li>
+</ul>
+<p><strong>Required Linux Packages:</strong></p>
+<ul>
+<li>httpd - Apache HTTP Server</li>
+<li>mod_ssl - SSL/TLS module for the Apache HTTP server</li>
+<li>php - The PHP HTML-embedded scripting language</li>
+</ul>
+<p><strong>Required PHP Modules:</strong></p>
+<ul>
+<li>php</li>
+<li>php-gd</li>
+<li>php-json (required if your PHP version is 5.2 or later)</li>
+<li>php-mysql</li>
+<li>php-openssl</li>
+<li>php-xml</li>
+<li>php-xmlrpc</li>
+<li>php-ldap (if you will be using LDAP authentication)</li>
+</ul>
+<hr />
+<ol>
+<li>
+<p><strong>Install the Required Linux Packages & PHP Modules</strong></p>
+<ul>
+<li>
+<p>If your web server is running a Red Hat-based OS, the required components can be installed with:</p>
+<p>For RHEL / CentOS 6 and 7</p>
+<div class="codehilite"><pre><span class="n">yum</span> <span class="n">install</span> <span class="n">httpd</span> <span class="n">mod_ssl</span> <span class="n">php</span> <span class="n">php</span><span class="o">-</span><span class="n">gd</span> <span class="n">php</span><span class="o">-</span><span class="n">mysql</span> <span class="n">php</span><span class="o">-</span><span class="n">xml</span> <span class="n">php</span><span class="o">-</span><span class="n">xmlrpc</span> <span class="n">php</span><span class="o">-</span><span class="n">ldap</span> <span class="o">-</span><span class="n">y</span>
+</pre></div>
+
+
+<p>For RHEL / CentOS 5</p>
+<div class="codehilite"><pre><span class="n">yum</span> <span class="n">install</span> <span class="n">httpd</span> <span class="n">mod_ssl</span> <span class="n">php</span> <span class="n">php</span><span class="o">-</span><span class="n">gd</span> <span class="n">php</span><span class="o">-</span><span class="n">mysql</span> <span class="n">php</span><span class="o">-</span><span class="n">xml</span> <span class="n">php</span><span class="o">-</span><span class="n">xmlrpc</span> <span class="n">php</span><span class="o">-</span><span class="n">ldap</span> <span class="o">-</span><span class="n">y</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Configure the web server daemon (httpd) to start automatically:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">chkconfig</span> <span class="o">--</span><span class="n">level</span> 345 <span class="n">httpd</span> <span class="n">on</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Start the web server daemon</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">service</span> <span class="n">httpd</span> <span class="n">start</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>If SELinux is enabled, run the following command to allow the web server to connect to the database:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">setsebool</span> <span class="o">-</span><span class="n">P</span> <span class="n">httpd_can_network_connect</span><span class="p">=</span>1
+</pre></div>
+
+
+</li>
+<li>
+<p>If the iptables firewall is being used, port 80 and 443 should be opened up in the iptables
+config file:</p>
+<div class="codehilite"><pre><span class="n">vi</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">sysconfig</span><span class="o">/</span><span class="n">iptables</span>
+</pre></div>
+
+
+<ul>
+<li>
+<p>Add these rules:</p>
+<div class="codehilite"><pre><span class="o">-</span><span class="n">A</span> <span class="n">RH</span><span class="o">-</span><span class="n">Firewall</span><span class="o">-</span>1<span class="o">-</span><span class="n">INPUT</span> <span class="o">-</span><span class="n">m</span> <span class="n">state</span> <span class="o">--</span><span class="n">state</span> <span class="n">NEW</span> <span class="o">-</span><span class="n">p</span> <span class="n">tcp</span> <span class="o">--</span><span class="n">dport</span> 80 <span class="o">-</span><span class="nb">j</span> <span class="n">ACCEPT</span>
+<span class="o">-</span><span class="n">A</span> <span class="n">RH</span><span class="o">-</span><span class="n">Firewall</span><span class="o">-</span>1<span class="o">-</span><span class="n">INPUT</span> <span class="o">-</span><span class="n">m</span> <span class="n">state</span> <span class="o">--</span><span class="n">state</span> <span class="n">NEW</span> <span class="o">-</span><span class="n">p</span> <span class="n">tcp</span> <span class="o">--</span><span class="n">dport</span> 443 <span class="o">-</span><span class="nb">j</span> <span class="n">ACCEPT</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Restart iptables</p>
+<div class="codehilite"><pre><span class="n">service</span> <span class="n">iptables</span> <span class="n">restart</span>
+</pre></div>
+
+
+</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>
+<p><strong>Install the VCL Frontend Web Code</strong></p>
+<ul>
+<li>
+<p>If you have not already done so, follow the instructions on the <a href="/downloads/download.cgi">download</a>
+page to download and verify apache-VCL-2.4.1.tar.bz2, and put it in /root</p>
+</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>4<span class="p">.</span>1<span class="p">.</span><span class="n">tar</span><span class="p">.</span><span class="n">bz2</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Copy the <strong>web</strong> directory to a location under the web root of your web server and
+navigate to the destination <strong>.ht-inc</strong> subdirectory:</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>2<span class="p">.</span>4<span class="p">.</span>1<span class="o">/</span><span class="n">web</span><span class="o">/</span> <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="n">www</span><span class="o">/</span><span class="n">html</span><span class="o">/</span><span class="n">vcl</span><span class="o">-</span>2<span class="p">.</span>4<span class="p">.</span>1
+<span class="n">ln</span> <span class="o">-</span><span class="n">s</span> <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="n">www</span><span class="o">/</span><span class="n">html</span><span class="o">/</span><span class="n">vcl</span><span class="o">-</span>2<span class="p">.</span>4<span class="p">.</span>1 <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="n">www</span><span class="o">/</span><span class="n">html</span><span class="o">/</span><span class="n">vcl</span>
+<span class="n">cd</span> <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="n">www</span><span class="o">/</span><span class="n">html</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="p">.</span><span class="n">ht</span><span class="o">-</span><span class="n">inc</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Copy secrets-default.php to secrets.php:</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span class="n">secrets</span><span class="o">-</span><span class="n">default</span><span class="p">.</span><span class="n">php</span> <span class="n">secrets</span><span class="p">.</span><span class="n">php</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Edit the secrets.php file:</p>
+<div class="codehilite"><pre><span class="n">vi</span> <span class="n">secrets</span><span class="p">.</span><span class="n">php</span>
+</pre></div>
+
+
+<ul>
+<li>Set the following variables to match your database configuration:<ul>
+<li>$vclhost</li>
+<li>$vcldb</li>
+<li>$vclusername</li>
+<li>$vclpassword</li>
+</ul>
+</li>
+<li>Create random passwords for the following variables:<ul>
+<li>$cryptkey</li>
+<li>$pemkey</li>
+</ul>
+</li>
+<li>Save the secrets.php file</li>
+</ul>
+</li>
+<li>
+<p>Run the genkeys.sh</p>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">genkeys</span><span class="p">.</span><span class="n">sh</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Copy conf-default.php to conf.php:</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span class="n">conf</span><span class="o">-</span><span class="n">default</span><span class="p">.</span><span class="n">php</span> <span class="n">conf</span><span class="p">.</span><span class="n">php</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Modify conf.php to match your site</p>
+<div class="codehilite"><pre><span class="n">vi</span> <span class="n">conf</span><span class="p">.</span><span class="n">php</span>
+</pre></div>
+
+
+<ul>
+<li>Review every entry under "Things in this section must be modified/reviewed".
+Descriptions and pointers for each value are included within conf.php.</li>
+</ul>
+</li>
+<li>
+<p>Set the owner of the .ht-inc/maintenance directory to the web server user (normally 'apache'):</p>
+<div class="codehilite"><pre><span class="n">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>
+<ul>
+<li>If you set up your site to be https://my.server.org/vcl/ open https://my.server.org/vcl/testsetup.php</li>
+<li>Debug any issues reported by testsetup.php</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<p><strong>Log In to the VCL Website</strong></p>
+<ul>
+<li>
+<p>Open the index.php page in your browser (https://my.server.org/vcl/index.php)</p>
+<ul>
+<li>Select Local Account</li>
+<li>Username: admin</li>
+<li>Password: adminVc1passw0rd</li>
+</ul>
+</li>
+<li>
+<p>Set the admin user password (<strong>DO NOT skip this step</strong>):</p>
+<ul>
+<li>Click User Preferences</li>
+<li>Enter the current password: adminVc1passw0rd</li>
+<li>Enter a new password</li>
+<li>Click Submit Changes</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<p><strong>Add a Management Node to the Database</strong></p>
+<ul>
+<li>Click the Management Nodes link<ul>
+<li>Select Edit Management Node Profiles</li>
+<li>Click Submit</li>
+<li>Click Add New Management Node</li>
+<li>Fill in these required fields:<ul>
+<li>Hostname - The name of the management node server. This value doesn't
+necessarily need to be a name registered in DNS nor does it need to be the value
+displayed by the Linux hostname command. For example, if you are installing all of the
+VCL components on the same machine you can set this value to localhost.</li>
+<li>IP address - the public IP address of the management node</li>
+<li>SysAdmin Email Address - error emails will be sent to this address</li>
+<li>Install Path - this is parent directory under which image files will be
+stored - only required if doing bare metal installs or using VMWare with local disks</li>
+<li>End Node SSH Identity Key Files - enter /etc/vcl/vcl.key unless you know
+you are using a different SSH identity key file</li>
+</ul>
+</li>
+<li>Optionally, fill in these fields:<ul>
+<li>Address for Shadow Emails - End users are sent various emails about the
+status of their reservations. If this field is configured, copies of all of those emails
+will be sent to this address.</li>
+<li>Public NIC configuration method - this defaults to Dynamic DHCP - if DHCP
+is not available for the public interface of your nodes, you can set this to Static.
+Then, the IP configuration on the nodes will be manually set using Public Netmask,
+Public Gateway, Public DNS Server, and the IP address set for the computer under Manage
+Computers </li>
+</ul>
+</li>
+<li>Click Add Management Node</li>
+<li>A dialog will pop up informing you to add the management node to a group,
+read it and click Close</li>
+<li>select the allManagementNodes group on the right</li>
+<li>click <-Add</li>
+<li>click Close</li>
+</ul>
+</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: <a href="installphpmyadmin">phpMyAdmin Installation &
+Configuration</a></p>
+</li>
+</ol>
+<hr />
+<h2 id="managementnode">Install & 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>
+<ul>
+<li>VCL 2.4.1 Database Installation</li>
+<li>VCL 2.4.1 Web Code Installation</li>
+</ul>
+<p><strong>Supported Operating Systems:</strong></p>
+<p>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>
+<ul>
+<li>Red Hat Enterprise Linux 5.x</li>
+<li>Red Hat Enterprise Linux 6.x</li>
+<li>Red Hat Enterprise Linux 7.x</li>
+<li>CentOS 5.x</li>
+<li>CentOS 6.x</li>
+<li>CentOS 7.x</li>
+</ul>
+<p><strong>Required Linux Packages:</strong></p>
+<p>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). Note, there is
+overlap as some of the perl modules are available through the yum packager manager.</p>
+<ul>
+<li>expat-devel - Libraries and include files to develop XML applications with expat</li>
+<li>gcc - Various compilers (C, C++, Objective-C, Java, ...)</li>
+<li>krb5-devel - Development files needed to compile Kerberos 5 programs</li>
+<li>krb5-libs - The shared libraries used by Kerberos 5</li>
+<li>libxml2-devel - Libraries, includes, etc. to develop XML and HTML applications</li>
+<li>make - GNU make utility to maintain groups of programs</li>
+<li>nmap - Network exploration tool and security scanner</li>
+<li>openssh - The OpenSSH implementation of SSH protocol versions 1 and 2</li>
+<li>openssl-devel - Files for development of applications which will use OpenSSL</li>
+<li>perl - The Perl programming language</li>
+<li>perl-Archive-Tar - provides an object oriented mechanism for handling tar files</li>
+<li>perl-CPAN - provides a command interface (not a shell) to CPAN</li>
+<li>perl-Crypt-OpenSSL-RSA - provides the ability to RSA encrypt,decrypt strings</li>
+<li>perl-DBD-MySQL - A MySQL interface for perl</li>
+<li>perl-DBI - The DBI is the standard database interface module for Perl</li>
+<li>perl-Digest-SHA1 - allows use of NIST SHA-1 message digest algorithm within Perl programs</li>
+<li>perl-IO-String - provides the IO::File interface for in-core strings</li>
+<li>perl-MailTools - a subclass of MIME::Lite, used for sending mail from within perl</li>
+<li>perl-Net-Jabber - a tool to utilize the Jabber Instant Messaging protocol from within perl</li>
+<li>perl-Net-Netmask - parses and understands IPv4 CIDR blocks</li>
+<li>perl-Net-SSH-Expect - a wrapper to the ssh executable that is available in system's PATH</li>
+<li>perl-RPC-XML - provides classes for data, for clients, for servers and for parsers XML-RPC</li>
+<li>perl-Text-CSV_XS - provides the composition and decomposition of comma-separated values</li>
+<li>perl-Time-HiRes - provides high resolution time and timers</li>
+<li>perl-XML-Simple - provides a simple API layer on top of an underlying XML parsing module</li>
+<li>perl-YAML - implements a YAML Loader and Dumper </li>
+<li>xmlsec1-openssl - OpenSSL crypto plugin for XML Security Library</li>
+</ul>
+<p><strong>Required Perl Modules:</strong></p>
+<p>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>
+<ul>
+<li>CPAN - provides a command interface (not a shell) to CPAN</li>
+<li>DBI - Generic Database Interface</li>
+<li>Digest::SHA1 - NIST SHA message digest algorithm</li>
+<li>Frontier::Client - issue Frontier XML RPC requests to a server</li>
+<li>LWP::Protocol::https - support for using https schemed URLs with LWP</li>
+<li>JSON - JavaScript Object Notation</li>
+<li>Mail::Mailer - Simple mail agent interface</li>
+<li>Mo:builder - Adds the builder feature to Mo's has</li>
+<li>Net::SSH::Expect - a wrapper to the ssh executable that is available in system's PATH</li>
+<li>Object::InsideOut - Comprehensive inside-out object support</li>
+<li>RPC::XML - Set of classes for core data, message, XML handling</li>
+<li>Scalar::Util - A selection of general-utility scalar subroutines</li>
+<li>Time::HiRes - provides high resolution time and timers</li>
+<li>URI - Uniform Resource Identifiers (absolute and relative)</li>
+<li>YAML - YAML Ain't Markup Language
+<BR></li>
+</ul>
+<hr />
+<ol>
+<li>
+<p><strong>Install the VCL Management Node Code - Perl Daemon</strong></p>
+<ul>
+<li>
+<p>If you have not already done so, follow the instructions on the
+<a href="/downloads/download.cgi">download</a> page to download and verify
+apache-VCL-2.4.1.tar.bz2, and put it in /root</p>
+</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>4<span class="p">.</span>1<span class="p">.</span><span class="n">tar</span><span class="p">.</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>2<span class="p">.</span>4<span class="p">.</span>1<span class="o">/</span><span class="n">managementnode</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">vcl</span><span class="o">-</span>2<span class="p">.</span>4<span class="p">.</span>1
+<span class="n">ln</span> <span class="o">-</span><span class="n">s</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">vcl</span><span class="o">-</span>2<span class="p">.</span>4<span class="p">.</span>1 <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">vcl</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+<li>
+<p><strong>Install the Required Linux Packages & Perl Modules</strong></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="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">bin</span><span class="o">/</span><span class="n">install_perl_libs</span><span class="p">.</span><span class="n">pl</span>
+</pre></div>
+
+
+</li>
+</ul>
+<p>The last line of the install_perl_libs.pl script output should be:</p>
+<p><em>COMPLETE: installed all components</em></p>
+<p>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>
+</li>
+<li>
+<p><strong>Configure vcld.conf</strong></p>
+<ul>
+<li>
+<p>Create the /etc/vcl directory:</p>
+<div class="codehilite"><pre><span class="n">mkdir</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">vcl</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Copy the stock vcld.conf file to /etc/vcl:</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">vcld</span><span class="p">.</span><span class="n">conf</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">vcl</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Edit /etc/vcl/vcld.conf:</p>
+<div class="codehilite"><pre><span class="n">vi</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">vcld</span><span class="p">.</span><span class="n">conf</span>
+</pre></div>
+
+
+<p>The following lines must be configured in order to start the VCL daemon (vcld)
+and allow it to check in to the database:</p>
+<ul>
+<li>FQDN - the fully qualified name of the management node, this should match the
+name that was configured for the management node in the database</li>
+<li>server - the IP address or FQDN of the database server</li>
+<li>LockerWrtUser - database user account with write privileges</li>
+<li>wrtPass - database user password</li>
+<li>xmlrpc_pass - password for xmlrpc api from vcld to the web interface(can be
+long). This will be used later to sync the database vclsystem user account</li>
+<li>xmlrpc_url - URL for xmlrpc api
+https://my.server.org/vcl/index.php?mode=xmlrpccall</li>
+</ul>
+</li>
+<li>
+<p>Save the vcld.conf file</p>
+</li>
+</ul>
+</li>
+<li>
+<p><strong>Configure the SSH Client</strong></p>
+<p>The SSH client on the management node should be configured to prevent SSH processes
+spawned by the root user to the computers it controls from hanging because of missing or
+different entries in the known_hosts file. </p>
+<ul>
+<li>
+<p>Edit the ssh_config file:</p>
+<div class="codehilite"><pre><span class="n">vi</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">ssh</span><span class="o">/</span><span class="n">ssh_config</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Set the following parameters:</p>
+<ul>
+<li>UserKnownHostsFile /dev/null</li>
+<li>StrictHostKeyChecking no</li>
+</ul>
+</li>
+</ul>
+<p>Note: If you do not want these settings applied universally on the management node
+the SSH configuration can also be configured to only apply these settings to certain
+hosts or only for the root user. Consult the SSH documentation for more information.</p>
+</li>
+<li>
+<p><strong>Install and Start the VCL Daemon (vcld) Service</strong></p>
+<ul>
+<li>
+<p>Copy the vcld service script to /etc/init.d and name it vcld:</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">bin</span><span class="o">/</span><span class="n">S99vcld</span><span class="p">.</span><span class="n">linux</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">init</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">vcld</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Add the vcld service using chkconfig:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">chkconfig</span> <span class="o">--</span><span class="n">add</span> <span class="n">vcld</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Configure the vcld service to automatically run at runtime levels 3-5:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">chkconfig</span> <span class="o">--</span><span class="n">level</span> 345 <span class="n">vcld</span> <span class="n">on</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Start the vcld service:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">service</span> <span class="n">vcld</span> <span class="n">start</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Check the vcld service by monitoring the vcld.log file:</p>
+<div class="codehilite"><pre><span class="n">tail</span> <span class="o">-</span><span class="n">f</span> <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="nb">log</span><span class="o">/</span><span class="n">vcld</span><span class="p">.</span><span class="nb">log</span>
+</pre></div>
+
+
+</li>
+</ul>
+<p>You should see the following being added to the log file every few seconds if the
+management node is checking in with the database:</p>
+<div class="codehilite"><pre>2015<span class="o">-</span>01<span class="o">-</span>28 13<span class="p">:</span>23<span class="p">:</span>45<span class="o">|</span>25494<span class="o">|</span><span class="n">vcld</span><span class="p">:</span><span class="n">main</span><span class="p">(</span>167<span class="p">)</span><span class="o">|</span><span class="n">lastcheckin</span> <span class="n">time</span> <span class="n">updated</span> <span class="k">for</span> <span class="n">management</span> <span class="n">node</span> 1<span class="p">:</span> 2015<span class="o">-</span>01<span class="o">-</span>28 13<span class="p">:</span>23<span class="p">:</span>45
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Set the vclsystem account password for xmlrpc api</strong></p>
+<p>Using the vcld -setup tool, set the vclsystem account. This is needed to properly
+use the block allocation features.</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">bin</span><span class="o">/</span><span class="n">vcld</span> <span class="o">--</span><span class="n">setup</span>
+</pre></div>
+
+
+<p>Select the options listed below to set the password. When prompted paste or type the
+password from xmlrpc_pass variable in the vcld.conf file and hit enter. </p>
+<div class="codehilite"><pre><span class="n">Select</span> 6<span class="p">.</span> <span class="n">Set</span> <span class="n">Local</span> <span class="n">VCL</span> <span class="n">User</span> <span class="n">Account</span> <span class="n">Password</span>
+<span class="n">Select</span> 2<span class="p">.</span> <span class="n">vclsystem</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Install & Configure the DHCP Service</strong></p>
+<p>DHCP service is needed for the private network to provide address to provisioned
+machines.</p>
+<ul>
+<li>
+<p>Install dhcp if it is not already installed:</p>
+<div class="codehilite"><pre><span class="n">yum</span> <span class="n">install</span> <span class="n">dhcp</span> <span class="o">-</span><span class="n">y</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Configure the dhcpd service to automatically start at runlevels 3-5:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">chkconfig</span> <span class="n">dhcpd</span> <span class="n">on</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Configure the dhcpd.conf file.</p>
+<div class="codehilite"><pre><span class="n">vi</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">dhcpd</span><span class="p">.</span><span class="n">conf</span>
+<span class="o">-</span><span class="n">or</span><span class="o">-</span>
+<span class="n">vi</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">dhcp</span><span class="o">/</span><span class="n">dhcpd</span><span class="p">.</span><span class="n">conf</span>
+</pre></div>
+
+
+</li>
+</ul>
+<p>Configure your dhcpd.conf file according to your network configuration.
+The contents of the dhcpd.conf file will vary based on how your network is
+configured. Below is an example of a basic dhcpd.conf file:</p>
+<div class="codehilite"><pre><span class="n">ddns</span><span class="o">-</span><span class="n">update</span><span class="o">-</span><span class="n">style</span> <span class="n">none</span><span class="p">;</span>
+<span class="n">shared</span><span class="o">-</span><span class="n">network</span> <span class="n">eth0</span> <span class="p">{</span>
+ <span class="n">subnet</span> 10<span class="p">.</span>100<span class="p">.</span>0<span class="p">.</span>0 <span class="n">netmask</span> 255<span class="p">.</span>255<span class="p">.</span>255<span class="p">.</span>0 <span class="p">{</span>
+ <span class="n">ignore</span> <span class="n">unknown</span><span class="o">-</span><span class="n">clients</span><span class="p">;</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+
+
+<p>You will add host definitions to the dhcpd.conf file after you add computers to VCL
+using the website. The website allows you to select a set of computers for which to
+generate dhcpd.conf information, which can be copied and pasted into the dhcpd.conf file.</p>
+<ul>
+<li>
+<p>Start the dhcpd service:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">sbin</span><span class="o">/</span><span class="n">service</span> <span class="n">dhcpd</span> <span class="n">start</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+</ol>
+<hr />
+<h1 id="initial-administration-steps-after-installing-vcl">Initial Administration Steps After Installing VCL</h1>
+<p>After you have installed the VCL components, you need to do some initial administration
+of your new VCL install.</p>
+<ol>
+<li>
+<p>Add Computers</p>
+<ul>
+<li>If using <strong>bare-metal</strong> provisioning, follow the instruction
+on the <a href="addcomputers">Adding Computers</a> page, selecting <strong>Bare Metal</strong>
+as the computer Type</li>
+<li>If using <strong>VM</strong> provisioning:<ul>
+<li>Follow the instruction on the <a href="addcomputers">Adding Computers</a>
+page, selecting <strong>Bare Metal</strong> as the computer Type to add at least one
+VM Host</li>
+<li>Follow the instruction on the <a href="addcomputers">Adding Computers</a>
+page, selecting <strong>Virtual Machine</strong> as the computer Type to add some
+virtual computers</li>
+<li>Finally, <a href="assignvmtohost">Assign the VMs to VM hosts</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<p><a href="image-creation">Create Base Images</a></p>
+</li>
+<li>
+<p>Configure Authorization (follow links appropriate to your site)</p>
+<ul>
+<li><a href="localaccounts">Adding Local Accounts</a></li>
+<li><a href="ldapauth">Configuring LDAP Authentication</a></li>
+<li><a href="shibauth">Configuring Shibboleth Authentication</a></li>
+</ul>
+</li>
+</ol>
+<hr />
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2012 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache and the Apache feather logo are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>