Endpoint

Tomcat#

  1. Install Tomcat 6.x.x or greater.
  2. Add a new user in the tomcat-users.xml file. This file is usually located in the folder $TOMCAT_HOME/conf. Note that this user should be a member of the manager group. For example, add the following line inside a tomcat-users element to the file tomcat-users.conf and restart tomcat:
<user username="endpoint" password="endpoint" roles="manager"/>

Initial install#

1 Create a directory where you want to place the sources of the Strabon on your machine, and `cd` into that directory, e.g.:
mkdir Strabon
cd
Strabon

2 Get a clone of Strabon from the Strabon repository:

3 The source code of the endpoint is located at the folder Strabon of the  source code tree that you just cloned, so `cd` into that directory, e.g. :

cd Strabon

4 Edit the endpoint/WebContent/WEB-INF/connection.properties file and define the PostgreSQL host, the database name and the credentials that will be used by for storing stRDF metadata.

5 Compile the endpoint by calling:

mvn clean package 

The result of this action is the creation of a .war file inside the target directory.

6 Deploy the endpoint by placing the .war file that was created inside the webapps folder of your Tomcat installation, e.g.:

sudo cp endpoint/target/strabon-endpoint-*.war /var/lib/tomcat6/webapps/strabonendpoint.war
7 Start your Tomcat server, e.g.:
sudo /etc/init.d/tomcat start

8 Open a browser and go to localhost:<port>/manager/html where <port> is the port number you specified during Tomcat’s installation (the default port is 8080).

Updating to newer version#

0 Go (`cd`) to directory Strabon.
cd ~/Strabon
1 Update the source code with the following command:
hg pull -u

2 If you have modified the *.properties files, copy then inside the source dir.

sudo cp /var/lib/tomcat6/webapps/strabonendpoint/WEB-INF/*.properties Strabon/endpoint/WebContent/WEB-INF/

4 Build the source code with the following command: :

( cd Strabon && mvn clean package )

4 Undeploy the previous version of the endpoint by calling the following url:

http://localhost:8080/manager/undeploy?path=/strabonendpoint

5 Deploy the new version of the endpoint by placing the .war file that was created inside the webapps folder of your Tomcat installation, e.g.:

sudo cp components/Strabon/endpoint/target/strabon-endpoint-*.war /var/lib/tomcat6/webapps/strabonendpoint.war

6 Open a browser and go to http://localhost:<port>/manager/html where <port> is the port number you specified during Tomcat’s installation (the default port is 8080).


Store/Query Instructions