When you add additional storage capacity, a new feature, or updated customer information, you may be required to update the Swarm license file.
All new license files must be issued by your Sales representative to ensure that they have an electronic signature that is recognized and approved by Swarm.
Important
When updating the license file on a running cluster, be careful to match the path and filename that is defined in the license.url setting in the configuration.
How to update the license
The default location is the caringo directory of the local node's USB drive or centralized configuration server.
- If you are running CSN 8.3, upload the license using the CSN Console.
- If you are running Platform Server, upload the license using either the Swarm UI (Settings > License) or the CLI
platform upload licensecommand.
How Swarm validates the license
Swarm checks the license file every 15 minutes.
- If the file is updated, Swarm validates the license and updates the customer information and/or licensed capacity as necessary. On success, an announcement appears in the syslog and the UI.
- If a license update fails to validate a new license file, the cluster nodes reports a critical error in the syslog and the UI.
- If an update fails with a validation error, Swarm continues to use the previous license file until the validation error is corrected.
- If the license file is located on an HTTP server that is not available when Swarm starts, Swarm analyzes the file for updates when it becomes available. Swarm may publish a corresponding update announcement in the syslog and the UI, even if the file itself has not changed.