View source for EdShare Reference Installation

{{EdShare}}

=Introduction=
The [[EdShare Reference Installation]] is the standard installation for EdShare and includes all of the functionality that is covered by the EdShare suite.

It is important to note that the [[EdShare Reference Installation]] assumes that you have a clean installation of EPrints 3.1.3.

==Features==
Once you have completed this recipie you will have a repository that has the following functionality;
* A simplified workflow removing features that are not required in the context of a teaching and learning resources repository
* Ability to create collections of resources
* Users can bookmark resources and collections
* There will be previews of documents on abstract pages

=Installation=

==Conventions==

The following conventions apply in this recipie;
* ''EPRINTS_ROOT'' - This is where you installed eprints. Usually this is ''/usr/share/eprints3'' on Debian/Ubuntu or ''/opt/eprints3'' following a source code install. Obviously change this if you installed EPrints elsewhere.
* ''ARCHIVEID'' - This is the id of the archive you set up that you want to carry out this recipie on.

==Getting Started==

===EPrints===
You will need to have installed at least EPrints 3.1 before continuing. See the following pages for reference on how to do this;

* Ubuntu/Debian [[Installing EPrints 3 via apt (Debian/Ubuntu)]]
* Other Linux [[Installation|Installing from source]]

===Plugins===
You will need to obtain the following plugins in order to complete this recipie;
* [[EdShareCore]]
* [[EdShareCollections]] ([[EdShareCollectionsInstallation]])
* [[EdShareToolbox]]
* [[MePrints]] ([[MePrintsInstall]])
* [[Sneep]]
* [[PreviewPlus]]
Additionally consult these pages for individual installation instructions for these plugins.

==Extensions Installation==
Before starting ensure that you are logged in as the ''eprints'' user and in your ''EPRINTS_ROOT''. Usually you can do this by running;

 sudo su eprints
 cd

You need to make sure this is the case before you attempt to install any of the extensions.

===EdShareCore===
Firstly change into your archive directory and extract the edsharecore tarball there. The name of your tarball may be different depending on the version you downloaded;

 cd EPRINTS_ROOT/archives/ARCHIVEID
 tar -xzf edsharecore-VERSION.tgz

Next you need to update your database structure, regenerate your views and regenerate your static pages;

 EPRINTS_ROOT/bin/epadmin update_database_structure ARCHIVEID
 EPRINTS_ROOT/bin/generate_views ARCHIVEID
 EPRINTS_ROOT/bin/generate_static ARCHIVEID

Finally all you need to do is restart your web server to ensure that the settings are applied and you will now have EdShareCore installed.

===EdShareCollections===
If you re not in your archive directory then change into is and extract the edsharecollections tarball there. The name of your tarball may be different depending on the version you downloaded;

 cd EPRINTS_ROOT/archives/ARCHIVEID
 tar -xzf collections-VERSION.tgz



[[Category:EdShare_Recipies]]