>
    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
    The installation may fail if the VM has internet access and Ubuntu attempts to download updated OS packages that conflict with the versions required by the installer. To prevent this:
    • Preferred: Deploy the VM in an isolated network environment without internet access during the installation.
    • Alternative: Configure a local or offline package source instead of public Ubuntu repositories to prevent package updates.
    If the installer UI does not start, execute the following commands individually in the order shown, then retry the installation:
    These commands downgrade specific system packages to versions pinned for the controller installer. Run them only on the supported OS version (Ubuntu 20.04) and only when directed by Palo Alto Networks support. Running --allow-downgrades on an unsupported OS version may introduce dependency instability or break other applications.
    sudo 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
    Retry the installation using the appropriate installer package:
    ./onprem_installer_6.2.3.23.sh
    The installer filename follows the format onprem_installer_<version>.sh. Replace <version> with the actual version string from your downloaded software bundle.
    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.2.3/build-deploy/onprem_v2/install_scripts/controller_install.py 
            6.2.3/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_<version>.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 ensure the ubuntu user has passwordless sudo access before proceeding 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.