Difference between revisions of "SUNScholar/Prepare Ubuntu/S08"

From Libopedia
Jump to navigation Jump to search
m (Text replacement - "Back to Index" to "Back to "Prepare Ubuntu"")
m
 
(36 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<center>
 
<center>
−
'''[[SUNScholar/Prepare Ubuntu|Back to "Prepare Ubuntu"]]'''
+
  '''[[SUNScholar/Prepare Ubuntu/S09|NEXT - STEP 9]]'''
 
</center>
 
</center>
−
==Step 8. Setup the environment variables==
 
−
==Step 8.1 Java  environment settings for Tomcat webapp server==
 
−
To setup the environment variables for Tomcat java web applications, type the following:
 
−
sudo nano /etc/default/tomcat6
 
  
−
Check the following for comparison:
+
==Step 8. Configure the environment variables==
−
<pre>
 
−
# 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=1024m"
 
−
</pre>
 
−
 
 
−
{{NANO}}
 
−
 
 
−
===Java  environment settings used for [http://scholar.sun.ac.za SUNScholar]===
 
−
Your settings will depend on how much RAM you have available to assign to the Tomcat server. See graph below as well.
 
−
JAVA_OPTS="-Djava.awt.headless=true -Xmx8192m -Xms4096m -XX:PermSize=4096m -XX:MaxPermSize=8192m"
 
−
----
 
−
Graph of RAM memory usage on SUNScholar.
 
  
−
[[File:Sunscholar-memory-year.png]]
+
==Step 8.1 Java environment settings for other java web applications==
−
 
+
<font color="red">'''*** To setup the environment variables for other java applications, type the following: ***'''</font>
−
==Step 8.2 Java environment settings for other java web applications==
 
−
To setup the environment variables for other java applications (such as the Handle and SOLR servers), type the following:
 
 
  sudo nano /etc/environment
 
  sudo nano /etc/environment
  
−
Copy and paste the following to the bottom of the file.
+
Copy and paste the following '''to the bottom of the file'''.
 
<pre>
 
<pre>
 
JAVA_HOME="/usr/lib/jvm/default-java"
 
JAVA_HOME="/usr/lib/jvm/default-java"
−
JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -Xms512m -Dfile.encoding=UTF-8"
+
JAVA_OPTS="-Djava.awt.headless=true -Xmx2048m -Xms1024m -Dfile.encoding=UTF-8"
 
</pre>
 
</pre>
  
−
{{NANO}}
+
Save and exit the file.
  
−
==Step 8.3 Increase number of open files available==
+
==Step 8.2 Increase number of open files available==
 
Open the following file as follows:
 
Open the following file as follows:
 
  sudo nano /etc/security/limits.conf
 
  sudo nano /etc/security/limits.conf
−
Add the following to the bottom of the file:
+
Add the following to '''the bottom of the file''':
 
<pre>
 
<pre>
 
*            hard      nofile          65536
 
*            hard      nofile          65536
Line 46: Line 26:
 
</pre>
 
</pre>
  
−
{{NANO}}
+
Save and exit the file.
  
−
Make sure to check the files open parameter with the next computer reboot by typing the following as the root user:
+
''Make sure to check the files open parameter with the '''next computer reboot''' by typing the following as the root user:''
  
 
  ulimit -n
 
  ulimit -n
  
−
==Step 8.4: Setup file creation permissions==
+
==Step 8.3: Setup file creation permissions==
 
  nano $HOME/.bashrc
 
  nano $HOME/.bashrc
−
Add the following to the bottom of the file
+
Add the following to '''the bottom of the file'''.
 
  umask 002
 
  umask 002
−
{{NANO}}
 
  
−
==Step 8.5 Setup Tomcat server permissions==
+
Save and exit the file.
−
<font color="red">'''Please note: This procedure violates best security practice on an Ubuntu server. See: http://dspace.2283337.n4.nabble.com/DSpace-Security-td4664584.html for a discussion on the DSpace tech mailing list. You apply this procedure at your own risk!'''</font>
 
−
sudo nano /etc/default/tomcat6
 
−
 
 
−
See example below.
 
−
<pre>
 
−
# Run Tomcat as this user ID. Not setting this or leaving it blank will use the
 
−
# default of tomcat6.
 
−
TOMCAT6_USER=root
 
−
 
 
−
# Run Tomcat as this group ID. Not setting this or leaving it blank will use
 
−
# the default of tomcat6.
 
−
TOMCAT6_GROUP=dspace
 
−
</pre>
 
−
 
 
−
{{NANO}}
 
  
 
==References==
 
==References==
 +
*http://en.wikipedia.org/wiki/Environment_variable
 
*http://wiki.apache.org/tomcat/FAQ/Memory
 
*http://wiki.apache.org/tomcat/FAQ/Memory
 
*http://en.wikipedia.org/wiki/Java_performance#Memory_usage
 
*http://en.wikipedia.org/wiki/Java_performance#Memory_usage
Line 81: Line 46:
 
*http://wiki.lib.sun.ac.za/index.php/SUNScholar/Optimisations
 
*http://wiki.lib.sun.ac.za/index.php/SUNScholar/Optimisations
 
*https://wiki.duraspace.org/display/DSDOC3x/Performance+Tuning+DSpace
 
*https://wiki.duraspace.org/display/DSDOC3x/Performance+Tuning+DSpace
−
[[File:Sunscholar-java.png]]
 
  
−
   '''[[SUNScholar/Prepare Ubuntu/S07|PREVIOUS]]'''
+
<center>
 +
   '''[[SUNScholar/Prepare Ubuntu/S07|PREVIOUS - STEP 7]]'''
 +
</center>
  
−
  '''[[SUNScholar/Prepare Ubuntu/S09|NEXT]]'''
+
[[Category:Installation]]
 +
__NOTOC__

Latest revision as of 23:50, 9 June 2016

 NEXT - STEP 9

Step 8. Configure the environment variables

Step 8.1 Java environment settings for other java web applications

*** To setup the environment variables for other java applications, type the following: *** 

sudo nano /etc/environment

Copy and paste the following to the bottom of the file. 

JAVA_HOME="/usr/lib/jvm/default-java"
JAVA_OPTS="-Djava.awt.headless=true -Xmx2048m -Xms1024m -Dfile.encoding=UTF-8"

Save and exit the file.

Step 8.2 Increase number of open files available

Open the following file as follows: 

sudo nano /etc/security/limits.conf

Add the following to the bottom of the file: 

*            hard       nofile          65536
*            soft       nofile          65536

Save and exit the file.

Make sure to check the files open parameter with the next computer reboot by typing the following as the root user: 

ulimit -n

Step 8.3: Setup file creation permissions

nano $HOME/.bashrc

Add the following to the bottom of the file. 

umask 002

Save and exit the file.

References

 PREVIOUS - STEP 7
Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S08&oldid=43110"