Workbench for Eclipse license

Workbench for Eclipse users can check out a license to enable Workbench for Eclipse functionality. By default, the checkout period lasts 10 hours but can be changed. Refer to the Common Enterprise Services Administration online help for information on changing the checkout period.

The Workbench for Eclipse license is validated whenever Workbench for Eclipse is launched, and manually when desired. Refer to the BMC-AMI-DevX-Workbench-for-Eclipse-Installation-Guide for information on the initial license setup.

To address a license failure message when Workbench for Eclipse is launched

  1. On the BMC AMI DevX Workbench License dialog box that appears, click Preferences. The Enterprise Services page of the Preferences dialog box appears.
  2. In the URL field, enter the URL for CES, then click Test Connection. If a message appears indicating that the connection is not successful, click OK, enter a valid URL, then click Test Connection again.
  3. Click OK. The BMC AMI DevX Workbench License dialog box appears again.
  4. Click Checkout.

To set the URL for CES

  1. From the Help menu, select BMC AMI DevX Workbench Licensing.

    Important

    If the 

    CES

     server has been set up to require credentials for authentication, depending on the type of credentials required, a prompt to enter credentials may appear. However, no prompt appears if the user previously opted to save credentials or is already logged in for the current 

    Workbench for Eclipse

     session.

  2. Click Preferences. The Common Enterprise Services page of the Preferences dialog box appears.
  3. In the URL field, enter the URL for CES, then click Validate Connection. If a message appears indicating that the connection is not successful, click OK, enter a valid URL, then click Validate Connection again.
  4. Click OK.

To check the status of the license

From the Help menu, select BMC AMI DevX Workbench Licensing. The Topaz Workbench License dialog box appears, showing whether the product is licensed as well as when the license was checked out and when it expires.

Important

If the 

CES

 server has been set up to require credentials for authentication, depending on the type of credentials required, a prompt to enter credentials may appear. However, no prompt appears if the user previously opted to save credentials or is already logged in for the current 

Workbench for Eclipse

 session.

To renew the license checkout

  1. From the Help menu, select BMC AMI DevX Workbench Licensing. The Topaz Workbench License dialog box appears.

    Important

    If the 

    CES

     server has been set up to require credentials for authentication, depending on the type of credentials required, a prompt to enter credentials may appear. However, no prompt appears if the user previously opted to save credentials or is already logged in for the current 

    Workbench for Eclipse

     session.

  2. Click Renew. The current license is released and an attempt is made to check out another license. If a failure message appears, resolve the reason for the checkout failure.

To resolve checkout failures

Checkout failures are caused by the following:

  • An inaccurate URL
  • An expired license
  • The web application is no longer running
  • The server is down
  • All available licenses are in use

Resolve the cause of the failure and click Try Again.

To enable cloud licensing

A cloud license is used to access licensed features in Workbench for Eclipse in situations in which a CES server is not available to provide these features. If interested in leveraging Compuware's cloud licensing service for Workbench for Eclipse's licensed features, contact BMC Support.

  1. Add the following properties in topaz.ini file:

    Location - <Topaz Installation Directory>\Compuware\Topaz\eclipse

    -Dces.cloud.url - <Your Cloud URL>

    -Dcustomerinfo.customernumber - <Your Customer Number>

    -Dcustomerinfo.siteid - <Your Site Id>

  2. Delete files CustomerInfo.xml and UserProfileInfo.xml  from the location <Topaz Installation Directory>\Compuware\Workbench.
  3. To enable cloud licensing once Compuware indicates that it is available, from the Window menu, select Preferences. 
  4. From the Preferences dialog box, toggle open the Compuware node and select Enterprise Services.
  5. Select the Use Compuware cloud license service for Topaz Workbench licensing check box.
  6. Click OK.
  7. Restart Workbench for Eclipse.
  8. From the Help menu, select Topaz Workbench licensing.
  9. From the dialog box, select Topaz for Enterprise Data.
  10. Click Check Out and Close.

Important

  • We recommend, for long-term use in large deployments, that a CES server be installed for easier administration of Workbench for Eclipse. When a CES server is available for licensing, the Use Compuware cloud license service for Topaz Workbench licensing check box must be cleared so Workbench for Eclipse leverages the CES server rather than the cloud service for licensing.
  • An internet connection is required to connect to the cloud licensing service and the connection uses HTTPS to encrypt the data transmitted. If a network proxy is required for internet access, from the Preferences menu, select General > Network Connections. On the Network Connections preference page, select the appropriate HTTPS proxy entry and click Edit. Complete the Edit Proxy Entry dialog box by entering the host and port for your proxy server so Workbench for Eclipse can connect to the cloud licensing service.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*