>
    Strata Copilot
    Understand Error Scenarios
    Focus
    Download PDF
    Focus
    1. Home
    2. Prisma SD-WAN
    3. Tech Support Dump Utility
    4. Understand Error Scenarios
    Download PDF
    Prisma SD-WAN

    Understand Error Scenarios

    Table of Contents

    Understand Error Scenarios

    Understand the errors you may face when deploying On-Premises Controller for Prisma SD-WAN.
    Where Can I Use This?What Do I Need?
    • Prisma SD-WAN
    • Prisma SD-WAN license
    Understand the various errors you may face when deploying On-Premises Controller for Prisma SD-WAN.
    • Installation Issue
    • Pre-check Validation Failed
    • Permission-related Issue
    • User Account Issue
    • Device-related Issue
    • Image Download and Signing Issues
    • Password-related Issues
    Installation Issue
    The installation fails due to Ubuntu downloading some OS packages. The workaround is to disable the internet connection when installing the VM and OS. If that can’t be done, use a dummy local source to prevent updates to OS packages, instead of using Ubuntu sources for package installation. If the installer fails to bring up the user interface, execute the following command and retrigger the installation using the onprem_installer_<6.2.3.23>.sh command:
    sed -i '/^libssl-dev.*/d' /home/ubuntu/onprem/controller_manage/prep_host/20.04/cnc_packages.txt sudo apt-get install libxml2=2.9.10+dfsg-5ubuntu0.20.04.5 --allow-downgrades sudo xargs apt-get install -y --allow-downgrades < /home/ubuntu/onprem/controller_manage/prep_host/20.04/cnc_packages.txt sudo xargs apt-get install -y --allow-downgrades < /home/ubuntu/onprem/controller_manage/prep_host/20.04/nginx_packages.txt
    Pre-check Validation Failed
    If the minimum validation requirements of RAM and disk space are not meant, you will get a validation failed notification.
    ~/onprem/prep_host 
            ##### OPS UI started 
            ##### ##### open https://192.168.122.39:9443/ ##### 
            6.1.2.8/build-deploy/onprem_v2/install_scripts/controller_install.py 
            6.1.2.8/build-deploy/onprem_v2/install_scripts/controller_verify.py 
            Triggering pre-check validations for controller installation... 
            Error: Pre-check validation failed: Minimum required RAM memory 64 GB, 
            current RAM memory is 31.558250496 GB 
            Upgrade the instance to have minimum RAM memory 64 GB 
            ubuntu@ubuntu:~$
    Check the minimum hardware requirements for your deployment.
    Permission-related Issue
    If you don’t have sudo permission, you may not be able to proceed with the installation.
    ubuntu@perf-onprem:~$ ./onprem_installer _<6.2.3.23>.sh Self Extracting Installer For Prisma SD-WAN Onprem Controller Error: Current user does not have sudo permissions or sudo is not passwordless. Please provide sudo permissions (passwordless) to proceed with the installation
    Check user permissions and proceed with the installation.
    User Account Issue
    If you are not logged in as user name ubuntu when installing the on-premises controller, you may get an error that the Ubuntu user is not found. User Ubuntu should be logged in to trigger the installation.
    Device-related Issue
    If you are unable to claim the device, check the connectivity to the controller. If the TCP ping is timed out, check the firewall policy or the controller status.
    Image Download and Signing Issues
    Image signing is triggered before the installation and the installation proceeds only after the image verification is done. If the verification fails, you will get an error message suggesting that the pre-check verification has failed and you will not be able to continue.
    Restart the installation from scratch. Cleanup of the previous installation is part of the re-installation.
    Password-related Issues
    If you forget or lose the password, delete the existing user and recreate the user with the same credentials as before on Operator console > User Management.

    © 2026 Palo Alto Networks, Inc. All rights reserved.