You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by "zhanglistar (via GitHub)" <gi...@apache.org> on 2026/01/05 01:18:11 UTC
[I] [Doc] https://bookkeeper.apache.org/docs/admin/bookies/autorecovery missing [pulsar]
zhanglistar opened a new issue, #25123:
URL: https://github.com/apache/pulsar/issues/25123
### Search before reporting
- [x] I searched in the [issues](https://github.com/apache/pulsar/issues) and found nothing similar.
### What issue do you find in Pulsar docs?
As title.
### What is your suggestion?
Fix this doc.
### Any reference?
_No response_
### Are you willing to submit a PR?
- [ ] I'm willing to submit a PR!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [Doc] https://bookkeeper.apache.org/docs/admin/bookies/autorecovery missing [pulsar]
Posted by "lhotari (via GitHub)" <gi...@apache.org>.
lhotari commented on issue #25123:
URL: https://github.com/apache/pulsar/issues/25123#issuecomment-3709491736
> Seems wrong url, the correct url is: https://bookkeeper.apache.org/docs/4.16.7/admin/autorecovery.
https://bookkeeper.apache.org/docs/admin/autorecovery/ points to the latest release.
> Please specify the page that references this url, so the repository member could fix this.
exactly. I checked the docs and there's no such reference. It seems that the expectation is that this page would be referenced somewhere in Pulsar docs.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [Doc] https://bookkeeper.apache.org/docs/admin/bookies/autorecovery missing [pulsar]
Posted by "oneby-wang (via GitHub)" <gi...@apache.org>.
oneby-wang commented on issue #25123:
URL: https://github.com/apache/pulsar/issues/25123#issuecomment-3709429480
Version missing in url: https://bookkeeper.apache.org/docs/4.16.7/admin/autorecovery.
Please specify the page that references this url, so the repository member could fix this.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [Doc] https://bookkeeper.apache.org/docs/admin/bookies/autorecovery missing [pulsar]
Posted by "lhotari (via GitHub)" <gi...@apache.org>.
lhotari closed issue #25123: [Doc] https://bookkeeper.apache.org/docs/admin/bookies/autorecovery missing
URL: https://github.com/apache/pulsar/issues/25123
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [Doc] https://bookkeeper.apache.org/docs/admin/bookies/autorecovery missing [pulsar]
Posted by "Annaxs (via GitHub)" <gi...@apache.org>.
Annaxs commented on issue #25123:
URL: https://github.com/apache/pulsar/issues/25123#issuecomment-4333666234
Hi, I'd like to work on this issue. Here's my proposed fix:
---
**Root Cause**
The broken link points to `https://bookkeeper.apache.org/docs/admin/bookies/autorecovery`, which returns 404. The correct URL is
`https://bookkeeper.apache.org/docs/admin/autorecovery/` (the `/bookies/` segment was removed in a BookKeeper docs restructure).
Beyond fixing the broken link, Pulsar currently has no dedicated AutoRecovery administration page of its own. As @lhotari suggested, the right fix is to
create `administration-autorecovery.md` in `apache/pulsar-site`.
---
**Proposed Changes (in `apache/pulsar-site`)**
1. **Create** `site2/docs/administration-autorecovery.md` — a new page covering:
- What AutoRecovery is and why it matters
- How the Auditor and Replication Worker operate
- Enabling/disabling AutoRecovery
- Key configuration properties (`bookkeeper.conf`)
- Monitoring via Prometheus metrics and BookKeeper shell
- Links to the correct BookKeeper AutoRecovery docs and related Pulsar pages
2. **Update** `site2/sidebars.json` — register `administration-autorecovery` under the Administration section (near `administration-bookies`)
---
**Target repo:** `apache/pulsar-site` (not this repo)
**Fixes:** apache/pulsar#25123
I'll open a PR against `apache/pulsar-site` and link it here once ready
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] [Doc] https://bookkeeper.apache.org/docs/admin/bookies/autorecovery missing [pulsar]
Posted by "Annaxs (via GitHub)" <gi...@apache.org>.
Annaxs commented on issue #25123:
URL: https://github.com/apache/pulsar/issues/25123#issuecomment-4369444237
---
Hi everyone! 👋
I've worked on this issue and raised a PR to address it: https://github.com/apache/pulsar-site/pull/1138
What was done:
- Created a new docs/administration-autorecovery.md page in apache/pulsar-site covering:
- AutoRecovery purpose and how it handles under-replicated ledgers
- Auditor and Replication Worker architecture
- Deployment options (embedded vs dedicated nodes)
- Start commands (foreground and daemon)
- Key bookkeeper.conf configuration parameters
- Enable/disable/status shell commands
- Manual recovery CLI commands
- Prometheus metrics for monitoring
- Updated sidebars.json to register the page under the Administration section (after the ZooKeeper & BookKeeper page)
Please review and let me know if any changes are needed. Happy to iterate!
---
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org