Update from 1.3.4 to 1.4.0/1.4.0-H1

You can update your existing CDP Private Cloud Data Services 1.3.4 to 1.4.0 or 1.4.0-H1 without requiring an uninstall.

In Cloudera Manager, navigate to CDP Private Cloud Data Services 1.3.4 and click . Click Update.
On the Getting Started page, you can select the Install method - Air Gapped or Internet and proceed.

Internet install method

Air Gapped install method

Click Continue.
On the Collect Information page, click Continue.
On the Install Parcels page, click Continue.
On the Update Progress page, you can see the progress of your update. Click Continue after the update is complete .
note
The upgrade might occasionally fail with error messages or conditions such as the following:

Error message: Unable to start ECS server role on ECS server host.
Workaround:

SSH to the affected host.

Search for the rke2-killall.sh script and run it.

Start the ECS server role on the host from Cloudera Manager.

Resume the upgrade by running any command that was affected by the upgrade failure.

Error message: Code: 503. Errors: * Vault is sealed.
Workaround: Longhorn repairs by itself. Wait until the Longhorn repair is complete.

Error message: During the following step: Execute command Install Tolerations Webhook on service ECS-3 the Upgrade progress page mentions a failure waiting for kube-proxy to come up.
Workaround:

Log in using ssh to one of the ECS Server nodes and run the following command:
/var/lib/rancher/rke2/bin/kubectl get nodes
The output will look similar to the following:
NAME STATUS ROLES AGE VERSION ecs-abc-1.vpc.myco.com Ready control-plane,etcd,master 4h50m v1.21.8+rke2r2 ecs-abc-2.vpc.myco.com NotReady <none> 4h48m v1.20.8+rke2r1 ecs-abc-3.vpc.myco.com Ready <none> 4h48m v1.21.8+rke2r2 ecs-abc-4.vpc.myco.com NotReady <none> 4h48m v1.20.8+rke2r1 ecs-abc-5.vpc.myco.com NotReady <none> 4h48m v1.20.8+rke2r1
If any of the version numbers in the last column are lower than the expected version, reboot those nodes. (For example, v1.20.8 in the output above.)

In the Command Output window, in the step that failed, click Resume.

Upgrade hangs on the Execute command Post upgrade configuration on service ECS step for more than an hour.
Workaround:

Log in to one of the ECS server nodes and run the following command:
kubectl get nodes
The output looks similar to the following:
NAME STATUS ROLES AGE VERSION ecs-abc-1.vpc.myco.com Ready control-plane,etcd,master 3h47m v1.21.11+rke2r1 ecs-abc-2.vpc.myco.com NotReady <none> 3h45m v1.21.8+rke2r2 ecs-abc-3.vpc.myco.com NotReady <none> 3h45m v1.21.8+rke2r2 ecs-abc-4.vpc.myco.com NotReady <none> 3h45m v1.21.8+rke2r2
If you any nodes display a status of NotReady, click the Abort button in the command output window.

Reboot all nodes showing NotReady.

Check the node status again as shown above. After all the nodes show Ready, click the Resume button in the command output window to continue with the upgrade.
After the update is complete, the Summary page appears. You can now Launch CDP Private Cloud from here.
If you see a Longhorn Health Test message about a degraded Longhorn volume, wait for the cluster repair to complete.

Or you can navigate to the CDP Private Cloud Data Services page and click Open CDP Private Cloud Data Services.

CDP Private Cloud Data Services opens up in a new window.

If the upgrade stalls, do the following:
1. Check the status of all pods by running the following command on the ECS server node:
```
kubectl get pods --all-namespaces 
```
2. If there are any pods stuck in “Terminating” state, then force terminate the pod using the following command:
```
kubectl delete pods <NAME OF THE POD> -n <NAMESPACE> --grace-period=0 —force 
```
  If the upgrade still does not resume, continue with the remaining steps.
3. In the Cloudera Manager Admin Console, go to the ECS service and click Web UI > Storage UI.
  The Longhorn dashboard opens.
4. Check the "in Progress" section of the dashboard to see whether there are any volumes stuck in the attaching/detaching state in. If a volume is that state, reboot its host.
Upgrade failure with Cloudera's public registry
On installation of CDP Private Cloud Data Services 1.3.4, the user can use an embedded registry or Cloudera's public registry. Upgrades using Cloudera's public registry will fail.
Upgrade is not possible in this scenario. If an upgrade was attempted, activating the 1.3.4 parcel will restore the cluster.