Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions modules/ROOT/content-nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@
** xref:kubernetes/operations/index.adoc[]
*** xref:kubernetes/operations/maintenance-mode.adoc[]
*** xref:kubernetes/operations/reset-password.adoc[]
*** xref:kubernetes/operations/change-configuration.adoc[]
*** xref:kubernetes/operations/dump-load.adoc[]
*** xref:kubernetes/operations/backup-restore.adoc[]
*** xref:kubernetes/operations/upgrade.adoc[]
Expand Down
1 change: 1 addition & 0 deletions modules/ROOT/pages/kubernetes/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ This chapter describes the following:
* xref:kubernetes/operations/index.adoc[Operations] -- Perform operations on a Neo4j deployment running on Kubernetes.
** xref:kubernetes/operations/maintenance-mode.adoc[Maintenance mode]
** xref:kubernetes/operations/reset-password.adoc[Reset the neo4j user password]
** xref:kubernetes/operations/change-configuration.adoc[Make a configuration change]
** xref:kubernetes/operations/dump-load.adoc[Dump and load databases (offline)]
** xref:kubernetes/operations/backup-restore.adoc[Back up and restore a single database (online)]
** xref:kubernetes/operations/upgrade.adoc[Upgrade Neo4j on Kubernetes]
Expand Down
33 changes: 33 additions & 0 deletions modules/ROOT/pages/kubernetes/operations/change-configuration.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
:description: The page describes how to restart Neo4j pods in case of modifying ConfigMaps or secrets.

= Make a configuration change

When you update ConfigMaps or secrets (for example, updating GDS or Bloom license values), you have to restart your Neo4j pod so that the changes take effect.

You have two options for restarting:

* To run the `kubectl delete pod` command as follows:
+
[source, shell]
----
kubectl delete pod <pod_name>
----
+
You manually delete the Neo4j pod.
Kubernetes will automatically recreate it with the updated configuration.

* To use the `kubectl rollout restart` command:
+
[source, shell]
----
kubectl rollout restart statefulset/<neo4j-statefulset-name>
----
+
A rollout restart means a gradual recreation of a pod — the old pod is not removed entirely until the new pod is running successfully.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How would that work regarding the volumes attached to neo4j ( both needing lock ) ?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi! I might be wrong, but as I understand it, the rollout restart command doesn’t affect the volumes attached to the Neo4j pods. It simply restarts the pod. Since the volumes have stable identities (PersistentVolumeClaims), they’ll be re-attached to the newly created pod after the restart.
@riggi-alekaj, please correct me if this is wrong.

This process is safer and ensures that your application remains available throughout the restart process.


If you need to change Neo4j password, see xref:kubernetes/operations/reset-password.adoc[].

For information on how to install and manage plugins, refer to the xref:kubernetes/plugins.adoc[].

1 change: 1 addition & 0 deletions modules/ROOT/pages/kubernetes/operations/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ It covers the following topics:

* xref:kubernetes/operations/maintenance-mode.adoc[Maintenance mode]
* xref:kubernetes/operations/reset-password.adoc[Reset the neo4j user password]
* xref:kubernetes/operations/change-configuration.adoc[Make a configuration change]
* xref:kubernetes/operations/dump-load.adoc[Dump and load databases (offline)]
* xref:kubernetes/operations/backup-restore.adoc[Back up and restore a single database (online)]
* xref:kubernetes/operations/upgrade.adoc[Upgrade Neo4j on Kubernetes]
Expand Down