Mac: 3. Install Graphlytic

1. 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

  • In Application folder find Neo4j application, click with secondary button on application and choose "Show Package Contents"

  • Copy the file "neo4j-gl-plugin-[version].jar" into the directory Contents/Resources/app/plugins

  • Alternatively, you can copy plugin in Terminal, as you can see in example below

Example:

$ cp neo4j-gl-plugin-1.15.0.jar /Applications/Neo4j\ Community\ Edition\ 3.2.6.app/Contents/Resources/app/plugins/

To see what is the functionlity of plugin see Architecture.

2. Install Graphlytic

2.1. Install Graphlytic as a console application

Copy Graphlytic installation file "graphlytic-<version>.tar.gz" into /tmp/.

Create directory structure:

$ mkdir /Users/Shared/Graphlytic

Copy installation file and unpack it:

$ cp /tmp/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