Show
Ignore:
Timestamp:
08/05/09 16:24:19 (3 years ago)
Author:
david
Message:

updating migration docs

Files:
1 modified

Legend:

Unmodified
Added
Removed

  • enpraxis.educommons/trunk/enpraxis/educommons/docs/MIGRATIONS_OLD.html

    r8 r515  
    55<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
    66<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" /> 
    7 <title>Migrating to eduCommons 3.0.2</title> 
     7<title></title> 
    88<link rel="stylesheet" href="./default.css" type="text/css" /> 
    99</head> 
    1010<body> 
    11 <div class="document" id="migrating-to-educommons-3-0-2"> 
    12 <h1 class="title">Migrating to eduCommons 3.0.2</h1> 
     11<div class="document"> 
    1312 
     13 
     14<div class="section" id="migrating-to-educommons-3-1-1"> 
     15<h1>Migrating to eduCommons 3.1.1</h1> 
    1416<div class="section" id="preparation"> 
    15 <h1>Preparation</h1> 
     17<h2>Preparation</h2> 
     18<p>A few things you should do before beginning the migration:</p> 
     19<blockquote> 
     20<ol class="arabic simple"> 
     21<li>VERY IMPORTANT: SAVE A BACKUP OF YOUR Data.fs FILE, which is located in the [old instance home]/var directory of your eduCommons site. This file contains all of the content for your site. (This way you will able to restore your file from this Data.fs file if anything goes wrong.)</li> 
     22<li>Using the Zope Management Interface (ZMI), export any customizations you have made in your [old site] --&gt; portal_skins --&gt; custom folder and then delete all files in the custom folder. You can re-import these customizations once you have migrated the site.</li> 
     23<li>Verify that your current instance is eduCommons-3.0.2-final.</li> 
     24</ol> 
     25</blockquote> 
     26</div> 
     27<div class="section" id="migration-of-educommons-3-0-2-final-to-3-1-1"> 
     28<h2>Migration of eduCommons 3.0.2-final to 3.1.1</h2> 
     29<p>The migration eduCommons from version 3.0.2-final to version 3.1.1 
     30includes the following:</p> 
     31<blockquote> 
     32<ol class="arabic simple"> 
     33<li>Movement of Data.fs file to a new 3.1.1 instance</li> 
     34<li>Migration to Plone 3.0.6</li> 
     35<li>Migration to the eduCommons 3.1.1 instance</li> 
     36<li>Final steps</li> 
     37</ol> 
     38</blockquote> 
     39</div> 
     40<div class="section" id="movement-of-data-fs-file-to-a-new-3-1-1-instance"> 
     41<h2>Movement of Data.fs file to a new 3.1.1 instance</h2> 
     42<p>For the first step, you will move the Data.fs file from the old instance to 
     43the new instance. First of all, install an eduCommons-3.1.1 
     44instance using the installations instructions found in [new instance home]/eduCommons/docs/. Stop both sites. Then 
     45copy the Data.fs file from the var directory of the old site to the 
     46var directory of the new site:</p> 
     47<pre class="literal-block"> 
     48sudo cp -rvfp [old instance home]/var/Data.fs [new instance home]/var/ 
     49</pre> 
     50</div> 
     51<div class="section" id="migration-of-plone"> 
     52<h2>Migration of Plone</h2> 
     53<p>The following steps need to be performed in the ZMI, as eduCommons-3.1.1 utlizes Plone 3.0.6, instead of 3.0.4:</p> 
     54<blockquote> 
     55<ol class="arabic simple"> 
     56<li>Open your 3.1.1 eduCommons site in the ZMI. (click educommons setup, then click Zope Management Interface.)</li> 
     57<li>Run portal_migration migration (click the upgrade button on the migrate tab)</li> 
     58</ol> 
     59</blockquote> 
     60</div> 
     61<div class="section" id="installation-of-filesystemstorage-product"> 
     62<h2>Installation of FileSystemStorage Product</h2> 
     63<p>At this point in time, we need to ensure that the FileSystemStorage AddOn Product is installed:</p> 
     64<blockquote> 
     65<ol class="arabic simple"> 
     66<li>Open your 3.1.1 eduCommons site in the ZMI. (click educommons setup, then click Zope Management Interface.)</li> 
     67<li>Navigate to portal_quickinstaller</li> 
     68<li>Select FileSystemStorage</li> 
     69<li>Press Install</li> 
     70</ol> 
     71</blockquote> 
     72</div> 
     73<div class="section" id="migration-of-the-educommons-3-1-1-instance"> 
     74<h2>Migration of the eduCommons 3.1.1 instance</h2> 
     75<p>eduCommons 3.1.1 uses the portal_setup tool to perform the necessary upgrade from 3.0.2 to 3.1.1:</p> 
     76<blockquote> 
     77<ol class="arabic simple"> 
     78<li>Open your 3.1.1 eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)</li> 
     79<li>Navigate to portal_setup</li> 
     80<li>Press the 'Upgrades' tab</li> 
     81<li>From the drop down menu, select 'Products.eduCommons:default' and click Choose Profile button.</li> 
     82<li>Choose the 'Migration :: 3.0.2 to 3.1.0' option</li> 
     83<li>Press Upgrade</li> 
     84</ol> 
     85</blockquote> 
     86</div> 
     87<div class="section" id="final-steps"> 
     88<h2>Final Steps</h2> 
     89<blockquote> 
     90Your site should now be migrated. Navigate to your site in the browser and ensure it has migrated.</blockquote> 
     91</div> 
     92</div> 
     93<div class="section" id="migrating-to-educommons-3-0-2"> 
     94<h1>Migrating to eduCommons 3.0.2</h1> 
     95<div class="section" id="id1"> 
     96<h2>Preparation</h2> 
    1697<p>A few things you should do before beginning the migration:</p> 
    1798<blockquote> 
    … …  
    24105</div> 
    25106<div class="section" id="migration-of-educommons-2-3-1-final-to-3-0-2"> 
    26 <h1>Migration of eduCommons 2.3.1-final to 3.0.2</h1> 
    27 <p>The migration eduCommons from version 2.3.1-final to version 3.1.1-final 
     107<h2>Migration of eduCommons 2.3.1-final to 3.0.2</h2> 
     108<p>The migration eduCommons from version 2.3.1-final to version 3.1.1 
    28109includes the following:</p> 
    29110<blockquote> 
    … …  
    32113<li>Movement of Data.fs file to a new 3.0.2 instance</li> 
    33114<li>Migration of Plone 3.0.4</li> 
    34 <li>Migration of the eduCommons 3.1.1-final instance</li> 
     115<li>Migration of the eduCommons 3.1.1 instance</li> 
    35116<li>Final steps</li> 
    36117</ol> 
    … …  
    38119</div> 
    39120<div class="section" id="pre-migration-of-data-fs-in-version-2-3-1-final"> 
    40 <h1>Pre-migration of Data.fs in version 2.3.1-final</h1> 
    41 <p>For this step, you will need to copy the migration source code found in version 3.1.1-final.  The file is located at eduCommons/extras/PreMigrate.py . 
     121<h2>Pre-migration of Data.fs in version 2.3.1-final</h2> 
     122<p>For this step, you will need to copy the migration source code found in version 3.1.1.  The file is located at eduCommons/extras/PreMigrate.py . 
    42123Copy this into [old instance]/Products/eduCommons/Extensions.</p> 
    43124<p>Run the migration script by following these steps:</p> 
    … …  
    61142</div> 
    62143<div class="section" id="movement-of-data-fs-file-to-a-new-3-0-2-instance"> 
    63 <h1>Movement of Data.fs file to a new 3.0.2 instance</h1> 
     144<h2>Movement of Data.fs file to a new 3.0.2 instance</h2> 
    64145<p>For the next step you will move the Data.fs file from the old instance to 
    65146the new instance. First of all, install an eduCommons-3.0.2 
    … …  
    71152</pre> 
    72153</div> 
    73 <div class="section" id="migration-of-plone"> 
    74 <h1>Migration of Plone</h1> 
    75 <p>The following steps need to be performed in the ZMI, as eduCommons-3.1.1-final utlizes Plone 3.0.4, instead of 2.5.x:</p> 
     154<div class="section" id="id2"> 
     155<h2>Migration of Plone</h2> 
     156<p>The following steps need to be performed in the ZMI, as eduCommons-3.1.1 utlizes Plone 3.0.4, instead of 2.5.x:</p> 
    76157<blockquote> 
    77158<ol class="arabic simple"> 
    … …  
    84165</div> 
    85166<div class="section" id="migration-of-the-educommons-3-0-2-instance"> 
    86 <h1>Migration of the eduCommons 3.0.2 instance</h1> 
    87 <p>Run the migration script included with the 3.1.1-final instance by following these steps:</p> 
     167<h2>Migration of the eduCommons 3.0.2 instance</h2> 
     168<p>Run the migration script included with the 3.1.1 instance by following these steps:</p> 
    88169<blockquote> 
    89170<ol class="arabic simple"> 
    90171<li>Copy the migration script found in Products/eduCommons/extras/Migrate.py to [new_instance]/Extensions/</li> 
    91 <li>Open your 3.1.1-final eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)</li> 
     172<li>Open your 3.1.1 eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)</li> 
    92173<li>Navigate to the root of the ZMI (click the Root Folder link located in the upper left portion of the page)</li> 
    93174<li>From the drop down menu, select &quot;External method&quot; and click the Add button.</li> 
    … …  
    108189</blockquote> 
    109190</div> 
    110 <div class="section" id="final-steps"> 
    111 <h1>Final Steps</h1> 
     191<div class="section" id="id3"> 
     192<h2>Final Steps</h2> 
    112193<blockquote> 
    113194<p>Your site should now be migrated. Navigate to your site in the browser and ensure it has migrated. 
    … …  
    138219</div> 
    139220</div> 
     221</div> 
    140222<div class="footer"> 
    141223<hr class="footer" /> 
    142224<a class="reference external" href="MIGRATIONS_OLD.txt">View document source</a>. 
    143 Generated on: 2009-01-14 23:51 UTC. 
     225Generated on: 2009-08-05 22:23 UTC. 
    144226Generated by <a class="reference external" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. 
    145227