License Installation Guide
This guide provides step-by-step instructions for installing or upgrading the MooseFS Pro license in your MooseFS Cluster.
To ensure the standardization of license file naming conventions, please use the default mfslicence.bin file for your setup.
License installation in an empty cluster
To install the license in a brand new MooseFS Pro cluster, you need to:
- Place the
mfslicence.binfile in the MooseFS master configuration directory (default/etc/mfs). - Run the masters.
You will not be able to run a MooseFS 4.x cluster without a license, so the above procedure is the only one possible with a new cluster in this version. MooseFS 5.x has a default test license built in, so in order to set up a fresh 5.x cluster, you can either follow the above procedure (place the license and only then run the masters), or you can run the masters first and then install your new license by following the upgrade procedure.
License upgrade in a working cluster
Always initiate the execution of all steps related to license upgrade on Master Follower servers, then run it on Master Leader at the final stage!
It is important to always run commands in a one-by-one manner, not in parallel on all servers!
If you run a license upgrade on a cluster, check the LICENCE_FILENAME variable entry in the mfsmaster.cfg file to avoid misconfiguration. It is also possible that your previous license file had a .key or a different extension.
THE PROCEDURE
In order to correctly upgrade the license on the MooseFS Pro cluster, please follow the steps below. Execute these steps one by one on each Master Follower:
1. Place the new license file
Place the new mfslicence.bin file in the MooseFS master configuration directory (default /etc/mfs).
2. Reload the master configuration
Reload MooseFS master configuration by executing mfsmaster reload command twice. If your master configuration file has a non-standard path (default is /etc/mfs/mfsmaster.cfg) use the -c switch, followed by the full path of your configuration file.
3. Check the logs
Check the most recent entries of the mfsmaster process in your operating system logs, confirming that no errors are logged!
4. Verify the license is loaded
Verify that the license key is loaded correctly. Run application mfslicinfo X.X.X.X with the IP address of the currently reloaded Master Server. The output data should show the information of the license you purchased. For example:
$ mfslicinfo 10.0.0.21
+---------------------------------------+
| Master version : 4.59.2 PRO |
| Licence ID : CB2D43092E254989 |
| Issuer : Saglabs SA |
| Client : MyCompany |
| cluster : MainStorage |
| Type : COMMERCIAL |
| Max version : 4.x |
| Expires : never |
| Max raw data usage : 20 TiB |
+---------------------------------------+
5. Repeat on the Leader
After you've finished the license upgrade procedure on all Follower Masters, execute the same procedure on the Leader Master.
FINAL CHECK
After you've updated the license on all Master servers (Followers and Leader), perform the final check: run mfslicinfo mfsmaster. Substitute the name mfsmaster with your master qualified domain if you use a different master name. The tool will resolve the master name using DNS and will download the license info from all masters. If the license upgrade was done correctly and all masters have the same license information, this information will be displayed by the tool. If any masters differ, the tool will display all licenses you have loaded, with information about which license is loaded on which master (which IP). If you see any discrepancies, you need to verify the configuration on masters with incorrect license info.
At this point, the License Key properties listed in your MooseFS Pro GUI/CLI, and the first quota on the list in the Quotas tab, should reflect purchased values.
In order to verify the installed license file on a cluster, we provide an additional application mfslicinfo. This application is only available in official packages with the latest releases of MooseFS 5.x. In order to guarantee backwards compatibility with earlier MooseFS versions, the application is also shipped inside the license packet.