sdpctl is a command-line tool for managing AppGate Collectives. It supports critical operations such as upgrading and backing up a Collective, as well as several other functions. For the full list of sdpctl capabilities, see the see the documentation hosted in GitHub.
Before upgrading
Before upgrading, complete the following steps:
Note the hostname of your primary Controller. You will connect to its admin interface and may need to reference this Controller if you revert the upgrade.
NOTE
Do not use a load-balanced address or hostname.
sdpctlmust work consistently with the same Controller.Download the CA certificate file from the Controller Certificate Authority page (System > Certificate Authority). This establishes a mutually trusted TLS connection between
sdpctland the Controller when the self-signed certificate is still in use.Create an admin user account for
sdpctlwith the appropriate privileges: Upgrade on the Controller, or Backup on other appliances.Create a policy for the admin user and assign the appropriate Admin role.
Using sdpctl
To use sdpctl:
Download the latest version. This site is not linked to AppGate ZTNA versions. Check the GitHub page before using
sdpctlto verify whether a newer version is available.Copy the relevant version of
sdpctlto the system on which it will run. This system must be outside the AppGate ZTNA Collective.