These installation instructions are only applicable for SPARQL versions 3.0.4 and older. Current sparqler instructions can be found here. |
A publicly-accessible SPARQL endpoint needs to be installed. It takes the form of an additional repository which contains everything in the main repository which is public (i.e. not email-addresses, phone-numbers, etc.; not un-published resources). It is affectionately known as the "sparqler" associated with this main repository. It is synchronized with its main repository on a regular basis - typically every night.
The installation of a sparqler follows very much the same procedure as for the main repository, with one or two changes because it doesn't live at the same location. The quick-start installation procedure is as follows - additional details are the same as for the main repository.
These instructions assume that a repository has already been installed and that |
In the existing eagle-i home directory, create a directory named sparqler
. For example, if your eagle-i home directory is /opt/eaglei
, you should be creating /opt/eaglei/sparqler
.
hms-mbp:eaglei user$ mkdir /sparqler |
Create an environment variable for the sparqler home directory, ${SPARQLER_HOME}
. For example:
SPARQLER_HOME=/opt/eaglei/sparqler |
Copy the file ${REPO_HOME}/webapps/sparqler.war
to Tomcat's webapps directory.
hms-mbp:eaglei user$ cp ${REPO_HOME}/webapps/sparqler.war /opt/tomcat7/webapps |
Add an additional system property to catalina.properties
:
org.eaglei.sparqler.home=/opt/eaglei/sparqler |
Run the script ${REPO_HOME}/etc/prepare-install.sh
with an additional argument: "sparqler-users.derby" (note that the username and password for the user you create here - who administers the sparqler - these should be different from the main repository's admin-user credentials):
hms-mbp:eaglei user$ bash ${REPO_HOME}/etc/prepare-install.sh SPARQLER_USERNAME SPARQLER_PASSWORD ${REPO_HOME} sparqler-users.derby |
Copy the repository configuration file to ${SPARQLER_HOME}
.
hms-mbp:eaglei user$ cp ${REPO_HOME}/configuration.properties ${SPARQLER_HOME}/configuration.properties |
Edit the newly created SPARQLER configuration file by changing the following two properties:
eaglei.repository.sesame.dir=${sys:org.eaglei.sparqler.home}/sesame eaglei.repository.log.dir=${sys:org.eaglei.sparqler.home}/logs |
Add two properties to your eagle-i-apps.properties
file to define the source and target repositories:
eaglei.sparqler.source.URL=https://localhost:8443/ eaglei.sparqler.target.URL=https://localhost:8443/sparqler/ |
Add credentials to the eagle-i-apps-credentials.properties
file for access to the source and target repositories:
eaglei.sparqler.lastSynchronizedDateFile=/eagle-i/home/sparqlerSyncDate.properties # The credentials for the source repository eaglei.sparqler.source.user=myRepositoryUser eaglei.sparqler.source.password=myRepositoryPassword # The credentials used by the prepare-install.sh above eaglei.sparqler.target.user=mySparqlerUser eaglei.sparqler.target.password=mySparqlerPassword |
Run the script ${REPO_HOME}/etc/finish-install.sh
, using the same sparqler-admin username and password that you set up in step 5, above, when you ran the "prepare-install.sh
":
hms-mbp:eaglei user$ bash ${REPO_HOME}/etc/finish-install.sh SPARQLER_USERNAME SPARQLER_PASSWORD https://localhost:8443/sparqler |
The sparqler repository keeps itself up-to-date with its source-repository by running a periodic synchronization process. This is run automatically so long as the sparlqer and its source-repository are running - no intervention is required.
However, if for some reason the synchronization fails (look in sparqler/logs/repository.log), you can run the synchronizer manually by invoking the script ${REPO_HOME}/etc/synchronize-sparqler.sh as follows:
cd /opt/eaglei bash repo/etc/synchronize-sparqler.sh |
If you run on Windows (warning: this is explicitly unsupported), you should set up a Unix-like environment (e.g. Cygwin) in which to perform the installation and run the shell-scripts.