Install and Configure DSpace 1.6.2 on Ubuntu - School of ...

Page 2 of 9Create a new virtual machine <strong>and</strong> install Ubuntu ServerReview the DigIn St<strong>and</strong>ard <strong>Install</strong>ation document for details, noting the following exceptions:During the installation process, do not select LAMP. All database <strong>and</strong> web configuration will be done manually.You should, however, select the Open SSH application to provide secure FTP <strong>and</strong> SSH functionality.Once the base system <strong>and</strong> SSH are installed, boot the virtual machine <strong>and</strong> configure a fixed IP address. You manyconfigure the same address as you have used for other VMs as long as you don’t try to run more than one ofthem at a time.Then, open the Ubuntu Partner Repositories by editing the repository sources list:$ sudo nano /etc/apt/sources.listFind the following lines relating to the partner repository <strong>and</strong> remove the hash marks at the beginning of theline to uncomment them (note: “lucid” refers to the version of Ubuntu <strong>and</strong> may be different depending on theversion of Ubuntu installed):# deb http://archive.canonical.com/ubuntu lucid partner# deb-src http://archive.canonical.com/ubuntu lucid partnerSave the file (ctrl-o <strong>and</strong> then ctrl-x) <strong>and</strong> then update the repositories list <strong>and</strong> install any available updates <strong>and</strong>security patches:$ sudo aptitude update$ sudo aptitude safe-upgradeIf the upgrade comm<strong>and</strong> fails (it usually takes several minutes), then confirm <strong>and</strong> troubleshoot connectivitybefore proceeding. Refer to the connectivity troubleshooting guide if there are problems.Take a snapshot before proceeding with additional installation steps.<strong>Install</strong> <strong>DSpace</strong> rev 20100926

Page 3 of 9Download <strong>and</strong> install required applications <strong>and</strong> dependencies.At the server comm<strong>and</strong> line, download <strong>and</strong> install each of the following components (some of these may takeseveral minutes or longer depending on your Internet connection speed <strong>and</strong> how busy the site is):$ sudo aptitude install tomcat6$ sudo aptitude install sun-java6-jdk[accept the license when prompted – there will be two screens; use the tab key to highlight the neededresponse <strong>and</strong> press enter to accept]Next (note the double hyphen before the word set in the last comm<strong>and</strong>):$ sudo aptitude install postgresql$ sudo aptitude install libpg-java$ sudo aptitude install ant-optional$ sudo aptitude install maven2$ sudo update-alternatives --set java /usr/lib/jvm/java-6-sun/jre/bin/java[confirm that the comm<strong>and</strong> responds with:update-alternatives: using /usr/lib/jvm/java-6-sun/jre/bin/java to provide /usr/bin/java (java) in manual mode.]Be sure to take another snapshot before continuing on with the <strong>DSpace</strong> installation. If something goes wrong, itwill be much faster to start from this point. Occasionally, one or two of the comm<strong>and</strong>s that follow will onlypartially complete if there are connectivity or network problems, <strong>and</strong> it is difficult to clean up the directorieswithout starting over. If there are problems, starting from a snapshot at this point will be much faster thanstarting over.<strong>Install</strong> <strong>DSpace</strong> rev 20100926

Page 5 of 9Create a database.The following comm<strong>and</strong> creates a database named dspace owned by the dspace user dspace:$ sudo –u dspace createdb -U dspace -E UNICODE dspaceChange ownership of the tomcat directories to the dspace user:$ sudo chown -R dspace /var/cache/tomcat6$ sudo chown -R dspace /var/lib/tomcat6$ sudo chown -R dspace /var/log/tomcat6$ sudo chown -R dspace /etc/tomcat6<strong>Install</strong> <strong>DSpace</strong> rev 20100926

Page 7 of 9dspace.Url = ${dspace.baseURL}/xmluiThis line may end in xmlui or jspui. We will be using the jspui interface, so if necessary, edit the last portion ofthe line to reflect that. It should read:dspace.Url = ${dspace.baseURL}/jspuiFind (a few lines further down):dspace.name = <strong>DSpace</strong> at My UniversityChange it to:dspace.name = DigIn <strong>DSpace</strong> Demo[or another name of your choosing]You should review carefully the <strong>DSpace</strong> manual for information on other configuration parameters. Inproduction settings, there are quite a few things you would need to set as non-default values such as hostname,live URL, usernames <strong>and</strong> passwords for the database <strong>and</strong> mail servers, <strong>and</strong> a number of parameters relating tothe user interface. Browse through the file <strong>and</strong> peruse the sections <strong>and</strong> settings, but don’t change anything elseat this time. When you are done, save the file with ctrl-o then ctrl-x.Before proceeding with the next step, take a snapshot. If maven or ant fails, it will be much easier to try it againfrom a snapshot than to try to clean it up, or start from an earlier point.Change to the source directory <strong>and</strong> package the installation (the first time you run maven, it will download anumber of files <strong>and</strong> may take several minutes or longer):$ cd dspace-<strong>1.6.2</strong>-release/dspace$ mvn packageNote that the “unable to find resource” messages as the build progresses are informational <strong>and</strong> do not meanthere is a problem with the installation.Check for the final BUILD SUCCESSFUL message when the process completes.<strong>Install</strong> <strong>DSpace</strong> rev 20100926

Page 8 of 9Next, initialize the database <strong>and</strong> prepare a fresh install:$ cd target/dspace-<strong>1.6.2</strong>-build.dir$ ant fresh_installMake sure you see the BUILD SUCCESSFUL message when the process completesCreate a <strong>DSpace</strong> administrator:$ /dspace/bin/create-administratorYou’ll be prompted to enter an email address. For this virtual machine demo system, email is not configured.You may enter your own email address (easy to remember) or something made up, such asadmin@localhost.net, but be sure to make a note of it because the email address is the administrator’s loginID.When prompted, enter a first <strong>and</strong> last name (your own will be easy to remember) <strong>and</strong> a password (I suggestpassword). Confirm all the information by entering y when prompted or n to re-enter the information.Log back in as your primary user <strong>and</strong> open the file /etc/default/tomcat6 for editing:$ su user1 *substitute your primary user’s login if different+$ cd$ sudo nano /etc/default/tomcat6Add the following lines to the end of that file, <strong>and</strong> save the file (be sure to press enter after the second line):TOMCAT6_USER=dspaceTOMCAT6_SECURITY=noOpen /etc/tomcat6/server.xml for editing:$ sudo nano /etc/tomcat6/server.xml<strong>Install</strong> <strong>DSpace</strong> rev 20100926

Page 9 of 9Find (using ctrl-w):