Upgrading from 1.x

Owned by James Roper
Last updated: Jul 09, 2009Version comment
2 min read

If you're upgrading from a previous 1.x version of Pebble, you'll need to follow these instructions.

Directory structure

Pebble 2.0 introduces a new directory structure for the storage of its data so, if you are upgrading from a previous version, you'll need to restructure your directories very slightly. Pebble will automatically create this structure if the data directory specified in the configuration doesn't exist.

Single blog

The following diagrams show the directory structure when Pebble is hosting a single blog, in Pebble 1.x and Pebble 2.x respectively. You will need to restructure your existing directories to match this new layout.

- Blog directory
|-- blog.properties
|-- 2006
|-- files
|-- images
|-- ...

- Pebble data directory
|-- blogs
| |-- default
|   |-- blog.properties
|   |-- 2006
|   |-- files
|   |-- images
|   |-- ...
|-- realm
  |-- {username1}.properties
  |-- {usernameN}.properties

Multi-blog

The following diagrams show the directory structure when Pebble is hosting more than a single blog, in Pebble 1.x and Pebble 2.x respectively. You will need to restructure your existing directories to match this new layout.

- Blog directory
|-- blog.properties
|-- blog1
| |-- blog.properties
| |-- 2006
| |-- files
| |-- images
| |-- ...
|-- blogN
| |-- blog.properties
| |-- 2006
| |-- files
| |-- images
| |-- ...

- Pebble data directory
|-- blogs
| |-- blog.properties
| |-- blog1
|   |-- blog.properties
|   |-- 2006
|   |-- files
|   |-- images
|   |-- ...
| |-- blogN
|   |-- blog.properties
|   |-- 2006
|   |-- files
|   |-- images
|   |-- ...
|-- realm
  |-- {username1}.properties
  |-- {usernameN}.properties

Themes

The way Pebble themes are implemented has been simplified and Pebble 1.x themes are not compatible. For this reason, the following steps should be followed before starting up Pebble.

  • Remove the backup theme : remove the directory called theme underneath each blog