Graph Data Science training - Installation Instructions 2021

1.
Neo4j Graph Data Science Training
Installation Instructions
Welcome
If you're reading this you are going to attend a Neo4j Graph Data
Science Training in the very near future. ​Congratulations​!
The training is instructor-driven and in theory you could just sit there
and take it all in. You will ​not​ miss any essential details that way.
However, the training is supposed to be both interactive and hands-on.
And that is way more interesting (and dare I say … fun) for both you and
the instructors!
In order to be able to do the hands-on, you will have to set up a Neo4j
instance on your own local machine. Below we provide two ways to do
this. The first one is completely manual and requires ​no​ elevated rights
whatsoever. It works provided you can download the necessary
softwares and run a few scripts (with your own regular user). The
second uses the Neo4j Desktop. Easier to do (although you'll also have
to do a bit of work to get the databases loaded), but it requires the
usual privileges for installing a software.
The choice is yours … once again welcome and hope to see you soon in
the training!
Tom Geudens - Neo4j EMEA Field Team - 2021/01/18
1

2.
Manual
The manual installation first and foremost depends on the battle-tested
(many many many trainings have used this) instructions to set up a
local Neo4j instance.
You will find these for your platform of choice at
https://bit.ly/neo4j-windows-single
https://bit.ly/neo4j-linux-single
https://bit.ly/neo4j-mac-single
Once you have an instance up-and-running, the next step is to load the
two ​databases we'll be using in the training
https://bit.ly/neo4j-gds-setup-windows
https://bit.ly/neo4j-gds-setup-linux
https://bit.ly/neo4j-gds-setup-mac
And that's it … if you have followed those instructions and things are
running, you are ready. Note that you can at any time just stop the
instance (ctrl-c in the window where you have it running and then you
can close that window) and only need to do the ​starting​ bit again, not
the whole installation (it's a persisted database you know).
See you in the training!
2

3.
Neo4j Desktop
So ​getting​ the Neo4j Desktop is quite a bit easier as the ​Manual
procedure above, as it's basically in your face the moment you go to
https://neo4j.com/download-center/
Setting​ it up is another matter entirely, as you'll soon find out ...
Currently the version is ​1.4.1​ and if you already have the Neo4j
Desktop, please update to that. The instructions will work on earlier
versions but the screens will be different so you may have to dig
around a bit to find what I'm referring to.
The below screenshots are taken on a Windows laptop. Where the
instructions differ (the manual steps) I will indicate that …
I'm presuming you can do a click-and-next install, so I'll not go through
that, there are videos on the website where you download if you need
assistance with that.
3

4.
Project
By default the installation sets up a Neo4j Primer Project with a Movie
database. You can obviously keep those, but I removed the lot, giving
me a clean slate ...
That's a pretty obvious choice … ​New Project ​is … and I named it Graph
Data Science … for some reason …
4

5.
DBMS
The next choice is obvious, too … ​Add​ a DBMS. And we're going for a
Local one. Which we provide with a name, a password and the latest
Neo4j software (4.2.2. for this training please, just in case there's
another release between now and then).
Once it's provisioned we do ​not​ start it yet, first we need to change
some settings.
Settings can be found in the (well hidden) ​. . .​ menu (that is indeed the
three dots menu, it's not meant to create suspense … wait … it is ;-).
5

6.
Settings
You'll get an editor like screen and we need to fix
dbms.memory.heap.initial_size=2g
dbms.memory.heap.max_size=2g
and we also need to add (at the bottom of the file, enter will give you a
new line)
browser.remote_content_hostname_whitelist=*
Apply and close the settings.
The next bit is even more horrible as you'll now have to open a Neo4j
Desktop ​Terminal​ (found in the same ​. . .​ menu) and execute a couple
of manual commands. But first you need to download two dump files in
a location that you'll be able to easily reach in a manual command …
https://github.com/tomgeudens/practical-neo4j/raw/master/data/gds_g
ameofthrones.dump
https://github.com/tomgeudens/practical-neo4j/raw/master/data/gds_p
aysim.dump
I put them in C:temp … remember, keep the location as easy as
possible …
6

7.
Dump loading
Got them? Now open that​ ​Neo4j Desktop ​Terminal ​and execute the
following (modify the commands to fit where you put the dumps, but
make sure you can cut-and-paste this, the Terminal is not a fun tool to
work with)
binneo4j-admin load
--from=C:tempgds_gameofthrones.dump
--database=gameofthrones
binneo4j-admin load --from=C:tempgds_paysim.dump
--database=paysim
Note that these ​are​ one liners, it's the document that wraps them,
please make sure you execute as one line!
Right, so if you are on Linux or Mac, it's exactly the same but the
slashes are in the other direction and the location for the dump will be
something like /var/tmp/ or such.
The commands will tell you that they load something, note that if you
can't ​see​ a lot (especially on Windows the Terminal renders notoriously
bad), that's - sad but true - normal.
You can then close that Terminal window …
7

8.
Plugins
No, we can't start just yet. We need to install the plugins. If you click on
the database line itself (but not on one of the buttons), you get this …
See the ​Plugins​ there? We need two of them
8

9.
Start and make databases visible
And now you can - at last - ​Start
After which you can open with the Neo4j Browser and as a former
colleague of mine used to write it … ​walla … ​(forgive him, he's an
American, I think he meant ​voila​) ..
But​ wait …
Where's the data???
Ah yes, we loaded offline and didn't create the databases yet, only the
default neo4j database is there and that's empty ...
Do the following ​line by line​ in the Neo4j Browser ...
:use system
CREATE DATABASE gameofthrones;
CREATE DATABASE paysim;
:use gameofthrones
MATCH () RETURN count(*);
// 2642
:use paysim
MATCH () RETURN count(*);
// 332948
9

10.
The end
And now you are all set. While you are there, check if the browser guide
works
:play http://neo4jguides.tomgeudens.io
Well well … who said a ​UI setup​ is easier than a commandline setup?
See you in the training!
Caveat
The 1.4.1 Neo4j Desktop version has some very nice features, but if
you're running … say … BitDefender or some other rather aggressive
Antivirus software, it may not be possible to install it (it flat out refuses
on my own laptop, I did the installation in a Virtual Machine). Don't
worry overly about this, you may find the ​Manual​ installation more to
your liking anyway if you're that well protected/restricted. If that also
doesn't work out, contact us before the class starts and we'll see what
we can do.
10