Dependencies for DSpace:
- Tomcat
- Postgres
- Java 7
Dependencies for a development environment
- Tomcat
- Postgres
- Java 7
- Git (to download dspace-source)
- Maven (to compile DSpace - part 1)
- Ant (to compile DSpace - part 2)
- IntelliJ (Optional: to edit code)
- pgAdmin3 (Optional: to run queries against postgres)
The process below is an efficient way of setting this all up on OSX. This guide was compiled on May 7, 2014, using a new MacBook Pro, running OSX 10.9 (Maverick), and grabbing the latest DSpace, something like DSpace 4.x or DSpace 5.x. There’s no one-click installer, so some command-line proficiency is required.
Dependencies for DSpace:
- Tomcat
- Postgres
- Java 7
- Git (to download dspace-source)
- Maven (to compile DSpace - part 1)
- Ant (to compile DSpace - part 2)
Some optional goodies, helpful when doing development include:
- IntelliJ (Java programming)
- pgAdmin3 (Better environment for making Postgres SQL queries)
- Sublime Text 3 (Simple lightweight text editor, better than default included tools on OSX)
Install Brew
Brew is a package installer/manager for OSX. Its great as it allows you to properly install a number of programs (i.e. dependencies) from the command line.
Install brew, and Install: brew, follow instructions from http://brew.sh
brew doctor
brew update
brew install git
...
Install Java 7 JDK
Download and Install Java 7 JDK, this step should be done before installing tomcat, and IntelliJ: http://www.oracle.com/technetwork/java/javase/downloads/index.html
Info | ||
---|---|---|
| ||
If vi / vim is too technical for you, you can use nano or sublime text (pro-tip at bottom) instead. Then, instead of vi ~/.bash_profile, it would be nano ~/.bash_profile or subl ~/.bash_profile vi is just common among systems people |
Configure JAVA_HOME for Java 7
...
export JAVA_HOME=$(/usr/libexec/java_home -v 1.7)
Install Git, Maven, Ant, Tomcat
brew install git maven ant tomcat tomcat-native
...
Install Postgres.App
Install postgres.app from: http://postgresapp.com/
...
“\q” gets you out of PSQL.
Configure Tomcat
Tell tomcat that tomcat-native is installed.
...
Create the /dspace directory, below where I have "myUserName", customize that for your local setup, i.e. "peter".
sudo mkdir /dspace
sudo chown -R myUserName /dspace
...
Clone DSpace from GitHub, to your Projects directory, and begin the compile process.
cd ~
mkdir Projects
cd ~/Projects
git clone https://github.com/DSpace/DSpace.git
cd DSpace
git checkout dspace-4_x
mvn package
cd dspace/target/dspace-installer/
...
From here, you should have a ready to go system. You can always check the official installation documentation too: Installing DSpace. It would be best to keep this document Install on OSX guide up-to-date, so if you run into issues, please leave a comment, update this document (if permitted), or contact the author.
PRO-Tips:
Mail Catcher for to view emails on localhost
...