Copying a Plone site

Description

Quick instructions on how to create a copy of a Plone installation.

Introduction

These instructions tell you the basics of creating a duplicate of Plone site for testing or back-up

Prerequisites

  • Ability to use file system manager to copy files from/to the remote server
  • Ability to use the command line

Plone site contents

In order to copy a Plone site the following must be copied

  • buildout.cfg - defines your site package configuration
  • src folder - all add-ons you have developed yourself
  • var/filestorage/Data.fs - ZODB database of your site
  • var/blobstorage folder which contains file-like objects of ZODB database (BLOBs)

Note

BLOB storage is supported from Plone 4.x onwards. Older Plone installations do not have this folder.

Other folders (eggs, downloads, parts) etc. are generated by buildout command and may be left empty.

Copying and bootstrapping a Plone site to a new computer

  • Create a new site in the destination using Plone installer and make sure you can log-in to the site with temporary admin account

  • Copy var/filestorage/Data.fs from the old system to the new system - note that admin password is stored in Data.fs and the password given during the creation of a new site is no longer effective after Data.fs copy

  • Copy blobs from the old system to the new system by copying var/blobstorage/ folder

  • Copy src/ folder from the old system if you have any custom development code there

  • Copy buildout.cfg and other .cfg files

  • Rerun buildout in order to automatically re-download and configure all Python packages needed to run the site
    • python bootstrap.py to make the buildout use new local Python interpreter
    • Then bin/buildout to regenerate parts/ folder

Copying site data in UNIX environment

Below are example UNIX commands to copy a Plone site data from a computer to another over SCP/SSH connection. The actual username and folder locations depend on your system configuration.

Note: a copy of the Plone site configuration must already exist on the target computer. These instructions are only for copying / back-uping site data.

This operation can be perfomed on a running system - Data.fs is append only file and you will simply lose transactions which happened during the copying of the end of the file.

Copy local to remote

Run this command in your buildout Plone installation.

Copy Data.fs database:

scp -C -o CompressionLevel=9 var/filestorage/Data.fs plone@server.com:/srv/plone/site/var/filestorage

Copy BLOB files using rsync

BLOB files contain file and image data uploaded to your site. Since the actual content of file rarely changes after upload, rsync can synchronize only changed files using -a (archive) flag.

rsync -av --compress-level=9 var/blobstorage plone@server.com:/srv/plone/site/var