ViPR SRM 3.6 – ViPR SRM Licensing

Table of Contents

Licensing concepts

Learn how to manage and troubleshoot ViPR SRM ELMS licensing. Learn how to upload license files, delete trial licenses, verify available licenses, and synchronize licenses on multiple hosts.

Starting with ViPR SRM 3.0, ViPR SRM uses ViPR SRM the Electronic Licensing Management System (ELMS) for licensing. ViPR SRM runs on the EMC M&R platform, which uses a different licensing system. Various other products that also run on EMC M&R, such as Software Assurance Suite (SAS) and ViPR, continue to use the legacy license system, which is also referred to as EMC M&R licenses.

To manage ViPR SRM licensing, you need to understand permanent and trial licensing and the relationship between EMC M&R features and the ViPR SRM ELMS licenses.

Back to Top

After installation: Licenses and SolutionPacks

A ViPR SRM installation includes the software for the core system features and all SolutionPacks. Although the installation includes the software for all SolutionPacks, your site might not have permanent licenses for all of them.

The ViPR SRM licensing method divides product content into the following three categories:

  1. ViPR SRM core software, which is a bundling of core features and selected SolutionPacks.
  2. ViPR SRM add-on SolutionPacks.
  3. SolutionPacks that are not part of ViPR SRM.

See ELMS license entitlements for the list of features included in the core suite and a list of available ViPR SRM add-on licenses.

Back to Top

EMC M&R feature names and ELMS licenses

EMC M&R is the underlying platform for ViPR SRM. EMC M&R identifies functionality using strings known as EMC M&R feature names. ELMS licenses use a different set of strings to refer to sets of features.

Feature names are formal references to SolutionPack names, collectors, and components that work within the product. For example, XML Collector is the feature name corresponding to the collector component that collects XML data. As another example, the SolutionPack that collects VNX data uses the feature name SolutionPack for EMC VNX. Services and components typically require multiple sets of features to run properly.

An ELMS license maps to a set of EMC M&R features.

For a list of ELMS license names and the features that they enable, see ELMS License Entitlements at the end of this article.

Back to Top

Trial licenses

Your ViPR SRM software can include all trial licenses or a combination of permanent and trial licenses.

Licenses that you purchase are permanent. Other software comes with trial licenses.

Trial licenses let you test features in the UI and perform some initial configurations before full purchase. Trial licenses typically last for 30 days after the installation time. You cannot copy or regenerate a trial license in the product.

If all of your licenses are trial licenses, including the core software license that includes the Web Portal feature, the software can lock out all users from accessing the UI when the trial expires.

Back to Top

License duration

Permanent licenses do not expire. Trial licenses have expiration dates, typically 30 days after the installation date.

When trial licenses expire, module license checks fail and the modules stop working. If the Web Portal module fails, you cannot access the product.

Because the License Management UI operates behind the Web Portal module, you must upload your permanent license file or extended trials before the 30-day license for the core features expires. Otherwise, the UI locks and you cannot upload the license file. If this happens, see Troubleshooting licensing.

Back to Top

License purchase

To convert a feature from a trial license into a permanently licensed feature, you need to purchase a license.

To initiate the purchase of a license for a SolutionPack or ReportPack, visit EMC Online Support using the following URL:

https://support.emc.com/servicecenter/createSR/

On the page that appears, submit a service request to EMC. Include the SolutionPack or ReportPack name that you want to purchase.

When all purchasing transactions are complete, EMC sends you instructions for downloading a regenerated license file for your site that includes the newly purchased software license. Download the file to a local server, and then follow instructions in Upload a new license file to upload the new license file into ViPR SRM.

Note Image
Until the license is purchased and the new license file is obtained and uploaded into ViPR SRM, the SolutionPack is inoperable, unless the 30-day trial license is still in effect.

Back to Top

Licensing operations

Use the ViPR SRM Centralized Management UI to perform licensing management operations, such as uploading, verifying, deleting, and synchronizing licenses.

Back to Top

Log in with admin credentials

You must have administrator credentials to perform license management operations.

Procedure

  1. Access ViPR SRM by typing the following URL in a web browser:
    http://frontend-hostname:58080/centralized-management

    where frontend-hostname is the server where the ViPR SRM frontend module is installed.

    The ViPR SRM login page opens.
  2. Log in with a user account that has administrator credentials.
    The Centralized Management UI opens to the Physical Overview page.
  3. In the navigation tree in the left pane, click Licenses Management.
    The Licenses Listing page opens. Notice the Upload and Synchronize operational commands at the top of the page.
