Home Explore Help
Sign In
cecf
/
deploy
5
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: e4538f3d9b
Branches Tags
deploy
/
neo4j-helm
/
doc
/
docs
/
modules
/
ROOT
/
pages
/
installation.adoc

installation.adoc 2.6 KB
History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758 
  1. = Installation
    2. 

  2. 

  3. [abstract]
    4. 

  4. Explore the options for installing neo4j-helm, and how to configure advanced scenarios
    5. 

  5. 

  6. 

  7. This is a helm chart, and it is installed by running https://helm.sh/docs/helm/helm_install/[helm install] with various parameters used to customize the deploy.
    8. 

  8. 

  9. The default for this chart is to install https://neo4j.com/docs/operations-manual/current/clustering/[Neo4j Causal Cluster]*, with 3 core members and zero replicas, but standalone is also supported.
    10. 

  10. 

  11. == Causal Cluster Example
    12. 

  12. 

  13. ```shell
    14. 

  14. helm install my-neo4j \
    15. 

  15.     --set core.numberOfServers=3,readReplica.numberOfServers=3,acceptLicenseAgreement=yes,neo4jPassword=mySecretPassword .
    16. 

  16. ```
    17. 

  17. 

  18. The above command creates a cluster containing 3 core servers and 3 read replicas.
    19. 

  19. 

  20. Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,
    21. 

  21. 

  22. ```shell
    23. 

  23. helm install neo4j-helm -f values.yaml .
    24. 

  24. ```
    25. 

  25. 

  26. [NOTE]
    27. 

  27. *Tip*: You can copy the default https://github.com/neo4j-contrib/neo4j-helm/blob/master/values.yaml[values.yaml] file as an example to edit, with full access to all options.
    28. 

  28. 

  29. == Standalone (Single Machine) Command Line Example
    30. 

  30. 

  31. [NOTE]
    32. 

  32. ====
    33. 

  33. **For Neo4j standalone (i.e . excluding Neo4j Causal Cluster) productized Helm charts for are available for Neo4j 4.3 and above.**
    34. 

  34. 

  35. That is the recommended way to run a standalone Neo4j server in Kubernetes. Full details are in the https://neo4j.com/docs/operations-manual/current/kubernetes/[Kubernetes section of the Neo4j operations manual]
    36. 

  36. ====
    37. 

  37. 

  38. ```shell
    39. 

  39. helm install my-neo4j --set core.standalone=true,acceptLicenseAgreement=yes,neo4jPassword=mySecretPassword .
    40. 

  40. ```
    41. 

  41. 

  42. Important notes about standalone mode:
    43. 

  43. 

  44. * When running in standalone mode, core.numberOfServers is ignored and you will get 1 server.
    45. 

  45. * Read replicas may only be used with causal cluster. When running standalone, all read replica arguments are ignored.
    46. 

  46. * All other core settings (persistent volume size, annotations, etc) will still apply to your single instance.
    47. 

  47. * Standalone instances installed in this way cannot be scaled into clusters.
    48. 

  48. If you attempt to scale a standalone system, you will get multiple independent DBMSes, you will not get 1 causal cluster.
    49. 

  49. 

  50. == Deployment Scenarios
    51. 

  51. 

  52. See the https://github.com/neo4j-contrib/neo4j-helm/blob/master/deployment-scenarios[deployment-scenarios folder] in the repo for example YAML values files. These are example configurations that show settings necessary to launch the helm chart in different configurations.
    53. 

  53. 

  54. Each of these scenario files is launched the same way:
    55. 

  55. 

  56. ```shell
    57. 

  57. helm install mygraph -f deployment-scenarios/my-scenario.yaml . 
    58. 

  58. ```
    59.