Table of content
Here we describe how to install Plone on Ubuntu Linux system. For an installation in a different operating system check the Plone online documentation, here. The installation process requires user to have root privileges and a basic knowledge with Linux command lines using a Terminal. If you are not familiar with UNIX operating system read this tutorial Linux shell tutorial. Please note that a single line must be complete at a time.
Plone framework requires the installation of additional system packages. Without those packages available in your system Plone will not compile.
sudo apt-get install build-essential gcc python-dev git-core libffi-dev sudo apt-get install libpcre3 libpcre3-dev autoconf libtool pkg-config sudo apt-get install zlib1g-dev libssl-dev libexpat1-dev libxslt1.1 libssl1.0-dev sudo apt-get install gnuplot libcairo2 libpango1.0-0 libgdk-pixbuf2.0-0 sudo apt-get install libxml2-dev libxslt1-dev
Download Plone 4.3 Unified Installer
The product Baobab LIMS is implemented and tested with Plone 4.3.11, a version released in 2016-09-12. You can download Plone 4.3.x by visiting the Plone site. Select and click on the Unified installer of your choice or use
wget command line in your terminal with the path to the Plone version to install. Only Plone 4.3.11 can be used. Version 5 is available but will not work.
wget --no-check-certificate https://launchpad.net/plone/4.3/4.3.11/+download/Plone-4.3.11-r1-UnifiedInstaller.tgz
Depending in the option used for the download, the installer would be in the
~/Downloads directory if the download has been done from the Plone site. If the second option rather used i.e, the
wget command line, the installer should be downloaded into the current directory.
To continue the installation, in your terminal change directory into the folder containing the downloaded file then run the following command line to unpack the archive file.
tar -xf Plone-4.3.11-r1-UnifiedInstaller.tgz
Change to the extracted folder
cd Plone-4.3.11-r1-UnifiedInstaller in your terminal, and run this next command to install Plone
./install.sh --target=/usr/local/Plone --build-python zeo
--target is the parameter used to specify the path to the installation folder,
--build-python to add and build
Python package in your system, this is optional if
Python already exist and finally
zeo is the option to install
Plone as a Client-Server application. Plone requires Python2.7 to work.
./install.sh --help to get the full list of the available parameters and their meaning.
Note: In production mode, prepend the the previous command line with
sudo then run.
Install Baobab LIMS
In the new folder created
/usr/local/Plone exists another folder named
zeocluster. This folder contains
buildout.cfg configuration file. Find in the configuration file, the section starting with eggs=, and add
bika.lims to the existing entries. Bika LIMS is a dependency that Baobab LIMS needs to function. Some of modules in Baobab LIMS reference modules in Bika LIMS.
eggs = Plone Pillow bika.lims baobab.lims graphite.theme
Add to the section
develop = the path to your version of Baobab LIMS and BIKA LIMS that should be already downloaded into your local machine. By convention it is preferable to put the source code in
zeocluster/src of your Plone installation folder.
develop = src/bika.lims src/baobab.lims src/graphite.theme
Add the following line to the buildout file. add it in the buildout section: index = https://pypi.python.org/simple/ because of the below warning.
If you encounter the packages not found issue, add the following line, issue related to this: https://github.com/BaobabLims/baobab.lims/issues/55
In the [buildout] section add the below line.
index = https://pypi.python.org/simple/
Save the file
Check out the bika, baobab and graphite code bases from GitHub
git clone or
fork this project to have your own copy in your local machine. For developers, any change in your source code that you judge interesting and useful for the community please create a Pull request to us and let us know if you want to become a collaborator in the Baobab LIMS project.
Change directory into zeocluster/src and run the git clone command from there.
cd src git clone https://github.com/BaobabLims/bika.lims.git git clone https://github.com/BaobabLims/baobab.lims.git git clone https://github.com/BaobabLims/graphite.theme.git
Exit out of the src directory and back into the zeocluster directory and run the
bin/buildout command. Buildout will download and install all the declared dependencies.
cd .. bin/buildout
If you installed
Ploneas a root user i.e., using
sudo, you should run the buildout command line with the user
plone_buildout, this user is automatically created during the
sudo -u plone_buildout bin/buildout
Test your installation
First, you will need to start the zeoserver (this is the database process).
To start a Plone client in debug mode, run this command:
If you installed Plone as a root user, you will need to use the following commands instead:
sudo -u plone_daemon bin/zeoserver start sudo -u plone_daemon bin/client1 fg
Note any error messages, and take corrective action if required. If no errors are encountered, you can press Control+C to exit.
In your preferred browser, firefox or google chrome, run http://localhost:8080/ and start working with Baobab LIMS. Enjoy it!
In production mode, other important tools need to be installed and configured, like
nginx. The following article details the process to follow to add those tools cited before.