Oracle EMCC 12c emcli命令行工具安装以及使用介绍

来源：这里教程网时间：2026-03-03 16:10:33 作者：

emcli command-line interface可以执行几乎所有EMCC控制台界面的操作。之前工作中，在目标端服务器部署agent时，通过控制台图形界面进行配置目标端自动搜索时，偶尔会遇见无法搜索发现某些目标类型的情况。例如目标服务器上面存在oracle instance以及listener，配置自动搜索后无法发现此类型的目标，并且排查失败原因比较耗时。此时就需要通过emcli命令行接口登录OMS去执行添加操作。这里介绍的是命令行模式下的emcli的一些操作，此外还有交互脚本模式这里不做介绍。

1. 环境要求

■ Enterprise Manager 12c Cloud Control framework

■ Sun Java JRE version 1.6.0_43 or greater

■ Workstation running Solaris, Linux, HPUX, Tru64, AIX, or Windows with NTFS

2.下载emcli，下载地址如下

https://xx.xx.xx.xx:7799/em/public_lib_download/emcli/kit/emclikit.jar ,ip为oms的服务器地址

3.安装jdk1.8,设置JAVA_HOME

[oracle@rptdb ~]$ tar -xvf jdk-8u231-linux-x64.tar.gz
[oracle@rptdb bin]$ /home/oracle/jdk1.8.0_231/bin/java -version          
java version "1.8.0_231"
Java(TM) SE Runtime Environment (build 1.8.0_231-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.231-b11, mixed mode)
[oracle@rptdb ~]$ export JAVA_HOME=/home/oracle/jdk1.8.0_231
[oracle@rptdb ~]$ env | grep JAVA_HOME
JAVA_HOME=/home/oracle/jdk1.8.0_231

4.创建安装目录，执行安装

[oracle@rptdb ~]$ mkdir emcli
[oracle@rptdb ~]$ $JAVA_HOME/bin/java -jar emclikit.jar -install_dir=/home/oracle/emcli
Oracle Enterprise Manager 12c Release 5.
Copyright (c) 2012, 2015 Oracle Corporation.  All rights reserved.
EM CLI client-side install completed successfully.
Execute "emcli help setup" from the EM CLI home (the directory where you have installed EM CLI) for further instructions.

5.使用emcli，登录oms

在非oms服务器本地上使用emcli登录oms，需要先进行setup配置。

--查看相关语法：

./emcli help setup

./emcli help sync

--执行初始化配置:

[oracle@rptdb emcli]$ ./emcli setup -url=http://10.10.201.152:7788/em -username="sysman" -dir="/home/oracle/emcli" -verb_jars_dir="/home/oracle/emcli" -trustall -autologin
Oracle Enterprise Manager 12c Release 5.
Copyright (c) 1996, 2015 Oracle Corporation and/or its affiliates. All rights reserved.
Enter password
Emcli setup successful

注: -autologin参数的作用是，如果登录超时，emcli会自动进行登录。默认时 noautologin模式，emcli超过45min没用执行操作，会超时，需要重新登录。

--执行同步操作:

[oracle@rptdb emcli]$./emcli sync
Synchronized successfully
[oracle@rptdb emcli]$

--查看状态:

[oracle@rptdb emcli]$ ./emcli status
Oracle Enterprise Manager 12c Release 5 EM CLI.
Copyright (c) 1996, 2015 Oracle Corporation and/or its affiliates. All rights reserved.
Instance Home          : /home/oracle/emcli/.emcli
Verb Jars Home         : /home/oracle/emcli/.emcli
Status                 : Configured
EM CLI Home            : /home/oracle/emcli/.
EM CLI Version         : 12.1.0.5.0
Java Home              : /home/oracle/jdk1.8.0_231/jre
Java Version           : 1.8.0_231
Log file               : /home/oracle/emcli/.emcli/.emcli.log
EM URL                 : http://10.10.201.152:7788/em
EM user                : sysman
Auto login             : true
Trust all certificates : true

6.添加，查看，删除主机上的目标

先在目标端主机上部署agent，这里不做介绍。

6.1.add_target语法如下:

emcli add_target

-name="name"

-type="type"

-host="hostname"

[-properties="pname1:pval1;pname2:pval2;..."]

[-separator=properties="sep_string"]

[-subseparator=properties="subsep_string"]

[-credentials="userpropname:username;pwdpropname:password;..."]

[-input_file="parameter_tag:file_path"]

[-display_name="display_name"]

[-groups="groupname1:grouptype1;groupname2:grouptype2;..."]

[-timezone_region="gmt_offset"]

[-monitor_mode="monitor_mode"]

[-instances="rac_database_instance_target_name1:target_type1;..."]

[-force=true|false]

[-timeout="time_in_seconds"]

--添加l类型为oracle数据库目标

