Upgrading to Silva 3.0

This page documents the steps that I took to upgrade a medium sized Silva 2.3.7 site to Silva 3.0.1. I hope that this can be useful to other people who wish to upgrade to the latest version of Silva.

It’s always a good idea to start by looking at the 3.0 documentation on Infrae’s site, specifically the API changes if you have custom code or have made other modifications to Silva’s code.

Upgrade Silva and Zope instances

I began by following the documentation that Infrae has for upgrading your installation, paying particular attention to the Silva 3.0 upgrade-specific notes.

I had two code sources that were broken and needed to be fixed. They were the cs_toc and cs_citation sources, which are shipped with Silva. On the edit screen in the ZMI for each code source I changed the “File system location” from “No location” to the “Products.SilvaExternalSources” path provided. After saving, I then clicked on “Update from filesystem”. This fixed the code sources.

The only problem I encountered was during the re-indexing of Silva Agenda Items. Prior to Silva 3.0.2, there was a bug with generating the key used for the index. You can read about it on Launchpad.

Upgrade custom code

This is a list of specific changes that I made to my various custom packages:

Revision History: