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 2019/06/10 15:08:18 UTC
svn commit: r1046074 - in /websites/staging/vcl/trunk/content: ./
docs/UpgradePreviousVersions/UpgradeFrom2.5to2.5.1.html
Author: buildbot
Date: Mon Jun 10 15:08:17 2019
New Revision: 1046074
Log:
Staging update by buildbot for vcl
Added:
websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.5to2.5.1.html
Modified:
websites/staging/vcl/trunk/content/ (props changed)
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Jun 10 15:08:17 2019
@@ -1 +1 @@
-1860950
+1860952
Added: websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.5to2.5.1.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.5to2.5.1.html (added)
+++ websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.5to2.5.1.html Mon Jun 10 15:08:17 2019
@@ -0,0 +1,361 @@
+<!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 - Upgrade From 2.4.2 to 2.5</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="left-column">
+ <div id="navigation">
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<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="http://www.apache.org/licenses/">License</a></li>
+<li><a href="http://www.apache.org/security/">Security</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="https://cwiki.apache.org/confluence/display/VCL/Apache+VCL" target="_blank">Confluence Wiki</a><ul>
+<li></li>
+</ul>
+</li>
+<li><a href="https://issues.apache.org/jira/browse/VCL" target="_blank">Jira Issue Tracking</a><ul>
+<li></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="/dev/index.html">Development</a><ul>
+<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">Sponsorship</a></li>
+</ul>
+</li>
+</ul>
+ </div>
+ <div id="current-event">
+ <a href="https://www.apache.org/events/current-event.html"><img src="https://www.apache.org/events/current-event-125x125.png"/></a>
+ </div>
+ </div>
+
+ <div id="content">
+ <h1 class="title">Upgrade From 2.4.2 to 2.5</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="scripted-upgrade">Scripted Upgrade<a class="headerlink" href="#scripted-upgrade" title="Permanent link">¶</a></h1>
+<p>VCL 2.5 is the second release to include an upgrade script. All you need to
+upgrade VCL is the script. It will download and validate the VCL software and
+then upgrade your system. The script can be used to upgrade all three parts of
+VCL (database, web portal, and management node) or to upgrade each part
+individually. It works for upgrading from any previous version of Apache VCL.</p>
+<p><a href="https://www.apache.org/dist/vcl/2.5/vcl-upgrade.sh">Download Upgrade Script (vcl-upgrade.sh)</a></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>5<span class="o">/</span><span class="n">vcl</span><span class="o">-</span><span class="n">upgrade</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">upgrade</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>5<span class="o">/</span><span class="n">vcl</span><span class="o">-</span><span class="n">upgrade</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">upgrade</span><span class="p">.</span><span class="n">sh</span><span class="p">.</span><span class="n">asc</span>
+</pre></div>
+
+
+<p>Running the upgrade script with no arguments will step you through upgrading
+all three parts of VCL. Alternatively, the following explains optional
+arguments. If upgrading 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.</p>
+<div class="codehilite"><pre><span class="n">vcl</span><span class="o">-</span><span class="n">upgrade</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="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">dbadminuser</span> <span class="o"><</span><span class="n">username</span><span class="o">></span><span class="p">]</span>
+ <span class="p">[</span><span class="o">--</span><span class="n">dbadminpass</span> <span class="o"><</span><span class="n">password</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">upgrade</span> <span class="n">database</span> <span class="n">components</span>
+ <span class="o">--</span><span class="n">dbhost</span> <span class="n">may</span> <span class="n">optionally</span> <span class="n">be</span> <span class="n">specified</span> <span class="k">if</span> <span class="n">not</span> <span class="n">localhost</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">upgrade</span> <span class="n">web</span> <span class="n">server</span> <span class="n">components</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">upgrade</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="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">dbname</span> <span class="o"><</span><span class="n">name</span><span class="o">></span> <span class="o">-</span> <span class="n">name</span> <span class="n">of</span> <span class="n">VCL</span> <span class="n">database</span> <span class="n">on</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">vcl</span><span class="p">)</span>
+
+<span class="o">--</span><span class="n">dbadminuser</span> <span class="o"><</span><span class="n">username</span><span class="o">></span> <span class="o">-</span> <span class="n">admin</span> <span class="n">username</span> <span class="k">for</span> <span class="n">database</span><span class="p">;</span> <span class="n">must</span> <span class="n">have</span> <span class="n">access</span>
+ <span class="n">to</span> <span class="n">modify</span> <span class="n">database</span> <span class="n">schema</span> <span class="n">and</span> <span class="n">dump</span> <span class="n">data</span> <span class="k">for</span> <span class="n">backup</span> <span class="p">(</span><span class="n">default</span><span class="p">=</span><span class="n">root</span><span class="p">)</span>
+
+<span class="o">--</span><span class="n">dbadminpass</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">dbadminuser</span> <span class="p">(</span><span class="n">default</span><span class="p">=[</span><span class="n">no</span> <span class="n">password</span><span class="p">])</span>
+</pre></div>
+
+
+<hr />
+<h1 id="manual-upgrade-instructions">Manual Upgrade Instructions<a class="headerlink" href="#manual-upgrade-instructions" title="Permanent link">¶</a></h1>
+<p>These instructions explain how to upgrade from VCL 2.4.2 to VCL 2.5. Please note
+it only applies for the upgrade from 2.4.2 to 2.5, this may or may not work for other
+versions.</p>
+<p><strong>The basic steps that will be performed</strong></p>
+<ul>
+<li>Download and Extract 2.5 code </li>
+<li>Shutdown httpd and vcld services</li>
+<li>Create backup of vcl database </li>
+<li>Update mysql schema</li>
+<li>Update web code, create a backup, copy in new, make changes </li>
+<li>Restart httpd service</li>
+<li>Update management node VCL code, create a backup, copy in new, make changes </li>
+<li>Restart vcld service</li>
+</ul>
+<h3 id="upgrade-steps">Upgrade steps<a class="headerlink" href="#upgrade-steps" title="Permanent link">¶</a></h3>
+<ol>
+<li>follow instructions on the <a href="http://vcl.apache.org/downloads/download.cgi">VCL download</a>
+page to download and verify apache-VCL-2.5.tar.bz2 and put in in /root</li>
+<li>
+<p><strong>extract VCL 2.5 code</strong></p>
+<div class="codehilite"><pre><span class="n">tar</span> <span class="n">xf</span> <span class="n">apache</span><span class="o">-</span><span class="n">VCL</span><span class="o">-</span>2<span class="p">.</span>5<span class="p">.</span><span class="n">tar</span><span class="p">.</span><span class="n">bz2</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Shutdown</strong> the httpd and vcld services</p>
+<div class="codehilite"><pre><span class="n">service</span> <span class="n">httpd</span> <span class="n">stop</span>
+<span class="n">service</span> <span class="n">vcld</span> <span class="n">stop</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>create a <strong>backup</strong> of the VCL database. This will provide a restore point if
+necessary.</p>
+<div class="codehilite"><pre><span class="n">mysqldump</span> <span class="n">vcl</span> <span class="o">></span> <span class="o">~/</span><span class="n">vcl</span><span class="o">-</span><span class="n">pre2</span><span class="p">.</span>5<span class="o">-</span><span class="n">upgrade</span><span class="p">.</span><span class="n">sql</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>This step <strong>updates the database</strong> schema.</p>
+<div class="codehilite"><pre><span class="n">mysql</span> <span class="n">vcl</span> <span class="o"><</span> <span class="o">/</span><span class="n">root</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>5<span class="o">/</span><span class="n">mysql</span><span class="o">/</span><span class="n">update</span><span class="o">-</span><span class="n">vcl</span><span class="p">.</span><span class="n">sql</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Possibly move old web code</strong>. If /var/www/html/vcl <strong>is a directory</strong>, rename it to
+/var/www/html/vcl-2.4.2. These instructions assume that you installed the
+VCL web code at /var/www/html/vcl. If you installed it elsewhere, replace
+/var/www/html/vcl with your vcl web root.</p>
+<div class="codehilite"><pre><span class="n">mv</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="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>2
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Disable access</strong> to the old web code</p>
+<div class="codehilite"><pre><span class="n">echo</span> "<span class="n">Require</span> <span class="n">all</span> <span class="n">denied</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>2<span class="o">/</span><span class="p">.</span><span class="n">htaccess</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Copy the new code</strong> in place</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span class="o">-</span><span class="n">ar</span> <span class="o">/</span><span class="n">root</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>5<span class="o">/</span><span class="n">web</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>5
+<span class="n">ln</span> <span class="o">-</span><span class="n">sfn</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>5 <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>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Copy your 2.4.2 config files</strong></p>
+<div class="codehilite"><pre><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>2<span class="p">.</span>4<span class="p">.</span>2<span class="o">/</span><span class="p">.</span><span class="n">ht</span><span class="o">-</span><span class="n">inc</span>
+<span class="n">cp</span> <span class="n">conf</span><span class="p">.</span><span class="n">php</span> <span class="n">secrets</span><span class="p">.</span><span class="n">php</span> <span class="n">pubkey</span><span class="p">.</span><span class="n">pem</span> <span class="n">keys</span><span class="p">.</span><span class="n">pem</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><strong>Set SELinux context</strong> If you are using SELinux, set the correct context:</p>
+<div class="codehilite"><pre><span class="n">chcon</span> <span class="o">-</span><span class="n">R</span> <span class="o">-</span><span class="n">t</span> <span class="n">httpd_sys_content_t</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>5
+<span class="n">chcon</span> <span class="o">-</span><span class="n">t</span> <span class="n">httpd_sys_rw_content_t</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>5<span class="o">/</span><span class="p">.</span><span class="n">ht</span><span class="o">-</span><span class="n">inc</span><span class="o">/</span><span class="n">maintenance</span>
+<span class="n">chcon</span> <span class="o">-</span><span class="n">t</span> <span class="n">httpd_sys_rw_content_t</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>5<span class="o">/</span><span class="p">.</span><span class="n">ht</span><span class="o">-</span><span class="n">inc</span><span class="o">/</span><span class="n">cryptkey</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Update conf.php</strong>. The following item needs to be removed from the conf.php
+file:</p>
+<div class="codehilite"><pre><span class="p">(</span><span class="n">don</span><span class="o">'</span><span class="n">t</span> <span class="n">forget</span> <span class="n">to</span> <span class="n">edit</span> <span class="n">conf</span><span class="p">.</span><span class="n">php</span> <span class="n">in</span> <span class="n">the</span> <span class="o">**</span><span class="n">new</span><span class="o">**</span> <span class="n">location</span><span class="p">)</span>
+<span class="n">vim</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><span class="o">/</span><span class="n">conf</span><span class="p">.</span><span class="n">php</span>
+</pre></div>
+
+
+<p><br></p>
+<div class="codehilite"><pre><span class="n">define</span><span class="p">(</span>"<span class="n">MAXVMLIMIT</span>"<span class="p">,</span> "100"<span class="p">);</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Update secrets.php</strong> $cryptkey in secrets.php needs to be generated
+using openssl. Generate the value and set it in secrets.php:</p>
+<div class="codehilite"><pre><span class="n">openssl</span> <span class="nb">rand</span> 32 <span class="o">|</span> <span class="n">base64</span>
+<span class="n">vim</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><span class="o">/</span><span class="n">secrets</span><span class="p">.</span><span class="n">php</span>
+</pre></div>
+
+
+<p><br></p>
+<div class="codehilite"><pre>$<span class="n">cryptkey</span> <span class="p">=</span> <span class="s">'xxxxxxxxxxxxxxxxxxxxxxxxx'</span><span class="p">;</span> # <span class="n">set</span> <span class="n">this</span> <span class="n">to</span> <span class="n">output</span> <span class="n">of</span> "<span class="n">openssl</span> <span class="nb">rand</span> 32 <span class="o">|</span> <span class="n">base64</span>"
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Make the maintenance and cryptkey directories writable</strong> by the web server user. Normally this is
+the apache user, if using a different user change below command accordingly.</p>
+<div class="codehilite"><pre><span class="n">chown</span> <span class="n">apache</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><span class="o">/</span><span class="n">maintenance</span>
+<span class="n">chown</span> <span class="n">apache</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><span class="o">/</span><span class="n">cryptkey</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Start httpd service</strong></p>
+<div class="codehilite"><pre><span class="n">service</span> <span class="n">httpd</span> <span class="n">start</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Check testsetup.php</strong> Check that everything is correct by viewing the testsetup.php
+script in your browser. This script is located in the same directory as the index.php script.
+I.e.</p>
+<div class="codehilite"><pre><span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">your</span><span class="p">.</span><span class="n">site</span><span class="p">.</span><span class="n">url</span><span class="o">/</span><span class="n">vcl</span><span class="o">/</span><span class="n">testsetup</span><span class="p">.</span><span class="n">php</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Copy old management node code</strong> If /usr/local/vcl is a directory, copy it to
+/usr/local/vcl-2.4.2, rename /usr/local/vcl to /usr/local/vcl-2.5, and create a symlink.
+If /usr/local/vcl is a symlink to vcl-2.4.2, copy /usr/local/vcl-2.4.2 to /usr/local/vcl-2.5
+and update the symlink.</p>
+<div class="codehilite"><pre><span class="p">(</span><span class="k">for</span> <span class="n">directory</span><span class="p">)</span>
+<span class="n">cp</span> <span class="o">-</span><span class="n">ar</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">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>2
+<span class="n">mv</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">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>5
+<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>5 <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>
+
+
+<p><br></p>
+<div class="codehilite"><pre><span class="p">(</span><span class="k">for</span> <span class="n">symlink</span><span class="p">)</span>
+<span class="n">cp</span> <span class="o">-</span><span class="n">ar</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>2 <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>5
+<span class="n">ln</span> <span class="o">-</span><span class="n">sfn</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>5 <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>
+<li>
+<p><strong>Copy new code in place</strong> Copy the new management node code over the old code:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">bin</span><span class="o">/</span><span class="n">cp</span> <span class="o">-</span><span class="n">ar</span> <span class="o">/</span><span class="n">root</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>5<span class="o">/</span><span class="n">managementnode</span><span class="o">/*</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>5
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Run install_perl_libs.pl</strong> to add any new perl library requirements:</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">install_perl_libs</span><span class="p">.</span><span class="n">pl</span>
+</pre></div>
+
+
+</li>
+<li>
+<p><strong>Start vcld service</strong></p>
+<div class="codehilite"><pre><span class="n">service</span> <span class="n">vcld</span> <span class="n">start</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Make some <strong>test reservations</strong> and watch the vcld.log to verify everything is working
+correctly.</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>
+</ol>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2019 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>