Upgrading IPv6 Clusters

All pre-6.5 clusters using the IPv6 address family can be upgraded to Couchbase Server Enterprise Edition 6.5: in some cases, additional steps are required in the upgrade-procedure.

IPv6 Cluster-Upgrade to 6.5

A pre-6.5 Couchbase Server-cluster that is currently using the IPv6 address family can be upgraded to run 6.5 and to continue using IPv6:

  • All IPv6 clusters running a pre-6.5 version of Couchbase Server Enterprise Edition can perform online upgrade as explained in Performing the Rolling Online Upgrade.

  • IPv6 clusters currently running Couchbase Server Enterprise Edition Version 5.5.3 or 6.0.1 or higher can perform offline upgrade as explained in Performing the Rolling Offline Upgrade.

  • IPv6 clusters currently running Couchbase Server Enterprise Edition Version 5.5.0, 5.5.1, 5.5.2, or 6.0.0 can perform offline upgrade as explained in Performing the Offline Upgrade, but must then perform the additional steps described below.

Note that pre-6.5 clusters that are to be upgraded to 6.5, and whose address family is to be changed, should first be upgraded to 6.5, and subsequently be assigned the new address family (since upgrade and address-family change cannot be performed simultaneously). Note also that if a pre-6.5 cluster is not using IPv6 and no address-family change is required, the cluster can be upgraded to 6.5 by either an offline or an online procedure, with its address-family setting remaining unchanged.

Additional Upgrade Steps for Some Clusters

To complete offline upgrade to 6.5 for a 5.5.0, 5.5.1, 5.5.2, or 6.0.0 cluster that has already been running IPv6 and is intended to continue doing so, after completion of the instructions in install:offline-upgrade.adoc, proceed as follows:

  1. Stop Couchbase Server. For instructions, see Start and Stop Couchbase Server.

  2. As either root or couchbase user, enter the following command:

    if [ -e /opt/couchbase/var/lib/couchbase/config/dist_cfg ] && [ ! -s /opt/couchbase/var/lib/couchbase/config/dist_cfg ]; then
      echo "[{preferred_external_proto,inet6_tcp_dist}, {preferred_local_proto, inet6_tcp_dist}]." > /opt/couchbase/var/lib/couchbase/config/dist_cfg;
    fi
  3. Start Couchbase Server.

This concludes the upgrade-process.