Library Version 12.1.3.0

Installing and Configuring SPARQL Gateway
Prev | Chapter 9. SPARQL Gateway for XML-based Tools | Next

## Installing and Configuring SPARQL Gateway

To install and configure SPARQL Gateway, follow these major steps, which are explained in subsections that follow:

1. Download the RDF Graph .zip file.

2. Deploy SPARQL Gateway in WebLogic Server.

3. Modify Proxy Settings, if necessary.

4. Configure the OracleSGDS Data Source, if necessary.

5. Add and configure the SparqlGatewayAdminGroup Group, if desired.

### Download the RDF Graph .zip File

If you have not already done so, download the RDF Graph feature from My Oracle Support. For download details, see Prerequisite Software.

Note that the SPARQL Gateway Java class implementations are embedded in sdordfclient.jar.

### Deploy SPARQL Gateway in WebLogic Server

Deploy the SPARQL Gateway web application (sparqlgateway.war) which is bundled in rdf_graph_for_nosql_database.zip into Oracle WebLogic Server. Verify your deployment by using your web browser to connect to the URL http://<host-name>:7001/sparqlgateway (This assumes that the Web application is deployed at port 7001).

### Modify Proxy Settings

If your SPARQL Gateway is behind a firewall and you want the SPARQL Gateway to communicate with SPARQL endpoints on the internet as well as those inside the firewall, you might need to use the following JVM settings:

    -Dhttp.proxyHost=<your_proxy_host>
    -Dhttp.proxyPort=<your_proxy_port>
    -Dhttp.nonProxyHosts=127.0.0.1|
    <hostname_1_for_sparql_endpoint_inside_firewall>|<
    hostname_2_for_sparql_endpoint_inside_firewall>|...|
    <hostname_n_for_sparql_endpoint_inside_firewall>

You can specify these settings in the `startWebLogic.sh` script.

### Add and Configure the SparqlGatewayAdminGroup Group

The following JSP files in SPARQL Gateway can help you to view, edit, and update SPARQL queries and XSL transformations that are stored in an Oracle database:

    http://<host>:7001/sparqlgateway/admin/sparql.jsp

    http://<host>:7001/sparqlgateway/admin/xslt.jsp

These files are protected by HTTP basic authentication. In `WEB-INF/weblogic.xml`, a principal named `SparqlGatewayAdminGroup` is defined.

To be able to log in to either of these JSP pages, you must use the WebLogic Server to add a group named `SparqlGatewayAdminGroup`, and create a new user or assign an existing user to this group.

Prev | Up | Next
Chapter 9. SPARQL Gateway for XML-based Tools | Home | Using SPARQL Gateway with RDF Data