How to Delete Licenses for Agile Requirements Designer

Document ID : KB000009592
Last Modified Date : 17/10/2018
Show Technical Document Details
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.

Background:

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 grey 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. Screenshot example is below:
 

User-added image

Environment:
CA Agile Requirements Designer (ARD)- All product release versions.
Instructions:
  1. Go to C:\Program Files (x86)\CodeMeter\Runtime\bin
     
  2. Locate 'CodeMeterCC.exe', right-click, and choose 'Run as administrator'.

    User-added image
     
  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’

    User-added image
     
  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. 

    User-added image

 

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: