Upgrading to a new release

From AuthPuppy Wiki

Jump to: navigation, search

Follow these instructions if you already have a working version of AuthPuppy and want to upgrade to a newer release.

Contents

Before upgrading

Backup

Before upgrading to a new release, it is advisable to

  • Backup the database
  • Backup the site's file, especially the config/*, .htaccess, web/frontend_dev.php (if you added some ips to debug), apps/frontend/config/* and any other file you may have changed.

Prepare the application

To make sure that no plugin interferes with the installation process, you should disable all plugins prior to upgrade.

Upgrading the code

Get the latest release from http://launchpad.net/authpuppy. Then, extract the files in you web server directory 

$> tar xvzf authpuppy-<version>-<stability>_<packaging>.tgz 
$> sudo cp -r authpuppy /var/www/

Or copy them to your server using and FTP client or anything else.


Setting directory permissions

If you installed from the tarball, you may need to set the directory permissions, just like the first time you installed AuthPuppy.

For the application to work, some directories must be writeable by the web-server. On development server, this may be done by giving write permissions to all 

chmod -R a+w <directory>

But the best way to do this on production server is to set the owner of the directory to the web server's process 

chown -R www-data <directory>

(provided www-data is the apache process owner, on some os, it is 'apache' or 'httpd')

Here follows a list of directories to set the permissions for. Those marked with a * MUST be writeable for the system to work, others must be writeable for automatic installation of plugins, but these steps can all be done manually:

  • config* or at least config/authpuppy.yml*: because the config/authpuppy.yml contains the list of active plugins so they can be loaded at initialization time
  • cache*: Used at runtime by symfony to cache functionnalities and data
  • log*: The log directory
  • data*: The clear cache task (needed when installing or configuring plugins) needs write access to this directory
  • plugins: The directory where plugins will be installed.
  • web: Plugins may have assets (images, javascript, css) to publish to the web directory, so make sure it is writeable, otherwise you'll need to do this by hand.

Clear the cache

If cache is enabled, it still reflects the old version. You need to clear it.

With command line access, from the app's root directory execute 

./symfony cc

Otherwise, you may manually empty the cache/ directory

Put back the files

You may overwrite the files you had modified with your own: config/databases.yml, .htaccess, web/frontend_dev.php, config/*.yml and modules .yml files.

Before doing so though, some new options may have been added to the .yml files. Compare with your own and merge your changes.

Upgrading the database

Navigate to http://<your authpuppy server>/index.php/install. Follow the instructions through the (re)installation process


Reconfigure

Go to the Manage plugins page and reenable any plugin that were disabled before the upgrade.

Retrieved from "http://www.authpuppy.org/doc/Upgrading_to_a_new_release"
Personal tools