-
Notifications
You must be signed in to change notification settings - Fork 5
Local Installation
There are two main use cases for a local installation of ViziQuer:
- To query your own set of SPARQL endpoints that do not have their schemas preloaded on viziquer.app
- To participate in the development of ViziQuer
The ViziQuer tool suite consists of:
- ViziQuer visual query tool itself
-
Data Shape Server (DSS) for serving the data schemata to ViziQuer
- DSS stores its data in a PostgreSQL database which also needs to be present
- The utility for data schema extraction from a SPARQL endpoint (OBIS Schema extractor) and the utility for storing the data in the DSS schema database (provided within the DSS repository), see Schema Extraction for details.
The Data Shape Server serves a stored knowledge graph schema information (classes, properties and their connections) to ViziQuer.
In order to run ViziQuer, DSS needs to be installed and running.
Please follow installation instructions in the Data Shape Server repository.
Prerequisites:
- Download and install Meteor framework following instructions at https://www.meteor.com/install
Instructions for installing ViziQuer:
- Clone ViziQuer github repository
- Change to the
./viziquer/appdirectory of the cloned repository - Create
.envfile based on thesample.envfile provided. It should contain the URL of the DSS server, e.g.SCHEMA_SERVER_URL=http://localhost:3344/api - Execute the command
meteor npm cito install the required packages - To run the ViziQuer tool, type
meteorin the ViziQuer directory. To run on a specific port:meteor --port 4000.
Open the ViziQuer tool in a web browser, e.g., localhost:3000.
Now you can create a new user and start using ViziQuer (see Getting Started).
- Start a new ViziQuer project by pressing the "New project" button
The first user to sign up to the new instance will get administrator rights (the rights to manage tool configurations).
Information about the architecture of the ViziQuer tool can be found at:
- J. Ovčiņņikova, A. Šostaks, K. Čerāns. Visual Diagrammatic Queries in ViziQuer: Overview and Implementation. Baltic J. Modern Computing, Vol. 11 (2023), No. 2, 317-350.