RDA

From Robs_Wiki
Revision as of 09:43, 21 January 2020 by Qadmin wiki (talk | contribs) (Step 6 Collect the required information)
Jump to: navigation, search

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 ...