Focus

On-Premises Controller for Prisma-SD-WAN Deployment Guide

Understand Error Scenarios

Table of Contents

Understand Error Scenarios

Understand the errors you may face when deploying On-Premises Controller for Prisma SD-WAN.

Understand the various errors you may face when deploying On-Premises Controller for Prisma SD-WAN.

Installation Issue
Precheck 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

Precheck 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.

Tech Support Dump Utility