From 6aa53134d078dd01095270b5bd62b1f4ab5f7242 Mon Sep 17 00:00:00 2001 From: Karl Cardenas <29551334+karl-cardenas-coding@users.noreply.github.com> Date: Fri, 13 Sep 2024 12:25:14 -0700 Subject: [PATCH] docs: PLT-1393 (#3910) * docs: PLT-1393 * docs: vale feedback * docs: Apply suggestions from code review Co-authored-by: Adelina Simion <43963729+addetz@users.noreply.github.com> --------- Co-authored-by: Adelina Simion <43963729+addetz@users.noreply.github.com> --- .../release-notes/known-issues.md | 2 + .../troubleshooting/vmo-issues.md | 45 +++++++++++++++++++ 2 files changed, 47 insertions(+) diff --git a/docs/docs-content/release-notes/known-issues.md b/docs/docs-content/release-notes/known-issues.md index 3cbd14c7a3..4e0dc8dc77 100644 --- a/docs/docs-content/release-notes/known-issues.md +++ b/docs/docs-content/release-notes/known-issues.md @@ -16,6 +16,8 @@ The following table lists all known issues that are currently active and affecti | Description | Workaround | Publish Date | Product Component | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------------------- | +| Palette OVA import operations fail if the VMO cluster is using a storageClass with the volume bind method `WaitForFirstConsumer`. | Refer to the [OVA Imports Fail Due To Storage Class Attribute](../troubleshooting/vmo-issues.md#scenario---ova-imports-fail-due-to-storage-class-attribute) troubleshooting guide for workaround steps. | September 13, 2024 | Palette CLI, VMO | +| Persistent Volume Claims (PVCs) metadata do not use a unique identifier for self-hosted Palette clusters. This causes incorrect Cloud Native Storage (CNS) mappings in vSphere, potentially leading to issues during node operations and cluster upgrades. | Refer to the [Troubleshooting section](../troubleshooting/enterprise-install.md#non-unique-vsphere-cns-mapping) for guidance. | September 13, 2024 | Self-hosted | | Third-party binaries downloaded and used by the Palette CLI may become stale and incompatible with the CLI. | Refer to the [Incompatible Stale Palette CLI Binaries](../troubleshooting/automation.md#scenario---incompatible-stale-palette-cli-binaries) troubleshooting guide for workaround guidance. | September 11, 2024 | CLI | | The AWS CSI pack has a [Pod Disruption Budget](https://kubernetes.io/docs/tasks/run-application/configure-pdb/) (PDB) that allows for a maximum of one unavailable pod. This behavior causes an issue for single-node clusters as well as clusters with a single control plane node and a single worker node where the control plane lacks worker capability. [Operating System (OS) patch](../clusters/cluster-management/os-patching.md) updates may attempt to evict the CSI controller without success, resulting in the node remaining in the un-schedulable state. | If OS patching is enabled, allow the control plane nodes to have worker capability. For single-node clusters, turn off the OS patching feature. | September 4, 2024 | Cluster, Packs | | On AWS IaaS Microk8s clusters, OS patching can get stuck and fail. | Refer to the [Troubleshooting](../troubleshooting/nodes.md#os-patch-fails-on-aws-with-microk8s-127) section for debug steps. | August 17, 2024 | Palette | diff --git a/docs/docs-content/troubleshooting/vmo-issues.md b/docs/docs-content/troubleshooting/vmo-issues.md index e336603bdc..749f7cdeee 100644 --- a/docs/docs-content/troubleshooting/vmo-issues.md +++ b/docs/docs-content/troubleshooting/vmo-issues.md @@ -59,3 +59,48 @@ Clusters with the VMO pack may experience VMs getting stuck in a continuous migr changes to take effect. ::: + +## Scenario - OVA Imports Fail Due To Storage Class Attribute + +If you are importing an OVA file through the Palette CLI +[VMO command](../automation/palette-cli/commands/vmo.md#import-ova), `import-ova`, and the import fails. It may be due +to the VMO cluster using a `storageClass` with an unsupported volume bind mode, such as +`volumeBindingMode: WaitForFirstConsumer`. To address this issue, use the following steps to update the `storageClass` +attribute for the VMO cluster. + +### Debug Steps + +1. Log in to [Palette](https://console.spectrocloud.com) + +2. Navigate to the **left Main Menu** and select **Clusters**. + +3. Select your VMO cluster to access the cluster details page. + +4. Download the cluster's kubeconfig file by clicking the URL for the **Kubeconfig File**. For additional guidance, + check out the [Kubeconfig](../clusters/cluster-management/kubeconfig.md) guide. + +5. Open a terminal session and export the kubeconfig file to your terminal session. + + ```bash + export KUBECONFIG=/path/to/your/kubeconfig + ``` + +6. Use [kubectl](https://kubernetes.io/docs/reference/kubectl/) to create a new _StorageClass_ with + `volumeBindingMode: Immediate`. Use the following command to create the new _StorageClass_. + + ```bash + cat <