Diagnostic Assistant
Version 1.4
README.txt
Reference Knowledge Article: 201804.1
Updated: Sept-04-2012

Diagnostic Assistant Mandatory Pre-Requisites
=============================================
In order to utilize the majority of the Diagnostic Assistant features the  
following components need to be installed and configured.
  1. Oracle Unix or Windows Environment
  2. Java 1.4.2 or higher
  3. RDA 4.26 or higher installed
      --> You can download RDA from here: Document 314422.1 - 
          Remote Diagnostic Agent (RDA) 4 - Getting Started	
  4. IF you are running an Exadata environment, please continue
     to the Diagnostic Assistant Optional Pre-Requisites sections


Diagnostic Assistant Optional Pre-Requisites
============================================
(1) In order to utilize the 'Create Draft Service Request' and 'Package and
    Upload Files' feature set, OR if you have an Exadata environment the
    following component needs to be installed and configured.

  1. OCM v10.3.6 or higher 
      --> Must be installed under Oracle Product software home
          Can be downloaded and installed from My Oracle Support "collector" tab.
         https://support.oracle.com/CSP/ui/flash.html#tab=Collector%28page=Collector&id=gsmaxjia%28%29%29
      --> Must be configured in CONNECTED mode
      --> Run the following emCCR command from ccr/bin direcotry to verify:
            > bin/emCCR status
            Oracle Configuration Manager - Release: 10.3.6.0.2 - Production
            Copyright (c) 2005, 2011, Oracle and/or its affiliates.All rights reserved.
            -------------------------------------------------------------
            Start Date               01-Sep-2011 18:09:36
            Last Collection Time     04-Aug-2011 16:14:00
            Next Collection Time     02-Sep-2011 16:14:00
            Collection Frequency     Daily at 16:14
            Collection Status        idle
            Log Directory            /u01/oracle/product/11.2.0/dbhome_2/ccr/hosts/X/log
            Registered At            26-May-2011 10:39:52
            Automatic Update         On
            Collector Mode           Connected
            
(2) In order to utilize the "getmenu <km Article id" dynamic download of DA menus 
    and execution feature.
     
  1. Java 1.5.0 or higher is required.
      
            

How To Execute The Diagnostic Assistant 
=======================================
For UNIX:
> cd .../rda/da
> bin/da.sh menu

For Windows:
cd C:\...\da\bin>
C:\...\da\bin>da.cmd /menu

'menu' discovers the targets available in your environment and provides 
access to associated target menu functionality as well non-target
standard menus: 
	(1) Host Target Menu
	(2) Database Target Menu
       (3) Exadata Support Menus, View/Collect
	(4) Admin, Manage Properties, Versions, Latest Collections
       (5) RDA, OCM, ADR, and SR Creation/Packaging

where options (4) and (5) in this example are non-target standard menus and (2) and (3) 
are product(s) discovered target-related menus.

Extended functionality is available by starting the Diagnostic Assistant
tool with the specified menu:
 
 Functionality           Command
 ----------------------  ----------------------------------------
 oracle_database target  bin/da.sh menu menus/oracle_database.xml
	 
To see a list of available commands:
    >bin/da.sh
    
For detailed information on each menu option, open the tool and 
select 'H' for Help
          
Diagnostic Assistant Release 1.4 Key Features
=============================================
This release includes the following key features:
  - Native support for JDBC (SQL) and Weblogic scripting
  - Added dynamic and multiple choice prompting capabilities
  - Added checksum verification of DA distribution from da.sh/da.cmd
  - DA output reformatting (XHTML format)
  - Improved DA Menu startup time
  - Improved DA Administration Screens
    - Simpler Password Storage setting (on/off)
    - Ability to change or reset any stored property value
    - Moved core collectors and packaging into their own menu
  - Improved 'exadata' target menu
  - Improved 'host' target menu
  - Improved 'oracle_database' target menu

References
==========
My Oracle Support Knowledge article 201804.1 -
https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=201804.1

COPYRIGHT NOTICE
================
Copyright (c) 2010 - 2012 Oracle and/or its affiliates. All rights reserved.

TRADEMARK NOTICE
================
Oracle and Java are registered trademarks of Oracle and/or its
affiliates. Other names may be trademarks of their respective owners.

LEGAL NOTICES AND TERMS OF USE
==============================
https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=225559.1

DOCUMENTATION ACCESSIBILITY
===========================
Our goal is to make Oracle products, services, and supporting documentation
accessible, with good usability, to the disabled community. To that end, our
documentation includes features that make information available to users of
assistive technology. This documentation is available in HTML format, and
contains markup to facilitate access by the disabled community. Standards will
continue to evolve over time, and Oracle is actively engaged with other market-
leading technology vendors to address technical obstacles so that our
documentation can be accessible to all of our customers. For additional
information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation JAWS, a Windows screen reader,
may not always correctly read the code examples in this document. The
conventions for writing code require that closing braces should appear on an
otherwise empty line; however, JAWS may not always read a line of text that
consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation. This
documentation may contain links to Web sites of other companies or
organizations that Oracle does not own or control. Oracle neither evaluates
nor makes any representations regarding the accessibility of these Web sites.

THIRD PARTY COPYRIGHT NOTICE
============================
Copyright (c) 2002-2012 Atsuhiko Yamanaka, JCraft,Inc.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice,
     this list of conditions and the following disclaimer.

  2. Redistributions in binary form must reproduce the above copyright
     notice, this list of conditions and the following disclaimer in
     the documentation and/or other materials provided with the distribution.

  3. The names of the authors may not be used to endorse or promote products
     derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JCRAFT,
INC. OR ANY CONTRIBUTORS TO THIS SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

