RDA

From Robs_Wiki
Revision as of 10:07, 21 January 2020 by Qadmin wiki (talk | contribs) (Step 6 Collect the required information)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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 ...

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