This installer will install Bika LIMS 2 (Inkosi) on Ubuntu 10.x system. The desktop and the server versions have been tested and both should work fine. In order for this installer to work your computer has to be connected to the Internet!
This installer is based on the Unified Plone Installer, written by Kamal Gill. Tips on installing were provided by Bika's own Campbell McKellar-Basset and lemoene Smit. Thanks to Lee James for testing the installer and for his valuable feedback.
Previous versions of the installer will be kept for future reference. However, this page will only contain instructions for the most recent version.
Source code for the most recent installer version is stored on github.
The installer was written with simplicity in mind. To install Bika you will need the following:
Once you have all of this in place you can just follow the steps below. Just copy-paste each green line from your browser into your terminal window and press Enter (or Return). This will execute each command for you. You do not have to actually understand these commands, it should work just fine.
I've made a tutorial video which shows the entire installation procedure using this installer which you can watch right here. I may be going a bit fast at times; just keep in mind that you can pause and rewind the video. For best results, make sure to switch the video to HD and full-screen using the video controls!
The file should automatically be placed into your downloads folder which is "~/Downloads/" (the little squiggle "~" means your home directory). Open up a terminal window and go to the downloads folder:
cd ~/Downloads/
tar -zxf ./bika-install.tar.gz
cd ./bika-install/
sudo ./plone-install.local.sh
This will download and install all dependencies and Plone 2.5.5. If you're asked at anytime during the installation whether you want to install software on your computer just confirm by typing y and Enter.
When it's done you'll be shown an admin password. You can retrieve it later with the following command: sudo cat /opt/Plone-2.5.5/adminPassword.txt.
sudo ./bika-install.local.sh
sudo nano /etc/shadow
In the "/etc/shadow" file, find the line that starts with "plone" and delete everything between the first two colons (":"). The line should now start with "plone::". Exit the nano editor by pressing Ctrl-X; confirm saving the file by typing y and Enter.
Now that the old password has been cleared we can set a new one. Put in:
sudo passwd plone
and enter a new password for user "plone".
su plone
And enter the password for user "plone" you just set.
cd /opt/Plone-2.5.5/zeocluster/client1
sh ./start-id-server
exit
sudo /opt/Plone-2.5.5/zeocluster/bin/startcluster.sh
Now access the location "localhost:8080/manage" in your broswer. You will be asked for the admin password you were given when Plone finished installing. Copy-paste the password; the user name is "admin". You should now be taken to the Zope Management Interface (ZMI).
See the drop-down menu where it says "ATContentTypes tool" ("Select type to add..." on some browsers) towards the top-right corner of the ZMI? Select "Plone Site" to go to the Plone site setup page. Fill in an ID (say, "bika") and a title (e.g. "Bika") and select "bika" from the "Extension Profiles". Click on the "Add Plone Site" button below. Be patient here, this can take a few minutes.
Voila. You may now visit your Bika LIMS at "localhost:8080/bika".