.. _Managing Licenses:

Managing Licenses
-----------------

.. _vinfra cluster license load:

vinfra cluster license load
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Load a license from a key.

.. only:: vz

   ::

      usage: vinfra cluster license load <license-key>

   ``<license-key>``
      License key to register

.. only:: ac

   ::

      usage: vinfra cluster license load --key <license-key> --type <license-type>

   ``--key <license-key>``
      License key to register. Specify this option multiple times to register multiple keys.

   ``--type <license-type>``
      License type (``prolong`` or ``upgrade``)

Example:

.. only:: vz

   ::

      # vinfra cluster license load A38600-3P6W74-RZSK58-Y9ZH05-2X7J48
      +---------------+------------------------+
      | Field         | Value                  |
      +---------------+------------------------+
      | capacity      | 7036767043584000       |
      | expiration_ts | 1549583999             |
      | free_size     | 7036766991361913       |
      | keynumber     | VZSTOR.74418710.0000   |
      | spla          | registered: false      |
      |               | registration_url: null |
      | status        | active                 |
      | total_size    | 7036767043584000       |
      | used_size     | 52222087               |
      +---------------+------------------------+

.. only:: ac

   ::

      # vinfra cluster license load --key A38600ML-3P6W746P-RZSK58BV-Y9ZH05Q5-2X7J48J6-KVRXRYPY-\
      Z2FK7ZQ6-Y7FGZNYF --type upgrade
      +------------+------------------------+
      | Field      | Value                  |
      +------------+------------------------+
      | capacity   | 10995116277760         |
      | expiration | 2021-01-10T12:42:00    |
      | free_size  | 10973383165601         |
      | spla       | registered: false      |
      |            | registration_url: null |
      | status     | active                 |
      | total_size | 10995116277760         |
      | used_size  | 21733112159            |
      +------------+------------------------+

This command installs the license from the key ``A38600-3P6W74-RZSK58-Y9ZH05-2X7J48``.

.. _vinfra cluster license show:

vinfra cluster license show
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Show details of the installed license:

:: 

   usage: vinfra cluster license show

Example:

.. only:: vz

   ::

      # vinfra cluster license show
      +---------------+------------------------+
      | Field         | Value                  |
      +---------------+------------------------+
      | capacity      | 7036767043584000       |
      | expiration_ts | 1549583999             |
      | free_size     | 7036766991361913       |
      | keynumber     | VZSTOR.74418710.0000   |
      | spla          | registered: false      |
      |               | registration_url: null |
      | status        | active                 |
      | total_size    | 7036767043584000       |
      | used_size     | 52222087               |
      +---------------+------------------------+

.. only:: ac

   ::

      # vinfra cluster license show
      +------------+------------------------+
      | Field      | Value                  |
      +------------+------------------------+
      | capacity   | 10995116277760         |
      | expiration | 2021-01-10T12:42:00    |
      | free_size  | 10973383165601         |
      | spla       | registered: false      |
      |            | registration_url: null |
      | status     | active                 |
      | total_size | 10995116277760         |
      | used_size  | 21733112159            |
      +------------+------------------------+

This command shows the details of the currently installed license.

.. only:: vz

   .. _vinfra cluster license update:

   vinfra cluster license update
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

   Update the installed license:

   :: 

      usage: vinfra cluster license update [--server <ka-server>]

   ``--server <ka-server>``
      Hostname[:port] of the key administration server (default: ``ka.parallels.com``)

   Example:
   
   ::

      # vinfra cluster license update --server ka.parallels.com
      +---------------+------------------------+
      | Field         | Value                  |
      +---------------+------------------------+
      | capacity      | 7036767043584000       |
      | expiration_ts | 1549583999             |
      | free_size     | 7036766991361913       |
      | keynumber     | VZSTOR.74418710.0000   |
      | spla          | registered: false      |
      |               | registration_url: null |
      | status        | active                 |
      | total_size    | 7036767043584000       |
      | used_size     | 52222087               |
      +---------------+------------------------+

   This command updates the installed license.