.. _Viewing the License:

Viewing the License
-------------------

You can use the ``vzlicview`` tool to view the information on the installed license and find out its current status. For example:

::

    # vzlicview
    Searching for installed licenses...
    VZSRV
            owner_name="Autogenerated Trial Licenses (Virtuozzo)"
            status="ACTIVE"
            version=7.0
            owner_id=70295522.10134133
            hwid="3D6F.FFB2.1CD5.1E47.1325.BBE0.6C66.ACF5"
            serial="BF3D.E943.18C5.5555.5D10.99D9.0310.DFA0"
            expiration="07/08/2016 03:00:00"
            start_date="06/07/2016 03:00:00"
            issue_date="06/08/2016 16:27:11"
            graceperiod=259200 (259200)
            key_number="PSBM.10134133.0001"
            cpu_total=8 (1)
            ct_total="unlimited" (0)
            architecture="x86"
            architecture="x86_64"
            platform="Linux"
            product="PSBM"
            nr_vms="unlimited" (2)
            subscription="70295522:dd482d1a-5268-4980-ae06-2a288a4fb7ab"

You can also view contents of license files with the ``vzlicview -f`` command. The output does not differ from that in the example above.

The license parameters are described in the following table.

+--------------------+--------------------------------------------------------+
| Column             | Description                                            |
+====================+========================================================+
| owner_name         | The name of the license owner.                         |
+--------------------+--------------------------------------------------------+
| status             | License status. For description of license statuses,   |
|                    | see :ref:`License Statuses`.                           |
+--------------------+--------------------------------------------------------+
| version            | The version of Virtuozzo for which the license was     |
|                    | issued.                                                |
+--------------------+--------------------------------------------------------+
| owner_id           | The ID of the license owner.                           |
+--------------------+--------------------------------------------------------+
| hwid               | Server hardware identifier.                            |
+--------------------+--------------------------------------------------------+
| serial             | License serial number. In particular, used to identify |
|                    | license files in ``/etc/vz/licenses/``.                |
+--------------------+--------------------------------------------------------+
| expiration         | License expiration date, if the license is             |
|                    | time-limited.                                          |
+--------------------+--------------------------------------------------------+
| start_date         | The date on which the license becomes active.          |
+--------------------+--------------------------------------------------------+
| issue_date         | The date on which the license was issued.              |
+--------------------+--------------------------------------------------------+
| graceperiod        | Period, in seconds, during which Virtuozzo continues   |
|                    | to function after the license has expired or if the    |
|                    | number of running virtual machines and containers      |
|                    | exceeds the limit defined by the license.              |
+--------------------+--------------------------------------------------------+
| license_update_date| The date on which the license was last updated.        |
|                    |                                                        |
+--------------------+--------------------------------------------------------+
| key_number         | Number under which the license is registered on the    |
|                    | Key Authentication server.                             |
+--------------------+--------------------------------------------------------+
| cpu_total          | The total number of physical CPUs that the server is   |
|                    | allowed to have.                                       |
+--------------------+--------------------------------------------------------+
| ct_total           | The total number of containers that are allowed to be  |
|                    | simultaneously running on the server.                  |
+--------------------+--------------------------------------------------------+
| architecture       | System architecture with which the license is          |
|                    | compatible.                                            |
+--------------------+--------------------------------------------------------+
| platform           | Operating system with which the license is compatible. |
+--------------------+--------------------------------------------------------+
| product            | Name of the product for which the license has been     |
|                    | issued.                                                |
+--------------------+--------------------------------------------------------+
| keyserver_host     | The hostname and port of the Key Authentication        |
|                    | server.                                                |
+--------------------+--------------------------------------------------------+
| nr_vms             | The number of virtual machines that are allowed to be  |
|                    | simultaneously running on the server.                  |
+--------------------+--------------------------------------------------------+
| subscription       | Virtuozzo feature subscription key.                    |
+--------------------+--------------------------------------------------------+

.. _License Statuses:

License Statuses
~~~~~~~~~~~~~~~~

When viewing information on your licenses, pay special attention to the license status that can be one of the following:

+--------------------+--------------------------------------------------------+
| Status             | Description                                            |
+====================+========================================================+
| ACTIVE             | The license installed on the server is valid and       |
|                    | active.                                                |
+--------------------+--------------------------------------------------------+
| VALID              | The license is valid and can be installed on the       |
|                    | server.                                                |
+--------------------+--------------------------------------------------------+
| EXPIRED            | The license has expired and cannot be installed on the |
|                    | server.                                                |
+--------------------+--------------------------------------------------------+
| GRACED             | The license is installed on the server but is          |
|                    | currently on the grace period because it has expired   |
|                    | or the number of running virtual machines and          |
|                    | containers exceeds the limit defined by the license.   |
+--------------------+--------------------------------------------------------+
| INVALID            | The license is invalid (e.g., because of server        |
|                    | architecture mismatch) or corrupt.                     |
+--------------------+--------------------------------------------------------+

