Skip to content

How to Upgrade Chyrp

hrabbit edited this page Sep 12, 2010 · 5 revisions

These instructions work for both official releases and the current git. It only takes about five minutes.

Make a Backup

We don’t expect that any thing will go wrong in the upgrade but backups are always a good idea in these cases. Just zip up your Chyrp directory and set that file aside somewhere. You probably won’t need it…

Disable Old Modules & Feathers

Modules and Feathers are version specific and leaving them enabled could cause your Chyrp installation to become unstable.

Copy your Configuration File

Make a copy of config.yaml.php and put it in a different directory.

Delete Old Directories & Files

Delete the following:

  • includes/
  • admin/
  • index.php
  • upgrade.php

NOTE: If you are installing from git you may also want to move the modules and feathers directories to modules.old and feathers.old.

Put the New Files in Place

You need to replace the files you just deleted:

  • includes/
  • admin/
  • index.php
  • upgrade.php

NOTE: If you are installing from git you may want to add the latest versions of the modules and feathers.

Run the Upgrader

The upgrader is located at yourdomain.com/chyrp_dir/upgrade.php or wherever you installed it. This should be a two click process and take you back to your main website page. You may need to login again to the admin section after you complete the upgrade.

Upgrade Your Modules and Feathers

You need to download new versions of your Modules and Feathers. The old versions may work but why take your chances.
Once you have installed each module and enable it run the upgrader again.

NOTE: If the new modules are not available you can try re-enabling the old modules. (But expect small code errors if you do.)

NOTE: If you are installing from git you can copy the modules/ and feathers/ directories to your installation.

Debugging

If you have done everything the way It was prescribed you shouldn’t have any problems. However if you do run into problems you can search for your answer on the Chyrp Forum or on irc://irc.freenode.net/#chyrp