Skip to content

Carry the RC1 tester fixes over to the 1.0 install pages - #85

Merged
guanzhousongmicrosoft merged 4 commits into
documentdb:mainfrom
GuanzhouSong:guanzhousong/rc1-tester-ux
Oct 19, 2026
Merged

guanzhousongmicrosoft merged 4 commits into
documentdb:mainfrom
GuanzhouSong:guanzhousong/rc1-tester-ux

Conversation

@GuanzhouSong

@GuanzhouSong GuanzhouSong commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

RC1 testers (two hands-on runs on clean Ubuntu/Rocky hosts, three source reviews) hit gaps on the release-candidate page. #88 cut that page down to "release candidates have ended", so these fixes would have been lost. The ones that still apply to v1.0-0 now go on the 1.0 pages:

  • Installer: run without sudo, it calls sudo -v. That asks for a password on cloud images whose default user has passwordless sudo, because the %sudo rule still applies. sudo sh documentdb-install.sh avoids it. There is also an unattended example; under sudo the password file must be root-owned, or the installer rejects it.
  • Removal: there were no removal steps. Purging the packages keeps the data, and documentdb-local-reset ships in documentdb-common, so the reset has to run before the purge.
  • db.version() returns the MongoDB compatibility version, not DocumentDB's.
  • Known issue: the health check runs pg_isready as documentdb every 30 s with no database set, so PostgreSQL logs FATAL: database "documentdb" does not exist. Startup also logs one IPv6 accept error. Both code paths are unchanged since RC1, which is where testers saw them.

Dropped: the installer summary's 127.0.0.1 (fixed in 1.0), the zsh-safe container prompt and the mongosh connect step (both already on 1.0 pages), and the #752 --password-stdin workaround (already in the release notes).

Five independent first-time-user runs hit the same walls: the container command needs credentials the page never set, the installer stalls at a sudo password on cloud users, nothing showed how to connect, the 752 workaround read a file that didn't exist, and cleanup had no commands.

Signed-off-by: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com>
Signed-off-by: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com>
@GuanzhouSong GuanzhouSong changed the title Close the gaps RC1 testers hit on the release-candidate page Carry the RC1 tester fixes over to the 1.0 install pages Oct 19, 2026
@guanzhousongmicrosoft
guanzhousongmicrosoft merged commit 1238580 into documentdb:main Oct 19, 2026
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