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 2012/10/11 20:35:26 UTC
svn commit: r834823 - in /websites/staging/vcl/trunk/content: ./
docs/UpgradePreviousVersions/
docs/UpgradePreviousVersions/UpgradeFrom2.2.1to2.3.html
Author: buildbot
Date: Thu Oct 11 18:35:26 2012
New Revision: 834823
Log:
Staging update by buildbot for vcl
Added:
websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/
websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.2.1to2.3.html
Modified:
websites/staging/vcl/trunk/content/ (props changed)
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Oct 11 18:35:26 2012
@@ -1 +1 @@
-1397205
+1397222
Added: websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.2.1to2.3.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.2.1to2.3.html (added)
+++ websites/staging/vcl/trunk/content/docs/UpgradePreviousVersions/UpgradeFrom2.2.1to2.3.html Thu Oct 11 18:35:26 2012
@@ -0,0 +1,261 @@
+<!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 - </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>Information<ul>
+<li><a href="/info/about.html">What is VCL?</a></li>
+<li><a href="/info/features.html">Features</a></li>
+<li><a href="/info/architecture.html">Architecture</a></li>
+<li><a href="/info/use-cases.html">Use Cases</a></li>
+<li><a href="/downloads/download.cgi">Download</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a></li>
+<li><a href="/info/faq.html">FAQ</a></li>
+</ul>
+</li>
+<li><a href="/docs/index.html">Documentation</a><ul>
+<li><a href="/docs/using-vcl.html">Using VCL</a></li>
+<li><a href="/docs/image-creation.html">Image Creation</a></li>
+<li><a href="/docs/administration.html">Administration</a></li>
+<li><a href="/docs/installation.html">Installation</a></li>
+<li><a href="/docs/deployment-planning.html">Deployment Planning</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/index.html#how-do-i-join-the-project">How can I Join</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"></h1>
+ <p>This page provides information on how to upgrade from VCL 2.2.1 to VCL 2.3. Please note it only applies for the upgrade from 2.2.1 to 2.3, 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.3 code </li>
+<li>Shutdown httpd and vcld services</li>
+<li>Create backup of vcl database </li>
+<li>Update mysql schema 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>
+<p><strong>Download and Extract 2.3 code</strong></p>
+<ol>
+<li>follow instructions on VCL 2.3 Release page to download and verify apache-VCL-2.3.tar.bz2 and put in in /root</li>
+<li>
+<p>extract VCL 2.3 code</p>
+<div class="codehilite"><pre><span class="n">tar</span> <span class="n">xjf</span> <span class="n">apache</span><span class="o">-</span><span class="n">VCL</span><span class="o">-</span><span class="mf">2.3</span><span class="o">.</span><span class="n">tar</span><span class="o">.</span><span class="n">bz2</span>
+</pre></div>
+
+
+</li>
+</ol>
+<p><strong>Shutdown services</strong></p>
+<p>Shutdown 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="ow">or</span> <span class="sr">/etc/i</span><span class="n">nit</span><span class="o">.</span><span class="n">d</span><span class="o">/</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> <span class="ow">or</span> <span class="sr">/etc/i</span><span class="n">nit</span><span class="o">.</span><span class="n">d</span><span class="o">/</span><span class="n">vcld</span> <span class="n">stop</span>
+</pre></div>
+
+
+<p><strong>Create a backup of vcl database</strong></p>
+<p>We will create a backup 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="mf">.3</span><span class="o">-</span><span class="n">upgrade</span><span class="o">.</span><span class="n">sql</span>
+</pre></div>
+
+
+<p><strong>Update mysql schema</strong></p>
+<p>This step updates the mysql schema.</p>
+<div class="codehilite"><pre> <span class="n">cd</span> <span class="sr">/root/</span><span class="n">apache</span><span class="o">-</span><span class="n">VCL</span><span class="o">-</span><span class="mf">2.3</span>
+ <span class="n">mysql</span> <span class="n">vcl</span> <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="o">.</span><span class="n">sql</span>
+</pre></div>
+
+
+<p><em>One item of note</em>: A new resource group is added in update-vcl.sql - <strong>all profiles</strong>. Access to manage the group is added to the VCL->admin node in the privilege tree if that node exists. If not, you will need to add it manually after starting httpd again. To add it manually, pick a node in the privilege tree, scroll to Resources, click Add Resource Group, select serverprofile/all profiles from the drop-down box, check available, administer, manageGroup, and manageMapping, and click Submit New Resource Group.</p>
+<p><strong>Update web code</strong></p>
+<p>This step we will move the 2.2.1 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>
+<ol>
+<li>
+<p>move your old code out of the way</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="sr">/var/</span><span class="n">www</span><span class="o">/</span><span class="n">html</span>
+<span class="n">mv</span> <span class="n">vcl</span> <span class="o">~/</span><span class="n">vcl_2</span><span class="mf">.2.1_</span><span class="n">web</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>copy the new code in place</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="sr">/root/</span><span class="n">apache</span><span class="o">-</span><span class="n">VCL</span><span class="o">-</span><span class="mf">2.3</span>
+<span class="n">cp</span> <span class="o">-</span><span class="n">r</span> <span class="n">web</span> <span class="sr">/var/</span><span class="n">www</span><span class="sr">/html/</span><span class="n">vcl</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>copy your 2.2.1 config files</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="o">~</span><span class="sr">/vcl_2.2.1_web/</span><span class="o">.</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="o">.</span><span class="n">php</span> <span class="n">secrets</span><span class="o">.</span><span class="n">php</span> <span class="n">pubkey</span><span class="o">.</span><span class="n">pem</span> <span class="nb">keys</span><span class="o">.</span><span class="n">pem</span> <span class="sr">/var/</span><span class="n">www</span><span class="sr">/html/</span><span class="n">vcl</span><span class="o">/.</span><span class="n">ht</span><span class="o">-</span><span class="n">inc</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Make the maintenance directory writable by the web server user. You will need to know what user httpd runs as on your server. This can be found with</p>
+<div class="codehilite"><pre><span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="nb">grep</span> <span class="n">httpd</span>
+</pre></div>
+
+
+<p>Look at the first column. One process will be owned by root. The remaining processes will be owned by the web server user. Now, own /var/www/html/vcl/.ht-inc/maintenance to that user (replacing 'apache' with your web server user if different):</p>
+<div class="codehilite"><pre><span class="nb">chown</span> <span class="n">apache</span> <span class="sr">/var/</span><span class="n">www</span><span class="sr">/html/</span><span class="n">vcl</span><span class="sr">/.ht-inc/m</span><span class="n">aintenance</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>make some changes to conf.php:</p>
+</li>
+</ol>
+<p>a. A new user group permission that controls who can manage block allocations globally or for a specific affiliation has been added. It can be granted to any user group under Privileges->Additional User Permissions->Manage Block Allocations. Users with this permission are notified of new block allocation requests. Remove</p>
+<div class="codehilite"><pre> <span class="nv">$blockNotifyUsers</span>
+</pre></div>
+
+
+<p>from conf.php.</p>
+<p>b. A new user group permission that controls who can look up users globally or for a specific affiliation has been added. It can be granted to any user group under Privileges->Additional User Permissions->User Lookup. Users with this permission can look up information about other users. Remove</p>
+<div class="codehilite"><pre> <span class="nv">$userlookupUsers</span>
+</pre></div>
+
+
+<p>c. Multilingualization has been added VCL. So, DEFAULTLOCALE has been added to conf.php to set the default locale. Add</p>
+<div class="codehilite"><pre> <span class="n">define</span><span class="p">(</span><span class="s">"DEFAULTLOCALE"</span><span class="p">,</span> <span class="s">"en_US"</span><span class="p">);</span>
+</pre></div>
+
+
+<p>to conf.php, changing en_US if needed to match your locale. You can look in /var/www/html/vcl/locale to see which ones are available.</p>
+<p>d. Users authenticated using Shibboleth without also having an LDAP server can now be added before they log in. Add</p>
+<div class="codehilite"><pre> <span class="n">define</span><span class="p">(</span><span class="s">"ALLOWADDSHIBUSERS"</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span>
+</pre></div>
+
+
+<p>to conf.php. If you are using Shibboleth and would like to be able to add users to groups before the user has ever logged in to VCL, you can set this to 1. However, please note that if you typo the userid, there is no way to verify it, and the user will be added with the typoed userid.</p>
+<p>e. Some LDAP related items have been simplified in the code using some additional options in $authMechs. For any LDAP entries, you need to add two options. "lookupuserbeforeauth" is used if you need VCL to look up the full DN of a user and use that when doing the bind that authenticates the user (if you don't know what this means, leave it set to 0). If you need to set it to 1, then you will need to set "lookupuserfield" to what LDAP attribute to use when looking up the user's DN (typically either 'cn', 'uid', or 'samaccountname'). Add</p>
+<div class="codehilite"><pre> <span class="s">"lookupuserbeforeauth"</span> <span class="o">=></span> <span class="mi">0</span><span class="p">,</span>
+ <span class="s">"lookupuserfield"</span> <span class="o">=></span> <span class="s">''</span><span class="p">,</span>
+</pre></div>
+
+
+<p>to each LDAP array you have in the $authMech array in conf.php.</p>
+<p>f. If you are using any Local accounts for authentication, you need to modify the entries for $addUserFunc and $updateUserFunc. Change</p>
+<div class="codehilite"><pre> <span class="nv">$addUserFunc</span><span class="p">[</span><span class="nv">$item</span><span class="p">[</span><span class="s">'affiliationid'</span><span class="p">]]</span> <span class="o">=</span> <span class="n">create_function</span><span class="p">(</span><span class="s">''</span><span class="p">,</span> <span class="s">'return 0;'</span><span class="p">);</span>
+ <span class="nv">$updateUserFunc</span><span class="p">[</span><span class="nv">$item</span><span class="p">[</span><span class="s">'affiliationid'</span><span class="p">]]</span> <span class="o">=</span> <span class="n">create_function</span><span class="p">(</span><span class="s">''</span><span class="p">,</span> <span class="s">'return 0;'</span><span class="p">);</span>
+</pre></div>
+
+
+<p>to</p>
+<div class="codehilite"><pre> <span class="nv">$addUserFunc</span><span class="p">[</span><span class="nv">$item</span><span class="p">[</span><span class="s">'affiliationid'</span><span class="p">]]</span> <span class="o">=</span> <span class="n">create_function</span><span class="p">(</span><span class="s">''</span><span class="p">,</span> <span class="s">'return NULL;'</span><span class="p">);</span>
+ <span class="nv">$updateUserFunc</span><span class="p">[</span><span class="nv">$item</span><span class="p">[</span><span class="s">'affiliationid'</span><span class="p">]]</span> <span class="o">=</span> <span class="n">create_function</span><span class="p">(</span><span class="s">''</span><span class="p">,</span> <span class="s">'return NULL;'</span><span class="p">);</span>
+</pre></div>
+
+
+<p><strong>Restart httpd service</strong></p>
+<div class="codehilite"><pre> <span class="n">service</span> <span class="n">httpd</span> <span class="n">start</span> <span class="ow">or</span> <span class="sr">/etc/i</span><span class="n">nit</span><span class="o">.</span><span class="n">d</span><span class="o">/</span><span class="n">httpd</span> <span class="n">start</span>
+</pre></div>
+
+
+<p><strong>Update management node code</strong></p>
+<div class="codehilite"><pre> <span class="n">This</span> <span class="n">step</span> <span class="n">will</span> <span class="n">make</span> <span class="n">a</span> <span class="n">backup</span> <span class="n">copy</span> <span class="n">of</span> <span class="n">the</span> <span class="mf">2.2.1</span> <span class="n">vcl</span> <span class="n">code</span> <span class="n">base</span> <span class="ow">and</span> <span class="k">then</span> <span class="n">copy</span> <span class="n">the</span> <span class="k">new</span> <span class="n">code</span> <span class="n">over</span> <span class="n">the</span> <span class="n">existing</span> <span class="n">code</span> <span class="n">to</span> <span class="n">preserve</span> <span class="n">any</span> <span class="n">drivers</span> <span class="ow">or</span> <span class="n">other</span> <span class="n">files</span> <span class="n">you</span><span class="err">'</span><span class="n">ve</span> <span class="n">added</span><span
class="o">.</span>
+</pre></div>
+
+
+<ol>
+<li>
+<p>Copy 2.2.1 code base to a backup location</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="o"><</span><span class="n">your</span> <span class="n">vcl</span> <span class="n">MN</span> <span class="n">code</span> <span class="n">root</span> <span class="n">path</span><span class="o">></span>
+<span class="n">ie</span><span class="o">.</span> <span class="n">cd</span> <span class="sr">/usr/</span><span class="nb">local</span><span class="o">/</span>
+<span class="n">cp</span> <span class="o">-</span><span class="n">r</span> <span class="n">vcl</span> <span class="o">~/</span><span class="n">vcl_2</span><span class="mf">.2.1_</span><span class="n">managementnode</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Copy in the 2.3 code base to /usr/local, copying in should preserve any drivers or other files you've added.</p>
+<div class="codehilite"><pre><span class="sr">/bin/c</span><span class="n">p</span> <span class="o">-</span><span class="n">r</span> <span class="sr">/root/</span><span class="n">apache</span><span class="o">-</span><span class="n">VCL</span><span class="o">-</span><span class="mf">2.3</span><span class="sr">/managementnode/</span><span class="o">*</span> <span class="sr">/usr/</span><span class="nb">local</span><span class="o">/</span><span class="n">vcl</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>Run install_perl_libs.pl to add any new perl library requirements:</p>
+<div class="codehilite"><pre><span class="sr">/usr/</span><span class="nb">local</span><span class="sr">/vcl/</span><span class="n">bin</span><span class="o">/</span><span class="n">install_perl_libs</span><span class="o">.</span><span class="n">pl</span>
+</pre></div>
+
+
+</li>
+</ol>
+<p><strong>Restart vcld service</strong></p>
+<div class="codehilite"><pre> <span class="n">service</span> <span class="n">vcld</span> <span class="n">start</span> <span class="ow">or</span> <span class="sr">/etc/i</span><span class="n">nit</span><span class="o">.</span><span class="n">d</span><span class="o">/</span><span class="n">vcld</span> <span class="n">start</span>
+</pre></div>
+ </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>