用于管理agent的 EMCTL 命令
EMCTL 命令与描述
emctl start agent
启动管理代理程序。
在具有大内存配置的 IBM AIX 环境中,管理代理程序正在监视大量目标,代理程序可能无法启动。要防止此问题,请在启动管理代理程序之前,将以下参数添加到公共环境文件中:
LDR_CNTRL=“MAXDATA=0x80000000”@NOKRTL
AIXTHREAD_SCOPE=S
该变量设置数据段大小,并禁用在内核空间中加载运行时库。该参数将 AIX 线程范围上下文从缺省进程范围的“P”更改为系统范围的“S”。这减少了互斥锁争用。LDR_CNTRLAIXTHREAD_SCOPE
emctl stop agent
停止管理代理程序。
emctl status agent
列出管理代理的状态。
如果管理代理正在运行,此命令将显示有关管理代理的状态信息,包括代理主页、进程 ID 以及上次成功上载到管理存储库的时间和日期 ()。
注意:在 Windows 系统上,在执行命令之前将目录更改为目录。AGENT_INSTANCE_HOME
emctl status agent -secure
列出管理代理的安全状态以及运行管理代理的安全模式端口。它还列出了 OMS 安全状态和端口。
emctl status agent scheduler
列出所有正在运行、就绪和计划的收集线程。
emctl status agent jobs
列出当前在管理代理程序上运行的作业的状态。
emctl status agent target <target name>,<target type>,<metric>
列出指定目标的详细状态,如目标名称、目标类型等。您还可以在命令中提供特定指标名称,以获取目标的特定指标的状态。emctl status agent
emctl status agent mcache <target name>,<target type>,<metric>
列出其值存在于指标缓存中的指标的名称。
emctl upload
将挂起的文件上载到上载目录下的 OMS。.xml
emctl upload (agent)
使用此命令强制将当前管理数据从托管主机立即上载到管理服务。使用此命令,而不是等到下一次计划上传数据。
emctl reload (agent)
此命令可用于在手动修改文件后应用更改。例如,要更改上载间隔,可以修改 emd.properties,然后可以运行这些属性。emd.propertiesemctl reload
注意:Oracle 不支持手动编辑文件,除非明确记录了该过程或 Oracle 支持部门指示您这样做。targets.xml
emctl reload agent dynamicproperties [<Target_name>:<Target_Type>]...
重新计算目标的动态属性并显示它们。
emctl pingOMS [agent]
对 OMS 执行 ping 操作以检查管理代理是否能够连接到 OMS。管理代理将等待来自 OMS 的反向 ping,以便管理代理可以确认 是否成功。pingOMS
emctl config agent getTZ
配置环境中设置的当前时区。
emctl config agent getSupportedTZ
根据环境中的设置显示支持的时区。
emctl config console <fileloc> [<EM loc>]
根据文件中提到的配置条目配置控制台<fileloc>.
该参数是可选的,可用于在不同的 Oracle 主页上运行。<EM loc>
emctl config agent listtargets [<EM loc>]
列出文件中存在的由管理代理监视的所有目标名称和类型。targets.xml
该参数是可选的,可用于在不同的 Oracle 主页上运行。<EM loc>
emctl control agent runCollection <target_name>:<target_type> <metric_name>
允许您手动运行目标特定指标的集合。
例如emctl control agent runCollection myOracleHomeTargetName:oracle_home oracle_home_config.
emctl control agent runCollection <targetName>:<targetType> <colletionItemName>
对指标集合执行即时重新评估
执行此命令会导致指标的重新评估值上传到管理存储库,并在指标超过其阈值时触发警报。
要标识与衡量指标关联的衡量指标名称和收集项名称,请参阅使用 EMCTL 命令重新评估衡量指标集合。
emctl resetTZ agent
重置管理代理的时区。要将当前时区更改为其他时区,请停止管理代理,然后运行此命令。然后,您可以启动管理代理。
重要:
在更改管理代理时区之前,请首先检查是否有任何中断当前正在运行或计划在该管理代理管理的任何目标上运行。请参阅查看中断/通知中断以了解如何检查中断。
如果存在任何中断,则从云控制台中,停止该管理代理监视的所有目标上的所有计划和所有当前正在运行的中断。然后,您可以更改管理代理的时区,然后根据需要在目标上创建新的中断。
emctl getversion agent
打印管理代理的版本。
emctl dumpstate agent <component> . . .
为管理代理生成转储。此命令允许您分析管理代理的内存/CPU 问题。
emctl gensudoprops
生成管理代理的 sudo 属性。
emctl clearsudoprops
清除 sudo 属性。
emctl clearstate
清除状态目录内容。如果运行此命令,将删除位于 中的文件。状态文件是等待管理代理将其转换为相应文件的文件。$ORACLE_HOME/sysman/emd/state.xml
emctl getemhome
打印管理代理主目录。
emctl start blackout <Blackoutname> [-nodeLevel] [<Target_name>[:<Target_Type>]].... [-d <Duration>]
在目标上开始中断。
如果未输入该参数,则默认为本地节点目标。如果在 之后指定参数,则中断将应用于所有目标,并且将忽略以下任何目标列表。应以 [天] hh:mm 格式指定。<Target_name:Target_type>-nodeLevel<Blackoutname><Duration>
emctl stop blackout <Blackoutname>
停止在特定目标上启动的中断。只有那些由 emctl 工具启动的中断才能使用 emctl 停止。此命令无法停止使用控制台或 em cli 实用程序启动的中断。
emctl status blackout [<Target_name>[:<Target_Type>]]....
提供目标中断的状态。状态包括中断的类型,以及它是一次性操作、重复中断还是计划中断。此命令还指定中断是已开始还是已停止。
emctl secure agent [registration password] -emdWalletSrcUrl <url> -protocol <ssl|tls>
使用 OMS 保护管理代理。注册密码是必不可少的,因为如果您不与命令一起提供注册密码,系统将提示您输入注册密码。
该参数指示必须用于保护代理的 OMS 的 URL。-emdWalletSrcUrl
该参数指示用于保护管理代理程序的协议。允许的值为 和-protocolssltls.
emctl unsecure agent
取消保护管理代理。此命令将管理代理的端口更改为 HTTP 端口。执行此命令后,管理代理将能够通过连接到 OMS 的 HTTP 上传端口而不是 HTTPS 上传端口来上传到 HTTP 上的 OMS。
emctl verifykey
通过发送 来验证 OMS 和管理代理之间的通信。pingOMS
emctl deploy agent [-s <install-password>] [-o <omshostname:consoleSrvPort>] [-S] <deploy-dir> <deploy-hostname>:<port> <source-hostname>
仅创建和部署管理代理。
参数说明如下:
[-s <password>]: 指示用于保护管理代理程序的安装密码。
[-S ]:指示将在 STDIN 中提供密码。
[-o <omshostname:consoleSrvPort>]:指示 OMS 主机名和控制台 servlet 端口。选择不安全的端口。
<deploy-dir>:指示用于创建共享(仅状态)安装端口的目录。
<deploy-hostname:port>:指示共享(仅状态)安装的主机名和端口。选择未使用的端口。
<source-hostname>: 指示源安装的主机名。通常,它是安装 EM 的计算机。在文件中搜索主机名并将其替换为参数中提供的主机名targets.xml<deploy-hostname:port>.
<sid>:指示远程数据库的实例。仅在部署dbconsole.
emctl setproperty agent
在管理代理配置文件中配置指定的属性名称和值。标志是一个可选标志,用于在管理代理配置文件中插入新属性(如果不存在)。allow_new
模式匹配行为
创建键列条件时,即使表达式仅与值的一部分匹配,代理也会针对行计算这些条件。例如,针对 定义的条件可能会应用于 注意:喜欢以前行为的客户可以选择将属性 “” 设置为 TRUE/u1%/prod/u1z_KeyColumnLikeMatchesSubstring
emctl setproperty agent -allow_new -name _KeyColumnLikeMatchesSubstring -value TRUE
emctl getproperty agent
从管理代理配置文件中获取指定的属性或属性类别。目前,此命令不支持名称中的空格。该标志提供以空格分隔的属性名称列表。-name
emctl clear_property agent
清除管理代理程序配置文件中指定属性的值。
emctl status agent verify
验证管理代理是否处于活动状态。
适用于 OMS 的 EMCTL 命令
EMCTL 命令与描述
emctl getversion oms
显示 OMS 实例的版本。
emctl start oms
启动运行 OMS 应用程序和 JVMD 引擎所需的融合中间件组件。
具体而言,此命令将启动 HTTP 服务器、节点管理器和部署管理服务的受控服务器。此外,如果此命令在具有管理服务器的主机上运行,则管理服务器也会启动。同样,如果在配置了 Oracle BI 发布服务器的主机上运行此命令,则也会启动 Oracle BI 发布服务器。
注意:只有 Oracle 软件所有者才能启动或停止 OMS。
emctl start oms -admin_only
仅启动域的管理服务器。
emctl start oms -bip_only
仅启动 BI 发布服务器。
emctl stop oms
停止 OMS 受控服务器、JVMD 引擎和 HTTP 服务器,但使节点管理器和管理服务器保持运行状态。
注意:该命令不会停止融合中间件。emctl stop oms
emctl stop oms -all
停止所有企业管理器进程,包括管理服务器、OMS、HTTP 服务器、节点管理器、管理服务器、JVMD 引擎和 Oracle BI 发布服务器(如果在主机上配置)。
emctl stop oms -all -force
和
emctl stop oms -force
停止 OMS。
该参数可以与 和 命令一起使用。该选项强制停止相关进程。不建议使用此参数。-forceemctl stop oms -allemctl stop oms -force
emctl stop oms -bip_only [-force]
仅停止 BI 发布服务器。
该参数强制停止进程,而不是正常关闭。不建议使用此参数。-force
emctl status oms
列出 OMS、JVMD 引擎和 BI 发布服务器的状态。
emctl status oms -bip_only
仅列出 BI 发布服务器的状态。
emctl status oms -details [-sysman_pwd <pwd>]
列出 OMS 详细信息,例如:
OMS 的 HTTP 和 HTTPS 上传和控制台端口以及相应的 URL
实例主位置
OMS 日志目录
软件负载均衡器配置详细信息
管理服务器机器和端口
Oracle BI 发布者详细信息
JVMD 引擎
该参数指示企业管理器 SYSMAN 密码。如果未在命令行上提供,系统将提示您输入它。-sysman_pwd
emctl set property
设置 OMS 配置属性的值。
默认情况下,该命令将设置所有 OMS 的属性值。若要设置特定 OMS 的属性值,请指定一个额外的选项 ,其格式应为 。若要设置当前 OMS 的属性值,请指定 .”。若要设置远程 OMS 的属性,请指定emctl set property-oms_namehostname.myco.com:17707_Management_Service-oms_name = "local_oms-oms_name=<name of remote OMS>.
注意:从企业管理器 12.1.0.2.0 开始,还可以从云控制台查看和编辑 OMS 属性,如下所示:
从“设置”菜单中,选择“管理云控制”,然后选择“管理服务”。
在“管理服务”页上,单击“配置属性”。
在“配置属性”页上,可以查看和编辑 OMS 属性。
注意:你将需要 OMS 配置属性资源特权才能导航到此页。
emctl get property
显示 OMS 配置属性的值。
emctl get property -name <property name> [-oms_name <OMS name>] [-sysman_pwd "sysman password"]
显示指定属性的值。
-name指示属性的名称,并指示要为其派生属性值的 OMS 的名称。如果未提及,则显示所有 OMS 的属性值。-oms_name-oms_name
emctl set property -name <property name> -value <property value> [-oms_name <OMS name>] [-module <emoms|logging>] [-sysman_pwd "sysman password"]
设置指定属性的值。
参数说明如下:
-name:指示属性的名称。
-oms_name:指示必须为其设置属性值的 OMS。如果未指定此选项,则在全局级别或为当前 OMS 设置属性值。
-module_name:指示属性的模块。指定 或 。日志记录属性用于配置 Log4j,而 emoms 属性用于配置 OMS。loggingemoms
emctl set property -file <absolute path of the file containing properties> [-oms_name <OMS name>] [-module <emoms|logging>] [-sysman_pwd "sysman password"]
设置指定文件中属性的值。
参数说明如下:
-file_name:指示包含属性和值的 .properties 文件的绝对路径。此文件应仅包含需要设置其值的那些属性。
-oms_name:指示必须为其设置属性值的 OMS。如果未指定此选项,则在全局级别或为当前 OMS 设置属性值。
-module_name:指示属性的模块。指定 或 。日志记录属性用于配置 Log4j,而 emoms 属性用于配置 OMS。loggingemoms
emctl delete property -name <property name> [-oms_name <OMS name>] [-module <emoms|logging>] [-sysman_pwd "sysman password"]
删除指定属性的已配置值,并将其设置为默认值。
-name指示属性的名称,并指示要删除其属性值的 OMS 的名称。如果未提及,则会在全局级别或当前 OMS 中删除属性值。-oms_name-oms_name
emctl list properties
显示所有 OMS 的属性。
使用参数获取所有 OMS 的所有属性的列表。此命令可以轻松比较两个 OMS 之间的配置。-out_file
emctl list properties [-oms_name <OMS name>] [-module <emoms|logging>] [-out_file <output file name>] [-sysman_pwd "sysman password"]
显示所有客户可见 OMS 属性的值。
参数说明如下:
-oms_name:指示要为其显示属性值的 OMS。如果未指定此选项,则会显示所有 OMS 的属性值。
-module_name:指示属性的模块。此选项可用作筛选器以显示特定于模块的属性。日志记录属性用于配置 Log4j,而 emoms 属性用于配置 OMS。
-out_file:表示输出文件的绝对路径。这是将输出保存在文件中的可选参数。
emctl config oms -list_repos_details
显示 OMS 存储库详细信息。
emctl config oms -store_repos_details [-repos_host <host> -repos_port <port> -repos_sid <sid> | -repos_conndesc <connect descriptor> ] -repos_user <username> [-repos_pwd <pwd>]
将 OMS 配置为使用指定的数据库作为管理存储库。
需要指定命令中提到的所有其他参数。
emctl config oms -change_repos_pwd [-old_pwd <old_pwd>] [-new_pwd <new_pwd>] [-use_sys_pwd [-sys_pwd <sys_pwd>]]
在存储库数据库和 OMS 中更改根用户 (SYSMAN) 的密码。
要更改企业管理器根用户 (SYSMAN) 密码,请执行以下操作:
使用命令停止所有 OMS。emctl stop oms
在其中一个 OMS 上运行。emctl config oms -change_repos_pwd
使用 和 命令重新启动所有 OMS。emctl stop oms -allemctl start oms
emctl config oms -change_view_user_pwd [-sysman_pwd <sysman_pwd>] [-user_pwd <user_pwd>] [-auto_generate]
配置 OMS 为MGMT_VIEW用户用于生成报告的密码。
要更改企业管理器MGMT_VIEW用户密码:
使用命令停止所有 OMS。emctl stop oms
在其中一个 OMS 上运行。emctl config oms -change_view_user_pwd
使用 和 命令重新启动所有 OMS。emctl stop oms -allemctl start oms
emctl secure oms
设置 OMS 的 SSL 配置。
emctl genreport oms -file_name <file_name> [-dest_dir <dest_dir>]
生成并保存 emcli 跟踪性能报告。
-file_name指示包含跟踪数据的输入文件的名称,并指示保存性能报告的输出目录的名称。-dest_dir
emctl gen_ui_trace_report oms [-start_time <start_time in hh:mm:ss format>] [-duration <duration in hh:mm format>] [-user_name <username>] [-out_file <out_file>] [-sysman_pwd <sysman_pwd>]
生成用户界面 (UI) 访问的性能报告。
参数说明如下:
-user_name:指示必须为其生成 UI 访问性能报告的用户名。默认值适用于所有用户。
-start_time:以 hh:mm:ss 格式指示从必须生成报告开始的时间。
-duration:以 hh:mm 格式指示必须为其生成报告的持续时间。默认值为 01:00。最长持续时间限制为 24:00。
-out_file:指示输出报告文件的名称。
emctl config oms -set_startup_mode [pbs_only | console_only | normal]
配置 OMS 的启动模式。无法在主 OMS 上执行此命令。
三种启动模式如下:
pbs_only:如果将启动模式配置为,则该命令仅启动 PBS 应用程序。pbs_only,emctl start oms
console_only:如果将启动模式配置为,则该命令仅启动控制台应用程序。console_only,emctl start oms
normal:如果将启动模式配置为,则该命令将同时启动 PBS 应用程序和控制台应用程序。normal,emctl start oms
emctl config oms -get_startup_mode
显示当前 OMS 的 OMS 启动模式。
emctl config oms sso -host ssoHost -port ssoPort -sid ssoSid -pass ssoPassword -das dasURL -u user
将企业管理器 (EM) 配置为使用 Oracle SSO (OSSO) 进行身份验证。要运行此命令,您应该已将 EM 站点注册到 OSSO 服务器,因为您需要生成的注册文件作为此命令的输入。
emctl config oms -update_ds_pwd -ds_name <datasource_name> [-ds_pwd <datasource_pwd>]
更新指定数据源的新密码。
在命令中,指示数据源的名称,并指示数据源的新密码。-ds_name-ds_pwd
emctl config oms -store_embipws_creds [-admin_pwd <weblogic_pwd>] [-embipws_user <new_embipws_username>] [-embipws_pwd <new_embipws_pwd>]
更改密码,以及企业管理器用于访问已安装的 BI 发布者 Web 服务器的用户名(可选)。
谓词不会更改后端中用户的凭据。使用相应的应用程序或控制台配置后端凭据以匹配此谓词中使用的凭据。emctlemctl
仅当安装了 BI 发布服务器时,此命令才可操作。对于此命令,无需重新启动任何 OMS(即 EMGC_OMS####、BIP####)。
emctl config oms -bip_shared_storage -config_volume <vol1> -cluster_volume <vol2> [-admin_pwd <adminpwd>] [-sysman_pwd <sysmanpwd>]
设置 BI 发布服务器的共享存储,以准备添加 OMS(其中还将包含横向扩展的 BI 发布服务器)。添加 OMS 会自动添加在高可用性环境中运行的 BI 发布服务器。因此,BI 发布服务器将同时支持冗余和可伸缩性。
此命令用于设置或移动共享存储位置,以准备在高可用性 (HA) 环境中运行 BI 发布服务器。
该参数指定 BI 发布服务器存储库和配置文件。现有卷将复制到此参数中指定的卷。-config_volume
该参数指定 BI 发布者计划程序在 HA 环境中运行所需的存储。-cluster_volume
此命令通常只在包含主 OMS 和主 BI 发布服务器的系统上运行一次。
emctl extended oms <verb> [verb_args] [-help]
执行使用 EMCTL 扩展框架注册的。<verb>
该参数指定特定于谓词的参数。verb_args
该参数提供谓词特定的帮助。有关扩展谓词的列表,请运行-helpemctl extended oms.
emctl register oms metadata -service <Metadata Service Id> (-file <Metadata Instance file> | -file_list <File containing list of files to register>) (-core | -pluginId <Plugin Id>) [-sysman_pwd <sysman password>]
注册元数据。
该参数提供包含文件路径列表(每行一个)的文件路径。这些文件路径相对于 OMS Oracle 主页或插件 Oracle 主页,具体取决于是传递参数还是传递参数。-file_list-core-pluginId
emctl register oms metadata -service targetType -file <XML filename> [-core | -pluginId <Plugin Id>] [-sysman_pwd "sysman password"]和emctl register oms metadata -service storeTargetType -file <XML filename> [-core | -pluginId <Plugin Id>] [-sysman_pwd "sysman password"]
在执行这两个命令时一个接一个地注册目标类型。
该参数指定目标类型 。具有绝对路径或相对路径的文件名。-file <XML filename>xml
emctl deregister oms metadata -service <Metadata Service Id> (-file <Metadata Instance file> && (-old_file <File containing previous metadata instances> | -no_old_file <in case there are no previous metadata instances>)) | -file_list <File containing list of ';' separeated new and old files to deregister>) (-core | -pluginId <Plugin Id>) [-sysman_pwd <sysman password>]
擦除元数据。
该选项提供包含文件路径列表的文件路径(每行一个)。这些文件路径相对于 OMS Oracle 主页或插件 Oracle 主页,具体取决于是传递参数还是传递参数。-file_list-core-pluginId