Notes on HC2 installation for EPrints 3.2+


Installation Requirements
=========================

  * EPrints 3.2+
  * Net::HoneyComb Perl Library (from files.eprints.org)
  * HC2 Plugin for EPrints 3.2+

General System Requirements (debian systems)
===========================

  * build-essential
  * devscripts
  * libidn libidb11 libidn11-dev
  * curl
  * libcurl4-openssl-dev

Building the HC2 C Library (availble from HC2) 
==========================
  
  * cd hc2/client/dist/src/c_lib
  * make
  * cp honeycomb/include/* /usr/include/
  * cp honeycomb/platform/linux/*.h /usr/include/
  * cp honeycomb/platform/linux/*.o /usr/lib/
  * cp ../../lib/*.so /usr/lib/
  * ldconfig
  
Building the Net::HoneyComb Module
==================================
 
  * Refer to it's README
	* Perl Makefile.PL
	* make
 	* make test
	* make install

Installing the HoneyComb.pm EPrints Plugin
==========================================

  * edit HoneyComb.pm to point it at your HC2 instance (change node1.cluster.org in the following code block withing this file)

  eval { $self->{honey} = Net::Sun::HoneyComb->new(
      "node1.cluster.org",
      8080
  ) };

  * cp HoneyComb.pm eprints_root/archives/archive_name/cfg/plugins/EPrints/Plugin/Storage/
  * restart apache / web server

Utilising your Honeycomb (EXAMPLE)
========================
 
  * As the eprints user in EPrints Root dir
 
  * cp lib/storage/default.xml archives/archive_name/cfg/storage/default.xml
 
  * Edit this file archives/archive_name/cfg/storage/default.xml and change:
	
		<epc:when test="datasetid = 'document'">
                        <plugin name="Local"/>
                </epc:when>
	
    to
		
		<epc:when test="datasetid = 'document'">
                        <plugin name="HoneyComb"/>
                </epc:when>
	
   * All document files will then be stored on your cluster, viewable via the "Storage Manager" button in the Admin interface