RDA
From Robs_Wiki
Contents
References
- Note 314422.1 "Remote Diagnostic Agent (RDA) 4.0 - Overview"
- Note 330363.1 "Remote Diagnostic Agent (RDA) 4 - FAQ"
- Note 330344.1 "Remote Diagnostic Agent (RDA) 4.0 - Training"
- Note 330362.1 "Remote Diagnostic Agent (RDA) 4 - Troubleshooting Guide"
- Note 314422.1 "Remote Diagnostic Agent (RDA) - Getting Started"
Introduction
- Remote Diagnostic Agent (RDA) is a command-line diagnostic tool that is executed by an engine written in the Perl programming language. RDA provides a unified package of support diagnostics tools and preventive solutions. The data captured provides Oracle Support with a comprehensive picture of the customer's environment which aids in problem diagnosis.
- Oracle Support encourages the use of RDA because it greatly reduces service request resolution time by minimizing the number of requests from Oracle Support for more information. RDA is designed to be as unobtrusive as possible; it does not modify systems in any way. It collects useful data for Oracle Support only and a security filter is provided if required.
Step 1 Download RDA
Download the platform specific version of RDA. Follow Oracle Note "Remote Diagnostic Agent (RDA) - Getting Started (Doc ID 314422.1)" to find the correct zip file.
Step 2 Check the current perl version
RDA is written in Perl and is a command-line script. The minimum version of Perl required to run RDA is 5.8.9. Besides Perl and a few basic Perl libraries it is not necessary to install extra software.
$ perl -v This is perl 5, version 16, subversion 3 (v5.16.3) built for x86_64-linux-thread-multi (with 39 registered patches, see perl -V for more detail)
Step 3 Unzip the RDA zip file
$ pwd /home/oracle $ ls -altr *.zip -rw-r--r--. 1 oracle oracle 18862389 Jan 20 13:44 p21769913_19419108_Linux-x86-64.zip
The above command will create an rda subdirectory which contains all the required rda files
Step 4 Check the installation
$ ./rda.sh -cv Loading the file list ... Checking the directory [D_RDA] . ... Checking the directory [D_RDA] engine ... Checking the directory [D_RDA_ADM] model ... Checking the directory [D_RDA_CHK] APPS ... . . . . . . No issues found
Step 5 Check which modules and profiles are available
$ ./rda.sh -L module
Available data collection modules:
ACFS Collects ASM Cluster File System Information
ACT Collects Oracle E-Business Suite Application Information
. . .
. . .
WLS Collects Oracle WebLogic Server Software and Domain
Information
. . .
$ ./rda.sh -L profile
Available profiles:
AS10g Oracle Application Server 10g problems
AS10g_Discoverer Discoverer 10g problems
AS10g_Identity Oracle Identity Management 10g problems
AS10g_IdentityFed Oracle Identity Federation 10g problems
. . .
. . .
WebLogicServer Oracle WebLogic Server problems (any
version)
. . .
Step 6 Collect the required information
In this example, we will collect information about the WeblogicServer profile.
The RDA process will:
- issue prompts for any information needed to execute the requested module or profile
- collect the relevant information (log files, configuration files, system details, script outputs)
- render the collected information so that it can be navigated and viewed using a browser
- package the output into a single file suitable for uploading to Support
$ ./rda.sh -p WebLogicServer
------------------------------------------------------------------------------
RDA.BEGIN: Initializes the Data Collection
------------------------------------------------------------------------------
Enter the Oracle home to be used for data analysis
Press Return to accept the default (/u01/app/oracle/product/12.2/fmw)
<RETURN>
------------------------------------------------------------------------------
RDA.CONFIG: Collects Key Configuration Information
------------------------------------------------------------------------------
------------------------------------------------------------------------------
OS.OS: Collects the Operating System Information
------------------------------------------------------------------------------
------------------------------------------------------------------------------
OS.PROF: Collects the User Profile
------------------------------------------------------------------------------
------------------------------------------------------------------------------
OS.NET: Collects Network Information
------------------------------------------------------------------------------
------------------------------------------------------------------------------
OS.PERF: Collects Performance Information
------------------------------------------------------------------------------
------------------------------------------------------------------------------
OFM.WLS: Collects Oracle WebLogic Server Information
------------------------------------------------------------------------------
Enter the location of the directory where the domains to analyze are located
(For example in UNIX, <BEA Home>/user_projects/domains or <Middleware
Home>/user_projects/domains)
> /u01/app/oracle/product/12.2/fmw/domains
Oracle WebLogic Server domain home target list:
When RDA discovers only one domain home, domain home list selection is
suppressed.
RDA will target the domain home:
'testdomain' (in /u01/app/oracle/product/12.2/fmw/domains)
Server list for 'testdomain' - domain home (in
/u01/app/oracle/product/12.2/fmw/domains/testdomain):
Two or more managed servers have been discovered.
1 AdminServer
2 WLS_REPORTS
3 rep_server1
4 reptools1
Enter your selection, as a comma-separated list of item numbers or ranges
Press Return to accept the default (1-4)
<RETURN>
Enter the user name to connect to the AdminServer of 'testdomain' domain
(/u01/app/oracle/product/12.2/fmw/domains/testdomain)
Press Return to accept the default (weblogic)
<RETURN>
------------------------------------------------------------------------------
OFM.WREQ: Handles the Oracle WebLogic Server Collection Requests
------------------------------------------------------------------------------
Are custom scripts used to start Oracle WebLogic servers (Y/N)?
Press Return to accept the default (N)
<RETURN>
Do you want RDA to capture thread dumps when a data collection module requires
on-line collections (Y/N)?
Press Return to accept the default (Y)
<RETURN>
------------------------------------------------------------------------------
OFM.IREQ: Handles the Oracle Instance Collection Requests
------------------------------------------------------------------------------
------------------------------------------------------------------------------
RDA.OCM: Set up the Configuration Manager Interface
------------------------------------------------------------------------------
------------------------------------------------------------------------------
RDA.STATUS: Produces the Remote Data Collection Reports
------------------------------------------------------------------------------
------------------------------------------------------------------------------
RDA.LOAD: Produces the External Collection Reports
------------------------------------------------------------------------------
------------------------------------------------------------------------------
RDA.FILTER: Controls Report Content Filtering
------------------------------------------------------------------------------
------------------------------------------------------------------------------
RDA.END: Finalizes the Data Collection
------------------------------------------------------------------------------
------------------------------------------------------------------------------
RDA Data Collection Started 21-Jan-2020 08:40:54
------------------------------------------------------------------------------
Processing RDA.BEGIN module ...
Processing OS.PERF module ...
Processing RDA.CONFIG module ...
Processing OS.OS module ...
Processing OS.PROF module ...
Processing OS.NET module ...
Processing OFM.WLS module ...
Processing OFM.WREQ module ...
Enter 'weblogic' user password for 'testdomain' domain: *****
Re-enter it to confirm: *****
This can take time. Be patient ...
Error encountered when connecting to the Admin Server of
'testdomain' Note:
* Runtime MBean information will not be collected.
* RDA collection of files, logs, and other data will continue.
* Upon completion, review the connection error via the RDA__start.htm:
-> 'testdomain' Domain
Sub Index:
-> Domain Level MBeans
--> Oracle WebLogic Server Connection Error
Processing HCVE tests ...
Performing HCVE checks ...
Test "WLS PostInstall Check: WebLogic Server 12c (12.x) Generic" executed at 21-Jan-2020 08:47:51
Test Results
~~~~~~~~~~~~
ID NAME RESULT VALUE
====== ==================== ======= ==========================================
A10000 Domain List RECORD testdomain
A10005 -- testdomain Domain --
A10010 Domain directory RECORD /u01/app/oracle/product/12.2/fmw/doma...
A10011 Domain valid? PASSED isValid
A10015 Domain URL RECORD
A10016 Domain User Name and RECORD weblogic/***
A10020 WLS Version RECORD 12.2.1
A10021 Version 12? PASSED VersionIsGood
A10100 Admin server name? PASSED AdminServer
A10110 Server names? PASSED AdminServer WLS_REPORTS
A10120 Installed Patch List RECORD no patches installed
A10130 config.xml Data RECORD General Server Configurations, value ...
A10140 JDBC Configuration RECORD Data from LocalSvcTblDataSource-jdbc....
A10150 JMS Configuration RECORD
A05000 JMS bytes-maximum PASSED protected
A05001 JMS messages-maximum PASSED protected
A05002 JDBC pinned-to-threa FAILED The following do not have pinned-to-t...
A05003 JDBC statement-cache FAILED The following do not have statement-c...
A05004 JDBC statement-cache FAILED The following do not have statement-c...
A05005 Server native-io-ena PASSED protected
A05006 Cluster frontend-hos FAILED The following do not have cluster fro...
A05007 Virtual-host max-pos PASSED protected
A05008 Server max-post-size FAILED The following do not have max-post-si...
A05009 Server max-open-sock FAILED The following do not have max-open-so...
A05010 Config server ssl ho PASSED protected
A05011 JVM heapsize PASSED protected
A05012 JDBC WaitingForConne PASSED protected
Result file: output/collect/OFM_HCVE_P_WLS12_gen_res.htm
Processing OFM.IREQ module ...
Processing RDA.LOAD module ...
Processing RDA.END module ...
------------------------------------------------------------------------------
RDA Data Collection Ended 21-Jan-2020 08:49:07
------------------------------------------------------------------------------
You can review the reports by transferring the /home/oracle/rda/output
directory structure to a location where you have web-browser access. Then,
point your browser at this file to display the reports:
RDA__start.htm
Based on your server configuration, some possible alternative approaches
are:
- If your client computer with a browser has access to a web-shared
directory, copy the /home/oracle/rda/output directory structure to the
web-shared directory and visit this URL:
http://machine:port/web_shared_directory/RDA__start.htm
or
- If your client computer with a browser has FTP access to the server
computer with the /home/oracle/rda/output directory, visit this URL:
ftp://robl@ibis-reports-test-01.ipa.ibo.org/rda/output
If this file was generated to assist in resolving a Service Request, send
/home/oracle/rda/RDA_output_ibis-reports-test-01.zip to Oracle Support by
uploading the file via My Oracle Support. When sending with FTP, make sure
you send it in BINARY format.
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
Step 7 Upload the results to Oracle Support
In the output above, you can see the following comments:
If this file was generated to assist in resolving a Service Request, send /home/oracle/rda/RDA_output_ibis-reports-test-01.zip to Oracle Support by uploading the file via My Oracle Support. When sending with FTP, make sure you send it in BINARY format.
So upload that zipfile to My Oracle Support
