SmallWorld Documentation for Future Developer: Difference between revisions
Line 79: | Line 79: | ||
Alias the keyword "sw" to access the Java CLI | Alias the keyword "sw" to access the Java CLI | ||
alias sw 'java -jar /opt/nextmove/sw.jar' | alias sw 'java -jar /opt/nextmove/sw.jar' | ||
==Tips for Running SmallWorld on the Command Line== | |||
Use sw help to get information about available commands | |||
sw help |
Revision as of 17:31, 14 May 2019
Written by Jennifer Young on April 23, 2019
Install and Set Up on TomCat
Step 1: Check the CentOS version and Java version
SmallWorld currently runs on n-9-22, which runs CentOS 6.10. You can check the version of CentOS with the following command:
cat /etc/centos-release
Check your current version of Java with the following command:
java -version
If you do not have the correct version, install it using yum. Follow the steps on this tutorial https://www.itzgeek.com/how-tos/linux/centos-how-tos/install-apache-tomcat-7-0-on-rhel-6-centos-6.html
Step 2: Create Tomcat Service Account
This must be done as a root user and has already been done for n-9-22.
groupadd tomcat mkdir /opt/tomcat useradd -g tomcat -d /opt/tomcat tomcat
Step 3: Create Initialization Script to Control Apache TomCat
Download the latest version of Apache TomCat from the website https://tomcat.apache.org/download-90.cgi
vi /etc/init.d/tomcat9
Copy the bash script from here https://www.itzgeek.com/how-tos/linux/centos-how-tos/install-apache-tomcat-7-0-on-rhel-6-centos-6.html
How to Restart the TomCat Server
service tomcat9 restart
How to Restart the SmallWorld WebApp
You do not need to restart Tomcat every time you want to restart SmallWorld. The TomCat GUI is available at
You need the tunnel to access the private network or this link will not work! Also, the admin username and password is required.
http://10.20.9.22:8080/
In the Manager App, in the Applications section, use the Stop and Start buttons for the sw-ws app to restart the SmallWorld server
Set Environment Variable for Anonymous Graphs for TomCat
The file to modify is
opt/tomcat/bin/catalina.sh
Add the following command to the top of the file (below the comments at the top_
export SWDIR=/srv/db4
Modifying the Amount of Memory Allocated to SmallWorld
The memory allocated to TomCat is found in
/opt/tomcat/bin/catalina.sh
Add the following commands to the top of the file (below the comments at the top)
export CATALINA_OPTS="$CATALINA_OPTS -Xms80g" export CATALINA_OPTS="$CATALINA_OPTS -Xmx80g" export CATALINA_OPTS="$CATALINA_OPTS -XX:MaxPermSize=70g"
Modifying the SmallWorld GUI
The files for the SmallWorld WebApp live in
/opt/tomcat/webapps/sw-ws
Edit the files in
/opt/tomcat/webapps/sw-ws/WEB-INF
To add the link to go to ZINC from the SmallWorld results page, edit the swsearch.js JavaScript file
/opt/tomcat/webapps/sw-ws/WEB-INF/static/swsearch.js
Creating Maps on SmallWorld
See the corresponding wiki page: http://wiki.docking.org/index.php/Creating_Maps_on_SmallWorld
Running SmallWorld from the Command Line
We have been running SmallWorld on n-9-22 as www which uses csh as the default shell. There is a file in /mnt/nfs/soft/www/home/smallworld called run_sw which contains the following commands to set up the SmallWorld Command Line Interface (CLI)
Set the SWDIR environment variable so SmallWorld scripts can access the 12 TB index
setenv SWDIR /srv/db4
Set the path to the SmallWorld C++ Executables
set path = ($path /opt/nextmove/bin)
Alias the keyword "sw" to access the Java CLI
alias sw 'java -jar /opt/nextmove/sw.jar'
Tips for Running SmallWorld on the Command Line
Use sw help to get information about available commands
sw help