Forge Home

Modules

Resources

PuppetEcosystemPuppet CommunityUpdates

neo4j

A module installing and configuring Neo4j community or enterprise editions.
Project URLRSS FeedReport issues

12,424 downloads

7,591 latest version

2.8 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 99.99.99 (latest)
  • 1.1.0
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 1.0.0
released Sep 23rd 2015
This version is compatible with:
  • Puppet Enterprise >=3.2.0
  • Puppet >=2.7.20 <4.0.0
This module has been deprecated by its author since May 15th 2020.

The author has suggested mlambrichs-neo4j as its replacement.

Start using this module

Tags: database, nosql, neo4j, neo, graph, relationship

Documentation

amosjwood/neo4j — version 1.1.0 Sep 23rd 2015

neo4j puppet module

####Table of Contents

  1. Overview
  2. Setup
  3. Usage
  4. Reference

Overview

Installs Neo4J (http://www.neo4j.com) on Ubuntu/Debian from their distribution tarballs downloaded directly from their site.

##Setup

All of the setup for any of the configuration is done through via class neo4j. There are default options provided such that you can install Neo4j into /opt/neo4j and start listening on http://your_ip:7474/ by specifying:

include neo4j

To install enterprise edition 2.0.3, you can specify:

class { 'neo4j' :
  version => '2.0.3',
  edition => 'enterprise',
}

See usage scenarios below for further usages.

##Usage

Currently, all of the configurations are done through the class neo4j including clustered Neo4j server.

Here are some example of different configurations that people could use this module to manage their Neo4j instances.

Note: For an explain of parameters and a complete list, please see the reference section below.

Basic Install

class { 'neo4j' :
}

Different Version

All known versions >= 2.0.0 can be installed. For the list of current releases, you can go to http://neo4j.com/download/.

class { 'neo4j' :
  version => '2.0.3',
  edition => 'enterprise',
}

Different Install Path

If you want to install to another directory, use the install_prefix parameter.

class { 'neo4j' :
  install_prefix => '/tmp',
}

Custom JVM Memory Options

class { 'neo4j' :
  jvm_init_memory => '1024',
  jvm_max_memory  => '1024',
}

Cache Options

The cache options can be customized too to allow for better performance scaling. For an explanation and usage of these options, see Neo4j documentation on caching.

class { 'neo4j' :
  nodestore_memory                  => '25M',
  relationshipstore_memory          => '50M',
  propertystore_memory              => '100M',
  propertystore_strings_memory      => '130M',
  propertystore_arrays_memory       => '130M',
  cache_type                        => 'hpc',
  cache_memory_ratio                => '50.0',
  node_cache_array_fraction         => '5',
  relationship_cache_array_fraction => '5',
  node_cache_size                   => '100M',
  relationship_cache_size           => '100M',
}

Authentication and User Management

To force authentication of the data and management entry points, you can use the auth_ensure and include auth_admin_user and auth_admin_password parameters too. The auth_users is optional, but can be used to manage authorized users.

$auth_users = {
  user1 => {
    ensure     => present,
    password   => 'puppet',
    readWrite  => true,
  },
}

class { 'neo4j' :
  auth_ensure         => present,
  auth_admin_user     => 'admin',
  auth_admin_password => 'password',
  auth_users          => $auth_users, #optional
}

New Relic Monitoring

You can also specify to monitor the server with New Relic. Sign-up and monitoring is free from http://www.newrelic.com.

class { 'neo4j' :
  newrelic_jar_path => '/path/to/newrelic.jar',
}

##Reference

###neo4j Manages the server. ####Attributes

  • version -- The version of Neo4j to install. Default: 2.1.2
  • edition -- The edition of Neo4j to install. Possibles: (community, enterprise). Default: community
  • install_prefix -- Where to install the software. Default: /opt/neo4j
  • allow_remote_connections -- Whether to allow remote connections to Neo4j instead of only from localhost. Default: true

######Custom Memory Attributes

  • jvm_init_memory* -- Initial memory size of the jvm. Equates to java option "-Xms=XXX". Specified in MBs. Default: 1024
  • jvm_max_memory* -- Maximum memory size of the jvm. Equates to java option "-Xmx=XXX". Specified in MBs. Default: 1024

######Custom Cache Attributes -- See Neo4j documentation on caching

  • nodestore_memory* -- See Neo4j documentation. Default: Neo4j default value
  • relationshipstore_memory* -- See Neo4j documentation. Default: Neo4j default value
  • propertystore_memory* -- See Neo4j documentation. Default: Neo4j default value
  • propertystore_strings_memory* -- See Neo4j documentation. Default: Neo4j default value
  • propertystore_arrays_memory* -- See Neo4j documentation. Default: Neo4j default value
  • cache_type* -- See Neo4j documentation. Default: Neo4j default value
  • cache_memory_ratio* -- See Neo4j documentation. Default: Neo4j default value
  • node_cache_array_fraction* -- See Neo4j documentation. Default: Neo4j default value
  • relationship_cache_array_fraction* -- See Neo4j documentation. Default: Neo4j default value
  • node_cache_size* -- See Neo4j documentation. Default: Neo4j default value
  • relationship_cache_size* -- See Neo4j documentation. Default: Neo4j default value

* - see Max DeMarzi's Neo4j blog entry titled Scaling-Up

######Authentication Attributes

  • auth_ensure** -- Turns on/off authentication. Possibles: present, absent. Default: absent

  • auth_admin_user -- Admin user name. Must be specified when using authentication. Default: undef

  • auth_admin_password -- Admin password. Must be specified when using authentication. Default: undef

  • auth_users -- Hash of users, passwords, and roles that can access Neo4j when using authentication. Default: undef

    Sample Input:

    $auth_users = {
  username1 => {
    ensure     => present,   #optional, defaults to present
    password   => 'mypass',
    readWrite  => true,      #optional, defaults to true
  },
  username2 => {
    password   => 'mypass',
  },
  username3 => {
    ensure     => absent,
    password   => '',        #you must specify this when removing the user
  },
}

######New Relic Parameters

  • newrelic_jar_path -- Specifies the full path to the newrelic java agent jar file. Default: undef

######HA Parameters These parameters configure the Neo4j HA options.

  • ha_ensure -- Turns on/off ha features. Possibles: present, absent. Default: absent

  • ha_server_id -- Required. Unique server id in cluster. Must be an integer. Default: undef

  • ha_initial_hosts -- Required. Other hosts in the cluster. Default: undef

    $ha_initial_hosts = "${::ipaddress}:5001,other_ip:5001,another_ip:5001"

    $ha_initial_hosts = "${::fqdn}:5001,host1.domain:5001,host2.domain:5001"

  • ha_cluster_port -- Port to listen to cluster heartbeats and management communications. Default: 5001

  • ha_data_port -- Port to send/receive cluster data on. Default: 6001

  • ha_pull_interval -- Pull interval from master. Specified in seconds. Default: Neo4j default

  • ha_tx_push_factor -- Push factor to X slave servers. Specified as an integer. Default: Neo4j default

  • ha_tx_push_strategy -- Push strategy to slave servers. Default: Neo4j default

  • ha_allow_init_cluster -- Allow server to initialize a cluster if it cannot contact other hosts. Default: Neo4j default

  • ha_slave_only -- Server can only be a slave in the cluster. Default: Neo4j default

######Logging Parameters