1. Overview

   A publicly-accessible SPARQL endpoint

...

1. 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.

   Installation

   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 -

...

1. additional details

...

1.  are the same as for the main repository.

   Info
   These instructions assume that a repository has already been installed and that ${REPO_HOME} has been defined as an environment variable.

   1. In the existing eagle-i

   home directory (the parent of the repository

   1. home

   -

   1. directory,

   ${REPO_HOME})

   1. create a directory

   "sparqler", and set an environmental variable ${SPARQLER_HOME}.  

   1. named sparqler. For example, if

   the repository home is /opt/eaglei/repo, then the sparqler home would be

   1. your eagle-i home directory is /opt/eaglei, you should be creating /opt/eaglei/sparqler.

      Code Block
      language bash title create sparqler home directory
      hms-mbp:eaglei user$ mkdir /sparqler

   2. Create an environment variable for the sparqler home directory, ${SPARQLER_HOME}. For example:

      Code Block
      language bash title define environment variable for sparqler home directory
      SPARQLER_HOME=/opt/eaglei/sparqler

   .
   2. Copy the

   file

   1. file ${REPO_HOME}/webapps/sparqler.war

   to

   1.  to Tomcat's webapps directory. 

      Code Block
      language bash title copy sparqler.war
      hms-mbp:eaglei user$ cp ${REPO_HOME}/webapps/sparqler.war /opt/tomcat7/webapps

   2. Add an additional system property

   to

   1. to catalina.properties:

   noformat

   1. Code Block
      language bash title catalina.properties
      org.eaglei.sparqler.home=/opt/eaglei/sparqler

   2. Run the

   script

   1. script ${REPO_HOME}/etc/prepare-install.sh

   with

   1.  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):

   1. Code Block
      language bash title run prepare-install.sh
      hms-mbp:eaglei user$

   No Format

   1. bash ${REPO_HOME}/etc/prepare-install.sh SPARQLER_USERNAME SPARQLER_PASSWORD ${REPO_HOME} sparqler-users.derby

   Create and edit the repository configuration file (

   1. Copy the repository configuration file to ${SPARQLER_HOME}.

      Code Block
      language bash title copy configuration file
      hms-mbp:eaglei user$ cp ${REPO_HOME}/configuration.properties ${SPARQLER_HOME}/configuration.properties

   ) - it should be identical to the main repository's config-file, with the following two exceptions - we set:
   2. Edit the newly created SPARQLER configuration file by changing the following two properties:

      Code Block
      language bash title $\{SPARQLER_HOME\}/configuration.properties

   noformat

   1. eaglei.repository.sesame.dir=${sys:org.eaglei.sparqler.home}/sesame eaglei.repository.log.dir=${sys:org.eaglei.sparqler.home}/logs

   2. Add

   some

   1. two properties to

   the files

   1. your eagle-i-apps.properties

   , eagle-i-apps-credentials.properties (found in directories ${EAGLE_I_HOME}/conf and possibly ${EAGLE_I_HOME}/.config):

   1.  file to define the source and target repositories: 

      Code Block
      language bash title $\{EAGLEI_HOME\}/conf/eagle-i-apps.properties

   noformat

   1. eaglei.sparqler.source.URL=https://

   eagle-i.myInstitution.edu

   1. localhost:8443/ eaglei.sparqler.target.URL=https://localhost:8443/sparqler/

   2. Add credentials to the eagle-i

   .myInstitution.edu/sparqler/ eaglei.sparqler.lastSynchronizedDateFile=/eagle-i/home/sparqlerSyncDate.properties # credentials to enable the Synchronizer to access the source and target:

   1. -apps-credentials.properties file for access to the source and target repositories: 

      Code Block
      language bash title $\{EAGLEI_HOME\}/.config/eagle-i-apps-credentials.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

   2. Start up
   Tomcat
   1. tomcat

   2. Run the

   script

   1. script ${REPO_HOME}/etc/finish-install.sh, using the same sparqler-admin username and password that you set up in step

   1

   1. 5, above, when you ran the "prepare-install.sh":

   1.  

      Code Block
      language bash title run finish-install.sh
      hms-mbp:eaglei user$

   No Format

   1. bash ${REPO_HOME}/etc/finish-install.sh SPARQLER_USERNAME SPARQLER_PASSWORD https://localhost:8443/sparqler