How to Delete Licenses for Agile Requirements Designer

Products

• CA Agile Requirements Designer

Issue/Introduction

This document will explain how to delete any unnecessary, old, or expired licenses for Agile Requirements Designer (ARD) so that they no longer show in CodeMeter Control Center (CC) or WebAdmin.
This same process also applies to license containers.
Deleting old license entries using the steps in this document is often helpful while troubleshooting ARD licensing issues.
It also ensures that whatever new license is applied is the only one ARD looks for when the product launches.

Here are some situations where you would want to delete licenses or license containers:

• Applying a new license key over an expired license.
• Applying a new, permanent license key over a trial license.
• Applying a new license over a broken license.
• After connecting to a concurrent license server.
• If you have a license container other than 'AgileDesigner' in CodeMeterCC.
  • Examples: 'AgileDesignerUnb', 'AgileDesigner-Trial', or 'AgileDesigner-Offline'.

 A license container is like a template for the ARD license key.
In most cases, you want to have the 'AgileDesigner' license container.
All containers start with a '32767' number and will have a gray icon next to them in CodeMeterCC.
License containers are needed when applying a new offline or online license.
For user machines with concurrent licenses, you will not need a license container.
With ARD 2.7+, this is deleted automatically in the License Activation Wizard when you use it to connect to a concurrent license server.
If you are using ARD 2.0-2.6, you will have to delete it manually.
Activated licenses for ARD all start with a '128' number and will have a blue icon next to them in CodeMeterCC.
The Screenshot example is below:

 

Environment

ARD 2.10+
CA Agile Requirements Designer

Resolution

1. Go to C:\Program Files (x86)\CodeMeter\Runtime\bin
    
2. Locate 'CodeMeterCC.exe', right-click, and choose 'Run as administrator'.
   
   
     
3. In the CodeMeter Control Center window, under the 'License' tab, select the CM license container which you would like to delete.
    
4. Make a note of the Serial number. Example in the screenshot is ‘128-9928168’
   
   
    
5. Open a command prompt. You can do this by searching for 'cmd' in your Windows start menu. It will show under 'Programs' as cmd.exe.
    
6. Navigate to ‘C:\Program Files (x86)\CodeMeter\Runtime\bin’ using the following command 
   >cd C:\Program Files (x86)\CodeMeter\Runtime\bin
    
7. Use the cmu32 command line tool to delete the license using the serial number you found in step one. Note that before the option ‘delete’ and ‘serial’ there are two hyphens. 
   >cmu32 --delete-cmact-license --serial 128-9928168
    
8. Once the license has been deleted, you should see a 'CmAct- License X successfully removed' message in the command prompt. You should also no longer see the license in the CodeMeter Control Center window. 
   
   

If you have any other license containers besides 'AgileDesigner' in CodeMeterCC, such as 'AgileDesignerUnb', 'AgileDesigner-Trial', or 'AgileDesigner-Offline', we suggest deleting them to avoid confusion and future issues. 

Additional Information

• To learn how to receive and apply a new license please refer to the following documents:
  • Offline licenses: 
    
    • ARD 2.7+: https://knowledge.broadcom.com/external/article?articleId=10809
  • Online licenses: 
    
    • ARD 2.7+: https://knowledge.broadcom.com/external/article?articleId=10819
       
• If you accidentally deleted your license containers, please review this document on how to add them back:
  • https://knowledge.broadcom.com/external/article?articleId=9602