Salesforce

Is there a way to trim a specific Agent of the Unified Broker ?

« Go Back

Information

 
TitleIs there a way to trim a specific Agent of the Unified Broker ?
URL NameP108395
Article Number000127727
EnvironmentProduct: OpenEdge
Version: 11.x
OS: All supported platforms
Other: AppServer
Question/Problem Description
Is there a way to trim a specific Agent of the unified Broker ?
How to trim a specific Agent of the Unified Broker ?
Can I trim a specific AppServer Agent ?
 
Steps to Reproduce
Clarifying Information
Error Message
Defect NumberEnhancement OE00119899
Enhancement Number
Cause
Resolution
Upgrade to OpenEdge 11.0 or later release.

Starting with OpenEdge 11.0, the command-line ASBMAN utility utiility supports the -agentstop <pid> and -agentkill <pid> Options for this purpose:
  • -agentstop (pid)                    Shutdown agent gracefully
  • -agentkill (pid)                       Kill agent forcefully
The PID of an Agent can be found using the asbman -query and wtbman -query command.
  • asbman -agentkill all follows the same logic as asbman -kill which sends a SIGKILL signal to terminate the process
  • asbman -agentstop all follows the same logic as asbman -stop which sends a SIGTERM signal to terminate the process
Example using default asbroker1 AppServer broker:   
$   asbman -query -i asbroker1
 
After broker startup, asbman -n asbroker1 -query shows 5 agents

Calling "asbman -i asbroker1 -agentstop 05124" and "asbman -i asbroker1 -agentkill 08300" results in:

-agentstop results in shutdown, -agentkill gives unconditional shutdown, both agents are gone from next asbman -query


Example using default wsbroker1 WebSpeed broker:   

1. Use the following command to find the PID of the agent.
wtbman -i wsbroker1 -query

2. Terminate the agent:
wtbman -i wsbroker1 -agentstop <PID>
wtbman -i wsbroker1 -agentkill <PID>
Workaround
To "trim" a specific Broker Agent on UNIX:
  • Find the Agent PID through ***man -name broker-name -query
  • Try kill -1, if that fails
  • Try kill -15, if that fails (or other signals fail)
  • Consider kill -9 at a time which will minimally affect the Application
WARNING:  If the Agents are configured as shared-memory client connections, killing an agent / client that is holding a latch or lock may crash the database.
Notes
Keyword Phrase
Last Modified Date11/20/2020 7:30 AM

Powered by