Back to Top

View license information

You can view license information in two ways in ViPR SRM. One method displays licenses by host. The other one shows a centralized view of all licenses.

Procedure

  1. Log in to ViPR SRM.
  2. To view active licenses on a physical host, navigate to Administration > Centralized Management > Physical Overview > host-name.
  3. Click the Licenses tab.
    License Host tab

    The host's Licenses tab opens, as shown in the following figure. The page shows the features with active licences on that host. It also indicates whether licenses are permanent or trial, the expiration date for trials, and additional license properties, if applicable.

  4. To view a consolidated list of licenses for all hosts, and to perform license management operations, in the navigation tree in the left pane, click Licenses Management.
    The Licenses Listing page opens showing all licenses on all servers.

    The following figure shows this page. Notice the ELMS permanent license, showing all features included in the license and the license serial number. Also notice the Upload and Synchronize commands at the top of the page.



    This table displays Information for ELMS licenses related to product name for the license, SWID, and serial numbers.

Back to Top

Upload a new license file

To add a new license to your system, such as a newly purchased SolutionPack or ReportPack license, you upload a new license file.

Before you begin

  1. Purchase the required licenses.
  2. Download the new license file to a local server, as directed by EMC during the purchase process.

When you upload a license file, the new file affects all servers capable of using the licenses.

Procedure

  1. Log in to the Centralized Management UI in ViPR SRM using the following URL:
    http://frontend-hostname:58080/centralized-management
  2. In the navigation pane, select Licenses Management.
  3. Click Upload at the top of the page.
    The License Upload dialog appears.
  4. Click Browse and locate the new license file that you downloaded.
  5. Click OK.
    The system extracts the licenses and displays them in the table on the Licenses Listing pane.
  6. When the License Upload Complete dialog appears, click OK, and then click Continue.
    The new license automatically affects all servers capable of using the license.
  7. Delete the trial licenses that correspond to newly licensed features, if any.

    To delete a trial license, see Delete licenses.

Back to Top

Delete licenses

You can select and delete specific licenses or delete all licenses. A delete action affects all servers that use the license.

After you install a permanent license, delete the trial licenses that are covered by the permanent license.

Procedure

  1. Log in to the Centralized Management UI in ViPR SRM using the following URL:
    http://frontend-hostname:58080/centralized-management
  2. In the navigation pane, select Licenses Management.
  3. In the Licenses Listing table, select one or more license check boxes.
  4. Click Delete.
    The Delete command appears below the table. It is dimmed until you select at least one license.
    The system deletes the selected license from all available servers.
Back to Top

Synchronize licenses on multiple hosts

The Synchronize action ensures that all remote hosts have licenses based on those available on the Centralized Management host.

Certain situations might cause licenses to become out of sync. For example, if a remote host is unavailable when you perform an upload or a delete operation, those operations would not be propagated to the offline server. Another example is if you add a new server to your configuration, the new server would need licensing information.

Procedure

  1. Log in to the Centralized Management UI in ViPR SRM using the following URL:
    http://frontend-hostname:58080/centralized-management
  2. In the navigation pane, select Licenses Management.
  3. Click Synchronize at the top of the page.
    The system synchronizes the licenses on all remote hosts.
Back to Top

Troubleshooting licensing

You can resolve common licensing problems.

Back to Top

Permanent license stops working after host reconfiguration

If you change the configuration of a host, for example, by adding interfaces, removing interfaces, or changing the operating system, your permanent license might stop working. If your license does not work, obtain a new host ID and request a new permanent license.

Before you begin

Ensure that you have a login with root, EMC M&R, or system administrator privileges to perform this task. The user apg is the account that the application uses instead of root.

Procedure

  1. Log in to the operating system command line on the EMC M&R host server.
  2. To obtain the new host ID, run one of the following operating system commands:
    The command output is the new EMC M&R host ID.
  3. Copy the host ID information to the clipboard or to a text file.
  4. To obtain the new license, go to the EMC support site using the following URL:
    https://support.emc.com/servicecenter/createSR/
    The Create a Service Request page opens.
  5. Submit a service request to EMC, asking for a new permanent license file for a new host. Paste the new host ID into the request.
  6. When EMC sends you the new license file, follow the procedure in Upload a new license file.
