Install permanent licenses / troubleshoot licensing issues

Products

• VMware Smart Assurance

Issue/Introduction

• The procedure to install the Watch4Net/MnR permanent license
• How to add a new license file for a particular SolutionPack
• How to delete a license already added to Watch4Net/M&R.
• How to verify whether licenses that are already added to Watch4Net/M&R platform are valid or expired.
• What to do if licenses are not registered properly after uploading from the GUI.
• Licenses not properly registered.
• Cannot access the GUI due to expired licenses.

Environment

Watch4Net/MnR - 7.x

Resolution

Whether you are installing permanent licensing or adding a new license file for a particular SolutionPack, the following must be done before you begin the tasks described in this article:

• Make sure you have a login with root, APG, or system administrator privileges to perform the following tasks. The user apg is the account that the Watch4Net/MnR application uses instead of root.

Procedure to install licenses via CLI:

To install licenses, enter the following command for your operating system from the bin directory: 

Operating system:                Command:
UNIX/Linux                               ./manage-licenses.sh install <download_path>/<license file in Zip format>

Example:

./manage-licenses.sh install /opt/APG/licenses/license.zip

Procedure to add licenses:

You must upload a license file whenever you install a new SolutionPack or ReportPack to enable views and reports to display. This can be done as follows:

1. Login to Centralized Management page as http://<MnR_SERVER>:58080/centralized-management/
2. In the Centralized Management pane, select "Licenses Management" as highlighted below:
3. In the Licenses Listing pane, click Upload:
4. In the License Upload dialog box, browse to your license file and click OK. Licenses in a .zip file are then extracted and appear in the Licenses Listing pane.
5. When "License Upload Complete" appears, click OK, then Continue.

NOTE: If you have remote servers in a distributed environment, click Synchronize to add the licenses to the remote servers.

Procedure to delete licenses:

1. Login to Centralized-Management page and navigate to "Licenses Management" section as explained in Procedure to add Licenses topic (Steps 1-3).
2. In the Licenses Listing pane, select one or more license check boxes.
3. Click Delete to delete the selected licenses:

NOTE: If you have remote servers in a distributed environment, click Synchronize to remove the licenses from the remote servers.

Procedure for verifying expiration status of licenses from GUI:

1. Login to Centralized-Management page and navigate to "Licenses Management" section as explained in Procedure to add Licenses topic (Steps 1-3).
2. In the Licenses Listing pane, read the Expiration column.

 

Procedure for verifying expiration status of licenses from CLI:

1. Open a CLI to the frontend server with 'root' access.
2. Navigate to <APG_BASE>/bin.
3. Run command: ./manage-licenses.sh check
    

What to do if licenses have expired and uploading new licenses does not clear the error:

1. Login to Centralized-Management page and navigate to "Licenses Management" section as explained in Procedure to add Licenses topic (Steps 1-3).
2. Delete all licenses except for the Web Portal license where '! red icon' is noticed.
3. Upload the new licenses.
4. Log out and back in to verify the proper licenses are installed.

NOTE: If the licenses still have not registered you may need to restart tomcat.  

To restart tomcat:

1. Open a CLI to the frontend server with 'root' access.
2. Navigate to <APG_BASE>/bin.
3. Run command: ./manage-modules.sh service restart tomcat Default