| 38 | | <div class="section" id="movement-of-data-fs-file-to-a-new-3-1-1-final-instance"> |
| 39 | | <h1>Movement of Data.fs file to a new 3.1.1-final instance</h1> |
| 40 | | <p>For the first step, you will move the Data.fs file from the old instance to |
| 41 | | the new instance. First of all, install an eduCommons-3.1.1-final |
| 42 | | instance using the installations instructions found in [new instance home]/eduCommons/docs/. Stop both sites. Then |
| 43 | | copy the Data.fs file from the var directory of the old site to the |
| 44 | | var directory of the new site:</p> |
| 45 | | <pre class="literal-block"> |
| 46 | | sudo cp -rvfp [old instance home]/var/Data.fs [new instance home]/var/ |
| 47 | | </pre> |
| 48 | | </div> |
| 49 | | <div class="section" id="migration-of-plone"> |
| 50 | | <h1>Migration of Plone</h1> |
| 51 | | <p>The following steps need to be performed in the ZMI, as eduCommons-3.1.1-final utlizes Plone 3.0.6, instead of 3.0.4:</p> |
| | 38 | <div class="section" id="pre-migration-of-data-fs-in-version-3-1-1-final"> |
| | 39 | <h1>Pre-migration of Data.fs in version 3.1.1-final</h1> |
| | 40 | <p>For this step, you will need:</p> |
| | 41 | <ul class="simple"> |
| | 42 | <li>contentmigration Plone Add-on Product, available at <a class="reference external" href="http://pypi.python.org/packages/source/P/Products.contentmigration/Products.contentmigration-1.1.zip">http://pypi.python.org/packages/source/P/Products.contentmigration/Products.contentmigration-1.1.zip</a></li> |
| | 43 | <li>to copy the migration source code found in version 3.2.1. The file is located at eduCommons/extras/PreMigrate.py<ul> |
| | 44 | <li>Copy this into [old instance]/Products/eduCommons/Extensions</li> |
| | 45 | </ul> |
| | 46 | </li> |
| | 47 | </ul> |
| | 48 | <p>Add contentmigration product by following these steps:</p> |
| 54 | | <li>Open your 3.1.1-final eduCommons site in the ZMI. (click educommons setup, then click Zope Management Interface.)</li> |
| 55 | | <li>Run portal_migration migration (click the upgrade button on the migrate tab)</li> |
| | 51 | <li>Download the product from the aforementioned URL</li> |
| | 52 | <li>Unzip the product into [old_instance]/Products</li> |
| | 53 | <li>Restart zope</li> |
| | 54 | </ol> |
| | 55 | </blockquote> |
| | 56 | <p>Run the migration script by following these steps:</p> |
| | 57 | <blockquote> |
| | 58 | <ol class="arabic simple"> |
| | 59 | <li>Open your 3.1.1-final eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)</li> |
| | 60 | <li>From the drop down menu, select "External method" and click the Add button.</li> |
| | 61 | <li>Enter the following parameters:<ul> |
| | 62 | <li>Id: PreMigrate</li> |
| | 63 | <li>Title: PreMigrate</li> |
| | 64 | <li>Module Name: PreMigrate</li> |
| | 65 | <li>Function Name: pre_migrate_3_1_1_to_3_2_1</li> |
| | 66 | </ul> |
| | 67 | </li> |
| | 68 | <li>Click Add</li> |
| | 69 | <li>Click on the PreMigrate script you just added</li> |
| | 70 | <li>Click the test tab.</li> |
| | 71 | <li>Verify that the method ran successfully. (It should give you feedback.)</li> |
| 59 | | <div class="section" id="installation-of-filesystemstorage-product"> |
| 60 | | <h1>Installation of FileSystemStorage Product</h1> |
| 61 | | <p>At this point in time, we need to ensure that the FileSystemStorage AddOn Product is installed:</p> |
| | 75 | <div class="section" id="movement-of-data-fs-file-to-a-new-3-2-1-instance"> |
| | 76 | <h1>Movement of Data.fs file to a new 3.2.1 instance</h1> |
| | 77 | <p>For this step, you will move the Data.fs file from the old instance to |
| | 78 | the new instance. First of all, install an eduCommons-3.2.1 |
| | 79 | instance using the installations instructions found in [new instance home]/eduCommons/docs/. Stop both sites. Then |
| | 80 | copy the Data.fs file from the var directory of the old site to the |
| | 81 | var/filestorage directory of the new site:</p> |
| | 82 | <pre class="literal-block"> |
| | 83 | sudo cp -rvfp [old instance home]/var/Data.fs [new instance home]/var/filestorage |
| | 84 | </pre> |
| | 85 | </div> |
| | 86 | <div class="section" id="migration-to-educommons-3-2-1-instance"> |
| | 87 | <h1>Migration to eduCommons 3.2.1 instance</h1> |
| | 88 | <p>eduCommons 3.2.1 uses the portal_setup tool to perform the necessary upgrade from 3.1.1 to 3.2.1. Due to the fact that eduCommons and it's dependencies were moved to python eggs, we must start with a new eduCommons site. The migration script will then copy and past content and relevant settings to the new installation:</p> |
| 64 | | <li>Open your 3.1.1-final eduCommons site in the ZMI. (click educommons setup, then click Zope Management Interface.)</li> |
| 65 | | <li>Navigate to portal_quickinstaller</li> |
| 66 | | <li>Select FileSystemStorage</li> |
| 67 | | <li>Press Install</li> |
| | 91 | <li>Navigate to the root of your ZMI instance and create a new eduCommons site called eduCommons321</li> |
| | 92 | <li>Open your new 3.2.1 eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)</li> |
| | 93 | <li>Navigate to portal_setup</li> |
| | 94 | <li>Press the 'Upgrades' tab</li> |
| | 95 | <li>From the drop down menu, select 'Products.eduCommons:default' and click Choose Profile button.</li> |
| | 96 | <li>Choose the 'Migration :: 3.1.1 to 3.2.1' option</li> |
| | 97 | <li>Press Upgrade</li> |
| 76 | | <li>Open your 3.1.1-final eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)</li> |
| 77 | | <li>Navigate to portal_setup</li> |
| 78 | | <li>Press the 'Upgrades' tab</li> |
| 79 | | <li>From the drop down menu, select 'Products.eduCommons:default' and click Choose Profile button.</li> |
| 80 | | <li>Choose the 'Migration :: 3.0.2 to 3.1.0' option</li> |
| 81 | | <li>Press Upgrade</li> |
| | 106 | <li>Navigate to the root of your ZMI instance</li> |
| | 107 | <li>Select the checkbox next to your new 3.2.1 eduCommons site</li> |
| | 108 | <li>Press Import/Export</li> |
| | 109 | <li>If your production environment is on the same server as your migration environment, choose 'Save file to server', else |
| | 110 | Download the file to your local machine. Dependent on the size of your site, this process may take a long time.</li> |
| | 111 | <li>Move the .zexp into the import directory of your production site [production_site]parts/instance/import</li> |
| | 112 | <li>Navigate to the ZMI of your production site</li> |
| | 113 | <li>Press Import/Export</li> |
| | 114 | <li>Select your .zexp from the drop down list, and press Import. Dependent on the size of your site, this process may take a long time.</li> |
| | 115 | <li>If desired, rename your imported eduCommons321 site.</li> |
