Upgrading Porcupine

Upgrading Porcupine is only supported for two consequent official releases. For example, if you need to upgrade from Porcupine 0.5 to 0.6 you need to apply two upgrades sequentially, the first for upgrading to 0.5.2 and the last for upgrading to 0.6.

The upgrading procedure is quite straightforward. If you have downloaded the source code:

1. Download the appropriate source upgrade archive, usually named "porcupine-upgrade-x.y.z-src.zip".

2. Backup the database and your current installation's source code by making a copy of the Porcupine's root folder.

3. Stop Porcupine server.

4. Unpack the archive to the server's root installation directory.

5. After unpacking, except from the source files being replaced, a Porcupine package file (.ppf) is extracted to the installation root folder. Execute "python pakager.py -i -p upgrade-x.y.z.ppf".

6. Delete the upgrade .ppf file.

If you are using the win32 binaries, download the "porcupine-upgrade-x.y.z-win32.exe" installer, execute it and follow the on screen instructions.

Before reaching the milestone of release 1.0, the Porcupine API is not guaranteed to be backwards compatible alhough in most cases your code will continue to run flawlessly after an upgrade. It is important to always check the server's change log for deprecated features in order to make the appropriate changes.

Clicky Web Analytics