1.4. Installing Bika Interlab

Next: Installing Bika LIMS 2 Inkosi on Linux Previous: Installing Bika LIMS  

BIKA is a LIMS, which is short for Laboratory Information Management
System.
Please refer to the README.txt in the bika directory

Pre-requisites:

• BikaLims 1.2.5
• RenderableCharts (which requires ReportLab - see below)
  

Tested with:

• Zope 2.9.5
• Plone 2.5.1
• BikaLIMS 1.2.5
  

Installation:

NOTE: To install BIKA, you need to be familiar with the Zope or Plone installation procedure. We hope to have graphical installers soon to simplify installation.

1. Copy BikaInterlab folder to your Plone Products folder.
2. Install BikaLIMS as per instructions in the BikaLIMS Installation Guide
   Do not load the BikaLIMS sample data, or create any other data.
   
3. Log on to your newly created bika site as administrator, and navigate to:
   
   
1.  [site setup]
   
   
2. [Add/Remove Products]
   
   
4. Select BikaInterlab from the Products available for install
   
   
   and click on install. BikaInterlab will now appear in the Installed products list. 
5. Test the graphing software installation with a page which graphs a set of dummy data. A smooth bell curve rendered with colours should be visible. If it is not, the graphing software has not been correctly installed. e.g. http://localhost:8080/instanceid/test_install
   
   You should see the following; (click on image to enlarge):
   
   
6. Sample data has been provided in  ../bikainterlab/skins/bikainterlab/load_testdata.py and a subset in ../bikainterlab/skins/bikainterlab/load_smalltestdata.py
   This can be loaded by being logged in to your BIKA instance as the administrator, and executing the script in the browser: e.g. http://localhost:8080/instanceid/load_testdata
   
   If successful you should see an empty browser page with: 'OK' in the top left corner.
   

If you have any trouble with the above installation procedure, please join the BIKA users mailing list and report any problems you might have:

• http://lists.sourceforge.net/lists/listinfo/bika-users

For latest Manuals, Tutorials, How-To's, Instruction Movies and other Help resources, please visit Bika Lab System's Help Centre at http://www.bikalabs.com/helpcentre

RenderableCharts Installation:

(included here from RenderableCharts README)

It is recommended that the RenderableCharts installation be tested with the example below before continuing with the BikaInterlab installation

ReportLab 1.19 is needed. See below

Works with ReportLab 1.20, _renderPM 1.0, _rl_accel 0.52 !

=====================================================================

Step-by-Step Installation How-To:

1. Install ReportLab 1.19 from http://reportlab.org/downloads.html
2. Install _renderPM 0.99 from http://reportlab.org/downloads.html
3. Install PIL 1.1.4 from http://www.pythonware.com/products/pil/
4. Install Adobe Acrobat Reader for the T1-Fonts
5. Adapt the rl_config.py T1SearchPath to fit your system path to the Acrobat*/Resource/Font directory (see below)
6. Unpack RenderableCharts-*.tar.gz in the Zope-Products folder
7. Restart Zope

=====================================================================

Step-by-Step Example How-To:

1. Add a ChartObject (name: my_chart):
   Id:                                   my_chart
   Title:                                My First simple ChartObject
   Name of ChartTemplate:   my_template
   List of DataObjects:          chart:get_chart_data  
   
   -> Add and Edit
2. Add a ChartTemplate (name: my_template):
   Id:                       my_template
   Title:                    My First simple ChartTemplate
   Sample:               ClusteredBar
   
   -> Add and Edit
3. Goto ZMI function Test, a nice horizontal bar chart should be visible now.
4. Goto the folder where my_chart was added.
5. Add a Database Connection for your favorite Database
   (name: database_connection)
   
6. Add a ZSQLMethod (name: get_chart_data):
   Id:                        get_chart_data
   Title:                    My First simple ChartData
   Connection Id:            database_connection
   Arguments:                (enter nothing)
   Query Template:            (put here your SQL-Query, which should return row-by-row in the first column a categoryName andin the other columns values)
   
   -> Add
7. Goto ChartObject my_chart -> ZMS function Test -> the horizontal bar chart with values from database should be visible now.
   

=====================================================================

Additional information in the RenderableCharts README, and from the product
web sites

ReportLab installation notes:

=============================
(from the ReportLab README - additional information in the ReportLab installation package)

Either unpack reportlab.zip or reportlab.tgz to some directory say d:\ReportLab. If you can, ensure that the  line terminator style is correct for your OS (man zip programs have a text mode option eg -a).

Create a .pth file, say reportlab.pth in your Python home directory.  It should have one line: e.g. /home/zope/plone/Products/ReportLab.

Alternatively unpack the archive into a directory which is already on your python path.

Next: Installing Bika LIMS 2 Inkosi on Linux Previous: Installing Bika LIMS