Zscaler ZIA (SWG/CASB/FWaaS): How to rollback to the previous image after a failed upgrade
By Sai Kiran Pandrala · reviewed by Sai Kiran Pandrala, Editor Last verified: 2026-05-30
| Vendor | Zscaler |
|---|---|
| Operating system | Zscaler Cloud (ZIA / ZPA / ZDX) |
| Category | Upgrade Failure |
| Skill level | Intermediate to advanced |
| DIY-able? | Yes with CLI access; some scenarios need Zscaler Support + RMA. |
On Zscaler kit the upgrade ritual matters more than the speed. `Admin Portal → Activation` first, `Client Connector → Help → Export Logs` second, then the actual `Cloud-managed; clients (Client Connector / App Connector) update via the cloud`. that order on Zscaler Cloud (ZIA / ZPA / ZDX) saves the most support-case time when something goes wrong on the ZIA (SWG/CASB/FWaaS) unit.
Integrity verification is non-negotiable. Vendor mirrors get corrupted, internal staging servers serve stale files, and the checksum step on Zscaler Cloud (ZIA / ZPA / ZDX) is the only thing standing between you and a chassis that boots to a recovery prompt.
What follows is the safe-rollback variant. If you need an in-place upgrade with zero rollback path, this guide is not it, and frankly that is not a thing you should be doing on production gear.
What this guide covers
Rollback to the previous image after a failed upgrade on a Zscaler ZIA (SWG/CASB/FWaaS) (Zscaler Cloud (ZIA / ZPA / ZDX)).
Step-by-step
- Confirm there's a previous image still on flash.
- Set the boot variable to that previous image.
- Reboot.
- Verify the version is back to the prior release.
- Investigate the upgrade failure separately: do not re-attempt without root cause.
CLI / commands
# Boot recovery prompt: Client Connector logs / App Connector service
# Verify image
Admin Portal → Activation
# Upgrade
Cloud-managed; clients (Client Connector / App Connector) update via the cloud
# Save / commit
Activate (Admin Portal upper-right)
# Rollback
Admin Portal → Activation → Revert
Recovery options
- Boot loader recovery (Client Connector logs / App Connector service)
- Rollback to the previous image with
Admin Portal → Activation → Revert - Force failover to a known-good standby (HA platforms)
Frequently asked questions
Will this work on my specific Zscaler Cloud (ZIA / ZPA / ZDX) version?
The procedure reflects current Zscaler Cloud (ZIA / ZPA / ZDX) behaviour. Older releases may need minor syntax adjustments, use the CLI help (? or tab-completion) to verify.
Should I open a Zscaler Support case immediately?
Open one if you suspect hardware failure or the symptom persists after a maintenance-window reload. Make sure your support entitlement is active first.
Where can I find the Zscaler official documentation?
https://help.zscaler.com. search the product family + feature name.
Is this procedure safe in production?
Test in a lab or maintenance window first. Capture pre-change state so you can roll back.
Related guides
Related fixes
Related guides worth a look while you sort this one out:
- Zscaler Cloud Firewall: How to rollback to the previous image after a failed upgrade
- Zscaler ZDX (Digital Experience): How to rollback to the previous image after a failed upgrade
- Zscaler ZIA (SWG/CASB/FWaaS): How to do an emergency image reload from the boot loader
- Zscaler ZIA (SWG/CASB/FWaaS): How to perform a controlled upgrade with rollback safety net
- Zscaler ZIA (SWG/CASB/FWaaS): How to recover from a corrupted image during upgrade
- Zscaler ZIA (SWG/CASB/FWaaS): How to verify image integrity before activating
References
- Zscaler support portal: https://help.zscaler.com
- Zscaler knowledge base: https://help.zscaler.com
- Zscaler security advisories: https://trust.zscaler.com
- Open a case: https://help.zscaler.com/submit-ticket
Reference material, not professional advice. Validate against your specific Zscaler Cloud (ZIA / ZPA / ZDX) version and test in a non-production environment before applying.
What changed recently?
Fault diagnosis on a Zscaler device goes faster when you map the symptom to a recent change:
- Did firmware update in the last 7 days?
- Did the network (router, ISP, VPN) change?
- Was the device moved physically?
- Did paired devices (phone, hub, app) update?
- Were any accessories swapped in or out?
The answer narrows the root cause to a manageable subset.
Safety + preconditions
Before any work on a Zscaler device:
- Unplug from mains for any internal-access procedure.
- Discharge stored energy (capacitors in PSUs, residual battery charge) per manufacturer guidance.
- Use ESD-safe handling for boards and modules, no carpet, no wool sleeves.
- Avoid moisture; never apply liquids near vents or connectors.
- If you smell smoke, see scorch marks, or feel uneven heat, stop and escalate.
Verification checklist
After applying the fix on your Zscaler device, confirm:
- The original symptom is no longer reproducible.
- Related features (status LEDs, app sync, paired accessories) still work.
- The device responds to a soft reboot without the fault returning.
- Any error codes that were on display have cleared.
- Documentation (your service log, the brand companion app) reflects the change.
Escalation guide
For a Zscaler device, the right escalation depends on impact:
- Cosmetic / minor: log a ticket via the Zscaler app or web portal. Response 1-3 business days.
- Mid-impact: phone support. Have your serial number ready.
- Critical (production down, safety issue): in-person dealer / TAC visit. Bring proof of purchase.
- Out of warranty: third-party repair shop with manufacturer-certified technicians.
More frequently asked questions
Why is this happening on a brand-new unit?
Out-of-box defects do occur. If you've owned the device under 30 days and the symptom persists after a factory reset, escalate to the seller for replacement under DOA terms before opening a manufacturer support case.
What if my model isn't exactly the same revision?
Cross-check the model code on the rating plate against the manufacturer support page. Major firmware generations sometimes shift the menu path; the option is usually under a similarly-named section.
Will the procedure work on the international variant?
Some features and firmware paths are region-locked. Check the model spec sheet to confirm your variant supports the menu option referenced. If you're outside the US/EU, look for the regional support portal.
Can I roll this back if something breaks?
Yes for software-level changes (firmware rollback, config rollback). Hardware changes are usually one-way. Always back up settings before starting.
Are there safer alternatives for non-technical users?
Yes: the manufacturer's self-service troubleshooter (HP Smart, LG ThinQ, Samsung Members, similar) usually walks through the same steps in a guided UI. Use that first if you're not comfortable with menu paths.