Technical Notes & Downloads

Joe Roback, dLIST Research Assistant and graduate student in Computer Science, University of Arizona, has developed modifications to Eprints and PKP software that provide additional user functionalities. These are fully described and made available here for your download. Please feel free to use them and don't forget to let us know (email: admin.dlist@gmail.com) when you do so. Thanks!

EPrints

• Displaying "Latest Addtions" from Apache SSI (Server Side Include)
• Displaying "News" from Apache SSI (Server Side Include)
• Bug fixes and MySQL improvements for EPrints Statistics package
• Latest News Plugin for EPrints 3.0

PKP

• OAI Set and Flow Control Harvesting
• Improved Advanced Search

Latest Additions

• Download modified eprints2/cgi/latest perl script
  
  

  $ cd eprints-2.3.12/cgi
  $ cp latest latest.bak
  $ curl -O http://dlist.sir.arizona.edu/downloads/latest
    % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                   Dload  Upload   Total   Spent    Left  Speed
  100  2959  100  2959    0     0  11572      0 --:--:-- --:--:-- --:--:--  240k
  

  
  
• Add server-side includes to cfg/apachevhost.conf for your archive
  
  

  <Location />
          Options +Includes
          AddType text/html .shtml
          AddHandler server-parsed .shtml
          AddOutputFilter INCLUDES .html
          XBitHack on
  </Location>
  

  
  
• Add include statement to index.xpage
  
  

  <--#include virtual="/perl/latest?output=inline" -->
  

  
  

News

• Download eprints2/cgi/news perl script
  
  

  $ cd eprints-2.3.12/cgi
  $ cp latest latest.bak
  $ curl -O http://dlist.sir.arizona.edu/downloads/news
    % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                   Dload  Upload   Total   Spent    Left  Speed
  100   723  100   723    0     0   3508      0 --:--:-- --:--:-- --:--:-- 45187
  

  
  
• Add server-side includes to cfg/apachevhost.conf for your archive (same step as above)
  
  

  <Location />
          Options +Includes
          AddType text/html .shtml
          AddHandler server-parsed .shtml
          AddOutputFilter INCLUDES .html
          XBitHack on
  </Location>
  

  
  
• Add include statement to index.xpage
  
  

  ePrintsStats.tar.gz
  <--#include virtual="/perl/news" -->
  

  
  

EPrints Statistics

• Download ePrintsStats.tar.gz and unpack
  
  

  $ cd <install_base_directory>
  $ curl -O http://dlist.sir.arizona.edu/downloads/ePrintsStats.tar.gz
    % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                   Dload  Upload   Total   Spent    Left  Speed
  100  262k  100  262k    0     0   535k      0 --:--:-- --:--:-- --:--:--  880k
  $ tar zxvf ePrintsStats.tar.gz
  

  
  
• Edit configuration files
  
  

  ePrintsStats/config/inc.vars.es.php
  	Need to set connections, filelocation and general arrays
  ePrintsStats/vhost/apache.conf
  	Copy configuration into httpd.conf or use "Include" statement
  ePrintsStats/scripts/eprints-usage.php
  	Need to fill in MySQL parameters and locations of apache httpd log files
  

  
  
• Follow official README.txt included in ePrintsStats.tar.gz for the remaining configuration
  All patches and bug fixes are included in ePrintsStats.tar.gz and ready to go
  
  

Latest News Plugin for EPrints 3.0

• Download latest_news.tar.bz2.
  
  
• Unpack latest news v1.0 source.
  
  
  
  
• Run install script. You must specify eprints 3.0 installation directory and an achive id.
  
  
  
  
• Edit phrases/news.xml in order to customize any labels.
  
  

  $ vi /<eprints installation>/archives/<archive id>/cfg/lang/en/phrases/news.xml
  

  
  
• Run generate_static on your archive.
  
  
  
  
• Restart Apache
  
  

  $ /etc/init.d/httpd restart
  

  
  
• Latest News can now be accessed from within the admin console of EPrints 3.0.
  
  
  
  
• To access to the latest news archive page, simply link to &perl_url;/news in any EPrints xml template.
  
  
• To include the latest news into any existing page, like the EPrints homepage, simply follow these steps:
  • Enable Apache Server-Side Includes (SSI)
  • <!--#include virtual="&perl_url;/news?output=inline" -->
  • Restart Apache

OAI Set and Flow Control Harvesting with PKP

• Download flow-control_sets.patch
  
  

  $ curl -O http://dlist.sir.arizona.edu/downloads/flow-control_sets.patch
    % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                   Dload  Upload   Total   Spent    Left  Speed
  100 30527  100 30527    0     0   134k      0 --:--:-- --:--:-- --:--:-- 29.1M
  

  
  
• Unpack PKP source
  
  

  $ tar zxvf harvester-1.0.1.tar.gz
  

  
  
• Patch flow-control_sets.patch against PKP source
  
  

  $ patch -p0 < flow-control_sets.patch
  patching file harvester/add.php
  patching file harvester/admin.php
  patching file harvester/include/db.inc.php
  patching file harvester/include/harvester.inc.php
  patching file harvester/include/xmlparser.inc.php
  

  
  

Improved Advanced Search Features, Optimized for MySQL4+

• Download mysql4-search.patch
  
  

  $ curl -O http://dlist.sir.arizona.edu/downloads/flow-control_sets.patch
    % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                   Dload  Upload   Total   Spent    Left  Speed
  100 30527  100 30527    0     0   134k      0 --:--:-- --:--:-- --:--:-- 29.1M
  

  
  
• Unpack PKP source (if not already done in previous step)
  
  

  $ tar zxvf harvester-1.0.1.tar.gz
  

  
  
• Patch mysql4-search.patch against PKP source
  
  

  $ patch -p0 < mysql4-search.patch
  patching file harvester/include/quicksearch.inc.php
  patching file harvester/search.php