Skip to content

Conversation

@NataliaIvakina
Copy link
Collaborator

@NataliaIvakina NataliaIvakina commented Dec 2, 2025

Rewrite the Clustering introductory page to include examples of database topologies.
Remove terminology inconsistencies across a few pages.

@NataliaIvakina NataliaIvakina removed the WIP label Dec 3, 2025
@NataliaIvakina NataliaIvakina force-pushed the dev-update-clustering-intro branch from 6b095c3 to 87a6450 Compare December 3, 2025 13:32
@jackwaudby jackwaudby self-assigned this Dec 15, 2025
Servers and databases are decoupled: servers provide computation and storage power for databases to use.
Each database relies on its own cluster architecture, organized into primaries (with a minimum of three for high availability) and secondaries (for read scaling).
. *Fault tolerance:* Primary database allocations provide a fault tolerant platform for transaction processing.
A database remains available for reads and writes as long as a simple majority of its primary copies are functioning.
Copy link
Contributor

Choose a reason for hiding this comment

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

copies -> allocations

Copy link
Contributor

Choose a reason for hiding this comment

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

Hmm depends actually, are we using copy/allocation interchangeably elsewhere? In which ignore this suggestion.

Copy link
Contributor

Choose a reason for hiding this comment

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

It might be good to use database allocation everywhere though.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

In fact, we're using copies/allocations interchangeably. In the Disaster recovery, however, we decided to use allocations only.

Comment on lines +30 to +32
That means they can host standard databases only in primary mode or only in secondary mode.
If the `modeConstraint` is set to `NONE`, a server can host databases in either mode.
In other words, a server can host primaries for some databases and secondaries for other databases.
Copy link
Contributor

Choose a reason for hiding this comment

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

We use both role and mode here to refer to the same concept, maybe this is ok but might be better for readers to be consistent

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I agree, but at the same time we use 'modeConstraint', 'server.cluster.system_database_mode' and the 'roles' column in the SHOW DATABASES output. So, there is some inconsistency in the code.
Which term is preferable in your opinion?

@NataliaIvakina NataliaIvakina force-pushed the dev-update-clustering-intro branch from 87a6450 to af0d43a Compare December 17, 2025 12:30
@neo4j-docops-agent
Copy link
Collaborator

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants