Download / Install
Last modified: 02/16/2014 04:18 PM
Instructions for where and how to install CPS
CPS is Free / Libre / Open source Software licensed and distributed according to the GNU GPL v2 license.
CPS releases are distributed in the following forms:
People interested in custom or development setups should rather follow the instructions to prepare a development version of CPS on our Trac.
The Debian packages install all needed dependencies.
CPS runs on the top of the Zope application server that shoud be installed first. Zope is Free / Libre / Open source Software too and can be downloaded at http://www.zope.org/Products/
In addition to Zope, CPS currently requires a few python libraries, namely docutils, lxml and PIL. The ldap library is also needed in case you'd want to hook to a LDAP server.
Additional external programs for full-text extractions are needed so that the contents of attached files is properly indexed.
Debian and Ubuntu packages
We provide packages for Debian 5 Lenny, Debian 6 Squeeze and Ubuntu 9.10 to 10.10. Starting from Debian 6.0 and Ubuntu 10.04, python 2.4 is no longer available in those distributions, which means that we had to provide it in a package of ours.
That being said, you'll probably find practical to use those packages and we of course would be delighted to have official packages in Debian and Ubuntu distributions.
Note that there is a dedicated package for dependencies (see below).
Short version : testing instance from scratch in four lines
Debian squeeze and Ubuntu >=10.04 < 12.04 users, just paste this (we recommend aptitude over apt-get, for afterwards cleaning, but it is not necessary).
sudo 'echo "deb http://apt.cps-cms.org/opt-debian squeeze contrib" > /etc/apt/sources.lists.d/cps-cms.list'
Go to http://localhost:6500/cps and enjoy
Debian wheezy amd64 packages have been freshly baken as of this writing. The corresponding instructions are:
sudo 'echo "deb http://apt.cps-cms.org/opt-debian wheezy contrib" > /etc/apt/sources.lists.d/cps-cms.list'
Setup instructions to use the packages
Put the following lines in your /etc/apt/sources.list (replace if needed by the actual codename of your Debian or Ubuntu version).Note that there is no specific repository for Ubuntu 10.04 and 10.10 yet, but the Squeeze packages work for them.
For Debian 7 Wheezy (brand new), and probably Ubuntu 12.04 LTS, on amd64 only (for now),
deb http://apt.cps-cms.org/opt-debian squeeze contrib
For Debian 6 Squeeze, Ubuntu 10.04 Lynx Lucid and Ubuntu 10.10 Maverick Meerkat
deb http://apt.cps-cms.org/debian squeeze contrib
Nota: the 'debian' repository is currently empty, so you may skip the first line
For Debian 5 Lenny
deb http://apt.cps-cms.org/debian lenny main contrib
APT repository GPG signatures
Our official CPS repositories are cryptographically signed by a GNU Privacy Guard (GPG) key. GPG signatures allow users to know that a repository is to be trusted or not, and that downloaded packaged are not altered by network errors or malicious attempts. Conclusion: users who want to use the CPS repositories first need to install those GPG keys on their system.
To install our CPS packagers GPG key run the following command. While doing so, watch out for warnings or errors in the output of the command to be sure that this operation is successful, otherwise the rest of the installation may simply not work.
sudo apt-key adv --keyserver hkp://subkeys.pgp.net --recv-keys 0x07556D74
Next, all you have to do is update the package lists, and the packages will be available:
sudo aptitude update
Installation of the testing instance
We provide a convenience package to set up a working and running CPS instance for your to easily test and evaluate CPS.
Critical warning: DO NOT use this kind of test instance as-is for production servers, or even servers that will be accessible from the Internet, even if you change the passwords. These CPS instances get upgraded blindly by the package.
To get a working and started vanilla CPS 3.5 instance listening on port 6500, do:
sudo aptitude install opt-zope-cps-3.5
All packages whose name starts with opt- don't touch the main part of your system; they install in the opt hierarchy : /opt, /etc/opt, /var/opt
The instance is located in /var/opt/cps-3.5/test-instance ; the toplevel ZMI account is admin, with password 'admin'.
With the opt-zope-cps-3.5 package comes an utility for instance creation. Sample usage:
sudo /opt/cps-3.5/bin/mkcpsinstance -u admin:password \
Installing dependencies only
Follow the instructions in this part if you want to setup a custom installation using the Zope provided instance creation scripts (mkzopeinstance.py, mkzeoinstance.py).
You don't need to do this if you installed either the testing instance or the development setup package. Removing them may uninstall everything and let your instances hanging in the void.
For Lenny and Karmic Koala, just do:
sudo aptitude install zope-cps-full-dependencies
You can then install Zope 2.9 or 2.10 in your preferred way (distribution version or self compiled)
For Squeeze and Ubuntu >= 10.04, the naming is a bit differen than in Lenny, and there are packages for Zope 2.9 and 2.10
sudo aptitude install opt-zope-cps-full-dependencies opt-zope2.9
For Wheezy, opt-zope2.9 has not been packaged yet, and probably won't, since CPS 3.5 supports Zope 2.10, unless we need to support CPS 3.4 at some point
sudo aptitude install opt-zope-cps-full-dependencies opt-zope2.10
The opt prefix puts emphasis on the fact that the installation is made partly in /opt
Alternatively, you may also compile Zope 2.9, just do it against the python interpreter provided by the dependencies package: From the Zope 2.9 distribution, do :
sudo aptitude install opt-zope-cps-full-dependencies