GeoKnow

h1. USeekM instr

The following instructions are tested to work with *uSeekM 1.2.0-a5* on a *debian/squeezy* platform.

Ιnstall java JDK and Tomcat6 servlet container from APT repositories:

<pre>

# apt-get install sun-java6-jdk tomcat6-admin tomcat6-common tomcat6-examples tomcat6

</pre>

Install PostgreSQL database with it's PostGIS extension.

<pre>

# apt-get install postgresql-8.4 postgresql-contrib-8.4 postgresql-8.4-postgis

</pre>

Create a PostGIS-enabled database named 'useekm':

<pre>

# sudo -u postgres createdb useekm

# sudo -u postgres psql -d useekm -c 'CREATE LANGUAGE plpgsql'

# sudo -u postgres psql -d useekm -f /usr/share/postgresql/8.4/contrib/postgis-1.5/postgis.sql

# sudo -u postgres psql -d useekm -f /usr/share/postgresql/8.4/contrib/postgis-1.5/spatial_ref_sys.sql 

</pre>

Download webapp archives (WARs) to be deployed under Tomcat6 (we choose version 1.2.0-a5):

<pre>

# mkdir -p ~/packages

# cd ~/packages

# wget --no-check-certificate https://dev.opensahara.com/nexus/content/repositories/releases/com/opensahara/useekm-http-server/1.2.0-a5/useekm-http-server-1.2.0-a5.war

# wget --no-check-certificate https://dev.opensahara.com/nexus/content/repositories/releases/com/opensahara/useekm-http-workbench/1.2.0-a5/useekm-http-workbench-1.2.0-a5.war

</pre>

Copy and rename archives into Tomcat6's webapp directory (requires restart to take effect). Afterwards, visit Tomcat's admin interface, 

at http://localhost:8080/manager/html and verify that the archives are properly deployed and hosted under the appropriate URL prefix (i.e. /openrdf-sesame and /openrdf-workbench):  

<pre>

# cp ~/packages/useekm-http-workbench-1.2.0-a5.war /var/lib/tomcat6/webapps/openrdf-workbench.war

# cp ~/packages/useekm-http-server-1.2.0-a5.war    /var/lib/tomcat6/webapps/openrdf-sesame.war

# /etc/init.d/tomcat6 restart

</pre>

Now a new RDF repository should be created with a set of minimal configuration options. Let's name it "geoknow":

<pre>

# mkdir -p /var/opt/useekm/geoknow

</pre>

Create a configuration file for your repository at <code>/var/opt/useekm/geoknow/config.xml</code> by editing the following template:

<pre><code class="xml">

<beans xmlns="http://www.springframework.org/schema/beans" 

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">

    <!-- The id "repository" is mandatory! -->

    <bean id="repository" class="org.openrdf.repository.sail.SailRepository">

        <constructor-arg>

            <bean class="com.useekm.indexing.IndexingSail">

                <constructor-arg ref="sail" />

                <constructor-arg ref="indexerSettings" />

            </bean>

        </constructor-arg>

    </bean>

    <!-- This example uses the NativeStore as the underlying sail, you could also use the MemoryStore -->

    <bean id="sail" class="org.openrdf.sail.nativerdf.NativeStore" />

    <!-- Please customize the indexer settings: -->

    <bean id="indexerSettings" lazy-init="true" class="com.useekm.indexing.postgis.PostgisIndexerSettings">

        <property name="defaultSearchConfig" value="simple" />

        <property name="dataSource" ref="pgDatasource" />

        <property name="matchers">

            <list>

                <!-- CUSTOMIZE: list all the predicates that need indexing (text and/or geo): -->

                <bean class="com.useekm.indexing.postgis.PostgisIndexMatcher">

                    <property name="predicate" value="http://www.w3.org/2000/01/rdf-schema#label" />

                    <property name="searchConfig" value="simple" />

                </bean>

                <bean class="com.useekm.indexing.postgis.PostgisIndexMatcher">

                    <property name="predicate" value="http://www.opengis.net/ont/geosparql#asWKT" />

                </bean>

            </list>

        </property>

        <!-- You can add additional configuration, such as index partitions to optimize performance. See the documentation. -->

    </bean>

    <bean id="pgDatasource" lazy-init="true" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">

        <property name="driverClassName" value="org.postgresql.Driver"/>

        <property name="url" value="jdbc:postgresql://localhost:5432/useekm"/>    <!-- CUSTOMIZE! -->

        <property name="username" value="postgres"/>                              <!-- CUSTOMIZE! -->

        <property name="password" value="postgres"/>                              <!-- CUSTOMIZE! -->

    </bean>

</beans>

</code></pre> 

Finally, change ownership of the directories that expect server output (logs etc.):

<pre>

# chown root:tomcat6 -R /usr/share/tomcat6/.aduna/openrdf-sesame

# chmod 0775         -R /usr/share/tomcat6/.aduna/openrdf-sesame

</pre>

Restart Tomcat6 and visit http://localhost:8080/openrdf-workbench. 

* You should be able to create a new server instance by using http://127.0.0.1:8080/openrdf-sesame as the address. Note that

this is a local (to the Tomcat instance) address.

* Afterwards, you should be able to create a new repository named 'geoknow'. Specify the server's absolute file path of the 

configuration file (that is <code>/var/opt/useekm/geoknow/config.xml</code>)