[oracle@rptdb emcli]$ ./emcli add_target -name="ekpdev" -type="oracle_database" -host="ekptest" -prop="SID:ekpdev;MachineName:ekptest" -prop="OracleHome:/u01/app/oracle/product/11.2.0/db_1;Port:1521" -credentials="UserName:dbsnmp;password:oracle;Role:normal"
Target "ekpdev:oracle_database" added successfully

--添加类型为listener的目标的方法:

[oracle@rptdb emcli]$ ./emcli add_target -name="LISTENER_ekpdev" -type="oracle_listener" -host="ekptest" -prop="Machine:ekptest;OracleHome:/u01/app/oracle/product/11.2.0/db_1;ListenerOraDir:/u01/app/oracle/product/11.2.0/db_1/network/admin;LsnrName:LISTENER;Port:1521"
Target "LISTENER_ekpdev:oracle_listener" added successfully

6.2. 获取目标状态信息

语法如下:

emcli get_targets

[-targets="[name1:]type1;[name2:]type2;..."]

[-alerts]

[-noheader]

[-script | -format=

[name:<pretty|script|csv>];

[column_separator:"column_sep_string"];

[row_separator:"row_sep_string"];

]

[-limit_rows="maximum_targets_to_be_retrieved"]

[-config_search="configuration_search_UI_name"]

[-unmanaged]

[-properties]

[-separator_properties="properties_sep_string"]

[-subseparator_properties="properties_subsep_string"]

[oracle@rptdb emcli]$ ./emcli get_targets -targets="ekpdev:oracle_database;"
Status  Status           Target Type           Target Name                        
ID                                                                               
1       Up               oracle_database       ekpdev
[oracle@rptdb emcli]$ ./emcli get_targets -targets="LISTENER_ekpdev:oracle_listener;"
Status  Status           Target Type           Target Name                        
ID                                                                               
1       Up               oracle_listener       LISTENER_ekpdev

登录emcc控制台，可以看见目标添加成功:

6.3删除目标

语法如下:

emcli delete_target

-name=<name>

-type=<type>

[-delete_monitored_targets]

[-async]

[-delete_members]

[oracle@rptdb emcli]$ ./emcli delete_target –type = "oracle_database" –name="ekpdev"
Target " ekpdev:oracle_database" deleted successfully
[oracle@rptdb emcli]$ ./emcli delete_target  -name="LISTENER_ekpdev" -type="oracle_listener"
Target "LISTENER_ekpdev:oracle_listener" deleted successfully

6.7 转移目标到新的target

当一个目标需要迁移到别的主机上时，常规的操作是先删除当前的目标，然后在新的目标端添加该目标。或者当前目标主机上在别的路径新部署了一个agent，需要删除老的agent的安装目录二进制文件，需要删除后重新添加目标。这样就会丢失该目标历史的相关度量信息。此时可以使用relocate targets，保证不丢失该目标历史的度量信息。

语法如下:

emcli relocate_targets

-src_agent=<source_agent_target_name>

-dest_agent=<dest_agent_target_name>

-target_name=<name_of_target_to_be_relocated>

-target_type=<type_of_target_to_be_relocated>

-copy_from_src

-changed_param=<propName>:<propValue>

-input_file:dupTargets=<targets_contents>

-input_file:moveTargets="complete path to file containing targets with

overridden property values"

-copy_from_src [-changed_param=<propName>:<propValue>]*

[-ignoreRelatedTargets]

[-noHostColumnUpdate]

[-ignoreTimeSkew=yes]

[-changed_param=MachineName:mmmm ]

[-force=yes]

例如，我需要把 crmmysql01主机上一个mysql迁移到一台新的服务器上，并进行监控。新的服务器 prdmysql01 安装好agent，mysql迁移完成后,就可以执行下面命令进行relocate target:

emcli relocate_targets 
-src_agent="crmmysql01:3872" 
-dest_agent="
prdmysql01
:3872" 
-target_name="crmmysql01" 
-target_type="mysql" 
-copy_from_src

7.使用emcli管理agent

可以通过emcli远程管理，启停所有目标端服务器上的agent

7.1列出类型为agent的目标:

[oracle@rptdb emcli]$ ./emcli get_targets -targets="oracle_emd" 
Status  Status           Target Type           Target Name                        
ID                                                                               
1       Up               oracle_emd            crmmysql03:3872                    
1       Up               oracle_emd            ekptest:3872                       
1       Up               oracle_emd            EKPDB01:3872                       
1       Up               oracle_emd            zysf:3872                          
1       Up               oracle_emd            oms.oracle.com:3872                
1       Up               oracle_emd            ngpdb02:3872                       
1       Up               oracle_emd            ngpdb01:3872                       
1       Up               oracle_emd            crmmysql02:3872                    
1       Up               oracle_emd            ngppdg:3872                        
1       Up               oracle_emd            rptdb:3872                         
1       Up               oracle_emd            crmmysql01:3872                    
1       Up               oracle_emd            crmngpstd:3872

