Skip to content

feat(enterprise): document influx-meta CLI and cleanup-shards command#7022

Draft
jstirnaman wants to merge 4 commits intomasterfrom
docs/6842-influx-meta-cleanup-shards
Draft

feat(enterprise): document influx-meta CLI and cleanup-shards command#7022
jstirnaman wants to merge 4 commits intomasterfrom
docs/6842-influx-meta-cleanup-shards

Conversation

@jstirnaman
Copy link
Copy Markdown
Contributor

Summary

Add documentation for the influx-meta CLI tool — an Enterprise metadata management binary that has been shipping undocumented since v1.12.0.

  • cleanup-shards (v1.12.3+): Full documentation with prerequisites, usage, output format, and examples
  • 8 other subcommands (v1.12.0+): Minimal stub pages with usage and global flags — a follow-up issue will expand these

Commands documented

Command Version Coverage
cleanup-shards v1.12.3+ Full
convert v1.12.0+ Stub
export v1.12.0+ Stub
fix-shard-owners v1.12.0+ Stub
import v1.12.0+ Stub
make-node-active v1.12.0+ Stub
make-node-passive v1.12.0+ Stub
renumber-shard-groups v1.12.0+ Stub
set-shard-group v1.12.0+ Stub

Changes

10 new files in content/enterprise_influxdb/v1/tools/influx-meta/

Verified

Binary confirmed on live Enterprise v1.12.3 cluster with all 9 subcommands present.

Test plan

  • Verify influx-meta appears in the Enterprise Tools nav
  • Verify cleanup-shards page renders with v1.12.3+ metadata badge
  • Verify stub pages render with v1.12.0+ metadata badges
  • Verify all command links from _index.md resolve

closes #6842

Add documentation for the `influx-meta` CLI tool with all 9 subcommands.
The `cleanup-shards` subcommand (v1.12.3+) gets full documentation with
prerequisites, usage, output format, and examples. The remaining 8
subcommands (v1.12.0+) have minimal stub pages with usage and global
flags.

The influx-meta binary has been shipping undocumented since v1.12.0.

closes #6842
@jstirnaman jstirnaman requested a review from a team as a code owner March 31, 2026 05:06
@jstirnaman jstirnaman added this to the v1.12.3 milestone Mar 31, 2026
@jstirnaman jstirnaman added release:pending Waiting for product release before merging product:v1-enterprise InfluxDB Enterprise v1 labels Mar 31, 2026
@jstirnaman jstirnaman requested review from devanbenz and sanderson and removed request for a team March 31, 2026 05:06
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 31, 2026

Vale Style Check Results

Metric Count
Errors 0
Warnings 0
Suggestions 0

Check passed

@davidby-influx
Copy link
Copy Markdown

This shouldn't be made public.

@jstirnaman jstirnaman marked this pull request as draft March 31, 2026 19:36
@jstirnaman jstirnaman added hold off Should not be merged or address yet and removed release:pending Waiting for product release before merging labels Mar 31, 2026
influx-meta is an internal InfluxData engineering/support tool, not
shipped in the InfluxDB Enterprise release. Add draft: true with
cascade to the section index and a DO NOT PUBLISH comment to all
10 pages to prevent accidental publication.

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

Labels

hold off Should not be merged or address yet product:v1-enterprise InfluxDB Enterprise v1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

New influx-meta cleanup-shards command

4 participants