Project-Id-Version: Trac 0.12
Report-Msgid-Bugs-To: trac-dev@googlegroups.com
POT-Creation-Date: 2008-01-30 09:20+0100
PO-Revision-Date: 2010-07-19 23:05+0200
Last-Translator: Jeroen Ruigrok van der Werven <asmodai@in-nomine.org>
Language-Team: en_US <trac-dev@googlegroups.com>
Plural-Forms: nplurals=2; plural=(n != 1)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Generated-By: Babel 0.9.6

Warning: Can't synchronize with repository "(default)" (Unsupported version control system "git": Can't find an appropriate component, maybe the corresponding plugin was not enabled? ). Look in the Trac log for more information.

Changes between Version 17 and Version 18 of HowToMigratePhtagr


Ignore:
Timestamp:
06/29/12 08:18:22 (8 years ago)
Author:
sebastian
Comment:

Update migration for 2.1.3

Legend:

Unmodified
Added
Removed
Modified
  • HowToMigratePhtagr

    v17 v18  
    1717 {{{ 
    1818$ wget https://sourceforge.net/projects/phtagr/files/latest 
    19 $ unzip phtagr-master-XXX.zip 
     19$ unzip phtagr-<version>-<git hash>.zip 
    2020}}} 
    2121 1. Migrate required files and directories from the old to the new phTagr 
    2222 {{{ 
    23 $ mv phtagr.old/Config/core.php phtagr/Config/core.php 
    24 $ mv phtagr.old/Config/database.php phtagr/Config/database.php 
     23$ cp phtagr.old/Config/core.php phtagr/Config/core.php 
     24$ cp phtagr.old/Config/database.php phtagr/Config/database.php 
    2525$ mv phtagr.old/users/* phtagr/users 
    2626}}} 
     
    2929= phTagr 2.2b3 = 
    3030 
    31 '''phTagr 2.2b3 uses now CakePHP 2.0'''. CakePHP 2.0 is the current version of the great MVC framework and brings new fancy features towards phTagr. The downside: CakePHP 2.0 (and so phTagr) requires now at least PHP 5.2.8 and the PDO extension (PHP Data Objects). Further, the folder structure changed (again). Besides some internal changes the folder structure is now capitalized in singular. In CakePHP 1.3 folders are named {{{controllers/components}}} and in CakePHP 2.0 names are like {{{Controller/Component}}}. Further the database configuration changed slightly. If you're using git the migration is harmless. Sorry for this inconvenience but this should be the last major change for the next time.    
    32  
    33 See http://book.cakephp.org/2.0/en/getting-started/cakephp-folder-structure.html for new CakePHP 2.0 folder structure. Note: phTagr uses cake as git submodule and is located in cakephp directory. 
     31'''phTagr 2.2b3 uses now CakePHP 2.1'''. CakePHP 2.1 is the current version of the great MVC framework and brings new fancy features towards phTagr. The downside: CakePHP 2.1 (and so phTagr) requires now at least PHP 5.2.8 and the PDO extension (PHP Data Objects). Further, the folder structure changed (again). Besides some internal changes the folder structure is now capitalized in singular. In CakePHP 1.3 folders are named {{{controllers/components}}} and in CakePHP 2.1 names are like {{{Controller/Component}}}. Further the database configuration changed slightly. If you're using git the migration is harmless. Sorry for this inconvenience but this should be the last major change for the next time.    
     32 
     33See http://book.cakephp.org/2.0/en/getting-started/cakephp-folder-structure.html for new CakePHP 2.1 folder structure. Note: phTagr uses cake as git submodule and is located in cakephp directory. 
    3434 
    3535'''Following migration instruction assumes that your are running at least 2.2b2. If not, please read prior migration guide.''' 
     
    3838 
    3939{{{ 
    40 cd /var/www/phtagr  # change to your phtagr directory 
     40cd /var/www/phtagr  # goto to your phtagr directory 
    4141git stash  
    4242git checkout cakephp-2.0  
     
    5454== Migration from ZIP archive == 
    5555 
    56  {{{ 
    57 $ cd /var/www 
    58 $ mv phtagr phtagr.old 
    59 }}} 
    6056 1. Fetch the [https://sourceforge.net/projects/phtagr/files/latest latest phTagr] sources from [https://sourceforge.net/projects/phtagr/ !SourceForge] and unzip it to {{{/var/www/}}} 
    6157 {{{ 
     
    6359$ unzip phtagr-master-XXX.zip 
    6460}}} 
     61 {{{ 
     62$ cd /var/www 
     63$ sudo mv phtagr phtagr.old 
     64$ sudo mv ~/phtagr . 
     65}}} 
     66 1. Make {{{phtagr/users}}} and {{{phtagr/tmp}}} writable by webserver if required 
     67 {{{ 
     68sudo chmod -R go+w phtagr/users phtagr/tmp 
     69}}} 
    6570 1. Migrate required files and directories from the old to the new phTagr 
    6671 {{{ 
    67 $ mv phtagr.old/config/core.php phtagr/Config/core.php 
    68 $ mv phtagr.old/config/database.php phtagr/Config/database.php 
     72$ mv phtagr.old/Config/core.php phtagr/Config/core.php 
     73$ mv phtagr.old/Config/database.php phtagr/Config/database.php 
    6974$ mv phtagr.old/users/* phtagr/users 
    70 $ mv phtagr.old/tmp/* phtagr/tmp 
    71 }}} 
    72  
    73 Continue with the database migration. 
     75$ mv phtagr.old/tmp/logs/* phtagr/tmp/logs 
     76}}} 
     77 
     78Continue with the database migration at ''Dashboard'' -> ''System'' -> ''Database Upgrade'' 
    7479 
    7580== Migration of the database configuration ==  
    7681 
    77 Now we need to adapt the database configuration in {{{Config/database.php}}}. The old database configuration looks like: 
     82If you migrate prior 2.2b3 you need to adapt the database configuration in {{{Config/database.php}}}. The old database configuration looks like: 
    7883 
    7984{{{ 
     
    131136 
    132137} 
    133 ?> 
    134138}}} 
    135139 
     
    156160'''Following migration instructions require a phtagr installation with version 2.1.3 or later (2011-03-07 or later).''' Please upgrade your installation to 2.1.3 and than to 2.2. These steps are required for correct database migration. 
    157161 
    158 '''Note''' Before you migrate, please ensure that you have done your backups, especially your database if the database migration fails unpredictable. 
     162'''Note''' Before you migrate, please ensure that you have done your backups, especially your database if the database might migration fail. 
    159163 
    160164== phTagr in /var/www from zip archive == 
     
    166170cd  
    167171wget http://sourceforge.net/projects/phtagr/files/latest # phtagr-master-XXX.zip 
    168 unzip phtagr-<version>-<git version>.zip 
     172unzip phtagr-<version>-<git hash>.zip 
    169173cd /var/www 
    170174sudo mv phtagr phtagr.old 
    171175sudo mv ~/phtagr . 
    172 mv phtagr/Config/core.php phtagr/Config/core.php.bak 
    173 cp phtagr.old/app/config.php phtagr.old/app/database.php phtagr/Config 
    174 rm -rf phtagr/users phtagr/tmp 
    175 mv phtagr.old/app/tmp phtagr.old/app/users phtagr 
     176cp phtagr.old/app/config/core.php phtagr/Config/core.php.old 
     177cp phtagr.old/app/config/database.php phtagr/Config/database.php.old 
     178rm -rf phtagr/users 
     179mv phtagr.old/app/users phtagr 
     180mv phtagr.old/app/tmp/logs/* phtagr/tmp/logs 
     181}}} 
     182 
     183Make shure that {{{phtagr/tmp}}} and {{{phtagr/users}}} is writeable by the webserver. If not execute: 
     184 
     185{{{ 
     186chmod -R go+w phtagr/users phtagr/tmp 
    176187}}} 
    177188 
     
    185196mysql> quit; 
    186197}}} 
     198 
     199Since phtagr 2.2 updated the CakePHP as well we need to migrate the core configuration file manually. Before we copied a backup to {{{Config/core.php.old}}} to the new phtagr directory. At least the {{{Security.salt}}} value is required for correct password encryption. Please copy the value of {{{Security.salt}}} within {{{Config/core.php.old}}} to {{{Config/core.php}}}. If you modified your old core configuration file, please apply your changes to the new core configuration as well.  
    187200 
    188201Now everything should be working again. To finalize the upgrade login as admin user and goto ''Dashboard'' -> ''System'' -> ''Database upgrade'' and init the new database migration utility.