Attention

This document was written for an unsupported version of Plone, Plone 2.5.x, and was last updated 898 days ago.

For more information, see the version support policy.

To learn how to upgrade to the current version of Plone, read the upgrade manual.

Installing Plone on Ubuntu 6.10 Server

by Bhuvan Pasham last modified Dec 06, 2009 09:27 PM
Installing Plone on Ubuntu server (installed with server CD) should take about 30 minutes but could find a straight forward guide anywhere. This How-To is a short step-by-step for installation.
I'm NOT a Linux or Plone Guru.

I tried to build a Plone on Ubuntu Server and it took four evenings to make the install work, as there is no clear step-by-step guide on how to do this. I tried document all the valid steps of the installation and repeated the whole install at a stretch and this works. Thought it as a good idea to share with other newbies like me.

I used Ubuntu 6.10 Server CD and Plone Universal Installer for this exercise.


  1. Download the latest Ubuntu server Installation CD image from http://mirror.cc.columbia.edu/pub/linux/ubuntu/releases/edgy/ubuntu-6.10-server-i386.iso
  2. Burn the image to CD
  3. Insert the disk in the CDROM drive and start the system. Make sure that the first boot device is the CD
  4. Follow thru the instructions of setup in Normal Mode (default).
  5. During DHCP configuration, select DHCP with hostname option.
  6. For Partitioner select with LVM option.
  7. the Server type select LAMP server option.
  8. After rebooting the server Install dependencies
    1. Install GCC:
      sudo apt-get install gcc
    2. Install G++:
      sudo apt-get install g++
    3. Install make:
      sudo apt-get install make
      1. Install Python module (mod_python) for Apache 2 (This step is purely Optional)
        1. sudo aptitude install libapache2-mod-python
          sudo nano /etc/apache2/mods-available/mod_python.conf

          add the following lines

          AddType application/x-httpd-python .py
          AddHandler mod_python .py
          PythonHandler mod_python.publisher
          PythonDebug On

          save

          cd /etc/apache2/mods-enabled
          sudo ln -s ../mods-available/mod_python.conf mod_python.conf
          sudo /etc/init.d/apache2 restart
      2. Install readline libraries (recommended - NOT mandatory) from
        1. cd /home/<username>
          wget http://ftp.debian.org/debian/pool/main/r/readline5/readline5_5.2.orig.tar.gz
        2. Unpack and Install:
          gunzip < readline5_5.2.orig.tar.gz | tar -x
          cd readline-5.2/
          ./configure
          make
          sudo make install
      3. Download Plone Universal Installer
        1. cd /home/<username>
          wget http://downloads.sourceforge.net/plone/Plone-2.5.2-UnifiedInstaller.tgz?use_mirror=osdn or from wget http://superb-east.dl.sourceforge.net/sourceforge/plone/Plone-2.5.2-UnifiedInstaller.tgz
        2. unpack the installer:
          gunzip < Plone-2.5.2-UnifiedInstaller.tgz | tar -x
          cd Plone-2.5.2-UnifiedInstaller
        3. install Plone:
          sudo ./install.sh
      4. Install Location
  • Plone installed at /opt/Plone-2.5.2
  • Python installed at /opt/Plone-2.5.2/Python-2.4.4
  • ZEO cluster (server and 2 clients) installed and configured at /opt/Plone-2.5.2/zeocluster
  • Zope Products folder at /opt/Plone-2.5.2/zeocluster/Products
  • Data.fs (ZODB) at /opt/Plone-2.5.2/zeocluster/server/var
  • Admin Password
    • A random administrator password is generated during the install. The password is located at /opt/Plone-2.5.2/adminPassword.txt
    • This is NOT the place where you change the Admin password. This is only a log file.
  • Start Plone server
    • sudo /opt/Plone-2.5.2/zeocluster/bin/startcluster.sh
  • Log in from a remote computer http://<servername>:8080/manage
  • Add Zope/Plone to start automatically at Boot
  • sudo cp /opt/Plone-2.5.2/zeocluster/bin/startcluster.sh /etc/init.d
    sudo update-rc.d myscript start 51 S .
    • (Do not forget the dot: . )
  • Reboot the server and check every thing is working fine.

  • This concludes the Installation.
    Additional Tasks include configuring apache Reverse Proxy, installing addons etc.

    Contribute

    Something wrong or out of date? Anybody can edit or create a new article in the knowledge base. Simply create an account on this site, log in, and click the Edit button to contribute.