Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-4737

Document how a user should perform an offline non-root upgrade.

    XMLWordPrintable

Details

    • 1

    Description

      Background
      The vbucket database file format is effectively changing in mad-hatter, the mad-hatter KV-engine will refuse to warm-up if the datafiles are found to be in the "old" format.

      The file-format change though is handled automatically

      • online upgrade, as data moves about via rebalance it will be written in the new format.
      • offline upgrade, the installer runs "cbupgrade" before starting couchbase. This is a script which will do the conversion

      Issue

      We document how to perform a non-root install, but not the upgrade.

      When we do the non-root install, the cbupgrade script is not executed, which is fine for a brand new install, however the cbupgrade script will need running if upgrading to mad-hatter.

      I tried myself to do an offline-non-root upgrade but could not make it work without losing the node's config.

      I don't know if there is a correct set of steps which needs documenting or it could be that offline non-root upgrade isn't possible/supported (which should be made clear in the non-root install)

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          jwalker Jim Walker created issue -
          jwalker Jim Walker made changes -
          Field Original Value New Value
          Description *Background*
          The vbucket database file format is effectively changing in mad-hatter, the mad-hatter KV-engine will refuse to warm-up if the datafiles are found to be in the "old" format.

          The file-format change though is handled automatically

          * online upgrade, as data moves about via rebalance it will be written in the new format.
          * offline upgrade, the installer runs "cbupgrade" before starting couchbase. This is a script which will do the conversion

          *Issue*

          We document how to perform a non-root install, but not the upgrade.

          When we do the non-root install, the cbupgrade script is not executed, which is fine for a brand new install, however the cbupgrade script will need running if upgrading.

          I tried to do a offline non-root upgrade but failed, if I follow the install instructions to overlay the new package over the installed data it resets the cluster config... luckily the database files were retained, but I lost all config (buckets/users etc...)

          I don't know if there is a correct set of step here which needs documenting or it could be that offline non-root upgrade isn't possible/supported (which should be made clear in the non-root install)
          *Background*
          The vbucket database file format is effectively changing in mad-hatter, the mad-hatter KV-engine will refuse to warm-up if the datafiles are found to be in the "old" format.

          The file-format change though is handled automatically

          * online upgrade, as data moves about via rebalance it will be written in the new format.
          * offline upgrade, the installer runs "cbupgrade" before starting couchbase. This is a script which will do the conversion

          *Issue*

          We document how to perform a non-root install, but not the upgrade.

          When we do the non-root install, the cbupgrade script is not executed, which is fine for a brand new install, however the cbupgrade script will need running if upgrading to mad-hatter.

          I tried myself to do an offline-non-root upgrade but could not make it work without losing the node's config.

          I don't know if there is a correct set of steps which needs documenting or it could be that offline non-root upgrade isn't possible/supported (which should be made clear in the non-root install)
          amarantha.kulkarni Amarantha Kulkarni (Inactive) made changes -
          Assignee Amarantha Kulkarni [ amarantha.kulkarni ] Eric Schneider [ eric.schneider ]
          amarantha.kulkarni Amarantha Kulkarni (Inactive) made changes -
          Fix Version/s 6.5 Milestone 1 [ 16654 ]
          amarantha.kulkarni Amarantha Kulkarni (Inactive) made changes -
          Fix Version/s to-be-triaged [ 16762 ]
          brett19 Brett Lawson made changes -
          Story Points 1
          eric.schneider Eric Schneider (Inactive) made changes -
          Fix Version/s 6.5.x Doc Updates [ 16770 ]
          Fix Version/s 6.6.x Doc Updates [ 17053 ]
          Fix Version/s Mad Hatter [ 15119 ]
          Fix Version/s 6.5 Milestone 1 [ 16654 ]
          Fix Version/s to-be-triaged [ 16762 ]
          Affects Version/s Mad Hatter [ 15119 ]
          eric.schneider Eric Schneider (Inactive) made changes -
          Resolution Won't Do [ 10000 ]
          Status Open [ 1 ] Closed [ 6 ]

          People

            eric.schneider Eric Schneider (Inactive)
            jwalker Jim Walker
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty