Data Domain: ELMS License frequently encountered issues[1]

           

   Article Number:     531264                                   Article Version: 4     Article Type:    How To 
   

 


Product:

 

Data Domain

 

Instructions:

 

 

   

      Updating the license on a Data Domain can be accomplished in 2 distinct ways.  This document contains a step by step process to updating your eLicense on a Data Domain, as well as a few commonly experienced issues when attempting the eLicense update.     
            
      How to: Applying your new eLicense     
           
  1.           Using the Data Domain Graphical User Interface (GUI)          
                 
    1.               Save .lic file to your computer           
    2.            
    3.               Log into System Manager for the Data Domain system           
    4.            
    5.               Navigate to the Administration Tab           
    6.            
    7.               Click Licenses           
    8.            
    9.               Click Replace license           
    10.            
    11.               A new window should pop up, you then can navigate to .lic file            
    12.            
    13.               Click okay           
    14.          
                      
  2.        
  3.           Using the Data Domain Command Line Interface (CLI)          
                 
    1.               Save the .lic file to your computer           
    2.            
    3.               Log into the Data Domain via Secure Shall (SSH)           
    4.            
    5.               Open the .lic file using WordPad           
    6.            
    7.               Copy the contents of the license file from WordPad           
    8.            
    9.                In the CLI, issue the command: #elicense update           
    10.            
    11.               The system will ask you to input the new license, simply paste what was previously copied           
    12.            
    13.                Hit control-D twice to save           
    14.            
    15.               The system will present you with the features contained in the new license           
    16.            
    17.               Ensure the license features are correct and type “yes” to apply           
    18.          
               Hint: Use control-A to select all, and control-C to copy       
  4.      
Common issues: Frequently seen complications with applying a new eLicense     
            
        1. The Copy/Paste from the .lic file results in a malformed license     
      This is generally caused when a program is used to open the .lic file that doesn’t word wrap properly.  Generally speaking we see this most frequently if using “Notepad” to open the .lic file.  The eLicense format is very specific, and any breaches in the format will cause the update to fail.  If you notice that the .lic file was copied from Notepad, close Notepad without saving, and open the .lic file using “Wordpad”     
       
        2. I attempted to apply my license through the GUI, but it just sits there and spins “thinking”     
      All actions completed through the GUI utilize the Data Domain internal process to pass communication from the GUI modules to the underlying subsystems on the Data Domain.  If the Data Domain is busy, this communication could end up timing out.  If you find yourself in this scenario, it’s generally quicker to attempt to update the license through the CLI (Instructions above).  Otherwise, you could wait for a time when the Data Domain system is less busy to attempt the update from the GUI again.     
       
        3. The installation of the eLicense fails, and returns an error stating “Invalid Locking ID”     
The locking ID on the license is a unique identifier that links your license file to your Data Domain system.  It is created using the serial number of your Data Domain.  If your license file has an Invalid Locking ID, gather the Serial Number from your Data Domain using the command “system show serialno”, and provide that to the licensing team who provided the license.  Generally, it’s easiest to utilize the email on which the license was provided since it will contain the info for the Purchase Order (PO) utilized to create the license.     
            
      End Word: For any issues not detailed here, please open up a Service Request and the Licensing/Support groups will assist with resolving.