Reference documentation: [http://dspace.org/technology/system-docs/install.html]
Notes:
* The following step-by-step howto has not been tested thoroughly. If you find any problems, please refer the reference documentation above.
* Most of the installation steps are performed in shell prompt (bash).
* Please help to make corrections. (English is not my primary language)
* This line will be deleted if I finish writing this howto and testing the DSpace system. I write this howto while I am installing DSpace on my Mandriva system. If you subscribe to DSpace-Tech mailing list (dspace-tech@lists.sourceforge.net), questions, comments, corrections, etc. to the list will be appreciated.
It is assumed that
* Linux Mandriva 2007 is already installed. See: [http://www.howtoforge.com/perfect_setup_mandriva_2007]
* The system has been connected to RPM repository (eg. via FTP, by typing at prompt: urpmi.addmedia ..).
* You are familiar with bash sell and text editor vi.
| Panel | ||||||
|---|---|---|---|---|---|---|
Contents
|
Install Java Package in Mandriva
...
| Code Block |
|---|
To satisfy dependencies, the following packages are going to be installed: antlr-2.7.6-4.1mdv2007.0.i586 bouncycastle-1.33-3mdv2007.0.i586 bouncycastle-jdk1.4-1.33-3mdv2007.0.i586 classpath-0.92-3mdv2007.0.i586 classpathx-jaf-1.1.1-1mdv2007.0.i586 classpathx-mail-1.1.1-3mdv2007.0.i586 classpathx-mail-monolithic-1.1.1-3mdv2007.0.i586 eclipse-ecj-3.2.0-12.3mdv2007.0.i586 gcc-java-4.1.1-3mdk.i586 gcj-tools-4.1.1-3mdk.i586 gjdoc-0.7.7-10mdv2007.0.i586 jamvm-1.4.3-3mdv2007.0.i586 java-1.4.2-gcj-compat-1.4.2.0-40.103.1mdv2007.0.i586 java-1.4.2-gcj-compat-devel-1.4.2.0-40.103.1mdv2007.0.i586 jpackage-utils-1.7.0-1.4mdv2007.0.noarch libgcj7-4.1.1-3mdk.i586 libgcj7-base-4.1.1-3mdk.i586 libgcj7-devel-4.1.1-3mdk.i586 xalan-j2-2.7.0-2.1mdv2007.0.i586 xerces-j2-2.8.0-1mdv2007.0.i586 xml-commons-1.3.03-5.1mdv2007.0.i586 xml-commons-resolver12-1.3.03-5.1mdv2007.0.i586 Proceed with the installation of the 22 packages? (115 MB) (Y/n) |
...
As an alternative of using Java package that is bundled with Mandriva 2007.0 Free Edition, you can download the Java SE Development Kit (JDK) from [http://java.sun.com/javase/downloads/index.jsp]. As stated in the reference documentation, you do not need Java EE (Enterprise Edition). You do not need Java SE with NetBeans, either; just the minimal JDK. As of this writing, the current version is Java SE Development Kit 5.0 Update 9, but in this howto we use JDK 5.0 Update 7, the RPM version (jdk-1_5_0_07-linux-i586-rpm.bin).
After putting the JDK file in the current directory, do the followings:
| Code Block |
|---|
chmod \+x jdk-1_5_0_07-linux-i586-rpm.bin ./jdk-1_5_0_07-linux-i586-rpm.bin #depends on the JDK version |
The License Agreement will be presented to you. Just press space-bar until you are asked to agree the license terms. Type 'yes' and press Enter. The RPM file will be created, eg. jdk-1_5_0_07-linux-i586.rpm. Then, type the following and then press Enter:
| Code Block |
|---|
rpm \-ivh jdk-1_5_0_07-linux-i586.rpm
|
If you want to know the files that have been installed on your system, type:
| Code Block |
|---|
rpm \-ql jdk-1.5.0_07-fcs fcs #depends on the JDK version; see the message after the command: rpm \-ivh .. |
At [http://www.linuxquestions.org/questions/showthread.php?t=214559], someone said that "it's worth installing Sun's J2EE enterprise java package when using tomcat. Just the normal java JRE will not work with Tomcat, because it uses J2EE libraries (jars)". He is right that 'normal java JRE will not work', but I think JDK is enough, so I decided to use Java package above (Java SE SDK). However, if you find problems with Sun JDK above, try to install Java EE SDK instead. It can be downloaded from [http://java.sun.com/javaee/downloads/index.jsp], eg. java_ee_sdk-5-linux.bin.
...
| Code Block |
|---|
urpmi postgresql urpmi postgresql-server urpmi ant urpmi xml-commons-apis urpmi tomcat5 |
After the last line (urpmi tomcat5), the console will show the following lines:
...
| Code Block |
|---|
JAVA_OPTS="-Xmx512M \-Xms64M \-Dfile.encoding=UTF-8" |
Please note that the option: '-Xmx512M -Xms64M' will only be understood by Sun Java but not by GNU Java. Please see GNU Java documentation to get the same goal.
...
| Code Block |
|---|
<Connector port="8080"maxHttpHeaderSize="8192"maxThreads="150"minSpareThreads="25"maxSpareThreads="75" enableLookups="false"redirectPort="8443"acceptCount="100" connectionTimeout="20000"disableUploadTimeout="true"URIEncoding="UTF-8"/> |
Summary of the Environment
| Code Block |
|---|
\[tomcat\] /usr/share/tomcat5 CATALINA_BASE: /usr/share/tomcat5 CATALINA_HOME: /usr/share/tomcat5 CATALINA_TMPDIR: /usr/share/tomcat5/temp JAVA_HOME: /usr/lib/jvm/java /# or JAVA_HOME: /usr/java/jdk |
...
I will write DSpace installation steps here. Visit this page later. However, DSpace installation described in the the reference documentation is clear enough (see the first line of this howto).