2.2. Installing Bika LIMS

Next: Installing Bika LIMS 2 Inkosi on Windows Previous: Installing Plone on Windows  

1. Download Bika LIMS from: http://sourceforge.net/project/showfiles.php?group_id=145464
2. There are several Products listed;
1. If you want to install Bika LIMS, then download the bika package, in whichever archive made available (rar, tar.gz, zip)
2. There are two package types;
1. Bika Product (stand-alone): e.g. bika-1.2.2.rar - this archive only contains the Bika product, but not Bika dependent products. Only download this package if you're upgrading Bika, but take note to make sure your Bika dependent products are up to date
2. Bika Product Bundle; e.g.  bika-1.2.2_bundle.rar  - this archive contains the following;
• bika - version LIMS 1.2.2
  
• ATExtensions - version 0.7.1
  
• ATSchemaEditorNG - version 0.4.2
  
• PloneHelpCenter - version 0.9-Modified_by_Upfront
  
• Portal Transport - version 1.1
  
• stripogram
  
• Upfront Contacts - version 0.4
3. Extract the BIKA Product Package or Bika Product Bundle inside the Products directory of your Zope instance, assuming you have the same set-up described in the Plone installation page, this would be: C:\Program Files\Plone 2\Data\Products
4. Copy start-id-server.bat from C:\Program Files\Plone2\Data\Products\bika\scripts to C:\Program Files\Plone2\Data
5. Edit 'start-id-server.bat' so PYTHON and BIKA_BASE variables reflect your installation
   The Final content of the start-id-server.bat should look like this:
   
   @set PYTHON=C:\Program Files\Plone212\Python\python.exe
   @set BIKA_BASE=C:\Program Files\Plone212\Data
   @set COUNTER_FILE=%BIKA_BASE%\var\idserver.counter
   @set LOG_FILE=%BIKA_BASE%\var\idserver.log
   @set PID_FILE=%BIKA_BASE%\var\idserver.pid
   @set SCRIPT=%BIKA_BASE%\Products\bika\scripts\id-server.py
   @set PORT=8081
   "%PYTHON%" "%SCRIPT%" -f "%COUNTER_FILE%" -p "%PORT%" -l "%LOG_FILE%" %1 %2 %3 %4 %5 %6 %7
   

   The section in bold needs to be added
   
   ONLY for Windows users: Alternatively you can download the patched start-id-server.bat from here:
   

6. Edit C:\Program Files\Plone2\Data\etc\zope.conf with <Environment> variable
   Add in 'environment' section for the ID Server (and remove all other 'environment' settings):
   
   

    <environment>
    IDServerURL http://localhost:8081  
    </environment> 
   

7. ALSO due to a quirk between Plone & windows, edit C:\Program Files\Plone2\Data\etc\zope.conf also un-comment the following section: 'Directive: suppress-all-access-rules'
   so that you get the following line below Example;
   

   suppress-all-access-rules on

8. Run 'runzope.bat' from C:\Program Files\Plone212\Data\bin or
   

1. Run the Plone Control panel (which you can find from Start -> Programs -> Plone -> Plone
   

   
   
   

   Click on the Start button
   

   
   

   Click on the 'Zope Management Interface' button, and the ZMI should open up in a new browser window
   
9. Start the IDServer from C:\Program Files\Plone 2\Data
   Test by browsing to http://localhost:8081/ - if running it will display a number, and will increment it with every reload
   
10. {Skip this step if you used the Plone Controller} Open Browser, go to ZMI, typically http://localhost:8080/manage
11. ZMI: a pop-up will appear requesting your login and password
    

    
    

    assuming you have the same set-up described in the Plone installation page, this would be:

    Login: admin & Password: local

12. Following successful authentication you should see the following screen;
    
    
    
    

13. Select 'Plone site' from the 'Add' drop down menu.
    

    
14. Specify the id (short name, part of site's address), Title (title of the Bika site) and Description (of your BIKA instance) and select 'bika' from the 'Extension Profiles' at the bottom of the form. And click on 'Add Plone Site' and the following screen will appear:
    

    
    

    e.g. Id: 'bika', Title: 'Bika LIMS Portal', Description: 'This is the demo of Bika 1.2.2'
    
15. After step 14 you should be automatically redirected to the ZMI, showing your new Bika instance
16. Click on you bika instance, and then click on the 'View' tab to see bika full screen. Or alternatively, open a new browser window or tab, and enter the following address: http://localhost:8080/bika
17. Uploading Sample Data for bika.
    

    NOTE: if you want to install Bika Wine or Bika Interlab, please only upload sample data at the end of the 'Wine' or 'Interlab' installation process.
    

    If you want to populate your Bika LIMS with sample data, login into bika as administrator, and enter the following address in your browser:
    http://localhost:8080/bika/load_sample_data
    

    NOTE: Make sure your IDServer is running!

18. This will take several seconds, and will be followed by an blank screen with 'Ok' in the top left. 

19. Use the browser's back button to return to the Bika LIMS

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

Next: Installing Bika LIMS 2 Inkosi on Windows Previous: Installing Plone on Windows