通过使用 Oracle 的远程诊断代理 (Remote Diagnostics Agent, RDA),STA 收集您的 Oracle 支持代表可用于在 STA 服务器上确定故障源的信息。
本章包含以下各节:
STA 服务日志对于解决 STA 用户界面和 STA 受管服务器的问题很有用。您的 Oracle 支持代表可将其用于性能分析、调试、安全分析、使用情况分析以及其他相关用途。
注:
服务日志不用于解决 STA 监视的磁带库和磁带机的问题。STA 使用 RDA 生成与 STA 应用程序和数据库相关的所有日志的当前快照,包括操作系统、安装和配置信息。系统自动将这些日志分组为日志包,并为其分配关联的日期和时间戳。
将无限期保留日志包,直到您将其删除,这些包仅受到 STA 服务器上磁盘空间量的限制。可以 zip 文件形式下载选择的日志包并将其转发给您的 Oracle 支持代表进行分析。
在以下情况下,您可能需要创建日志包:
发生意外的 STA 应用程序事件并且该事件似乎是个错误。
Oracle 服务要求您生成快照。
STA 用户界面自动显示一条消息,指示您应生成快照。
可以通过以下任一方法生成服务日志快照。可以创建和存储多个日志包。
收集 RDA 服务日志信息的最简单方法是使用 STA 用户界面。使用该方法,会将快照存储在以下目录中:
/Oracle_storage_home/Middleware/rda/snapshots
其中 /Oracle_storage_home 是在 STA 安装期间定义的 Oracle 存储主目录位置。有关详细信息,请参见《STA 安装和配置指南》。
如果您无法访问 STA 用户界面,则可以使用 rda.sh 实用程序通过系统命令行手动创建日志包。使用该方法,会将快照存储在以下目录中:
/Oracle_storage_home/Middleware/rda/output
使用以下任何命令显示有关 rda.sh 实用程序的附加信息:
./rda.sh –M-显示该实用程序的完整手册页。
./rda.sh –M STA-显示该实用程序针对 STA 生成的日志文件摘要。
./rda.sh –h-显示所有实用程序选项的帮助信息。
下面是日志包收集和提交过程概述:
生成 STA 日志快照。请参见通过 STA 用户界面创建服务日志包或通过系统命令行创建服务日志包。
将日志包 zip 文件下载到您的计算机。请参见下载日志包。
将 zip 文件转发到 Oracle 技术支持。请参见将日志快照转发给 Oracle 技术支持。
使用该过程在 STA 服务器上生成包含服务信息的当前快照的日志包。
在导航栏中,选择 Setup & Administration,然后选择 Logs。
单击 Create New Log Bundle 图标。
在 "Log Bundle Name" 字段中,输入符合以下要求的快照名称:
最多 210 个字符
仅能包含字母数字字符和下划线(但不能包含四个或四个以上连续下划线)
如果输入空格,将替换为下划线
不能以下面的大写字符开头:COM、LPT、PRN、CON、AUX 或 NUL。
单击 Save。
此时将显示一条消息,指示该作业已排队。提交的作业显示在表中以及过程完成可能需要几分钟的时间。如果您离开 "Service – Logs" 屏幕,该过程将在后台继续执行。
注:
单击 Refresh Table 图标可更新正在进行的日志运行的状态。使用该过程通过系统命令行手动收集服务信息。
以系统 root 用户身份登录到 STA 服务器。
转到 RDA 目录。例如:
# cd /Oracle/Middleware/rda
验证是否存在 RDA setup.cfg 文件。
# ls -la setup.cfg
-rw-r----- 1 root root 13467 Nov 13 11:25 setup.cfg
输入以下命令以生成日志包。
# ./rda.sh –v –f
其中:
–v-显示数据收集的进度;该参数是可选的。
-f-强制执行当前数据收集。
该实用程序生成名为 RDA.STA_servername.zip 的 RDA 日志包。这可能需要几分钟的时间。示例10-1 是命令输出摘录。
# ./rda.sh –v –f
Collecting diagnostic data ... ------------------------------------------------------------------------------- RDA Data Collection Started 13-Nov-2014 10:46:33 ------------------------------------------------------------------------------- Processing Initialization module ... Processing OCM module ... Processing PERF module ... Processing CFG module ... Processing OS module ... Processing PROF module ... Processing NET module ... Processing Oracle installation module ... Processing WREQ module ... Processing STA module ... Hashing credential information...... Starting MySql STA database dump to /var/log/tbi/db/dump....... MySql STA database dump complete Processing RDSP module ... Processing LOAD module ... Processing End module ... ------------------------------------------------------------------------------- RDA Data Collection Ended 13-Nov-2014 10:47:59 ------------------------------------------------------------------------------- Generating the reports ... - STA_WREQ_d1_R00162_abbr.txt ... - STA_WREQ_d1_R00022_log_secureWebLogic_sh.txt ... - STA_WREQ_d1_R00114_log_nm_password_properties.txt ... - STA_WREQ_d1_R00107_log_readme_txt.txt ... - STA_WREQ_d1_R00171_log_dms_mbeans_xml.txt ... - STA_INST_R00009_oraInstall2014_10_30_03_53_34PM_out.dat ... - STA_INST_oracle_home.txt ... - STA_WREQ_o1_R00005_log_log_txt.txt ... ... If this file was generated to assist in resolving a Service Request, please send /Oracle/Middleware/rda/output/RDA.STA_mystaserver.zip to Oracle Support by uploading the file via My Oracle Support. If ftp'ing the file, please be sure to ftp in BINARY format. Please note: Do not submit any health, payment card or other sensitive production data that requires protections greater than those specified in the Oracle GCS Security Practices (http://www.oracle.com/us/support/library/customer-support-security-practices-069170.pdf). Information on how to remove data from your submission is available at https://support.oracle.com/rs?type=doc&id=1227943.1 Updating the setup file ... #
将 RDA zip 文件重命名为唯一的名称。例如:
# mv RDA.STA_servername.zip ./RDA.STA_servername_xxxx.zip
其中 xxxx 是您选择的唯一扩展。
(可选)使用以下方法之一显示刚刚创建的文件。
在 STA 服务器上打开一个浏览器窗口并导航到以下 URL:
file:///Oracle_storage_home/Middleware/rda/output/STA_start.htm
将 zip 文件下载到本地计算机,解压缩包,并通过上述的 URL 访问日志文件。
使用该过程显示有关 STA 服务器上的所有日志包的摘要信息。
注:
该过程仅适用于通过 STA 用户界面创建的日志包。在导航栏中,选择 Setup & Administration,然后选择 Logs。
"Service Logs" 屏幕显示每个日志包的以下信息。
Bundle Name-分配给日志快照的用户定义的名称。请参见通过 STA 用户界面创建服务日志包。
State-新日志包的运行状态("Running" 或 "Completed")。
Date Created-启动 RDA 运行的日期和时间。
File Size (KB)-日志文件的大小。
使用该过程显示有关选择的日志包的详细信息。可以在日志运行正在进行时或在其完成之后执行该过程。
注:
该过程仅适用于通过 STA 用户界面创建的日志包。在导航栏中,选择 Setup & Administration,然后选择 Logs。
选择要显示的日志包。
单击 Log Bundle Run Info 图标。
此时将显示 "Log Bundle Run Info" 对话框,其中提供有关日志运行的信息。
单击 Close 关闭对话框。
使用该过程将已完成的日志包下载到本地计算机。
注:
该过程仅适用于通过 STA 用户界面创建的日志包。在导航栏中,选择 Setup & Administration,然后选择 Logs。
选择要下载的日志包。
单击 Download Selected Log Bundle 图标。
保存文件。
注:
如果在日志文件中看到此错误消息,可以忽略此消息:WARNING:
java.lang.ClassNotFoundException: oracle.tbi.view.faces.ExceptionHandler
使用该过程删除选择的日志包。
注:
该过程仅适用于通过 STA 用户界面创建的日志包。在导航栏中,选择 Setup & Administration,然后选择 Logs。
选择要删除的日志包。
单击 Delete Selected Log Bundle 图标。
使用该过程将日志包转发给 Oracle 技术支持进行评估。该过程适用于通过 STA 用户界面或通过系统命令行创建的日志包。
注:
该过程适用于所有日志包。在以下 URL 访问 My Oracle Support Web 站点:
单击 Sign In(登录)并输入用户名和密码。
选择 Service Requests(服务请求)选项卡,然后选择 Create SR(创建 SR)。使用向导提示完成每个必填字段。
在 What is the Problem?(有什么问题?)部分中填写问题摘要和描述。
完成 Where is the Problem?(问题发生在何处?) 部分并选择所报告的问题类型的 Support(支持)选项卡(软件、硬件、云等)。
从列表中选择问题类型。
选择适当的客户服务号 (support identifier, SI) 并单击 Next(下一步)。
查看任何首选的知识文章。
要继续执行 SR 创建,请根据需要上载文件并提供其他信息。
选择严重性,确认联系信息,然后单击 Submit(提交)。