Deleting VSatellites
Table of Contents
Expand all | Collapse all
-
- Activate Next-Generation Trust Security
-
-
- Configure Akamai Connection
- Configure AWS Connection
- Configure Azure Key Vault Connection
-
- Workload Identity Federation Authentication
- Workload Identity Federation - Azure Identity Provider Authentication
- Next-Gen Trust Security Generated Key Authentication
- User Permissions
- Workload Identity Federation Authentication
- Next-Gen Trust Security Generated Key Authentication
- User Permissions
- Supported OIDC Claims
-
-
-
- Working with the Built-in CA
- Add AWS Public CA
- Add AWS Private CA
- Add DigiCert One Certificate Authority
- Add Entrust
- Add GlobalSign Atlas
- Add GlobalSign MSSL
- Add GoDaddy
- Add Google Cloud Private CA
- Add a HID PKIaaS CA
- Add Certificate Manager - Self-Hosted
- Set Up an OpenSSL Certificate Authority Connector
- Create a Sectigo Certificate Manager Certificate Authority
- Add Zero Touch PKI
- Set Up Certificate Expiration Notifications
- Using a Custom DNS Provider
-
-
-
-
- Create an F5 BIG-IP LTM Machine
- Create a Microsoft Azure Private Key Vault Machine
- Create a Microsoft Azure Application Registration Machine
- Create a Microsoft IIS Machine
- Create a Microsoft Windows (PowerShell) Machine
- Create a Microsoft SQL Server Machine
- Create a Common KeyStore Machine
- Create a Citrix ADC Machine
- Create an Imperva WAF Machine
- Create a VMware NSX Advanced Load Balancer (AVI) Machine
- Create an A10 Thunder ADC Machine
- Create a Cloudflare Machine
- Create Kemp Virtual LoadMaster Machine
- Create a Palo Alto Panorama Machine
- Create a Radware Alteon Machine
-
- Provision to an F5 BIG-IP LTM
- Provision to a Microsoft Azure Private Key Vault
- Provision to Microsoft IIS
- Provision to Microsoft Windows (PowerShell)
- Provision to Microsoft SQL Server
- Provision to a Common KeyStore
- Provision to a Citrix ADC
- Provision to an Imperva WAF
- Provision to VMware NSX Advanced Load Balancer (AVI)
- Provision to an A10 Thunder ADC
- Provision to Cloudflare
- Provision to a Kemp Virtual LoadMaster
- Provision to Palo Alto Panorama
- Provision Certificates to Radware Alteon
-
-
- 47-Day Validity Readiness TLS Certificates dashboard
- About the Certificate Inventory
- Managing Certificate Lifecycle Settings
- Reissuing Certificates in Next-Gen Trust Security
- Downloading Certificates, Certificate Chains, and Keystores
- Retiring, Recovering, and Deleting Certificates
- Finding Certificates in the Certificate Inventory
- Importing Certificates from a CA Using EJBCA
- Domain-Based Validation for External Emails
-
- Create a Workload Identity Management or Discovery Agent Built-in Account
- Create an OCI Registry Built-in Account
- Create a Certificate Manager - Self-Hosted Built-in Account
- Create a Scanafi Built-in Account
- Toggling a Built-in Account on or Off
- Editing Built-in Accounts
- Deleting Existing Built-in Accounts
- Renew Existing Built-in Accounts
- Troubleshooting
Deleting VSatellites
When you need to retire an existing VSatellite, you can delete it from the VSatellites page.
To delete a VSatellite, you must delete it within Next-Gen Trust Security and then remove the binaries from the file system where it is installed.
Warning: Deleting the very last VSatellite permanently deletes all associated services and the VSatellite data encryption key (DEK), which contains all related keys and credentials. Learn more
Important: A backup DEK is not sufficient for recovery if the last VSatellite is deleted. Recovery requires that at least one VSatellite entry remains in your Next-Gen Trust Security account.
Important: Deleting VSatellites that have existing services running on them can cause service outages. Before deleting a VSatellite, reassign any associated services to a different VSatellite.
If you no longer need the services, you can delete the VSatellite without reassigning them.
Reassign Existing Services to a Different VSatellite
- Sign in to Next-Gen Trust Security.
- Click System Settings > Services.
- In the left pane, click the service you want to reassign.
- Click the Administration tab.
- In the VSatellite section, click the field and select a different VSatellite.
- Click Save.
Repeat these steps for every service running on the VSatellite you want to delete.
Delete a VSatellite from Next-Gen Trust Security
- Click System Settings > Services.
- Select the VSatellite you want to delete and click Delete.
- When prompted, click Delete to confirm.
- Log in to Next-Gen Trust Security.
- Click Settings > VSatellites.
- Select the VSatellite you want to delete and click Delete.
- When prompted, select I understand the risks of deleting the VSatellite, then click Delete VSatellite to confirm.
Remove VSatellite Binaries
After deleting a VSatellite in Next-Gen Trust Security, remove the VSatellite binaries from the server where it was installed.
Run the following command from a terminal:
sudo ./vsatctl uninstall
Why are root privileges required?The vsatctl uninstall command deletes k3s from /usr/local/bin, which is owned by the root user.
If you installed VSatellite on RHEL, Oracle, or Rocky Linux, the vsatctl uninstall command removes the k3s-selinux RPM package, which requires root privileges.
If you are already logged in as the root user, you can omit the sudo command.
Tip: See what else you can do using vsatctl.