Por uma questão pontual, precisava deletar um agent do Oracle Enterprise Manager Cloud Control (OEM13C). Encontrei um procedimento documentado no Oracle Note “EM 12c, EM 13c: How to Delete Agent and Targets Using emcli with the delete_target Verb in Enterprise Manager Cloud Control (Doc ID 1459204.1)“.
O primeiro passo, é você estar no ambiente onde foi instalado a aplicação OEM13C, pois precisará usar o utilitário “EMCLI”. Caso não saiba onde ele está localizado, faça um find -name na área de binários para facilitar o trabalho:
[user@hostname OEM13C]$ find -name emcli
./XXX/OPatch/Patches/28161815/28161815/files/oracle.sysman.top.oms/13.2.0.0.0/oracle.sysman.top.oms.symbol/sysman/emcli
./XXX/OPatch/Patches/28161815/28161815/files/oracle.sysman.top.oms/13.2.0.0.0/oracle.sysman.top.oms.symbol/sysman/emcli/omssideext/standardomsside.jar/oracle/sysman/core/common/blackouts/emcli
./XXX/OPatch/Patches/28161815/28161815/files/oracle.sysman.top.oms/13.2.0.0.0/oracle.sysman.top.oms.symbol/sysman/emcli/omssideext/standardomsside.jar/oracle/sysman/emdrep/user_model/emcli
./XXX/OPatch/Patches/28161815/28161815/files/oracle.sysman.top.oms/13.2.0.0.0/oracle.sysman.top.oms.symbol/sysman/emcli/omssideext/standardomsside.jar/oracle/sysman/eml/admin/rep/emdConfig/emcli
./XXX/OPatch/25672422/25414245/files/oracle.sysman.cfw.oms.plugin/13.2.1.0.0/em.plugin.common.symbol/oracle.sysman.cfw.oms.plugin_13.2.1.0.0/archives/emcli
. . .
./XXX/bin/emcli
./XXX/plugins/oracle.sysman.ssa.oms.plugin_13.2.1.0.0/archives/emcli
./XXX/plugins/oracle.sysman.emas.oms.plugin_13.2.1.0.0/archives/emcli
. . .
[user@hostname OEM13C]$
Como era esperado, o utilitário se encontra no “EMCLI_HOME/bin”. Desse modo, tentei disparar o delete do target, porém recebi o seguinte erro:
[user@hostname bin]$ ./emcli delete_target -name="target_name:XXXX" -type="oracle_emd" -delete_monitored_targets -async
Error: Session expired. Run emcli login to establish a session.
Me deparei com outro Oracle Note (“EM 12c, EM 13c: EMCLI commands Fail with Message: Error: Session expired. Run emcli login to establish a session (Doc ID 1913968.1)“), reportando que o erro podia ter 4 causas. No meu caso, foi por conta do usuário do emcli estar expirado.
O comando abaixo caracteriza essa situação:
[user@hostname bin]$ ./emcli sync
Error: Session expired. Run emcli login to establish a session.
Conforme procedimento, foi necessário executar o comando abaixo para normalizar a situação do usuário. É solicitado que se passe a senha do usuário default “sysman”
[user@hostname bin]$ ./emcli login -username=sysman
Enter password :
Login successful
Depois disso, a execução da exclusão do agent (e seus targets associados) procedeu com sucesso:
[user@hostname bin]$ ./emcli delete_target -name="target_name:XXXX" -type="oracle_emd" -delete_monitored_targets -async
Target "target_name:XXXX:oracle_emd" deleted successfully
[user@hostname bin]$