3.6. Managing Virtuozzo Storage Licenses¶
This section describes the process of managing Virtuozzo Storage licenses. You will learn to do the following:
- Install a new license for a Virtuozzo Storage cluster
- Update the installed license
- View the installed license contents
- Check the current license status
3.6.1. Obtaining the Hardware Node ID¶
The Hardware Node ID (HWID) is required to purchase a Virtuozzo Storage license. You can obtain the HWID with the
vstorage stat --license-hwid command. For example:
# vstorage -c stor1 stat --license-hwid ... 3F96.DFF2.EAF6.CE86.DD49.786C.DC01.3D53
A Virtuozzo Storage Hardware Node ID is not the same as a Virtuozzo Hardware Node ID. For details on how to obtain a Virtuozzo HWID, see the Virtuozzo User’s Guide.
3.6.2. Installing the License¶
Along with installing Virtuozzo licenses on all clients in a cluster, you need to install a separate license to start using the Virtuozzo Storage functionality. One license is required per cluster. You can install the license from any server participating in the cluster: an MDS server, a chunk server, or a client.
To install the license, use the
vstorage load-license command:
# vstorage -c stor1 load-license -p XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX
If you have obtained the license in the form of a file, you can install it by using the
-f option instead of
-p and specifying the full path to the license file:
# vstorage -c stor1 load-license -f /etc/storlicense
3.6.3. Updating the License¶
In Virtuozzo, you can use the
vstorage update-license command to update the license currently installed on your server. When executed, the utility connects to the Key Authentication (KA) server, retrieves a new license, downloads it to the server, and installs it there.
To update a license, do the following:
- Make sure that the server where you want to update the license is connected to the Internet.
- Run the
vstorage update-licensecommand to update the license.
For example, to update a license installed in the
pcs1 cluster, execute this command:
# vstorage -c pcs1 update-license
vstorage obtains a new license from the default KA server. However, you can explicitly specify what KA server to use by passing the
--server option to the command:
# vstorage -c pcs1 update-license --server ka.server.com
Once you run the command,
vstorage will connect to the KA server with the hostname of
ka.server.com, download a new license, and install it on your server.
3.6.4. Viewing the License Contents¶
You can use the
vstorage view-license command to view the information on the license currently installed in your cluster. When executed, the utility processes the license and shows its contents on the screen. A sample output of
vstorage view-license is given below:
# vstorage -c stor1 view-license HWID: XXXX.XXXX.XXXX.XXXX.XXXX.XXXX.XXXX.XXXX PCSSTOR status="ACTIVE" version=1.0 expiration="08/24/2012 19:59:59" graceperiod=3600 key_number="PCSS.XXXXXXXX.XXXX" platform="Linux" product="PCSS" gracecapacity=5 autorecovery=0 autorebalance=0 snapshots=1 capacity=500 replicas=5
The main license parameters are explained in the table below.
|status||License status. For details, see Checking the License Status (p. 46).|
|version||Version of Virtuozzo Storage for which the license was issued.|
|expiration||License expiration date and time.|
|graceperiod||Period, in seconds, during which Virtuozzo Storage continues functioning after the license has expired.|
|key_number||Key number under which the license is registered on the Key Authentication server.|
|platform||Operating system with which the license is compatible.|
|product||Product for which the license has been issued.|
Amount of disk space that data chunks may occupy in the cluster, in per cent to the capacity limit value.
For example, if the capacity limit is set to 1 TB, and the grace capacity is 5%, data chunks may use 50 GB above the capacity limit.
Total amount of disk space, in GB, data chunks may occupy in the cluster.
To view the disk space currently used by chunks, run the vstorage top command, press the V key on your keyboard, and check the FS field. For details, see Understanding Disk Space Usage.
|replicas||Maximum number of replicas a data chunk may have.|
|autorecovery||Denotes whether the auto-recovery feature is enabled (1) or disabled (0).|
|autorebalance||Denotes whether the auto-rebalance feature is enabled (1) or disabled (0).|
|snapshots||Denotes whether the snapshots feature is enabled (1) or disabled (0).|
3.6.5. Checking the License Status¶
You can check the status of your license in one of the following ways:
vstorage view-license, for example:
# vstorage -c stor1 view-license | grep status status="ACTIVE"
vstorage topcommand, for example:
# vstorage -c stor1 stat | grep License connected to MDS#1 License: PCSS.XXXXXXXX.XXXX is ACTIVE
The table below lists all statuses a license can have.
|ACTIVE||License is valid and active.|
|VALID||License is valid and can be installed in the cluster.|
|EXPIRED||License has expired.|
|GRACED||License is currently on the grace period or data chunks in the cluster use disk space from the grace capacity.|
|INVALID||License is invalid (for example, because its start date is in the future).|