About Upgrade Agent
Purpose of the Upgrade Agent in Application Protector.
Upgrading the Application Protector Java
Upgrading the Application Protector Java from version 10.1.0 to any higher version.
Purpose
The AP Java Upgrade feature enables zero‑downtime upgrades of the Protegrity Application Protector Java SDK.
Traditionally, upgrading the SDK required restarting the Java application, resulting in service disruption. The upgrade process removes this requirement by dynamically reloading updated SDK libraries at runtime, ensuring that protection operations continue uninterrupted throughout the upgrade process.
Overview
AP Java Upgrade is implemented through coordination between two primary components:
- Upgrade Agent
- Protector SDK (AP Java)
Upgrade Agent
An external process, installed and run separately from the application, that orchestrates the upgrade. The Upgrade Agent deploys new SDK binaries, upgrades shared companion components, such as RP Agent and Log Forwarder, and signals upgrade availability to running protector instances through a shared metadata.ini metadata file.
Protector SDK for Zero-downtime Upgrade
The AP Java SDK embedded in the customer’s Java application. It continuously monitors metadata.ini for version changes. When an upgrade is detected, the SDK performs a hot reload and upgrades the protector seamlessly without requiring a restart.
Key Terminologies related to Upgrade
| Term | Definition |
|---|---|
| Upgrade Agent | An external process that orchestrates the upgrade lifecycle, including deploying new binaries, upgrading shared components, and coordinating with running protector instances. |
metadata.ini | A shared control file located at /opt/protegrity/upgrader/data/metadata.inithat acts as the communication channel between the Upgrade Agent and the Protector SDK. |
| PID file | A per‑process file located at /opt/protegrity/upgrader/active_processes/<pid>.pid that identifies active protector processes and records their current upgrade state and version. |
| Hot Reload | The process of replacing the active SDK implementation at runtime by loading updated JARs without restarting the Java application. |
Installing the Upgrade Agent
Steps to install the Upgrade Agent for Application Protector.
Setting Up the Upgrade Agent
Configurations required to set up the Upgrade Agent.
AP Java Upgrade and Rollback Examples
Examples for Upgrade and Rollback operations.
Feedback
Was this page helpful?