Mac: 3. Install Graphlytic

Deploy plugin into Neo4j

Graphlytic requires some advanced features which are not delivered with Neo4j but are deployed as a plugin for Neo4j delivered with Graphlytic installation package. To know more about the functionality of the plugin please see Architecture.

The Graphlytic Neo4j plugin has to be copied into Neo4j:

  • Stop Neo4j if it is running

  • Copy the file "neo4j-gl-plugin-<version>.jar" into the directory $NEO4J_HOME/Contents/Resources/app/plugins

    • Alternativelly use the "legacy-neo4j-gl-plugin-<version>.jar" when you want to use Neo4j version 3.3 or 3.4

You can copy the plugin also with Terminal, as you can see in example below.

Example:

$ cp neo4j-gl-plugin-<version>.jar <NEO4J_HOME>/plugins/

To see what is the functionlity of plugin see Architecture.

Install Graphlytic

Install Graphlytic as a console application

Create directory structure:

$ mkdir /Users/Shared/Graphlytic

Copy installation file and unpack it:

$ cp ~/Downloads/graphlytic-<version>.tar.gz /Users/Shared/Graphlytic
$ cd /Users/Shared/Graphlytic
$ tar zxvf graphlytic-<version>.tar.gz

Graphlytic's configuration is stored in the "conf/graphlytic.conf" file.

To change Graphlytic's default configuration run this command (this is a optional step):

vi /Users/Shared/Graphlytic/conf/graphlytic.conf

Default configuration is as follows:

# where Graphlytic stores its data
main.dataDir=../data/
# where Graphlytic stores log files
main.logDir=../data/logs/
# where Graphlytic stores external widgets
main.widgetsDir=../widgets/
# where Graphlytic stores external icons
main.iconsDir=../icons/
 
# login page logo title
site.logo.title=Graphlytic
 
# url for HTTP or HTTPS connection to Neo4j REST
# do not comment this line. HTTP/HTTPS connection is mandatory for communication with Graphlytic Neo4j plugin
# you can use HTTPS url to use SSL but you need import Neo4j certificate into Java default truststore
neo4j.connector.http=http://localhost:7474
# url for Bolt connection to Neo4j
# comment this line to disable Bolt protocol communication and HTTP/HTTPS will be used for all communication with Neo4j
neo4j.connector.bolt=bolt://localhost:7687
# username for Neo4j connection
neo4j.connector.username=neo4j
# password for Neo4j connection
neo4j.connector.password=enter_real_password_for_neo4j_here

To change the starting script's configuration run this command (this is a optional step):

$ vi /Users/Shared/Graphlytic/bin/graphlyticc

Edit this configuration file to use HTTP or HTTPS or both (this is a optional step - default is both HTTP and HTTPS available):

#!/bin/sh
 
# use this script to start GL from console
 
# disable or enable HTTP/HTTPS. To disable comment od remove line
#HTTP_PORT=8080
HTTPS_PORT=8443