7.2关闭agent

[oracle@rptdb emcli]$ ./emcli stop_agent -agent=ekptest:3872 -host_username=oracle
Host User password:
The Shut Down operation is in progress for the Agent: ekptest:3872
The Agent "ekptest:3872" has been stopped successfully.
---------------------
Operation Output
---------------------
Oracle Enterprise Manager Cloud Control 12c Release 5  
Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.Stopping agent ..... stopped.

7.3启动agent

[oracle@rptdb emcli]$ ./emcli start_agent -agent=ekptest:3872 -host_username=oracle
Host User password:
The Start Up operation is in progress for the Agent: ekptest:3872
The Agent "ekptest:3872" has been started successfully.
---------------------
Operation Output
---------------------
Oracle Enterprise Manager Cloud Control 12c Release 5  
Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.Starting agent ................ started.

--启动后查看agent状态

[oracle@rptdb emcli]$ ./emcli get_targets -targets="ekptest:3872:oracle_emd"
Status  Status           Target Type           Target Name                        
ID                                                                               
1       Up               oracle_emd            ekptest:3872

7.4重启agent

[oracle@rptdb emcli]$ ./emcli restart_agent -agent=ekptest:3872 -host_username=oracle
Host User password:
The Restart operation is in progress for the Agent: ekptest:3872
The Agent "ekptest:3872" has been restarted successfully.
---------------------
Operation Output
---------------------
Oracle Enterprise Manager Cloud Control 12c Release 5  
Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.Stopping agent ..... stopped.Oracle Enterprise Manager Cloud Control 12c Release 5  
Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.Starting agent ................ started.

7.5查看agent的配置信息

[oracle@rptdb emcli]$ ./emcli get_agent_properties -agent_name=ekptest:3872
Name                            Value                                             
agentVersion                    12.1.0.5.0                                        
agentTZRegion                   Asia/Shanghai                                     
emdRoot                         /home/oracle/agent/core/12.1.0.5.0                
agentStateDir                   /home/oracle/agent/agent_inst                     
perlBin                         /home/oracle/agent/core/12.1.0.5.0/perl/bin       
scriptsDir                      /home/oracle/agent/core/12.1.0.5.0/sysman/admin/sc
                                ripts                                             
EMD_URL                         https://ekptest:3872/emd/main/                    
localListeningHost                                                                
localListeningPort                                                                
REPOSITORY_URL                  https://oms.oracle.com:4903/empbs/upload          
externalProxyPort                                                                 
EMAGENT_PERL_TRACE_LEVEL        INFO                                              
UploadInterval                  15                                                
Total Properties : 13

7.6 删除agent

--停止agent

[oracle@rptdb emcli]$ ./emcli stop_agent -agent=crmmysql01:3872 -host_username=crmuser
Host User password:
The Shut Down operation is in progress for the Agent: crmmysql01:3872
The Agent "crmmysql01:3872" has been stopped successfully.
---------------------
Operation Output
---------------------
Oracle Enterprise Manager Cloud Control 12c Release 5  
Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.Stopping agent ..... stopped.
[oracle@rptdb emcli]$ ./emcli stop_agent -agent=crmmysql02:3872 -host_username=crmuser
Host User password:
The Shut Down operation is in progress for the Agent: crmmysql02:3872
The Agent "crmmysql02:3872" has been stopped successfully.
---------------------
Operation Output
---------------------
Oracle Enterprise Manager Cloud Control 12c Release 5  
Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.Stopping agent ..... stopped.
[oracle@rptdb emcli]$ ./emcli stop_agent -agent=crmmysql03:3872 -host_username=crmuser
Host User password:
The Shut Down operation is in progress for the Agent: crmmysql03:3872
The Agent "crmmysql03:3872" has been stopped successfully.
---------------------
Operation Output
---------------------
Oracle Enterprise Manager Cloud Control 12c Release 5  
Copyright (c) 1996, 2015 Oracle Corporation.  All rights reserved.Stopping agent ..... stopped.

--删除主机上agent和监控的target

[oracle@rptdb emcli]$ ./emcli delete_target -type="oracle_emd" -name="crmmysql01:3872" -delete_monitored_targets -async;
Target "crmmysql01:3872:oracle_emd" deleted successfully
[oracle@rptdb emcli]$ ./emcli delete_target -type="oracle_emd" -name="crmmysql02:3872" -delete_monitored_targets -async;
Target "crmmysql02:3872:oracle_emd" deleted successfully
[oracle@rptdb emcli]$ ./emcli delete_target -type="oracle_emd" -name="crmmysql03:3872" -delete_monitored_targets -async;
Target "crmmysql03:3872:oracle_emd" deleted successfully

总结:emcli可以实现几乎EMCC控制台图形界面的所有操作，这里只列举一些简单的常用操作命令。具体可以执行./emcli help查看相关命令并结合官方文档去查看对应的操作。