Date: Thu, 28 Mar 2024 13:30:55 -0400 (EDT) Message-ID: <395334490.28441.1711647055637@lyrasis1-roc-mp1> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_28440_1554936017.1711647055637" ------=_Part_28440_1554936017.1711647055637 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
This how-to is an updated version of Peter Dietz's installation guide. The purpose = of this guide is to extend the ease and clarity of that instruction set to = more modern installs.
This install is based on Ubuntu 14.04.1 LTS Server.
sudo ap= t-get update
sudo ap= t-get install tasksel sudo tasksel
Select the following packages
[*] LAM= P server [*] PostgreSQL database [*] Tomcat Java server
*** Don't forget to deselect any defaults!
You can try executing the commands which tasksel would have executed as = separate statements:
sudo tasksel install lamp-server
sudo tasksel install tomcat-server
sudo tasksel install postgresql-server
sudo ap= t-get install ant maven
sudo su= postgres createuser -U postgres -d -A -P dspace exit
sudo vi= /etc/postgresql/9.3/main/pg_hba.conf # Add this line to the configuration: =09local all dspace md5 # Comment out any lines that have "peer" at the end of them # When done, restart postgresql: =09sudo service postgresql restart
created= b -U dspace -E UNICODE dspace
sudo vi= /etc/tomcat7/server.xml # Insert the following chunk of text just above the closing </Host> <!-- Define a new context path for all DSpace web apps --> <Context path=3D"/xmlui" docBase=3D"/dspace/webapps/xmlui"/> <Context path=3D"/sword" docBase=3D"/dspace/webapps/sword"/> <Context path=3D"/oai" docBase=3D"/dspace/webapps/oai"/> <Context path=3D"/jspui" docBase=3D"/dspace/webapps/jspui"/> <Context path=3D"/lni" docBase=3D"/dspace/webapps/lni"/> <Context path=3D"/solr" docBase=3D"/dspace/webapps/solr"/>
The [dspace] directory is where the running dspace code will reside= .
sudo mk= dir /dspace cd /dspace
The source release allows you to customize every aspect of DSpace. This = step downloads the compressed archive from SourceForge, and unpacks it in y= our current directory. The dspace-1.x.x-src-release directory is typically = referred to as [dspace-src].
sudo gi= t clone https://github.com/DSpace/DSpace.git (apt-get install git if you do= n't already have it) # Now, actually checkout the 4.2 codebase via the 'dspace-4.2' tag. There's= two options, CHOOSE ONE # Option #1: Checkout the official 'dspace-4.2' tag into a new local branch= (which we've named "dspace-source") sudo git checkout -b dspace-source dspace-4.2 # Option #2: Just checkout the "dspace-4_x" maintenance branch. This will e= ssentially include all the latest patches on 4.x sudo git checkout dspace-4_x
The source release that has been obtained is human readable source code,= and must be compiled to machine code for the server to run it. "mvn packag= e" compiles the source code, and "ant" will do all the work necessary&= nbsp;to initialize the database with the DSpace schema, and copy all of the= compiled machine code to a location where the web server can serve it.&nbs= p;This will overwrite any existing installation of DSpace that you = may have.
make sure all your dependencies are in order, and you're running maven 3= .x. (Check this version with mvn -v). If not, run these commands:
sudo apt-get install maven
sudo apt-get remove maven2
Now run these:
sudo ap= t-get install openjdk-7-jdk cd DSpace sudo mvn package (this step takes a long time) cd dspace/target/dspace-installer sudo ant fresh_install
This guide follows the convention where the tomcat user will own all of = the files in [dspace], so we have to change the owner of the files to = tomcat7. Restarting tomcat will deploy the dspace webapps that are now read= y to be viewed.
cd /hom= e/dspace (or wherever your bottom most directory for dspace is) sudo chown tomcat7:tomcat7 /dspace -R sudo service tomcat7 restart
That is all that is required to install DSpace on Ubuntu. There are two = main webapps that provide a similar turn-key repository interface