Upgrade

From . .. poMMo .. .

Jump to: navigation, search

NOTE: This document outlines the general upgrade process. It will also contain special notes detailing non standard changes or known issues of a release. It is wise to consult this document before upgrading your version of poMMo. If you experience any troubles during an upgrade, please notify!

Contents

[edit]

Standard Upgrade Procedure

In general, upgrading poMMo is a straight forward process. After copying the new files over the old, visit poMMo. It will will detect a "version mismatch" and direct you to a web based upgrade script which handles updating the database and other information. To upgrade poMMo, follow these steps.
  1. Check for any bulletins related to the new version.
  2. Backup your database (just in case anything goes terribly wrong).
    • Periodically, you may want to export your subscribers to a CSV file.
  3. Copy the configuration file (config.php) to your computer or a directory on the webserver outside of the poMMo installation.
  4. Remove the poMMo installation from the webserver (delete its directory)
    • Note: you can probably copy the files from the new version of poMMo over the old ones, however, it is recommended to remove the entire directory in order to get rid of any "legacy" files.
  5. Copy the new version of poMMo in the old one's place
  6. Restore your config.php to its location
  7. Visit your poMMo installation from a web browser to complete the process.
[edit]

Bulletins

[edit]

Aardvark PR16.1

Versions effected: PR16 and below (including upgrading to versions > PR16.1)

PR16.1 adds fine grain control of user facing messages. As such, those upgrading to PR16.1 should note that messages sent to users will be reset to factory defaults. The messages are your subscription confirmation, welcoming letter, records access request, etc. and may be configured within poMMo by visiting Setup > Configure > Messages.
If you do upgrade now *OR* in the FUTURE, please note that user facing messages will STILL be reset to factory defaults and must be restored by visiting Setup > Configure > Messages (within your poMMo install).


[edit]

Aardvark PR14

There is no upgrade path from PR13! -- Please read below for instructions on migrating.
  • FIRST, Install PR14. Do a clean install -- either into a new database or change the database prefix. Once PR14 is installed...
  1. Recreate subscriber fields from PR13 in PR14
  2. Recreate groups && group filters from PR13 in PR14
  3. Export your subscriber list from PR13
  4. Import your subscriber list (as a .CSV if you collect fields) from PR13
  5. See if the subscribers, groups, and fields are correctly retained in PR14

Report any problems to the PR14 Upgrade Thread

Update A release critical bug has been found with PR14 -- mailings will freeze if you have Mails per Second throttling enabled. See this thread for a quick fix. A new release will be available shortly.

Subscription form Change --- If using a customized subscriber form, read below!

The email field on the subscription form has changed. It has been renamed "Email" from "bm_email". Please update your form! e.g. change; 

<input type="text" name="bm_email" ....>
to 
<input type="text" name="Email" ....>
on your subscriber form.


[edit]

Aardvark PR11.1

NOTE: For those of you with a table prefix, you'll notice that the updater fails! I have included a fix @ Bug #79.
Subscriber removal/editing was broken. A fix exists in subversion, and will be included in the next poMMo release. If interested, update your admin/subscribers/subscriber_mod.php with the latest in our SVN Repository branch: aardvark-brice.
The config.sample.php includes a syntax error at the top of file (line1). There is a "l" before the "<?php" tag. You'll want to remove this from your config.php


[edit]

Aardvark PR11

Versions effected: PR10.2 and below (all versions)

NOTE: A bug exists in the upgrade procedure. Please see http://www.pommo.org/flyspray/?do=details&id=67 for a fix.
This is a milestone release, featuring a complete reorganization of the file structure and the addition of a themeable, translatable framework.
  • A "working directory" will need to be setup for the new templating engine. See the Install Guide for details.
  • The config.php has changed location and contents. Make sure to bring yours up to date with the new language and workdir settings. It should now be located in the "root" directory along with bootstrap.php. See the included config.sample.php for changes.
  • poMMo's look and feel is now controlled by template files. See the Theme Page for details on customizing the look of the subscriber form, user pages, and poMMo interface.


[edit]

Aardvark PR10.2

Versions effected: PR10.1 and below

Subscriber pages have moved from the subscriber directory to user -- and that means that the subscriber login page and subscription form processor have also migrated. The new subscriber login page can be reached by visiting {your website}/{poMMo}/user/login.php. Update your subscription form to send to /user/process.php
Your config.php NEEDS to be updated because the syntax has changed. Model your new one from "config.sample.php" in the setup directory.
Retrieved from "http://pommo.org/Upgrade"
Personal tools