How to remove hung release via the JMX console?

Document ID : KB000010659
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

There are certain scenarios where sometime due to some technical reason the release hung during execution. Such releases keep on processing stating executing but doesn't proceed any further.

Background:

Such release/s which are hung blocks the agents execution ability which are participating in execution of those release and henceforth as an Administrator it is required to clean the system and free it blocked resources. Some of the most common known scenarios are listed below.

  • Release/s hung during artifact distribution
  • Release/s hung during execution when some agents goes through a restart
Environment:
CA Release Automation: 6.2, 6.3, 6.4 & 6.5
Instructions:

The listed step can be performed by an administrator using JMX console exposed for administrative managements.

 

 

 

Steps to remove hung release(s)

 

1.     Navigate to JMX console expose by default on port 20203 (it can be different port in your environment). The URL to access same will be 

 o   http://<Management Server IP>:<JMXPORT>/mbean?objectname=releasecenter%3Atype%3DInfo

 

2.     It will prompt for login, please login using the administrative username and password configured in your environment

Default JMX username/password – nolio/nolio

Note: If you are unable to get to the link, login to the JMX Console and search for 'releasecenter:type=info'. Locate the link and click on it.

 

3.     Post successful login find the method getAllActiveReleases and invoke it to get the list of releases and the release ID

 

4.     You can identify the release by the release details.

 

5.     Enter the releaseId of the release, and invoke the removeRelease method which will remove the relevant release from the system

 

Note: In order to remove multiple releases you need to follow step 5 for each unique release id.

 

 

 

 

Additional Information:

In case if the JMX default port is not enabled in your environment, you can verify which port is configured for JMX by accessing file distributed.properties on path <ReleaseAutomationInstallDir>\webapps\datamanagement\WEB-INF  and look for text jmx.web.console.port.The port number mentioned here will be the port where JMX is exposed.