Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. Cohesity Cloud Scale Technology Manual Deployment Guide for Kubernetes Clusters
  3. Section IV. Maintenance
  4. Troubleshooting
  5. Troubleshooting AKS and EKS issues
  6. NetBackup Snapshot Manager auto-registration fails after successful Cloud Scale deployment
Cohesity Cloud Scale Technology Manual Deployment Guide for Kubernetes Clusters

NetBackup Snapshot Manager auto-registration fails after successful Cloud Scale deployment

NetBackup Snapshot Manager deploys successfully in a Cloud Scale environment, but does not auto-register with the NetBackup primary server.

On a fresh NetBackup Snapshot Managerdeployment, all Kubernetes resources may appear healthy. The environment and cpServer custom resources show a Success state, and all flexsnap pods are in Running state. However, the Snapshot Manager does not appear in the NetBackup primary server's list of registered Snapshot Managers.

This issue occurs when one or more flexsnap container images take longer than expected to pull during the first deployment. If the image pull exceeds the internal 10‑minute health‑check window, the operator marks the deployment as failed before reaching the Snapshot Manager registration step. As a result, registration is skipped even though the deployment completes successfully.

Run the following commands to confirm the issue. If one of the following command displays the failure indicators, the deployment is affected.

  • Check deployment configmap status:

    kubectl get cm flexsnap-deployment-conf-<cpserver-name> -n <env-namespace> -o yaml | grep -i status

    Failure indicator:

    STATUS: Failed
  • Check cpServer registration annotations:

    kubectl get cpserver <cpserver-name> -n <env-namespace> -o jsonpath='{.metadata.annotations}{"\n"}'

    Failure indicator:

    <empty output>

Workaround:

Remove and recreate the cpServer configuration by updating the environment custom resource. This forces the operator to re-run the full install workflow. Because the container images are already cached from the first attempt, the second run completes within the health‑check window and successfully performs auto-registration.

  1. Back up the environment configuration:

    • Save a copy of the environment custom resource using the following command:

      kubectl get environment <environment-name> -n <env-namespace> -o yaml > environment-backup.yaml

    • Verify that the flexsnap operator is running using the following command:

      kubectl get pods -n netbackup-operator-system | grep flexsnap-operator

  2. Remove the cpServer specification:

    Edit the environment custom resource using the following command:

    kubectl edit environment <environment-name> -n <env-namespace>

    Delete the entire spec.cpserver section. Save and exit.

  3. Wait for cpServer cleanup to complete.

    The operator will run the uninstall path on the cpServer. This scales down and removes flexsnap-* resources.

  4. Re-add the cpServer specification:

    Edit the environment custom resource again using the following command:

    kubectl edit environment <environment-name> -n <env-namespace>

    Reinsert the spec.cpserver section using the values from environment-backup.yaml file. Save and exit.

  5. Wait for cpServer reinstall to complete and verify that cpServer state is Success:

    kubectl get cpserver -n <env-namespace>

Verification:

After redeployment completes, confirm that Snapshot Manager registration is successful.

  1. Verify deployment configmap status:

    kubectl get cm flexsnap-deployment-conf-<cpserver-name> -n <env-namespace> -o yaml | grep -i status

    Expected output:

    STATUS: Success
  2. Verify cpServer registration annotations:

    kubectl get cpserver <cpserver-name> -n <env-namespace> -o jsonpath='{.metadata.annotations}{"\n"}'

    Expected output:

    netbackup.veritas.com/registration-status: Success

Feedback

Was this page helpful?
Previous

Cloud Scale upgrade shows environment failed or partially ready

Next

No usage report is available to download from the Web UI

Feedback

Was this page helpful?