|
|
| (210 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | '''<font size="3" color="red">It is vitally essential that you have first completed the [[SUNScholar/Prepare_Ubuntu|preparation of Ubuntu]] for the installation of DSpace.</font>''' | + | =PROCEDURE 3 - INSTALL DSPACE= |
| | + | <center> |
| | + | '''<font color="red">This procedure assumes that your server is open on the campus firewall OR proxy server.<br>Open access to the internet is needed to be able to download Java packages from various websites during the build of the various DSpace web applications.</font>''' |
| | | | |
| − | If you have not, please do so now.
| + | '''<font color="red">*** Complete the following steps as the "dspace" user, unless otherwise explicitly specified ***</font>''' |
| − | =Introduction= | + | </center> |
| − | =Step 1. Login to the remote server= | + | ===[[SUNScholar/Install DSpace/S01|Step 1. Login to the remote server]]=== |
| − | On your client PC with the Ubuntu desktop live CD, click on: '''Applications => Accessories => Terminal''' to open a command line terminal.
| + | ===[[SUNScholar/Install DSpace/S02|Step 2. Get DSpace]]=== |
| | + | ===[[SUNScholar/Install DSpace/S03|Step 3. Unpack DSpace]]=== |
| | + | ===[[SUNScholar/Install DSpace/S04|Step 4. *** Edit the DSpace configuration ***]]=== |
| | + | ===[[SUNScholar/Install DSpace/S05|Step 5. Build the DSpace Java webapps]]=== |
| | + | ===[[SUNScholar/Install DSpace/S06|Step 6. Install the DSpace Java webapps]]=== |
| | + | ===[[SUNScholar/Install DSpace/S07|Step 7. *** Create the DSpace super-admin user ***]]=== |
| | + | ===[[SUNScholar/Install DSpace/S08|Step 8. Enable the DSpace Java webapps on the Tomcat Java webapp server]]=== |
| | + | ===[[SUNScholar/Install DSpace/S09|Step 9. Perform system tests]]=== |
| | + | ===[[SUNScholar/Install DSpace/S10|Step 10. Login to the DSpace application as the "super-admin" user]]=== |
| | + | ===[[SUNScholar/Install DSpace/S11|Step 11. After installation tasks]]=== |
| | | | |
| − | '''<font color="red">Login to your remote server as the "dspace" user by typing as follows in the terminal</font>'''
| + | ===[https://youtu.be/CyW6j5J3Rzg YouTube Video]=== |
| | | | |
| − | ssh dspace@%hostname%
| + | ===References=== |
| − | Replace %hostname% with the hostname of your server.
| + | *https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace#InstallingDSpace-Installation |
| − | | + | *https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-Installation |
| − | =Step 2. Get [http://sourceforge.net/projects/dspace/files/DSpace%20Stable/ DSpace] version 1.6.2= | + | *https://wiki.duraspace.org/display/DSDOC4x/Installing+DSpace#InstallingDSpace-Installation |
| − | Click on the link above and download the DSpace 1.6.2 source code to the dspace home folder.
| + | *https://wiki.duraspace.org/display/DSDOC3x/Installation#Installation-Installation |
| − | | + | <center> |
| − | =Step 3. Unpack DSpace= | + | '''<big>[[SUNScholar/Prepare_Ubuntu|PREVIOUS - PREPARE UBUNTU]]</big>''' |
| − | Type the following to extract the source code.
| + | </center> |
| − | tar -xzvf /home/dspace/dspace-1.6.2-src-release.tar.gz
| + | [[Category:Installation]] |
| − | | + | __NOTOC__ |
| − | =Step 4. *** Edit the DSpace configuration ***= | |
| − | Type the following to edit the Dspace (dspace.cfg) config file:
| |
| − | | |
| − | nano /home/dspace/dspace-1.6.2-src-release/dspace/config/dspace.cfg
| |
| − | | |
| − | Replace all the places with a pair of percent signs (%something%) with the settings for your campus.
| |
| − | | |
| − | <pre>
| |
| − | dspace.dir = /home/dspace
| |
| − | dspace.url = http://%hostname%
| |
| − | dspace.hostname = %hostname%
| |
| − | dspace.name = DSpace for My University
| |
| − | db.name = postgres
| |
| − | db.url = jdbc:postgresql://localhost:5432/dspace
| |
| − | db.driver = org.postgresql.Driver
| |
| − | db.username = dspace
| |
| − | db.password = dspace
| |
| − | mail.server = %my_university_mail_server_address%
| |
| − | mail.from.address = %my_email_address%
| |
| − | feedback.recipient = %my_email_address%
| |
| − | mail.admin = %my_email_address%
| |
| − | alert.recipient = %my_email_address%
| |
| − | registration.notify = %my_email_address%
| |
| − | default.language = en_ZA
| |
| − | </pre>
| |
| − | | |
| − | =Step 5. Maven packages installation=
| |
| − | Change to the source folder as follows:
| |
| − | | |
| − | cd /home/dspace/dspace-1.6.2-src-release
| |
| − | | |
| − | Type the following to download the maven2 packages. Ensure you have an open connection to the internet first.
| |
| − | | |
| − | mvn package
| |
| − | | |
| − | A lot of stuff will be downloaded and scroll on the screen.
| |
| − | | |
| − | If nothing downloads, check your maven config file and ask for an open connection to the internet for your server from your IT department.
| |
| − | | |
| − | If the downloads start, then go make a cup coffee and check your emails.. this takes quite a while with slow internet connections !!
| |
| − | | |
| − | When complete you will get a message like this:
| |
| − | <pre>
| |
| − | [INFO] Copying 861 files to /home/dspace/dspace-1.6.2-release/dspace/target/dspace-1.6.2-build.dir
| |
| − | [INFO]
| |
| − | [INFO]
| |
| − | [INFO] ------------------------------------------------------------------------
| |
| − | [INFO] Reactor Summary:
| |
| − | [INFO] ------------------------------------------------------------------------
| |
| − | [INFO] DSpace Addon Modules .................................. SUCCESS [30.453s]
| |
| − | [INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [1:14.611s]
| |
| − | [INFO] DSpace LNI :: Web Application ......................... SUCCESS [10.261s]
| |
| − | [INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.427s]
| |
| − | [INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [8.017s]
| |
| − | [INFO] DSpace SWORD :: Web Application ....................... SUCCESS [5.869s]
| |
| − | [INFO] DSpace Assembly and Configuration ..................... SUCCESS [43.018s]
| |
| − | [INFO] ------------------------------------------------------------------------
| |
| − | [INFO] ------------------------------------------------------------------------
| |
| − | [INFO] BUILD SUCCESSFUL
| |
| − | [INFO] ------------------------------------------------------------------------
| |
| − | [INFO] Total time: 2 minutes 59 seconds
| |
| − | [INFO] Finished at: Sun Apr 12 07:40:07 BST 2009
| |
| − | [INFO] Final Memory: 25M/255M
| |
| − | [INFO] ------------------------------------------------------------------------
| |
| − | </pre>
| |
| − | | |
| − | =Step 6. Compile the DSpace Java webapp=
| |
| − | Change directory to the build directory by typing as follows:
| |
| − | | |
| − | cd /home/dspace/dspace-1.6.2-src-release/dspace/target/dspace-1.6.2-build.dir
| |
| − | | |
| − | Type the following in the above named directory:
| |
| − | | |
| − | ant fresh_install
| |
| − | | |
| − | A lot of information now appears on the screen. Below are shown the last lines confirming success:
| |
| − | <pre>
| |
| − | [echo] ====================================================================
| |
| − | [echo] The DSpace code has been installed, and the database initialized.
| |
| − | [echo]
| |
| − | [echo] To complete installation, you should do the following:
| |
| − | [echo]
| |
| − | [echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
| |
| − | [echo] DSpace web applications in: /home/dspace/webapps/
| |
| − | [echo]
| |
| − | [echo] OR, copy any web applications from /home/dspace/webapps/ to
| |
| − | [echo] the appropriate place for your servlet container.
| |
| − | [echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
| |
| − | [echo]
| |
| − | [echo] * Make an initial administrator account (an e-person) in DSpace:
| |
| − | [echo]
| |
| − | [echo] /home/dspace/bin/create-administrator
| |
| − | [echo]
| |
| − | [echo] * Start up your servlet container (Tomcat etc.)
| |
| − | [echo]
| |
| − | [echo] You should then be able to access your DSpace's 'home page':
| |
| − | [echo]
| |
| − | [echo] http://vleinternal.bromley.ac.uk/dspace
| |
| − | [echo]
| |
| − | [echo] You should also be able to access the administrator UI:
| |
| − | [echo]
| |
| − | [echo] http://vleinternal.bromley.ac.uk/dspace/dspace-admin
| |
| − | [echo] ====================================================================
| |
| − | [echo]
| |
| − | BUILD SUCCESSFUL
| |
| − | </pre> | |
| − | | |
| − | '''Please note:''' If you change anything later then [[SUNScholar/Rebuild_Dspace|rebuild your Dspace]]. | |
| − | | |
| − | =Step 7. *** Create the DSpace admin user ***=
| |
| − | If you get a "build successful" message from the previous step, then add an admin user for your Dspace installation as follows:
| |
| − | /home/dspace/bin/create-administrator
| |
| − | Fill in all the details when prompted and keep the credentials a secret.
| |
| − | | |
| − | <pre>
| |
| − | Creating an initial administrator account
| |
| − | E-mail address: %emailaddress%
| |
| − | First name: Hilton
| |
| − | Last name: Gibson
| |
| − | WARNING: Password will appear on-screen.
| |
| − | Password: dspace
| |
| − | Again to confirm: dspace
| |
| − | Is the above data correct? (y or n): y
| |
| − | Administrator account created
| |
| − | </pre> | |
| − | | |
| − | This is what should happen. Change the %emailaddress% to your email address.
| |
| − | | |
| − | '''<font color="red">*** Do not let any unauthorised persons have access to your Dspace admin account. ***</font>''' | |
| − | | |
| − | =Step 8. Enable the DSpace java webapps on the java Tomcat webapp server=
| |
| − | The Dspace webapp has been compiled in the '''/home/dspace/webapps''' folder but Tomcat only serves up webapps in the '''/usr/share/tomcat6/webapps''' folder.
| |
| − | | |
| − | So, how do we get all the files into the Tomcat webapps folder ?
| |
| − | | |
| − | There are several methods, but we are going to set it up so that if you change anything in the Dspace '''/home/dspace/webapps''' folder and re-compile then the changes automatically occur in the Tomcat '''/usr/share/tomcat6/webapps''' folder.
| |
| − | | |
| − | To achieve this become the root user by typing as follows:
| |
| − | sudo -i
| |
| − | | |
| − | Now we create the shortcuts to the Dspace webapps in the default Tomcat webapps folder by typing as follows:
| |
| − | | |
| − | cd /usr/share/tomcat6/webapps
| |
| − | | |
| − | ln -s /home/dspace/webapps/xmlui
| |
| − | | |
| − | ln -s /home/dspace/webapps/jspui
| |
| − | | |
| − | ln -s /home/dspace/webapps/sword
| |
| − | | |
| − | ln -s /home/dspace/webapps/oai
| |
| − | | |
| − | ln -s /home/dspace/webapps/lni
| |
| − | ==Step 8.1 Enable the default DSpace java webapp on the java Tomcat webapp server==
| |
| − | '''Please note: Only choose one option.'''
| |
| − | ===Option A: Type the following to make the JSPUI the default interface.===
| |
| − | sudo -i
| |
| − | | |
| − | cd /usr/share/tomcat6/webapps
| |
| − | | |
| − | ln -s /home/dspace/webapps/jspui ROOT
| |
| − | | |
| − | ===Option B: Type the following to make the XMLUI the default interface.===
| |
| − | | |
| − | sudo -i
| |
| − | | |
| − | cd /usr/share/tomcat6/webapps
| |
| − | | |
| − | ln -s /home/dspace/webapps/xmlui ROOT
| |
| − | | |
| − | =Step 9. Login to the DSpace application as the "admin" user=
| |
| − | | |
| − | Type the following in your browser address bar:
| |
| − | | |
| − | http://%hostname-of-your-new-repository%
| |
| − | | |
| − | Click on "Edit Profile" and login with the DSpace admin email address and password.
| |
| − | | |
| − | =Conclusion=
| |
| − | Well done with the Dspace installation !!
| |
| − | | |
| − | Now you can pat yourself on the back for a job well done. Download and consult the Dspace 1.6.2 manual for further configuration.
| |
