Author: buildbot Date: Mon Jul 17 18:32:15 2017 New Revision: 1015598 Log: Staging update by buildbot for vcl
Added: websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.4.2to2.5.html Modified: websites/staging/vcl/trunk/content/ (props changed) Propchange: websites/staging/vcl/trunk/content/ ------------------------------------------------------------------------------ --- cms:source-revision (original) +++ cms:source-revision Mon Jul 17 18:32:15 2017 @@ -1 +1 @@ -1801976 +1802187 Added: websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.4.2to2.5.html ============================================================================== --- websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.4.2to2.5.html (added) +++ websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.4.2to2.5.html Mon Jul 17 18:32:15 2017 @@ -0,0 +1,336 @@ +<!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.3.2 to 2.4.2</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"> + <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="/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">Upgrade From 2.3.2 to 2.4.2</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.4.2 is the first 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.4.2/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>4<span class="p">.</span>2<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>4<span class="p">.</span>2<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.3.2 to VCL 2.4.2. Please note +it only applies for the upgrade from 2.3.2 to 2.4.2, 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.4.2 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.4.2.tar.bz2 and put in in /root</li> +<li> +<p><strong>extract VCL 2.4.2 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>4<span class="p">.</span>2<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>4<span class="p">.</span>2<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>4<span class="p">.</span>2<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>Update the web code</strong>. This step we will move the 2.3.2 web directory out of the +way, so we can copy in the new web code base. After copying in the new code, we will +migrate your configuration changes. 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>3<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">Deny</span> <span class="n">from</span> <span class="n">all</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>3<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">r</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>4<span class="p">.</span>2<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>4<span class="p">.</span>2 +<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>2 <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.3.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>3<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>Add new items to conf.php</strong>. The following items need to be added to the conf.php +file (they can be added anywhere as long as it is not inside an +array() definition):</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">SEMTIMEOUT</span>"<span class="p">,</span> "45"<span class="p">);</span> + +<span class="n">define</span><span class="p">(</span>"<span class="n">MAXINITIALIMAGINGTIME</span>"<span class="p">,</span> 720<span class="p">);</span> <span class="o">//</span> <span class="k">for</span> <span class="n">imaging</span> <span class="n">reservations</span><span class="p">,</span> <span class="n">users</span> <span class="n">will</span> <span class="n">have</span> <span class="n">at</span> <span class="n">least</span> <span class="n">this</span> <span class="n">long</span> <span class="n">as</span> <span class="n">the</span> <span class="n">max</span> <span class="n">selectable</span> <span class="n">duration</span> + +<span class="n">define</span><span class="p">(</span>"<span class="n">MAXSUBIMAGES</span>"<span class="p">,</span> 5000<span class="p">);</span> <span class="o">//</span> <span class="n">maximum</span> <span class="n">allowed</span> <span class="n">number</span> <span class="k">for</span> <span class="n">subimages</span> <span class="n">in</span> <span class="n">a</span> <span class="n">config</span> + +# <span class="n">boolean</span> <span class="n">value</span> <span class="n">of</span> 0 <span class="n">or</span> 1 <span class="n">to</span> <span class="n">enable</span> <span class="n">documentation</span> <span class="n">links</span> <span class="n">on</span> <span class="n">login</span> <span class="n">page</span> <span class="n">and</span> <span class="n">page</span> +# <span class="n">where</span> <span class="n">authentication</span> <span class="n">method</span> <span class="n">is</span> <span class="n">selected</span> +# 0 <span class="p">=</span> <span class="n">disables</span><span class="p">;</span> 1 <span class="p">=</span> <span class="n">enabled</span> +<span class="n">define</span><span class="p">(</span>"<span class="n">NOAUTH_HOMENAV</span>"<span class="p">,</span> 0<span class="p">);</span> + +# <span class="n">boolean</span> <span class="n">value</span> <span class="n">of</span> 0 <span class="n">or</span> 1 <span class="n">to</span> <span class="n">control</span> <span class="n">logging</span> <span class="n">of</span> <span class="n">non</span> <span class="n">SELECT</span> <span class="n">database</span> <span class="n">queries</span> <span class="k">for</span> <span class="n">auditing</span> <span class="n">or</span> <span class="n">debugging</span> <span class="n">purposes</span><span class="p">;</span> <span class="n">queries</span> <span class="n">are</span> <span class="n">logged</span> <span class="n">to</span> <span class="n">the</span> <span class="n">querylog</span> <span class="n">table</span> +<span class="n">define</span><span class="p">(</span>"<span class="n">QUERYLOGGING</span>"<span class="p">,</span> 1<span class="p">);</span> + +# <span class="n">boolean</span> <span class="n">value</span> <span class="n">of</span> 0 <span class="n">or</span> 1 <span class="n">to</span> <span class="n">control</span> <span class="n">logging</span> <span class="n">of</span> <span class="n">XMLRPC</span> <span class="n">calls</span> <span class="k">for</span> <span class="n">auditing</span> <span class="n">or</span> <span class="n">debugging</span> <span class="n">purposes</span><span class="p">;</span> <span class="n">queries</span> <span class="n">are</span> <span class="n">logged</span> <span class="n">to</span> <span class="n">the</span> <span class="n">xmlrpcLog</span> <span class="n">table</span> +<span class="n">define</span><span class="p">(</span>"<span class="n">XMLRPCLOGGING</span>"<span class="p">,</span> 1<span class="p">);</span> + +# <span class="n">documentation</span> <span class="n">links</span> <span class="n">to</span> <span class="n">display</span> <span class="n">on</span> <span class="n">login</span> <span class="n">page</span> <span class="n">and</span> <span class="n">page</span> +# <span class="n">where</span> <span class="n">authentication</span> <span class="n">method</span> <span class="n">is</span> <span class="n">selected</span> <span class="n">when</span> <span class="n">NOAUTH_HOMENAV</span> <span class="n">is</span> <span class="n">set</span> <span class="n">to</span> 1 +$<span class="n">NOAUTH_HOMENAV</span> <span class="p">=</span> <span class="n">array</span> <span class="p">(</span> + "<span class="n">What</span> <span class="n">is</span> <span class="n">VCL</span>" <span class="p">=</span><span class="o">></span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">vcl</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="p">,</span> + "<span class="n">How</span> <span class="n">to</span> <span class="n">use</span> <span class="n">VCL</span>" <span class="p">=</span><span class="o">></span> "<span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">cwiki</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">confluence</span><span class="o">/</span><span class="n">display</span><span class="o">/</span><span class="n">VCL</span><span class="o">/</span><span class="n">Using</span><span class="o">+</span><span class="n">VCL</span>"<span class="p">,</span> + "<span class="n">Report</span> <span class="n">a</span> <span class="n">Problem</span>" <span class="p">=</span><span class="o">></span> "<span class="n">mailto</span><span class="p">:</span>" <span class="p">.</span> <span class="n">HELPEMAIL</span><span class="p">,</span> +<span class="p">);</span> +</pre></div> + + +</li> +<li> +<p><strong>Make the maintenance directory writable</strong> by the web server user. Normally this is +the apache user, if using a different user change below cmd 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> +</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>Backup management node code</strong>. This step will make a backup copy of the 2.3.2<br /> +management node code. These instructions assume that you installed the +VCL management node code at /usr/local/vcl. If you installed it elsewhere, replace +/usr/local with your management node path.</p> +<div class="codehilite"><pre><span class="n">cp</span> <span class="o">-</span><span class="n">r</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>3<span class="p">.</span>2 +</pre></div> + + +</li> +<li> +<p><strong>Copy in the 2.4.2 management node code</strong> to /usr/local. First, rename the existing +management node code directory to vcl-2.4.2 so that any drivers or other files you've +added are preserved. Then, create a symlink for /usr/local/vcl and copy the new +management code over top of it.</p> +<div class="codehilite"><pre><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>4<span class="p">.</span>2 +<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>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><span class="n">bin</span><span class="o">/</span><span class="n">cp</span> <span class="o">-</span><span class="n">r</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>4<span class="p">.</span>2<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> +</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 © 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>