Using docker
The fastest was to get a local installation is by using docker and docker-compose
Prerequisites
Assuming you have docker and docker-compose installed.
$ git clone https://github.com/COMBAT-TB/combat-tb-neodb.git
$ cd combat-tb-neodb
$ docker-compose up --build -d
Building
Once the server is running, visit http://localhost:7474. You shall see the following guide to get you familiar with the database.
Standalone
Download and extract the latest release of Neo4j from the Neo4j Download Center and follow the relevant installation instructions from the operators manual.
cd into Neo4j directory:
$ cd ~/Downloads/neo4j-community-3.5.4
Download the NeoDB browser guide and configure Neo4j accordingly:
$ pwd
# $HOME/Downloads/neo4j-community-3.5.4
$ wget https://raw.githubusercontent.com/COMBAT-TB/combat-tb-neodb/master/guides/combattb_neodb.html \
-P data/guides/ \
&& echo 'dbms.security.auth_enabled=false' >> conf/neo4j.conf \
&& echo 'dbms.allow_upgrade=true' >> conf/neo4j.conf \
&& echo 'dbms.security.procedures.unrestricted=apoc.*,algo.*' >> conf/neo4j.conf \
&& echo 'dbms.security.procedures.whitelist=apoc.*, algo.*' >> conf/neo4j.conf \
&& echo 'dbms.unmanaged_extension_classes=extension.web=/guides' >> conf/neo4j.conf \
&& echo 'org.neo4j.server.guide.directory=data/guides' >> conf/neo4j.conf \
&& echo 'browser.post_connect_cmd=config; play http://localhost:7474/guides/combattb_neodb.html' >> conf/neo4j.conf \
&& echo 'browser.remote_content_hostname_whitelist=*' >> conf/neo4j.conf
Download and extract the Combat-TB-NeoDB:
$ pwd
# $HOME/Downloads/neo4j-community-3.5.4
$ wget "https://zenodo.org/record/3274226/files/neodb-db-data.tar.bz2" \
-O neodb_db_data.tar.bz2
$ tar -xjvf neodb_db_data.tar.bz2
$ cp -R databases/ data/
Download the APOC Procedures and Graph Algorithms binary jars, and place then in the $NEO4J_HOME/plugins folder:
$ pwd
# $HOME/Downloads/neo4j-community-3.5.4
$ export NEO4J_CONTRIB="https://github.com/neo4j-contrib"
$ wget "${NEO4J_CONTRIB}/neo4j-graph-algorithms/releases/download/3.5.4.0/graph-algorithms-algo-3.5.4.0.jar" -P plugins/ \
&& wget "${NEO4J_CONTRIB}/neo4j-apoc-procedures/releases/download/3.5.0.4/apoc-3.5.0.4-all.jar" -P plugins/
Run Neo4j as a background process:
$ pwd
# $HOME/Downloads/neo4j-community-3.5.4
$ bin/neo4j start
and visit http://localhost:7474.