Skip to content

Setup and Config Instructions

pmartin7 edited this page Aug 16, 2016 · 11 revisions

Local installation

This section summarizes how to set up a PC to run the Music Graph Explorer solution locally, including the Neo4j based graph storage.

1. Install Neo4j

  • Download Neo4j Community Edition 3.0 for Windows. Note it must be a v3 release, the solution does not support Neo4j v1 and v2 for now as a graph storage.
  • Install Neo4j on your local box. Install folder: C:\Program Files\Neo4j CE 3.0.4

2. Download test music graph store to your local box and test Neo4j installation

  • Download the full default.graphdb folder ([OneDrive location] (https://1drv.ms/f/s!AugVHxjh0dP-gv9hnfgYHRD6WmudJA)). Size: approx. 200 Mb

  • Unzip the content of the default.graphdb folder to C:\Neo4j\MusicGraphExplorer

  • Start Neo4j. Point the database location to the folder C:\Neo4j\MusicGraphExplorer, then click start

  • Start your browser at http://localhost:7474/browser/

  • enter user name neo4j and password Gr@phexplore1

  • Type in a Cypher query to retrieve 15 nodes from Nirvana's subgraph of related artists and genres:

    MATCH (b:Artist)<-[:RELATED]-(a:Artist {Name: "Nirvana"})-[:IN_GENRE]->(g) RETURN a, b, g LIMIT 15

  • type in another query to retrieve count of artists and genres:

    MATCH (a:Artist) WITH count(distinct a) as totalArtists MATCH (g:Genre) WITH totalArtists, count(distinct g) as totalGenres MATCH (a)-[r:RELATED]->(b) RETURN totalArtists, totalGenres, count(distinct r) as totalArtistRelationships

3. Set up visual studio

  • Download and install VS 2012, 2013, or 2015. Ensure you have at least VS 2012 Update 5 installed, [Visual Studio Tools for Git] (https://visualstudiogallery.msdn.microsoft.com/abafc7d6-dcaa-40f4-8a5e-d6724bdb980c) so you can pull the solution from Git directly from VS, and Nuget Package Manager for VS 2012 (if you use VS2012) to download the dependencies for the solution.. On VS 2012, ensure you have selected the Git Provider under Tools>Options>Source Control
  • Under VS Team Explorer>Connect, Clone the Music Graph Explorer to a local git repository. Clone it from this url: https://github.com/pmartin7/MusicGraphExplorer.git. Then sync from the unsynced commits tab. This will prompt for your GitHub credentials.
  • Open the MusicGraphExplorer.sln solution from your local repository.
  • The solution is currently built using .Net framework 4.5.2. This may prompt you to download the latest version of the .Net framework.
  • Open the solution in VS. Using the Nuget Pakcage Manager, download the Neo4j.Driver package for the MusicGraphStore project. This will install the library used to query Neo4j.
  • Rebuild the solution. The build should succeed.
  • In test manager, run all tests, after ensuring that Neo4j is started using the right folder for the Music Graph Store. all tests should pass successfully.
  • Start the SampleApp console application. Have fun :)

Clone this wiki locally