Updating the VSM License

Publication Date:  2012-07-19 Views:  112 Downloads:  0
Issue Description
This topic describes how to update the VSM license.

The OS and database must run properly.
The processes of the VSM must be properly started.
You must log in to the VSM as the admin user.
The license file of the VSM must be obtained.
   Through the GUI of the client: Save the new VSM license to the server where the VSM client is located.
   Through the CLI: .
Alarm Information
None.
Handling Process
Through the GUI of the Client
For the single-server system:
1.         On the VSM workstation, back up the original license file.
In the Windows OS: Create the backup folder in the default directory D:\vsm\server\etc\conf\license. Copy the original license file to the created folder.
2.         Choose Help > License Management > License Information from the client main menu. Then, click Update License. In the Open dialog box that is displayed, select the new license file and click Open.

Through the CLI
For the single-server system:
1.         On the VSM workstation, back up the original license file.
 In the Windows OS: Create the backup folder in the default directory D:\vsm\server\etc\conf\license. Copy the original license file to the created folder.
2.         Update the VSM license.
1.         In the Windows OS:
1.         Log in to the OS of the server.
2.         Run the following command to update the VSM license file:
>updateLicense -fileLicense_file_name

In the command, License_file_name indicates the combination of an absolute path and a file name.
Information similar to the following is displayed:
state                    product         feature          item        name            old value              new value
no change:   VSM              COMMON            LSW1CAPA01            Client            500        500
no change:   VSM              COMMON            LSW1CAPA01            Client            1            1
no change:   VSM              COMMON            LSW1FMCLT01          Alarm Export        1            1
no change:   VSM              COMMON            LSW1RENOTI01         Client            1            1
 
Are you sure to update the license?(Y/N)
3.         Enter Y, and then press Enter.
Root Cause
In the case that the device types supported by the new license are different from those supported by the original license, the license is updated as follows:
If the device types supported by the new license are more than the device types supported by the original license and the added device types are supported by the current version, the license can be updated. If the added device types are not supported by the current version, the license cannot be updated.
If the device types supported by the new license are less than the device types supported by the original license and no NEs of the reduced device types are created in the NMS, the license can be updated. If certain NEs of the reduced device types are created in the NMS, the license cannot be updated.
If the function items supported by the new license are less those supported by the original license, the license cannot be updated.
In the case that the number of clients supported by the new license is different from that supported by the original license, the license is updated as follows:
If the number of clients supported by the new license is less than that supported by the original license but the number of online clients is less than the number of clients supported by the new license, the license can be updated. If the number of online clients is greater that the number of clients supported in the new license, the license cannot be updated.
If the number of clients supported by the new license is greater than that supported by the original license, the license can be updated.
In scenarios where you can change the license, you can shut down the VSM server, change the license and then restart the server. you can also update the VSM license through the following method.

It is recommended that you update the VSM license through the GUI of the client.
To ensure the normal running of the VSM, do not manually replace the license file.

Through the GUI of the Client:
Application scenario: This method is recommended if you can log in to the VSM client and access the GUI.
Operation method: Log in to the VSM client, and then click Update License to update the license.
Through the CLI:
Application scenario: This method is applicable to the scenario where you need to remotely update the license through commands because logging in to the VSM client is not allowed and the client does not provide any GUI.
Operation method: Check that the processes of the VSM are properly started, and then run the updateLicense-filefilename command to update the license file.
Restart the client after you replace a license. Then, the client automatically reloads the menu items according to the control items defined in the new license.
Suggestions
None.

END