Skip to content

Release notes: note ClickHouse 26.2+ requirement for Server v0.81.0+#2836

Draft
amarkov-cw wants to merge 2 commits into
mainfrom
amarkov/server-releases-0.81-clickhouse-26.2
Draft

Release notes: note ClickHouse 26.2+ requirement for Server v0.81.0+#2836
amarkov-cw wants to merge 2 commits into
mainfrom
amarkov/server-releases-0.81-clickhouse-26.2

Conversation

@amarkov-cw

Copy link
Copy Markdown

What

Adds an upgrade-prerequisite <Note> to the v0.81.0 server release notes: deployments using the ClickHouse/OLAP features (Registry Search, Run Store Accelerator, or History) need ClickHouse 26.2+ before upgrading to v0.81.0+.

Why

W&B Server 0.81.0 introduced a runs-accelerator schema migration (services/gorilla/clickhouse/migrations/runs/001_init.up.sql) that uses a ClickHouse-26.2-only full-text index — INDEX … TYPE text(tokenizer = array). On older ClickHouse (e.g. 25.x) the migration fails on boot and the api/glue pods don't start. 0.80 and earlier don't carry this migration. Dedicated/managed instances are already on 26.2; this is an on-prem / self-managed concern.

This came up with a self-managed customer and isn't currently documented. It mirrors the existing v0.78 Weave/ClickHouse upgrade note already on this page.

Notes for reviewer

  • Placed once on the v0.81.0 block with "v0.81.0+" wording so it covers the 0.81.x line. Happy to also echo it onto the 0.81.1/.2/.3 patch blocks (as the v0.78 note was repeated) if you prefer that pattern.
  • Wording/placement is yours to adjust — flagging the requirement is the goal.

🤖 Generated with Claude Code

W&B Server 0.81.0 introduced a runs-accelerator schema migration that uses a
ClickHouse 26.2-only full-text index (TYPE text(tokenizer = array)). On older
ClickHouse the migration fails on boot and the api/glue pods won't start, so
deployments using the ClickHouse/OLAP features must be on CH 26.2+ before
upgrading. Mirrors the existing v0.78 Weave/ClickHouse upgrade note.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@amarkov-cw amarkov-cw requested a review from mdlinville June 30, 2026 14:39
@amarkov-cw amarkov-cw requested a review from a team as a code owner June 30, 2026 14:39
@mintlify

mintlify Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview Jun 30, 2026, 2:46 PM

@github-actions

github-actions Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

📚 Mintlify Preview Links

🔗 View Full Preview

📝 Changed (1 total)

📄 Pages (1)

File Preview
release-notes/server-releases.mdx Server Releases

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: c3f2f4f at 2026-06-30 14:54:34 UTC

@github-actions

Copy link
Copy Markdown
Contributor

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-amarkov-server-releases-0-81-clickhouse-26-2.mintlify.app

…and Keeper

Self-managed ClickHouse runs the server and ClickHouse Keeper as two separate,
independently-versioned images; upgrading only the server leaves Keeper behind.
Call this out so on-prem upgraders move both to 26.2+.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.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.

1 participant