Back to Top

Users are locked out of ViPR SRM

If the license for the core ViPR SRM features expires, the system locks users out of the UI.

To recover from this scenario:

  1. Obtain a license file with permanent licenses. See License purchase.
  2. Install the new license file from the command line. See Install license file from the command line.
  3. Restart the Tomcat service. See Restart Tomcat service.
  4. Log in to ViPR SRM and perform the following tasks:
    1. Reinstall the new license file from the Centralized Management UI.
    2. Delete the expired trial licenses.
    See Reinstall license file and delete trial licenses after lockout.
Back to Top

Install license file from the command line

You can install a license file from the command line if you are locked out of the UI. Always use the UI unless you are locked out.

Before you begin

  • Ensure that you have an OS account with root, apg, or system administrator privileges. The application uses the apg account, rather than root.
  • Acquire a new license file from EMC and download it to a local server. To request a new license file, create a Service Request on EMC Online Support.

Procedure

  1. Log in to the server where the ViPR SRM core software is installed.
  2. Copy the new, valid license file to this same server. The file is a .zip file.
  3. At the OS command line, navigate to the bin directory.
  4. Install the license file using one of the following commands appropriate to your OS:
    Note Image
    The command installs the license file on this server only.

Back to Top

Restart Tomcat service

If the Web Portal license expires, you might need to restart the Tomcat service.

Before you begin

  1. Install the new license file using operating system commands.
  2. Ensure that the library search path is correct on the server that is the host for the core software. This requirement applies to the libstdc package on a Solaris server and the libaio package on a LINUX server.

It is only necessary to restart the Tomcat service when the license for a web application, such as the Web Portal, expires.

Procedure

  1. Log in to the server where the ViPR SRM core software is installed.
  2. At the OS command line, navigate to the bin directory.
  3. Run one of the following commands appropriate to the OS:
    The command output starts like this:
    * Starting 'tomcat Default'... [ OK ]
Back to Top

Reinstall license file and delete trial licenses after lockout

After you install a permanent license file on the command line, you need to reinstall that file using the Centralized Management UI to make the license visible in the UI and available for distribution to other remote servers. You also need to delete the expired trial licenses.

Procedure

  1. Open a browser and log in to the Centralized Management UI in ViPR SRM using the following URL:
    http://frontend-hostname:58080/centralized-management
  2. In the navigation pane, select Licenses Management.
  3. Click Upload at the top of the page.
    The License Upload dialog appears.
  4. Click Browse and locate the new license file.
  5. Click OK.
    The system extracts the licenses and displays them in the table on the Licenses Listing pane.
  6. When the License Upload Complete dialog appears, click OK, and then click Continue.
    The new license automatically affects all servers capable of using the license.
  7. In the License Listing table, select all expired trial licenses by clicking the appropriate check boxes.
  8. Click Delete.
    The Delete command appears at the bottom of the page, below the table of licenses.
    The delete action automatically affects all available servers.
Back to Top

Module does not start or has no license

If a component reports that it has no license or does not start, verify the licenses on the physical host.

Procedure

  1. Log in to the Centralized Management UI in ViPR SRM using the following URL:
    http://frontend-hostname:58080/centralized-management
  2. Navigate to Physical hosts > host-name > Licenses.
    The page shows all licenses active on this local host.
  3. Inspect the Expiration column for the termination date of each license.
Back to Top

ELMS license entitlements

This section describes the features associated with the core ViPR SRM license as well as the additional licenses that you can purchase.

The ELMS SRMSUITE_GENERAL feature bundles all of the basic features and SolutionPacks that you receive as part of any ViPR SRM purchase. This bundle enables most of the EMC M&R functionality. The first table below lists the features included in SRMSUITE_GENERAL.

When you purchase an add-on license, you receive additional ELMS features. The add-on licenses enable sets of features that ViPR SRM verifies during runtime. The second table below lists ELMS add-on license names and the features enabled by each one.

ViPR SRM ELA License

Starting with EMC M&R 6.4u1, a ViPR SRM ELA license is available under the ELMS feature name ViPRSRM_ELA. This license grants all of the functionality and SolutionPacks for ViPR SRM. It is equivalent to a license for SRMSUITE_GENERAL plus all of the available ELMS features listed in the previous table.

Note Image
The Backend Adapter for this license allows for 1 million devices and 4 million metrics per device.

Back to Top