Deleting VSatellites
Table of Contents
Expand all | Collapse all
-
- Activate Next-Generation Trust Security
-
-
- 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
-
-
-
-
- Create an F5 BIG-IP LTM machine
- Create a Microsoft Azure Private Key Vault 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
-
- 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
-
-
- 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
- Notification Center overview
- Domain-based validation for external emails
- Managing user 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.