Setup SENAITE with the unified installer

This guide describes the steps how to install SENAITE LIMS on a Debian based Linux system.

Install dependencies

sudo apt install build-essential
sudo apt install python2.7 python2.7-dev
sudo apt install libxml2 libxml2-dev libxslt1.1 libxslt1-dev
sudo apt install libffi-dev libcairo2 libpango-1.0-0 libgdk-pixbuf2.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0

Download the Plone unified installer

wget --no-check-certificate https://launchpad.net/plone/4.3/4.3.18/+download/Plone-4.3.18-UnifiedInstaller.tgz
tar xzf Plone-4.3.18-UnifiedInstaller.tgz
cd Plone-4.3.18-UnifiedInstaller

Install Plone

./install.sh standalone --target=/home/senaite --instance=senaitelims --password=admin

Install SENAITE

To install SENAITE we need to modify the generated buildout.cfg config file:

cd /home/senaite
vim buildout.cfg

Add senaite.lims to the eggs section of the file:

[buildout]
...
eggs =
    ...
    senaite.lims
zcml =
...

Re-run the buildout script:

bin/buildout

Also see here: https://github.com/senaite/senaite.lims#readme

Setup SENAITE for development

This guide describes the steps how to prepare your system for SENAITE development.

SENAITE Dependencies

SENAITE depends on the following systems:

Python

Most UNIX based operating system (Linux/Mac OSX) ship already with a Python interpreter installed. However, it is not recommended to use the system interpreter to setup and install SENAITE on the local system.

Besides the required super-user permissions for installing additional Python libraries is that it might get upgraded by the system and get incompatible.

Therefore, it is better to setup a virtual Python environment with one of the following tools:

In this manual we will use Miniconda.

Miniconda

Please use your terminal to run the commands listed below.

  1. Download the Python 2.7 version for your operating system
  2. Create a virtual environment with conda create --name senaite
  3. Activate the environment with conda activate senaite

The command which python can be used to check if the right Python interpreter is active in the current shell:

$ which python
~/miniconda2/envs/senaite/bin/python
$ python
Python 2.7.16 |Anaconda, Inc.| (default, May  1 2018, 18:37:05)
[GCC 4.2.1 Compatible Clang 4.0.1 (tags/RELEASE_401/final)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>