A newer version of this documentation is available.

View Latest

Upgrade an IPv6 Cluster

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

      IPv6 Cluster-Upgrade to 7.0+

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

      • All IPv6 clusters running a pre-7.0 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 6.0.1 or higher can perform offline upgrade as explained in Upgrade an Offline Cluster.

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

      Note that pre-7.0 clusters that are to be upgraded to 7.0+, and whose address family is to be changed, should first be upgraded to 7.0+, and subsequently be assigned the new address family (since upgrade and address-family change cannot be performed simultaneously). Note also that if a pre-7.0 cluster is not using IPv6 and no address-family change is required, the cluster can be upgraded to 7.0+ 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 7.0+ for a 6.0.0 cluster that has already been running IPv6 and is intended to continue doing so, after completion of the instructions in Performing the Offline Upgrade, proceed as follows:

      1. Stop Couchbase Server. For instructions on stopping a server installed by the standard, package-based procedure, see Start and Stop Couchbase Server. For instructions on stopping a server installed by the non-root procedure, see Non-Root Install and Upgrade, in the section Stop, Start, and Get Status.

      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.