3.6. Managing Virtuozzo Storage Licenses¶

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

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:

1. Make sure that the server where you want to update the license is connected to the Internet.

2. Run the vstorage update-license command to update the license.

For example, to update a license installed in the pcs1 cluster, execute this command:

# vstorage -c pcs1 update-license

By default, 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.

3.6.5. Checking the License Status¶

You can check the status of your license in one of the following ways:

• Using the vstorage view-license, for example:

  # vstorage -c stor1 view-license | grep status
  status="ACTIVE"
  

• Using the vstorage stat or vstorage top command, 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.