From 08c9cf50aa3758c67de191f042d7adb6fbdacd2e Mon Sep 17 00:00:00 2001 From: Derek Charles Date: Mon, 10 Mar 2025 18:26:08 +0000 Subject: [PATCH 1/2] Add upgrade notes for 3.x to 3.4.x The default node name in configure.ps1 changed in #4678, from couchdb@localhost to couchdb@127.0.0.1 The same change in default node name (and resulting behaviour) also occurred in "When upgrading from 2.x to 2.1.1", so the upgrade notes for 3.4.x have been updated with the same text. https://docs.couchdb.org/en/stable/whatsnew/2.1.html#upgrade-notes --- src/docs/src/whatsnew/3.4.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/src/docs/src/whatsnew/3.4.rst b/src/docs/src/whatsnew/3.4.rst index 14c5ff30552..aaef1122d61 100644 --- a/src/docs/src/whatsnew/3.4.rst +++ b/src/docs/src/whatsnew/3.4.rst @@ -20,6 +20,24 @@ :depth: 1 :local: +.. _release/3.4.x/upgrade: + +Upgrade Notes +============= + +* When upgrading from 3.x to 3.4.x, if you have not customized your + node name in ``vm.args``, be sure to retain your original ``vm.args`` + file. The default node name has changed from ``couchdb@localhost`` to + ``couchdb@127.0.0.1``, which can prevent CouchDB from accessing existing + databases on the system. You may also change the name option back to the + old value by setting ``-name couchdb@localhost`` in ``etc/vm.args`` by + hand. The default has changed to meet new guidelines and to provide + additional functionality in the future. + + If you receive errors in the logfile, such as + ``internal_server_error : No DB shards could be opened.`` or in Fauxton, + such as ``This database failed to load.`` you need to make this change. + .. _release/3.4.2: Version 3.4.2 From c6b687e396957f55a95309783345124cfebe589e Mon Sep 17 00:00:00 2001 From: Derek Charles Date: Thu, 13 Mar 2025 15:01:34 +0000 Subject: [PATCH 2/2] Add sub-heading to clarify Windows-only applicability --- src/docs/src/whatsnew/3.4.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/docs/src/whatsnew/3.4.rst b/src/docs/src/whatsnew/3.4.rst index aaef1122d61..6f2c4d89320 100644 --- a/src/docs/src/whatsnew/3.4.rst +++ b/src/docs/src/whatsnew/3.4.rst @@ -25,6 +25,9 @@ Upgrade Notes ============= +Windows +------- + * When upgrading from 3.x to 3.4.x, if you have not customized your node name in ``vm.args``, be sure to retain your original ``vm.args`` file. The default node name has changed from ``couchdb@localhost`` to