Skip to content

Adminstration guidelines to migrate to postgresql#103

Open
sghosh23 wants to merge 7 commits intomainfrom
how-to-migrate-to-postgresql
Open

Adminstration guidelines to migrate to postgresql#103
sghosh23 wants to merge 7 commits intomainfrom
how-to-migrate-to-postgresql

Conversation

@sghosh23
Copy link
Copy Markdown
Contributor

Change type

  • Documentation change
  • Build pipeline change
  • Submodule update
  • Deployment change

Basic information

  • THIS CHANGE REQUIRES A WIRE-DOCS RELEASE NOW

Testing

  • I ran/applied the changes myself, in a test environment.

Tracking

  • I mentioned this PR in Jira, OR I mentioned the Jira ticket in this PR.
  • I mentioned this PR in one of the issues attached to one of our repositories.

@sghosh23 sghosh23 requested review from a team as code owners March 13, 2026 13:59
@sghosh23 sghosh23 changed the title add adminstration guidelines to migrate to postgresql Adminstration guidelines to migrate to postgresql Mar 13, 2026
@sghosh23 sghosh23 requested a review from mastaab March 13, 2026 13:59
- Conversation codes
- Team features

After the migration is complete, PostgreSQL becomes the authoritative store for the migrated domains.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'm not sure i would have used data domains as the term here; when you say migrated domains, people think DNS.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

ok


The `cassandra-migrations` job only prepares schema and metadata. It does not copy conversation data from Cassandra into PostgreSQL. The data copy is performed by `background-worker`.

## PostgreSQL Connection Budget
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Move this into a dedicated document; it is general guidance, not migration related.

Copy link
Copy Markdown
Contributor Author

@sghosh23 sghosh23 Mar 31, 2026

Choose a reason for hiding this comment

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

it's already moved to the dedicated domain, what we have here is the awareness of using the connection budget and link to that dedicated document


- `galley` should restart cleanly.
- New writes for that domain should be written to both Cassandra and PostgreSQL.
- No backfill should run yet.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Define backfill for the person running through this document.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

ok

- `error occurred`
- `estimatedRows`

Useful Prometheus metrics:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We cannot assume they have metrics configured; leave a note pointing to how to pull metrics manually, for those who don't have it (read: everyone!)


After this rollout, the selected domain reads from PostgreSQL only.

## Recommended Domain Order
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

you should recommend the order before giving the instructions.

sghosh23 and others added 2 commits March 31, 2026 16:25
Co-authored-by: Julia Longtin <julia.longtin@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants