Al\u00e9m disso , h\u00e1 dois tipos de alvos:<\/p>\n
- \n
- Alvos de Reposit\u00f3rio (“Repository Side”)<\/li>\n
- Alvos de Agente (“Agent Side”)<\/li>\n<\/ul>\n
Para consultar os alvos de Reposit\u00f3rio, utilize a seguinte query\u00a0dentro do seu reposit\u00f3rio do EM:<\/p>\n
SELECT ENTITY_TYPE,\r\n TYPE_DISPLAY_NAME,\r\n ENTITY_NAME,\r\n DISPLAY_NAME\r\nFROM SYSMAN.EM_MANAGEABLE_ENTITIES\r\nWHERE MANAGE_STATUS = 2\r\nAND REP_SIDE_AVAIL = 1\r\nORDER BY 1,\r\n 2;<\/pre>\n
Para consultar os alvos de Agente, use esta query dentro do seu reposit\u00f3rio EM:<\/p>\n
SELECT ENTITY_TYPE,\r\n TYPE_DISPLAY_NAME,\r\n ENTITY_NAME,\r\n DISPLAY_NAME,\r\n EMD_URL\r\nFROM SYSMAN.EM_MANAGEABLE_ENTITIES\r\nWHERE MANAGE_STATUS = 2\r\nAND REP_SIDE_AVAIL = 0\r\nAND EMD_URL IS NOT NULL\r\nORDER BY 1,\r\n 2,\r\n 3;<\/pre>\n
Os alvos de Agente s\u00e3o armazenados tamb\u00e9m dentro do host sendo monitorado. Voc\u00ea pode list\u00e1-los com o seguinte script\u00a0(como usu\u00e1rio owner do EM Agent):<\/p>\n
[root@evabddrjs001 ~]# su - emc12\r\n[emc12@evabddrjs001 ~]$ $AGENT_HOME\/bin\/emctl config agent listtargets\r\nOracle Enterprise Manager Cloud Control 12c Release 2\r\nCopyright (c) 1996, 2012 Oracle Corporation. All rights reserved.\r\n[10.221.63.104, host]\r\n[10.221.63.104:3872, oracle_emd]\r\n[agent12c1_2_evabddrjs001, oracle_home]\r\n[COLISEU_104, oracle_database]\r\n[OraDb10g_home1_1_evabddrjs001, oracle_home]\r\n[COLISEU_10.221.63.104, oracle_listener]\r\n[emc12@evabddrjs001 ~]$<\/pre>\n
Primeiro, vamos ver um exemplo de como renomear alvos do Reposit\u00f3rio:<\/p>\n
Renomear alvos de Reposit\u00f3rio<\/h2>\n
O que voc\u00ea precisa saber:<\/p>\n
- \n
- Esses alvos n\u00e3o<\/strong> s\u00e3o monitorados pelo agente do Cloud Control.<\/li>\n
- Esses alvos n\u00e3o<\/strong> est\u00e3o presentes nos arquivos do agente do Cloud Control “$AGENT_BASE\/sysman\/emd\/targets.xml”<\/li>\n
- Esses alvos est\u00e3o apenas presentes no reposit\u00f3io do Cloud Control repository e eles s\u00e3o mais conhecidos como alvos de “Sistema” ou alvos agregados (como grupos).<\/li>\n<\/ul>\n
O “Display Name” e o “Target Name” s\u00e3o quase sempre iguais para alvos de Reposit\u00f3rio.<\/p>\n
\u00c9 poss\u00edvel renomear alvos de Reposit\u00f3rio. Para come\u00e7ar, execute o\u00a0seguinte comando “emcli”, como usu\u00e1rio oracle dentro do servidor do OEM:<\/p>\n
[root@ec12mntrjr001 ~]# su - oracle\r\n[oracle@ec12mntrjr001 ~]$ emcli login -username=sysman\r\nEnter password :\r\n\r\nLogin successful\r\n[oracle@ec12mntrjr001 ~]$ emcli sync\r\nSynchronized successfully<\/pre>\n
Target Name<\/h3>\n
Para renomear o “Target Name” do nome, use o comando abaixo:<\/p>\n
-target_name=<“target name” atual>
\n-new_target_name=<novo “target name”><\/p>\nEx: Renomenado um\u00a0target name de\u00a0“oracbddrjs_cluster”<\/strong><\/em><\/span>\u00a0para\u00a0“oracbddrjs-cluster”<\/strong><\/em><\/span>.<\/p>\n
[oracle@ec12mntrjr001 ~]$ emcli rename_target -target_type=\"cluster\" -target_name=\"oracbddrjs_cluster\" -new_target_name=\"oracbddrjs-cluster\"<\/pre>\n
Agora verifique com a query de “alvos de Reposit\u00f3rio” se o “Target name” e o “Display name” foram alterados.<\/p>\n
Se apenas o “target name” tiver sido modificado, execute o seguinte:<\/p>\n
Display Name<\/h3>\n
Para renomar o “Display Name” do alvo, use o comando:<\/p>\n
-name=<“Target name”> # Perceba que aqui eu utilizei o novo nome pois eu j\u00e1 o renomeei na etapa anterior.
\n-display_name=<novo “Display name”><\/p>\nEx: Renomeando um display name para\u00a0“oracbddrjs-cluster”<\/em><\/span><\/strong>.<\/p>\n
[oracle@ec12mntrjr001 ~]$ emcli modify_target -name=\"oracbddrjs-cluster\" -type=\"cluster\" -display_name=\"oracbddrjs-cluster\"\r\nTarget \"oracbddrjs-cluster:cluster\" modified successfully\r\n[oracle@ec12mntrjr001 ~]$<\/pre>\n
Agora vamos ver um exemplo de como renomear alvos de Agentes:<\/p>\n
Renomear alvos de Agente<\/h2>\n
O que voc\u00ea precisa saber:<\/p>\n
- \n
- Esses alvos s\u00e3o<\/strong> monitorados pelo agente do Cloud Control.<\/li>\n
- Esses alvos est\u00e3o<\/strong> presentes nos arquivos do agente do Cloud Control “$AGENT_BASE\/sysman\/emd\/targets.xml”<\/li>\n<\/ul>\n
O “Display Name” e o “Target Name” podem ser diferentes para alvos de Agente.
\nO “Target Name” para um alvo de Agente \u00e9 o nome do alvo no arquivo “$AGENT_BASE\/sysman\/emd\/targets.xml” do agente do EM Cloud Control.
\n(Que pode ser obtido executando o comando “emctl config agent listtargets” no agente do EM Cloud Control).<\/p>\nDisplay Name<\/h3>\n
Para modificar o “Display Name” de um alvo de Agente, voc\u00ea pode executar o seguinte comando:<\/p>\n
Ex: Renomeando o\u00a0display\u00a0name do listener para\u00a0“LISTENER_10.221.63.104”<\/em><\/strong><\/span>.<\/p>\n
[root@ec12mntrjr001 ~]# su - oracle\r\n[oracle@ec12mntrjr001 ~]$ emcli login -username=sysman\r\nEnter password :\r\n\r\nLogin successful\r\n[oracle@ec12mntrjr001 ~]$ emcli modify_target -name=\"COLISEU_10.221.63.104\" -type=\"oracle_listener\" -display_name=\"LISTENER_10.221.63.104\" -on_agent\r\nTarget \"COLISEU_10.221.63.104:oracle_listener\" modified successfully<\/pre>\n
Verificando no alvo:<\/p>\n
[emc12@evabddrjs001 ~]$ emctl config agent listtargets\r\nOracle Enterprise Manager Cloud Control 12c Release 2\r\nCopyright (c) 1996, 2012 Oracle Corporation. All rights reserved.\r\n[10.221.63.104, host]\r\n[10.221.63.104:3872, oracle_emd]\r\n[agent12c1_2_evabddrjs001, oracle_home]\r\n[COLISEU_104, oracle_database]\r\n[OraDb10g_home1_1_evabddrjs001, oracle_home]\r\n[COLISEU_10.221.63.104, oracle_listener]\r\n[emc12@evabddrjs001 ~]$<\/pre>\n
O “Target name” n\u00e3o mudou, mas o “Display name” est\u00e1 agora como na figura abaixo:<\/p>\n
![\"\"](\"http:\/\/www.dbarj.com.br\/wp-content\/uploads\/2013\/10\/img_5259df16219d0.png\")
<\/p>\nTarget Name<\/h3>\n
Aten\u00e7\u00e3o: Execute os comando abaixos assumindo um risco. Oracle n\u00e3o suporta isto ainda e ser\u00e1 necess\u00e1rio efetuar modifica\u00e7\u00f5es em packages do SYSMAN.<\/p>\n
Neste exemplo, n\u00f3s iremos renomear o target name de um listener de\u00a0“COLISEU_10.221.63.104”<\/em><\/span>\u00a0para\u00a0“LISTENER_10.221.63.104”<\/span><\/em>. Note\u00a0que o\u00a0display name j\u00e1 foi alterado na etapa anterior.<\/strong><\/p>\n
Antes de mais nada, pare o agente na m\u00e1quina alvo, edite o arquivo “$AGENT_BASE\/sysman\/emd\/targets.xml” com o nome desejado para o “Target name” e inicie o agente novamente:<\/p>\n
[emc12@evabddrjs001 ~]$ emctl stop agent\r\nOracle Enterprise Manager Cloud Control 12c Release 2\r\nCopyright (c) 1996, 2012 Oracle Corporation. All rights reserved.\r\nStopping agent ..... stopped.\r\n[emc12@evabddrjs001 ~]$ vim $AGENT_BASE\/sysman\/emd\/targets.xml<\/pre>\n
Antes:<\/p>\n
[emc12@evabddrjs001 ~]$ cat $AGENT_BASE\/sysman\/emd\/targets.xml<\/pre>\n
...\r\n<Target TYPE=\"oracle_listener\" NAME=\"COLISEU_10.221.63.104\" DISPLAY_NAME=\"LISTENER_10.221.63.104\" ON_HOST=\"\" EMD_URL=\"https:\/\/10.221.63.104:3872\/emd\/main\/\" TIMEZONE_REGION=\"\" IDENTIFIER=\"TARGET_GUID=0AD03AC01B183A0E9762470BD2A4799E\">\r\n<Property NAME=\"Machine\" VALUE=\"10.221.63.104\"\/>\r\n<Property NAME=\"Port\" VALUE=\"1521\"\/>\r\n<Property NAME=\"ListenerOraDir\" VALUE=\"\/software\/app\/oracle\/product\/network\/admin\"\/>\r\n<Property NAME=\"OracleHome\" VALUE=\"\/software\/app\/oracle\/product\"\/>\r\n<Property NAME=\"LsnrName\" VALUE=\"LISTENER\"\/>\r\n<\/Target>\r\n...<\/pre>\n
Depois:<\/p>\n
[emc12@evabddrjs001 ~]$ cat $AGENT_BASE\/sysman\/emd\/targets.xml<\/pre>\n
\u00a0...\r\n<Target TYPE=\"oracle_listener\" NAME=\"LISTENER_10.221.63.104\" DISPLAY_NAME=\"LISTENER_10.221.63.104\" ON_HOST=\"\" EMD_URL=\"https:\/\/10.221.63.104:3872\/emd\/main\/\" TIMEZONE_REGION=\"\" IDENTIFIER=\"TARGET_GUID=0AD03AC01B183A0E9762470BD2A4799E\">\r\n<Property NAME=\"Machine\" VALUE=\"10.221.63.104\"\/>\r\n<Property NAME=\"Port\" VALUE=\"1521\"\/>\r\n<Property NAME=\"ListenerOraDir\" VALUE=\"\/software\/app\/oracle\/product\/network\/admin\"\/>\r\n<Property NAME=\"OracleHome\" VALUE=\"\/software\/app\/oracle\/product\"\/>\r\n<Property NAME=\"LsnrName\" VALUE=\"LISTENER\"\/>\r\n<\/Target>\r\n...<\/pre>\n
[emc12@evabddrjs001 ~]$ emctl start agent\r\nOracle Enterprise Manager Cloud Control 12c Release 2\r\nCopyright (c) 1996, 2012 Oracle Corporation. All rights reserved.\r\nStarting agent .................. started.\r\n[emc12@evabddrjs001 ~]$ vim $AGENT_BASE\/sysman\/emd\/targets.xml\r\n[emc12@evabddrjs001 ~]$ emctl config agent listtargets\r\nOracle Enterprise Manager Cloud Control 12c Release 2\r\nCopyright (c) 1996, 2012 Oracle Corporation. All rights reserved.\r\n[10.221.63.104, host]\r\n[10.221.63.104:3872, oracle_emd]\r\n[agent12c1_2_evabddrjs001, oracle_home]\r\n[COLISEU_104, oracle_database]\r\n[OraDb10g_home1_1_evabddrjs001, oracle_home]\r\n[LISTENER_10.221.63.104, oracle_listener]\r\n[emc12@evabddrjs001 ~]$<\/pre>\n
O nome do target no cliente foi alterado. No entanto, apenas essas mudan\u00e7as n\u00e3o s\u00e3o suficiente.s Se voc\u00ea verificar no EM, ver\u00e1 que o “Target name” continua o mesmo.<\/p>\n
Agora, teremos 2 m\u00e9todos diferentes com o mesmo resultado para terminar essa renomea\u00e7\u00e3o do target:<\/p>\n
M\u00e9todo 1:<\/h4>\n
Se voc\u00ea tentar renomear o “Target name” como fizemos com os alvos de Reposit\u00f3rio, voc\u00ea receber\u00e1 o seguinte erro:<\/p>\n
[oracle@ec12mntrjr001 ~]$ emcli rename_target -target_type=\"oracle_listener\" -target_name=\"COLISEU_10.221.63.104\" -new_target_name=\"LISTENER_10.221.63.104\"\r\nRename not supported for given Target Type.<\/pre>\n
Esse comando chama, implicitamente, a procedure\u00a0SYSMAN.EM_TARGET.RENAME_TARGET.<\/p>\n
Infelizmente, se verificarmos o c\u00f3digo dentro da procedure, veremos que existe o coment\u00e1rio:<\/p>\n
-- we will implement rename of agent side targets when it is fully\r\n-- supported by agent<\/pre>\n
No entanto, j\u00e1 fizemos essa altera\u00e7\u00e3o manual no nome do target do agente.<\/p>\n
Para completar a tarefa, voc\u00ea precisar\u00e1 editar a PACKAGE BODY SYSMAN.EM_TARGET. Fa\u00e7a um backup do c\u00f3digo e efetive as mudan\u00e7as:<\/p>\n
De:<\/p>\n
-- we will implement rename of agent side targets when it is fully\r\n -- supported by agent\r\n IF ( l_trec.manage_status = MANAGE_STATUS_MANAGED AND\r\n l_trec.emd_url IS NOT NULL) \r\n THEN\r\n raise_application_error(MGMT_GLOBAL.INVALID_PARAMS_ERR,\r\n MGMT_GLOBAL.INVALID_PARAMS_ERR||' Not allowed') ;\r\n END IF ;<\/pre>\n
Para:<\/p>\n
-- we will implement rename of agent side targets when it is fully\r\n -- supported by agent\r\n IF ( l_trec.manage_status = MANAGE_STATUS_MANAGED AND\r\n l_trec.emd_url IS NOT NULL) \r\n THEN\r\n --raise_application_error(MGMT_GLOBAL.INVALID_PARAMS_ERR,\r\n -- MGMT_GLOBAL.INVALID_PARAMS_ERR||' Not allowed') ;\r\n\t null;\r\n END IF ;<\/pre>\n
Agora fa\u00e7a o recompile da package e de qualquer objeto dependente iv\u00e1lido::<\/p>\n
SQL> EXEC sys.UTL_RECOMP.recomp_serial('SYSMAN');\r\n\r\nPL\/SQL procedure successfully completed.<\/pre>\nVamos tentar de novo. Ups, recebemos um erro:<\/p>\n
[oracle@ec12mntrjr001 ~]$ emcli rename_target -target_type=\"oracle_listener\" -target_name=\"COLISEU_10.221.63.107\" -new_target_name=\"LISTENER_10.221.63.107\"\r\nORA-04068: existing state of packages has been discarded\r\nORA-04061: existing state of package body \"SYSMAN.EM_TARGET\" has been invalidated\r\nORA-04065: not executed, altered or dropped package body \"SYSMAN.EM_TARGET\"\r\nORA-06508: PL\/SQL: could not find program unit being called: \"SYSMAN.EM_TARGET\"\r\nORA-06512: at \"SYSMAN.MGMT_TARGET\", line 3373\r\nORA-06512: at line 1<\/pre>\n
Se voc\u00ea recebeu este erro, apenas reconecte ou fa\u00e7a o resync da sess\u00e3o que estava aberta antes da altera\u00e7\u00e3o do c\u00f3digo da package e tente novamente:<\/p>\n
[oracle@ec12mntrjr001 ~]$ emcli sync\r\nSynchronized successfully\r\n[oracle@ec12mntrjr001 ~]$ emcli rename_target -target_type=\"oracle_listener\" -target_name=\"COLISEU_10.221.63.107\" -new_target_name=\"LISTENER_10.221.63.107\"\r\nTarget COLISEU_10.221.63.107 successfully renamed to LISTENER_10.221.63.107.<\/pre>\n
\u00d3timo. Agora recupere o c\u00f3digo da package body original do backup que foi feito e coloque de volta a linha comentada.<\/p>\n
M\u00e9todo 2:<\/h4>\n
Tamb\u00e9m existe outro caminho para trocar o nome do target dentro do metadados do OEM 12c. N\u00f3s podemos chamar diretamente a procedure que foi alterada no “M\u00e9todo 1”:<\/p>\n
SQL> exec sysman.em_target.rename_target('oracle_listener','COLISEU_10.221.63.104','LISTENER_10.221.63.104');\r\n\r\nbegin sysman.em_target.rename_target('oracle_listener','COLISEU_10.221.63.104','LISTENER_10.221.63.104'); end;\r\n\r\nORA-20233: -20233 Not allowed\r\nORA-06512: at \"SYSMAN.EM_TARGET\", line 5040\r\nORA-06512: at line 2<\/pre>\nEu recebi o erro acima porque \u00e9 preciso comentar as linhas do Package Body exatamente como foi feito no “M\u00e9todo 1”. Fa\u00e7a ent\u00e3o o backup do c\u00f3digo, comente, recompile as repend\u00eancias e execute novamente:<\/p>\n
SQL> exec sysman.em_target.rename_target('oracle_listener','COLISEU_10.221.63.104','LISTENER_10.221.63.104');\r\n\r\nbegin sysman.em_target.rename_target('oracle_listener','COLISEU_10.221.63.104','LISTENER_10.221.63.104'); end;\r\n\r\nORA-04068: existing state of packages has been discarded\r\nORA-04061: existing state of package \"SYSMAN.EM_TARGET\" has been invalidated\r\nORA-04065: not executed, altered or dropped package \"SYSMAN.EM_TARGET\"\r\nORA-06508: PL\/SQL: could not find program unit being called: \"SYSMAN.EM_TARGET\"\r\nORA-06512: at line 2<\/pre>\nSe voc\u00ea receber este erro, apenas reconecte ou fa\u00e7a o resync da sess\u00e3o que estava aberta antes da altera\u00e7\u00e3o do c\u00f3digo da package e tente novamente:<\/p>\n
SQL> exec sysman.em_target.rename_target('oracle_listener','COLISEU_10.221.63.104','LISTENER_10.221.63.104');\r\n\r\nPL\/SQL procedure successfully completed\r\n\r\nSQL> commit;\r\n\r\nCommit complete\r\n\r\nSQL><\/pre>\n\u00d3timo, agora vamos verificar na tela do EM:<\/p>\n
![\"\"](\"http:\/\/www.dbarj.com.br\/wp-content\/uploads\/2013\/10\/img_5259df864dd59.png\")
<\/p>\nTudo est\u00e1 funcionando bem. N\u00e3o esque\u00e7a de restaurar o c\u00f3digo original da package body com o backup que voc\u00ea fez, colocando de volta as linhas comentadas.<\/p>\n
Agora finalmente o seu target foi renomeado.<\/p>\n
Esse artigo foi escrito baseado no documento do Metalink Doc ID 1515413.1, com muitas e muitas adapta\u00e7\u00f5es.<\/strong>
\n
\nGostou? N\u00e3o deixe de comentar ou deixar um \ud83d\udc4d!<\/b><\/p>\n - Esses alvos est\u00e3o<\/strong> presentes nos arquivos do agente do Cloud Control “$AGENT_BASE\/sysman\/emd\/targets.xml”<\/li>\n<\/ul>\n
- Esses alvos n\u00e3o<\/strong> est\u00e3o presentes nos arquivos do agente do Cloud Control “$AGENT_BASE\/sysman\/emd\/targets.xml”<\/li>\n
- Esses alvos n\u00e3o<\/strong> s\u00e3o monitorados pelo agente do Cloud Control.<\/li>\n
