Translations of this page?:

This section describes the steps to upgrade Feng Office to newer versions.

Upgrading from 1.X to 1.X or 2.X to 2.X

In order to upgrade Feng Office from a 1.X to another 1.X version, or from 2.X to another 2.X version, please do as following. Otherwise, look for ‘Upgrading from 1.X to 2.X’ ahead in this manual.

  1. Backup everything from your installation in case anything goes wrong and you have to rollback:
    1. filesystem (all the files and folders)
    2. database
  2. Copy, paste and replace the new version files on top of the folders and documents from your actual installation.
  3. Make sure your folder permissions are correct (upload, config, cache and tmp folders with 775 or 777 permissions)
  4. You now have to run the upgrade script.You may do it through one of the following methods:
    1. Run the following command in your console - which is faster and better -:
      php FENG_ROOT/public/upgrade/console.php [version_from] [version_to]

      For example:

      php FENG_ROOT/public/upgrade/console.php 2.2 2.2.1
    2. Or do it from your browser going to:
      my.domain.com/fengoffice/public/upgrade

      and run the upgrade to the latest version available.

  5. If you are using Feng Office 2.X, remember to update the plugins as well
  6. Delete the autoloader.php file within the cache/ folder
  7. Once everything is ready, go to 'your domain url'/'your_feng_root'/ and remember to delete the cache from your browser (CTRL + F5 in Windows and CMD + R in Mac)

Plugins Installation and Updates

With the new version, you may have new plugins to install and upgrade as well.In order to do this there are two ways of doing it: command line or graphic user interface (GUI)

Command Line:

- Access the installation folder (or do it from wherever you want through absolute reference of course)

- Run the following commands:

php [FENG_ROOT]/public/install/plugin-console.php list
php [FENG_ROOT]/public/install/plugin-console.php update_all

That is it! Your plugins are updated.

Note: In case you experience a “memory exhausted error” in between, you may try allocating more memory for this process, as shown below:

php -d memory_limit=512M [FENG_ROOT]/public/install/plugin-console.php update_all

Command Line Explanations:

In case you are curious to know of the other possibilites, please look below:

Listing all possibilities

php [FENG_ROOT]/public/install/plugin-console.php

List all of the plugins with their state, version and installed version:

php [FENG_ROOT]/public/install/plugin-console.php list

Install a plugin:

php [FENG_ROOT]/public/install/plugin-console.php install [plugin_name]

Activate a plugin (for the time being, this is compulsory to do after you install one!):

php [FENG_ROOT]/public/install/plugin-console.php activate [plugin_name]

Update a plugin:

php [FENG_ROOT]/public/install/plugin-console.php update [plugin_name]

Update all of the installed plugins:

php [FENG_ROOT]/public/install/plugin-console.php update_all

Examples:

Gantt Installation (this plugin is currently available for the Professional Edition only):

php /www/acme/public/install/plugin-console.php install gantt

Gantt Activation (this plugin is currently available for the Professional Edition only):

php /www/acme/public/install/plugin-console.php activate gantt

Gantt Update (this plugin is currently available for the Professional Edition only):

php /www/acme/public/install/plugin-console.php update gantt

Graphic User Interface (GUI):

  1. Edit the config.php file within the config/ folder and add the following line anywhere in the document (within the Php tags of course): define('PLUGIN_MANAGER', true);
  2. Log in to your Feng Office installation, click on your name (top right corner)and access the ‘Administration’ and then the ‘Plugin Manager’
  3. Install and then activate (or upgrade) the plugins you should consider useful and necessary
  4. Change the new constant in the config.php file to false if you wish to

Important notes:

  1. For the time being, after you upgrade your Feng Office installation, you must manually update your plugins as well (we suggest using the command line).Eventually this will be done automatically, but not yet.
  2. Delete the cache from your browser(CTRL+F5 in Windows/Linux and CMD+R in Mac)

Upgrading from Community Edition to Professional Edition

Please contact a Feng Office Executive for a quote (contact@fengoffice.com)

Upgrading from 1.X to 2.X

In case you do not count with the latest 1.7.X version available, you should first make sure you upgrade your version to the 1.7.5 at least (backing up everything before, of course).

Then, you have to follow these steps:

  1. Backup everything from your installation:
    1. filesystem
    2. documents
    3. and database.
    4. In case anything goes wrong and you have to rollback.
  2. Delete all of the folders and files (except the .htaccess and php.ini to keep your previous settings) within your Feng Office root except for the following folders:
    1. cache
    2. config
    3. tmp
    4. upload
  3. Copy all of the new folders of the new version into your Feng Office root folder, except the ones you have kept on step 2.
  4. Change the 'TABLE_PREFIX' value to 'fo_' within the config.php file inside the config/ folder
  5. JavaScript compression and cache are not supported in Feng Office 2.X yet, so remove or comment those lines as well.
  6. Delete the autoloader.php file within the cache/ folder.
  7. You now have to run the first script to upgrade the version. You may do it through one of the following methods:
    1. Run the following command in your console - which is faster and better -:
      php FENG_ROOT/public/upgrade/console.php [version_from] [version_to]

      For example:

      php FENG_ROOT/public/upgrade/console.php 1.7.5 2.2.1
    2. Or do it from your browser going to:
      my.domain.com/fengoffice/public/upgrade

      and run the upgrade to the latest version available.

  8. After performing the upgrade, you have to run the complete_migration.php script. As you may have to run it several times depending on the amount of data you have, we suggest adding a line to the crontab as following:
*/10 * * * * php FENG_ROOT/public/upgrade/complete_migration.php 2000 >> /root/feng_upgrade_log.log

This means that 2000 objects will be processed every 10 minutes. In some cases, with clients of ours with years of data, this has taken up to 30 hours of running, so you have to be patient :)

You ought to check the log file, and once it is over, delete that line from your crontab.

After running the upgrade script, remember to update the plugins as well, otherwise you may find failures within the system.

Once everything is ready, remember to delete the cache from your browser (CTRL + F5 in Windows and CMD + R in Mac)

Note: This process will leave your database with both old and new tables. You may delete the old ones if you want to, but we do not suggest doing so yet in case the migration missed something and we then release a script to solve the issues.

Discussion

PLEASE NOTE: Comments to the wiki should only contain suggestions and questions that help us to improve the manual (and not the software). These comments will be deleted as soon as the information has been integrated into the manual.

Posts that do not contribute to the DOCUMENTATION of the project will be DELETED.

Ask QUESTIONS on the product here.
Report BUGS here.
Propose NEW FEATURES here.


Enter your comment
 
installation/migration.txt · Last modified: 2014-03-20 18:30 by conrado
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported


Terms of Service | Copyright © 2014 fengoffice.com