Difference between revisions of "PreviewPlusInstallation"

From EPrints Documentation
Jump to: navigation, search
(Plugin Installation)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=Installation =
+
[[Category:EPrints 3 Plugins]]
 +
=Installation=
  
Begin by downloading PreviewPlus from : SOMEWHERE
+
Begin by downloading PreviewPlus from : [http://files.eprints.org/473 http://files.eprints.org/473]
  
 
== Prerequesit software ==
 
== Prerequesit software ==
Line 21: Line 22:
 
  cd /opt/eprints3/archives/ARCHIVEID
 
  cd /opt/eprints3/archives/ARCHIVEID
 
  tar xvzf PreviewPlus.VERSION.tgz
 
  tar xvzf PreviewPlus.VERSION.tgz
 +
 +
== Configure office conversions ==
 +
Depending what distribution of linux you are using you will find that open office installs in different places. You may need to edit <code>cfg/cfg.d/office_conversions.pl</code> so that <code>$c->{office_path}</code> points to you open office install.
 +
 +
== Symlink CGI scripts ==
 +
 +
ln -s /opt/eprints3/archives/ARCHIVEID/cgi/get_preview_plus /opt/eprints3/cgi/
 +
 +
== Adding the preview to eprint render ==
 +
In eprint render find where you want the preview to appear on the page and add:
 +
if($session->get_repository()->call("previews_exist", $eprint)){
 +
        $page->appendChild($session->get_repository()->call("make_preview_plus", $session, $eprint, "horizontal"));
 +
  }
 +
 +
== Cleaning up ==
 +
 +
You must restart your webserver.
 +
 +
You will probably also want to run /opt/eprints/bin/epadmin redo_thumbnails ARCHIVEID
 +
but be warned this is a very expensive process if you have a large archive and should definately be run overnight.
 +
 +
== Setting up cron ==
 +
You will probably want to run the /opt/eprints3/archives/ARCHIVEID/bin/generate_video_previews and /opt/eprints3/archives/ARCHIVEID/bin/generate_audio_previews nightly. The easiest way to do this is to add them to the eprints users contab.
 +
 +
Currently there is no mechanism to stop these scripts snowballing so make sure you leave long enough in the crontab for one job to finish before the next starts.
 +
 +
=Resources/Misc=
 +
 +
== Ubuntu/FFMPEG ==
 +
 +
How to install extra codecs for ffmpeg on ubuntu: https://wiki.ubuntu.com/ffmpeg (especially support for AAC, 3GP)

Latest revision as of 17:49, 9 February 2010

Installation

Begin by downloading PreviewPlus from : http://files.eprints.org/473

Prerequesit software

As prerequisits you will also require FFMPEG, LAME and OpenOffice. On Ubuntu/Debian you can install these from the package manager. On RedHat/Fedora you may have to install them by hand depending what repositories you have available.

FFMPEG:http://ffmpeg.org/index.html

LAME:http://lame.sourceforge.net/

OpenOffice:http://www.openoffice.org/

Plugin Installation

Instructions assume eprints is installed at /opt/eprints3

Extract the tarball into your local archive directory:

cd /opt/eprints3/archives/ARCHIVEID
tar xvzf PreviewPlus.VERSION.tgz

Configure office conversions

Depending what distribution of linux you are using you will find that open office installs in different places. You may need to edit cfg/cfg.d/office_conversions.pl so that $c->{office_path} points to you open office install.

Symlink CGI scripts

ln -s /opt/eprints3/archives/ARCHIVEID/cgi/get_preview_plus /opt/eprints3/cgi/

Adding the preview to eprint render

In eprint render find where you want the preview to appear on the page and add:

if($session->get_repository()->call("previews_exist", $eprint)){
       $page->appendChild($session->get_repository()->call("make_preview_plus", $session, $eprint, "horizontal"));
 }

Cleaning up

You must restart your webserver.

You will probably also want to run /opt/eprints/bin/epadmin redo_thumbnails ARCHIVEID but be warned this is a very expensive process if you have a large archive and should definately be run overnight.

Setting up cron

You will probably want to run the /opt/eprints3/archives/ARCHIVEID/bin/generate_video_previews and /opt/eprints3/archives/ARCHIVEID/bin/generate_audio_previews nightly. The easiest way to do this is to add them to the eprints users contab.

Currently there is no mechanism to stop these scripts snowballing so make sure you leave long enough in the crontab for one job to finish before the next starts.

Resources/Misc

Ubuntu/FFMPEG

How to install extra codecs for ffmpeg on ubuntu: https://wiki.ubuntu.com/ffmpeg (especially support for AAC, 3GP)