|
|
| (238 intermediate revisions by one other user not shown) |
| Line 1: |
Line 1: |
| − | '''<font size="3" color="red">It is vitally essential that you have first completed the [[SUNScholar/Install_Ubuntu|installation of Ubuntu]] with the LAMP stack</font>.''' | + | =PROCEDURE 2 - PREPARE UBUNTU= |
| | + | <center> |
| | + | '''<big>[[SUNScholar/Install_DSpace|NEXT - INSTALL DSPACE]]</big>''' |
| | | | |
| − | 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> |
| − | Before Dspace can be installed and setup we have to prepare the server with the software needed by Dspace. Because Dspace is essentially a Java Webapp that uses a SQL database, the following steps simply setup the Ubuntu Server as a Java Webapp server with a SQL database server. Unfortunately the Ubuntu server does not come with a default Java Webapp SQL Database Server setup, so we have to do it manually.
| + | ===[[SUNScholar/Prepare Ubuntu/S01|Step 1. Login to the remote server]]=== |
| | + | ===[[SUNScholar/Prepare Ubuntu/S02|Step 2. Review "nano" command line editor instructions]]=== |
| | + | ===[[SUNScholar/Prepare Ubuntu/S03|Step 3. Install the Java software dependencies]]=== |
| | + | ===[[SUNScholar/Prepare Ubuntu/S04|Step 4. Install the Maven Java WAR builder]]=== |
| | + | ===[[SUNScholar/Prepare Ubuntu/S05|Step 5. Install the Tomcat Java web application server]]=== |
| | | | |
| − | =Step 1. Login to the remote server= | + | ===[[SUNScholar/Prepare Ubuntu/S06|Step 6. Install the PostgreSQL database server]]=== |
| − | On your client PC with the Ubuntu desktop live CD, click on: '''Applications => Accessories => Terminal''' to open a command line terminal.
| + | ===[[SUNScholar/Prepare Ubuntu/S07|Step 7. Install the Postfix mail server]]=== |
| | + | ===[[SUNScholar/Prepare Ubuntu/S08|Step 8. Configure the environment variables]]=== |
| | + | ===[[SUNScholar/Prepare Ubuntu/S09|Step 9. Check the installation]]=== |
| | + | ===[https://youtu.be/nNc_lUHl2dI YouTube Video]=== |
| | | | |
| − | '''<font color="red">Login to your remote server as the "dspace" user by typing as follows in the terminal</font>'''.
| + | <center> |
| − | | + | '''<big>[[SUNScholar/Install_Ubuntu|PREVIOUS - INSTALL UBUNTU]]</big>''' |
| − | ssh dspace@%hostname%
| + | </center> |
| − | Replace %hostname% with the hostname of your server.
| + | [[Category:Installation]] |
| − | | + | __NOTOC__ |
| − | =Step 2. Become the "root" user=
| |
| − | To install all the Dspace dependencies become the "root" user by typing the following in terminal.
| |
| − | | |
| − | sudo -i
| |
| − | =Step 3. Install Java Software Dependencies=
| |
| − | | |
| − | ==Step 3.1: Install Java 6 Development Kit==
| |
| − | Type as follows:
| |
| − | | |
| − | aptitude install openjdk-6-jdk
| |
| − | | |
| − | Afterwards make it available system wide:
| |
| − | | |
| − | update-java-alternatives -s java-6-openjdk
| |
| − | | |
| − | ==Step 3.2: Install Java Ant Compiler==
| |
| − | Type as follows:
| |
| − | | |
| − | aptitude install ant ant-optional
| |
| − | | |
| − | =Step 4. Setup Apache2 Maven2 Java Installer=
| |
| − | | |
| − | ==Step 4.1: Install Maven2==
| |
| − | Type as follows:
| |
| − | | |
| − | aptitude install maven2
| |
| − | | |
| − | ==Step 4.2: Create the Maven2 home folder==
| |
| − | Type the following;
| |
| − | | |
| − | mkdir /home/dspace/.m2
| |
| − | | |
| − | Give the "dspace" user full ownership of the folder by typing the following:
| |
| − | | |
| − | chown dspace.dspace -R /home/dspace/.m2 | |
| − | | |
| − | ==Step 4.3: Setup the Maven2 config file==
| |
| − | ''The Maven 2 proxy configuration file is only needed if your connection to the internet is via a campus proxy server. You can skip this step if you have a direct connection to the internet.''
| |
| − | | |
| − | ===Maven proxy notes===
| |
| − | Use the proxy settings for your campus. '''Check with your IT department'''. You need to ensure that the following two sites are allowed to pass through your campus proxy server (i.e. add them to the ACL configuration on the Squid proxy server):
| |
| − | | |
| − | # maven.apache.org
| |
| − | # repo1.maven.org
| |
| − | | |
| − | More information about Maven can be found here at the following links:
| |
| − | * http://maven.apache.org/guides/mini/guide-configuring-maven.html
| |
| − | * http://maven.apache.org/guides/mini/guide-proxies.html
| |
| − | | |
| − | ===Maven proxy config file===
| |
| − | Type the following to enable Maven proxy settings:
| |
| − | | |
| − | nano /home/dspace/.m2/settings.xml
| |
| − | | |
| − | ''Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.''
| |
| − | | |
| − | Add the following:
| |
| − | <pre> | |
| − | <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
| |
| − | xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
| |
| − | xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
| |
| − | http://maven.apache.org/xsd/settings-1.0.0.xsd">
| |
| − | <localRepository/>
| |
| − | <interactiveMode/>
| |
| − | <usePluginRegistry/>
| |
| − | <offline/>
| |
| − | <pluginGroups/>
| |
| − | <servers/>
| |
| − | <mirrors/>
| |
| − | <proxies>
| |
| − | <proxy>
| |
| − | <id>Maties</id>
| |
| − | <active>true</active>
| |
| − | <protocol>http</protocol>
| |
| − | <host>lib-proxy.sun.ac.za</host>
| |
| − | <port>3128</port>
| |
| − | <username></username>
| |
| − | <password></password>
| |
| − | <nonProxyHosts></nonProxyHosts>
| |
| − | </proxy>
| |
| − | </proxies>
| |
| − | <profiles/>
| |
| − | <activeProfiles/>
| |
| − | </settings>
| |
| − | </pre>
| |
| − | | |
| − | Save the file by pressing '''CTL+O''' and then '''CTL+X''' on the keyboard.
| |
| − | | |
| − | =Step 5. Setup Apache2 Tomcat 5.5 Java Webapp Server=
| |
| − | | |
| − | ==Step 5.1: Install Tomcat 5.5==
| |
| − | Type the following:
| |
| − | | |
| − | aptitude install tomcat5.5 tomcat5.5-admin
| |
| − | ==Step 5.2: Configure Tomcat 5.5==
| |
| − | Afterwards we have to configure it:
| |
| − | | |
| − | nano /etc/default/tomcat5.5
| |
| − | | |
| − | Change TOMCAT5_SECURITY from yes to no:
| |
| − | | |
| − | <pre>
| |
| − | [...] | |
| − | # Use the Java security manager? (yes/no)
| |
| − | #TOMCAT5_SECURITY=yes
| |
| − | TOMCAT5_SECURITY=no
| |
| − | [...] | |
| − | </pre>
| |
| − | | |
| − | Setup the correct JAVA_OPTS for the XMLUI interface
| |
| − | <pre>
| |
| − | # Arguments to pass to the Java virtual machine (JVM).
| |
| − | JAVA_OPTS="-Djava.awt.headless=true -Xms1024m -Xmx2048m -XX:MaxPermSize=512m -XX:+CMSClassUnloadingEnabled -XX:+CMSPermGenSweepingEnabled"
| |
| − | </pre>
| |
| − | | |
| − | Save the file by pressing '''CTL+O''' and then '''CTL+X''' on the keyboard.
| |
| − | | |
| − | ==Step 5.3: Post Tomcat 5.5 installation checks==
| |
| − | Now let's look if all went well:
| |
| − | | |
| − | netstat -tap | grep jsvc
| |
| − | | |
| − | Tomcat should be listening on port 8180:
| |
| − | | |
| − | <pre>
| |
| − | root@server1:~# netstat -tap | grep jsvc
| |
| − | tcp6 0 0 [::]:8009 [::]:* LISTEN 7865/jsvc
| |
| − | tcp6 0 0 [::]:8180 [::]:* LISTEN 7865/jsvc
| |
| − | root@server1:~#
| |
| − | </pre> | |
| − | | |
| − | ==Step 5.4: Enable Tomcat with UTF-8 multi-byte encoding==
| |
| − | Type as follows:
| |
| − | | |
| − | nano /etc/tomcat5.5/server.xml
| |
| − | | |
| − | ''Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.''
| |
| − | | |
| − | Add '''URIEncoding="UTF-8"''' to the connector section for port 8180. See the example below. '''Look carefully at the last line !'''
| |
| − | <pre>
| |
| − | <Connector port="8180" maxHttpHeaderSize="8192"
| |
| − | maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
| |
| − | enableLookups="false" redirectPort="8443" acceptCount="100"
| |
| − | connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8" />
| |
| − | </pre>
| |
| − | | |
| − | Save the file by pressing '''CTL+O''' and then '''CTL+X''' on the keyboard.
| |
| − | | |
| − | ==Step 5.5: Setup Tomcat 5.5 admin users==
| |
| − | Type as follows:
| |
| − | | |
| − | nano /etc/tomcat5.5/tomcat-users.xml
| |
| − | | |
| − | Delete all the contents of the file and add the following admin and manager roles with a password.
| |
| − | <pre>
| |
| − | <?xml version='1.0' encoding='utf-8'?>
| |
| − | <tomcat-users>
| |
| − | <role rolename="manager"/>
| |
| − | <role rolename="admin"/>
| |
| − | <user username="dspace" password="dspace" roles="admin,manager"/>
| |
| − | </tomcat-users>
| |
| − | </pre> | |
| − | | |
| − | Save the file by pressing '''CTL+O''' and then '''CTL+X''' on the keyboard.
| |
| − | | |
| − | ==Step 5.6: Undeploy the Tomcat 5.5 admin interface==
| |
| − | Login to the Tomcat '''/manager/html''' interface and undeploy the "admin" application. It interferes with the XMLUI admin application !
| |
| − | | |
| − | See: http://jira.dspace.org/jira/browse/DS-488
| |
| − | | |
| − | ==Step 5.7: Restart the Tomcat 5.5 server==
| |
| − | Type the following:
| |
| − | | |
| − | /etc/init.d/tomcat5.5 restart
| |
| − | | |
| − | =Step 6. Setup Apache2 Tomcat 5.5 Jakarta Connector=
| |
| − | Jakarta is an application router for Apache2. Jakarta tells Apache2 which URL must go to which Java webapp server. For example the URL http://myrepo.ac.za/jspui must be routed to Tomcat5.5.
| |
| − | ==Step 6.1: Install and enable the Apache2 Tomcat Jakarta connector==
| |
| − | To install the Jakarta Tomcat Apache connector type as follows:
| |
| − | | |
| − | aptitude install libapache2-mod-jk libapache-mod-jk-doc
| |
| − | | |
| − | To setup Apache2 to use the mod_jk connector type the following:
| |
| − | | |
| − | a2enmod jk
| |
| − | | |
| − | /etc/init.d/apache2 reload
| |
| − | | |
| − | ==Step 6.2: Configure the Jakarta connector on the Apache server==
| |
| − | To tell Apache2 where to send the Java URL's, type the following:
| |
| − | | |
| − | nano /etc/apache2/sites-available/000-default
| |
| − | | |
| − | ''Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.''
| |
| − | | |
| − | Then insert the following at the bottom of the file:
| |
| − | <pre>
| |
| − | <IfModule mod_jk.c>
| |
| − | JkWorkersFile /etc/tomcat6/workers.properties
| |
| − | JkLogFile /var/log/apache2/mod_jk.log
| |
| − | JkLogLevel info
| |
| − | JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
| |
| − | JkRequestLogFormat "%w %V %T"
| |
| − | JkMountCopy All
| |
| − | | |
| − | # JkMount directive is: JkMount [URL prefix] [Worker name]
| |
| − | # send all requests ending in .jsp to ajp13_worker
| |
| − | JkMount /*.jsp ajp13
| |
| − | | |
| − | # send all requests ending /servlet to ajp13_worker
| |
| − | JkMount /*/servlet/ ajp13
| |
| − | | |
| − | # OWN ADDITIONS
| |
| − | #######################################
| |
| − | JkMount / ajp13
| |
| − | JkMount /* ajp13
| |
| − | JkMount /manager ajp13
| |
| − | JkMount /manager/* ajp13
| |
| − | JkMount /jspui ajp13
| |
| − | JkMount /jspui/* ajp13
| |
| − | JkMount /xmlui ajp13
| |
| − | JkMount /xmlui/* ajp13
| |
| − | JkMount /oai ajp13
| |
| − | JkMount /oai/* ajp13
| |
| − | JkMount /lni ajp13
| |
| − | JkMount /lni/* ajp13
| |
| − | JkMount /solr ajp13
| |
| − | JkMount /solr/* ajp13
| |
| − | JkMount /sword ajp13
| |
| − | JkMount /sword/* ajp13
| |
| − | </IfModule>
| |
| − | | |
| − | </pre>
| |
| − | | |
| − | Save the file by pressing '''CTL+O''' and then '''CTL+X''' on the keyboard.
| |
| − | | |
| − | For secure connections to Apache2 and Tomcat6, type the following:
| |
| − | | |
| − | nano /etc/apache2/sites-available/default-ssl
| |
| − | | |
| − | ''Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.''
| |
| − | | |
| − | Then insert the following at the bottom of the file:
| |
| − | | |
| − | <pre>
| |
| − | <IfModule mod_jk.c>
| |
| − | JkLogFile /var/log/apache2/mod_jk.log
| |
| − | JkLogLevel info
| |
| − | JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
| |
| − | JkRequestLogFormat "%w %V %T"
| |
| − | JkMountCopy All
| |
| − | | |
| − | # JkMount directive is: JkMount [URL prefix] [Worker name]
| |
| − | # send all requests ending in .jsp to ajp13_worker
| |
| − | JkMount /*.jsp ajp13
| |
| − | | |
| − | # send all requests ending /servlet to ajp13_worker
| |
| − | JkMount /*/servlet/ ajp13
| |
| − | | |
| − | # OWN ADDITIONS
| |
| − | #######################################
| |
| − | JkExtractSSL On
| |
| − | JkHTTPSIndicator HTTPS
| |
| − | JkMount / ajp13
| |
| − | JkMount /* ajp13
| |
| − | JkMount /manager ajp13
| |
| − | JkMount /manager/* ajp13
| |
| − | JkMount /jspui ajp13
| |
| − | JkMount /jspui/* ajp13
| |
| − | JkMount /xmlui ajp13
| |
| − | JkMount /xmlui/* ajp13
| |
| − | JkMount /oai ajp13
| |
| − | JkMount /oai/* ajp13
| |
| − | JkMount /lni ajp13
| |
| − | JkMount /lni/* ajp13
| |
| − | JkMount /solr ajp13
| |
| − | JkMount /solr/* ajp13
| |
| − | JkMount /sword ajp13
| |
| − | JkMount /sword/* ajp13
| |
| − | </IfModule>
| |
| − | </pre>
| |
| − | | |
| − | ==Step 6.3: Configure the Jakarta connector on the Tomcat server==
| |
| − | To to tell Tomcat which worker to use on what port, to listen for Java webapp requests, type the following:
| |
| − | | |
| − | nano /etc/tomcat6/workers.properties
| |
| − | | |
| − | Then insert the following:
| |
| − | <pre>
| |
| − | workers.apache_log=/var/log/apache2
| |
| − | workers.tomcat_home=/usr/share/tomcat6/
| |
| − | workers.java_home=/usr/lib/jvm/java-6-openjdk/
| |
| − | | |
| − | worker.list=ajp13
| |
| − | worker.ajp13.port=8009
| |
| − | worker.ajp13.host=localhost
| |
| − | worker.ajp13.type=ajp13
| |
| − | worker.ajp13.lbfactor=1
| |
| − | </pre>
| |
| − | | |
| − | Save the file by pressing '''CTL+O''' and then '''CTL+X''' on the keyboard.
| |
| − | | |
| − | ==Step 6.4: Restart the Apache and Tomcat servers==
| |
| − | Now restart apache and tomcat as follows:
| |
| − | | |
| − | /etc/init.d/apache2 restart
| |
| − | | |
| − | /etc/init.d/tomcat6 restart
| |
| − | | |
| − | Thats it, now you have a working Java webapp server.
| |
| − | | |
| − | =Step 7. Install PostgreSQL=
| |
| − | Dspace uses the PostgreSQL database server for the main catalog database. The following procedure installs the PostgreSQL server and creates the "dspace" database and "dspace" database user with the default password.
| |
| − | | |
| − | ==Step 7.1: Install PostgreSQL==
| |
| − | | |
| − | aptitude install postgresql-8.4 libpg-java
| |
| − | | |
| − | ==Step 7.2: Setup PostgreSQL admin password==
| |
| − | Change database user permissions to "trust" only.
| |
| − | sed -i 's/ident sameuser$/trust/' /etc/postgresql/8.4/main/pg_hba.conf
| |
| − | Restart database server.
| |
| − | /etc/init.d/postgresql-8.4 restart
| |
| − | Open a database shell...
| |
| − | psql -U postgres
| |
| − | ... and set the password:
| |
| − | alter role postgres with password 'dspace';
| |
| − | Quit the database shell.
| |
| − | \q
| |
| − | Change database user permissions from "trust" to "md5" password.
| |
| − | sed -i 's/trust$/md5/' /etc/postgresql/8.4/main/pg_hba.conf
| |
| − | Restart database server.
| |
| − | /etc/init.d/postgresql-8.4 restart
| |
| − | | |
| − | ==Step 7.3: Create the PostgreSQL 'dspace' database==
| |
| − | Create the "dspace" database with the "dspace" database user.
| |
| − | sudo -u dspace createdb -U dspace -E UNICODE dspace
| |
| − | | |
| − | ==Step 7.4: Create the PostgreSQL 'dspace' user==
| |
| − | Create the "dspace" database user with full privileges.
| |
| − | sudo -u postgres createuser -U postgres -d -A -P dspace
| |
| − | | |
| − | If asked the following:
| |
| − | Shall the new role be allowed to create more new roles? (y/n) y
| |
| − | Answer "y" for yes.
| |
| − | | |
| − | ==Step 7.5: Setup database host and user access permissions==
| |
| − | Type the following:
| |
| − | | |
| − | echo "host dspace dspace 127.0.0.1/32 md5" >> /etc/postgresql/8.4/main/pg_hba.conf
| |
| − | | |
| − | ==Step 7.6: Restart the PostgreSQL server==
| |
| − | Type the following:
| |
| − | | |
| − | /etc/init.d/postgresql-8.4 restart
| |
| − | | |
| − | =Step 8 - Setup the Postfix mail server=
| |
| − | ==Step 8.1: Install the software==
| |
| − | In order to be able to use email with your Dspace server install the postfix mail server as follows:
| |
| − | sudo aptitude install postfix
| |
| − | | |
| − | sudo dpkg --purge exim4
| |
| − | | |
| − | ==Step 8.2: Setup the mail server config files==
| |
| − | Next we edit the Postfix '''main.cf''' file as follows:
| |
| − | sudo nano /etc/postfix/main.cf
| |
| − | | |
| − | ''Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.''
| |
| − | | |
| − | See below for an example of the config file:
| |
| − | <pre>
| |
| − | # See /usr/share/postfix/main.cf.dist for a commented, more complete version
| |
| − | | |
| − | | |
| − | # Debian specific: Specifying a file name will cause the first
| |
| − | # line of that file to be used as the name. The Debian default
| |
| − | # is /etc/mailname.
| |
| − | #myorigin = /etc/mailname
| |
| − | | |
| − | smtpd_banner = $myhostname ESMTP $mail_name (Ubuntu)
| |
| − | biff = no
| |
| − | | |
| − | # appending .domain is the MUA's job.
| |
| − | append_dot_mydomain = no
| |
| − | | |
| − | # Uncomment the next line to generate "delayed mail" warnings
| |
| − | #delay_warning_time = 4h
| |
| − | | |
| − | readme_directory = no
| |
| − | | |
| − | # TLS parameters
| |
| − | smtpd_tls_cert_file=/etc/ssl/certs/%hostname%.pem
| |
| − | smtpd_tls_key_file=/etc/ssl/certs/%hostname%.key
| |
| − | smtpd_use_tls=yes
| |
| − | smtpd_tls_session_cache_database = btree:${data_directory}/smtpd_scache
| |
| − | smtp_tls_session_cache_database = btree:${data_directory}/smtp_scache
| |
| − | | |
| − | # See /usr/share/doc/postfix/TLS_README.gz in the postfix-doc package for
| |
| − | # information on enabling SSL in the smtp client.
| |
| − | | |
| − | myhostname = %hostname%
| |
| − | alias_maps = hash:/etc/aliases
| |
| − | alias_database = hash:/etc/aliases
| |
| − | myorigin = /etc/mailname
| |
| − | mydestination = %hostname% localhost
| |
| − | relayhost = %relay-hostname%
| |
| − | mynetworks = %my-subnet% 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128
| |
| − | mailbox_size_limit = 0
| |
| − | recipient_delimiter = +
| |
| − | inet_interfaces = all
| |
| − | </pre>
| |
| − | # Change the ''' %hostname%''' to the hostname of your server.
| |
| − | # Change the '''%relay-hostname%''' to the hostname of your campus email server which sends and delivers email.
| |
| − | # Add the subnet of your campus TCP/IP network '''%my-subnet%''' to the '''mynetworks''' parameter.
| |
| − | # Ensure '''mydestination = %hostname% localhost''' to prevent your mail server becoming a spam email relay.
| |
| − | Talk to the campus system administrator about these settings.
| |
| − | | |
| − | Also see: http://www.postfix.org/SMTPD_ACCESS_README.html and http://en.wikipedia.org/wiki/Subnet_Mask.
| |
| − | | |
| − | ==Step 8.3: Setup default mailname==
| |
| − | Now we edit the servers mailname as follows:
| |
| − | sudo nano /etc/mailname
| |
| − | Add one line only which should be the hostname of your server.
| |
| − | | |
| − | Now we restart Postfix:
| |
| − | sudo /etc/init.d/postfix restart
| |
| − | ==Step 8.4: Setup "root" email alias==
| |
| − | The "root" email address is setup as follows:
| |
| − | sudo nano /etc/aliases
| |
| − | See below for an example:
| |
| − | <pre>
| |
| − | # Added by installer for initial user
| |
| − | root: me@myedu.ac.za
| |
| − | </pre>
| |
| − | Change the '''me@myedu.ac.za''' to your email address. Then save and exit "nano".
| |
| − | | |
| − | To activate the new aliases type the following:
| |
| − | sudo newaliases
| |
| − | | |
| − | ==Step 8.5: Send a test email to root==
| |
| − | Install the command line mailer program as follows:
| |
| − | sudo aptitude install mailx
| |
| − | Now we can send a test email to the root user by typing as follows:
| |
| − | mail -s "Test Email from root" root
| |
| − | Press the "Enter" key and type some message content. Press '''CTL+D''' and then '''Enter''' to send the mail.
| |
| − | | |
| − | Check the following log for any delivery errors as follows:
| |
| − | sudo tail -n 40 /var/log/mail.info
| |
| − | If there are no delivery errors your mail server is setup. Well done.
| |
| − | | |
| − | =Step 9. Setup the environment variables=
| |
| − | ==Step 9.1 Java settings for Tomcat6==
| |
| − | To setup the environment variables for Tomcat java web applications, type the following:
| |
| − | nano /etc/default/tomcat6
| |
| − | | |
| − | Check the following for comparison:
| |
| − | <pre>
| |
| − | # Run Tomcat as this user ID. Not setting this or leaving it blank will use the
| |
| − | # default of tomcat6.
| |
| − | #TOMCAT6_USER=tomcat6
| |
| − | | |
| − | # Run Tomcat as this group ID. Not setting this or leaving it blank will use
| |
| − | # the default of tomcat6.
| |
| − | #TOMCAT6_GROUP=tomcat6
| |
| − | | |
| − | # The home directory of the Java development kit (JDK). You need at least
| |
| − | # JDK version 1.5. If JAVA_HOME is not set, some common directories for
| |
| − | # OpenJDK, the Sun JDK, and various J2SE 1.5 versions are tried.
| |
| − | #JAVA_HOME=/usr/lib/jvm/openjdk-6-jdk
| |
| − | | |
| − | # Directory where the Tomcat 6 binary distribution resides. This a read-only
| |
| − | # directory that can be shared by all Tomcat instances running on the machine.
| |
| − | # Default: /usr/share/tomcat6
| |
| − | #CATALINA_HOME=/usr/share/$NAME
| |
| − | | |
| − | # Directory for per-instance configuration files and webapps. It contains the
| |
| − | # directories conf, logs, webapps, work and temp. See RUNNING.txt for details.
| |
| − | # Default: /var/lib/tomcat6
| |
| − | #CATALINA_BASE=/var/lib/$NAME
| |
| − | | |
| − | # You may pass JVM startup parameters to Java here. If unset, the default
| |
| − | # options (-Djava.awt.headless=true -Xmx128m) will be used.
| |
| − | #JAVA_OPTS="-Djava.awt.headless=true -Xmx128m"
| |
| − | | |
| − | JAVA_OPTS="-Djava.awt.headless=true -Xms1024m -Xmx2048m -XX:MaxPermSize=512m"
| |
| − | | |
| − | # Use a CMS garbage collector for improved response time
| |
| − | JAVA_OPTS="${JAVA_OPTS} -XX:+UseConcMarkSweepGC"
| |
| − | | |
| − | # When using the CMS garbage collector, you should enable the following option
| |
| − | # if you run Tomcat on a machine with exactly one CPU chip that contains one
| |
| − | # or two cores.
| |
| − | #JAVA_OPTS="${JAVA_OPTS} -XX:+CMSIncrementalMode"
| |
| − | | |
| − | # To enable remote debugging uncomment the following line.
| |
| − | # You will then be able to use a java debugger on port 8000.
| |
| − | #JAVA_OPTS="${JAVA_OPTS} -Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n"
| |
| − | | |
| − | # Java compiler to use for translating JavaServer Pages (JSPs). You can use all
| |
| − | # compilers that are accepted by Ant's build.compiler property.
| |
| − | #JSP_COMPILER=javac
| |
| − | | |
| − | # Use the Java security manager? (yes/no, default: no)
| |
| − | #TOMCAT6_SECURITY=no
| |
| − | | |
| − | # Number of days to keep logfiles in /var/log/tomcat6. Default is 14 days.
| |
| − | #LOGFILE_DAYS=14
| |
| − | | |
| − | # Location of the JVM temporary directory
| |
| − | # WARNING: This directory will be destroyed and recreated at every startup !
| |
| − | #JVM_TMP=/tmp/tomcat6-temp
| |
| − | | |
| − | # If you run Tomcat on port numbers that are all higher than 1023, then you
| |
| − | # do not need authbind. It is used for binding Tomcat to lower port numbers.
| |
| − | # NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
| |
| − | # (yes/no, default: no)
| |
| − | #AUTHBIND=no
| |
| − | </pre>
| |
| − | ==Step 9.2 Java settings for applications such as the Handle server==
| |
| − | To setup the environment variables for Tomcat java web applications, type the following:
| |
| − | nano /etc/default/environment
| |
| − | | |
| − | Check the following for comparison:
| |
| − | | |
| − | <pre>
| |
| − | PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games"
| |
| − | JAVA_HOME="/usr/lib/jvm/java-6-openjdk"
| |
| − | JAVA_OPTS="-Djava.awt.headless=true -Xmx512m"
| |
| − | </pre>
| |
| − | | |
| − | =Step 10. Check the installation=
| |
| − | Type the following to reboot the server:
| |
| − | sudo reboot
| |
| − | | |
| − | When the server has started up again, start a web browser session on another machine and type the following in the address bar:
| |
| − | | |
| − | http://%hostname%/manager/html
| |
| − | | |
| − | Replace %hostname% with your sites Dspace server address. Use the credentials you specified with the Tomcat installation step above. You should now be connected to the admin interface for Tomcat.
| |
| − | | |
| − | =Next Procedure=
| |
| − | Well done with the setup of the server for the Dspace installation later !!
| |
| − | | |
| − | If everything is OK, then proceed to the [[SUNScholar/Install_Dspace|installation of Dspace]] itself.
| |
