Skip to content

Latest commit

 

History

History
133 lines (87 loc) · 7.3 KB

File metadata and controls

133 lines (87 loc) · 7.3 KB

Grakn and Graql Grakn License

Run Grakn and Graql in a docker container running under the traditional Java 8 (from OpenJDK or another source).

Find out more about Grakn and Graql from the Resources section below.

On start-up, useful details including time to start-up the Grakn server and duration for which Graql was run are printed.

Also, available experimental usage of GraalVM, to take advantages of the performance benefits of this JVM.


Goals

  • Run Grakn and Graql in a docker container
  • Ability to create custom docker images (scripts & docs provided)
  • Ability to debug the docker container
  • Run using the traditional JDK (OpenJDK or vendor specific versions)
  • Run using the polyglot JVM i.e. GraalVM JDK (Community version from Oracle Labs)
  • Measure startup and execution times for the different JDKs used
  • Run Grakn's native performance benchmarking scripts

Scripts provided

See Scripts provided.

Performance Scripts provided

Usage

Setting your environment

Note: you need to do the below only if you are trying to build your own version of the Grakn Docker container and push to your own Docker Hub repository. Otherwise you can skip this section and move on.

Ensure your environment has the below variable set, or set it in your .bashrc or .bash_profile or the relevant startup script:

export DOCKER_USER_NAME="your_docker_username"

You must have an account on Docker hub under the above user name.

Running Grakn docker container

See Grakn Docker container

Run the performance script in the Grakn docker container

See Run the performance script

Build the Grakn docker container

See Build the Grakn docker container

Docker image on Docker Hub

Find the Grakn Docker Image on Docker Hub. The ./grakn-runner.sh --pushImageToHub command pushes the image to the Docker hub and the ./grakn-runner.sh --runContainer script runs it from the local repository. If this is absent in your local repository, scripts download this image from the Docker Hub.

Building Grakn

See Building Grakn

Known issues doing the above

Graql

See Graql README

English-to-Graql

See English-to-Graql

Graql-to-English

See Graql-to-English

Resources

Disclaimer

All the code and scripts container in this folder grakn are a proof-of-concept work to illustrate use-case(s) and usage scenarios. It is not mean to be a full-fledge solution and is adapted to show-case certain scenarios and hence all of the behaviours are in that order.

The code (this repo) and the referred datasets (see Grakns' docs and git repos)are available as F/OSS. The code is available here under the Apache license, see license.txt and can be used/changed accordingly. Grakn's resources are available under their said licenses (please check accordingly).

Contributing

Contributions are very welcome, please share back with the wider community (and get credited for it)!

Please have a look at the CONTRIBUTING guidelines, also have a read about our licensing policy.


Back to Data
Back to main page (table of contents)