Install a License by Using a USB Key

Note:

• If you have got a license by using a request key, you can view Plus License of both the request key and USB key after inserting the USB key. If the Plus License is the same, the latest uploaded one will be taken as a reference.
• If you get a license by using the USB key, every time you enter the License Management interface of the Cloud, there will be about two seconds of information reading, and the relevant information of the USB key will appear after two seconds.
• If you are using a dual-MN environment, note that:
  • You can obtain the authorization by inserting only one USB key into the management node.
  • If the node with the USB key inserted is faulty, we recommend that you remove the USB key and insert it into another healthy node to ensure the business continuity.
  • If you update from a single management node environment to a dual-MN environment, you do not need to get the additional license.

Renew a License by Using a USB Key

Note:

• If you do not insert a USB key into the management node, you can not upload a license by using the USB key.
• If the USB key ID dose not match the applied license, you can not upload the license by using the USB key.
• If you apply a new license by using a USB key, you need to fill in previous all applied information and then add new Plus License information when the USB key does not match the request key.

View USB Key Status

On the main menu of ZStack Cloud, choose Personal Center > License Management. Then, the License Management page is displayed. You can view the current status of the USB key of the Cloud.

USB Key Status

USB key has the following statuses.

Status	Description
Ready	The USB key is Ready when there is only one USB key inserted into the management node and it works properly.
Missing	After unplugging the USB key, the USB key is Missing. Note: When unplugging the USB key, the Cloud will check whether the current license is expired. If it is expired, there will be no buffer license after unplugging the USB Key. It keeps the status of Expired. If it is not expired, a 30-day buffer license is generated based on the current license of the USB key when you unplug the USB key at the first time. the last time it was unplugged will be detected when you do not unplug the USB key for the first time: If the period between two times is 60 days or more, the buffer license is renewed. If the period is less than 60 days, the expiration time of the previous buffer license is retained. After unplugging the USB key and inserting a new USB key, the licensing information of the new USB key will be displayed and the buffer license of the old USB key will be invalidated.
Abnormal	For a dual-MN environment, you might face a possibility of USB key failure if you: Insert one USB key into each of the two management nodes. Insert one USB key into one management node, and insert multiple USB keys into the other management node. Note: The USB key in an abnormal state does not affect the license.
Fault	For a dual-MN environment, you may face a possibility of USB key failure if you: Insert multiple USB keys into one management node, and insert no USB key into the other management node. Insert multiple USB keys into every management node. For a single management node environment, if you insert multiple USB keys into this management node, the USB key status will be Faulty. Note: When the USB key status is Faulty, you can not use the license after the buffer license is expired.

Install a License on the UI

Note:

• You can upload both the Base license and Plus license at the same time by using a tar.gz package or a .txt file.
• If you are using a dual-MN environment, we recommend that you download the request key and upload the license file on the management node where the virtual IP address is located. Then, the licensing information on both nodes can be updated.
• Only the admin has the permission to load or delete licenses. Note that the Base license cannot be deleted.

Install a License by Using Command Line Tool

1. Import the license by using a command line tool after getting the new license.

   [root@localhost ~]# zstack-ctl install_license -f zstack-license.tar.gz

2. Refresh the license.
   Reload the license by using the following commands:

   [root@localhost ~]# zstack-cli     ZStack command line tool   Type "help" for more information   Type Tab key for auto-completion   Type "quit" or "exit" or Ctrl-d to exit  >>>LogInByAccount accountName=admin password=password {     "inventory": {         "accountUuid": "36c27e8ff05c4780bf6d2fa65700f22e",         "createDate": "May 25, 2016 8:12:54 PM",         "expiredDate": "May 25, 2016 10:12:54 PM",         "userUuid": "36c27e8ff05c4780bf6d2fa65700f22e",         "uuid": "d505bde1bcce46cb9c79774440654f42"     },     "success": true }  >>>ReloadLicense

Renew a License by Using a Request Key