Applies to:

Enterprise Manager Base Platform - Version 10.1.0.2 to 11.1.0.1 [Release 10.1 to 11.1]
Information in this document applies to any platform.

Purpose

Provide general instructions on how to Install, Upgrade or Deinstall the EMDiag agtvfy 10g and 11g Kit.

This EMDIAG agtvfy Kit cannot be used with a Cloud Control 12c agent.
A specific release of the EMDIAG agtvfy Kit has been developed for the Cloud Control agent.
Please consult the note:
Document 1374441.1 - EMDIAG Agtvfy 12c Kit - Download and Install

Scope

The EMDIAG AGTVFY kit is designed to assist in the diagnosis and correction of the Grid Control Management Agent 10g and 11g, the DB Control Agent 10g and 11g and the AS Control Agent issues.

Details

Download and Install the EMDIAG AGTVFY Kit

Download the EMDIAG AGTVFY kit Release 2013.0315 from here
Extract the ZIP file in a directory or sub-directory emdiag or EMDIAG

IMPORTANT: The EMDIAG AGTVFY kit may fail to run some commands if installed in a directory or sub-directory name different than emdiag or EMDIAG.
Example: $ORACLE_BASE/agtvfy or $ORACLE_BASE/emdiag/agtvfy.
In that case you will need to set the environment variable EMDIAG_HOME before running any agtvfy command.

If you have multiple Grid Control or DB Control Management Agents installed on the same host and in one or several ORACLE_HOMEs, you do not need to install the EMDIAG AGTVFY kit several times. Agtvfy will check the current ORACLE_HOME (and ORACLE_SID for a DB Control Agent) to run the appropriate commands against the correct Management Agent.
So we highly recommend that you unzip the EMDIAG AGTVFY kit in the directory $ORACLE_BASE/emdiag or $ORACLE_BASE/EMDIAG.

Note: the location where the EMDIAG AGTVFY kit has been unzipped will be further referenced in this document as EMDIAG_HOME.

Windows ONLY: Setup the EMDIAG AGTVFY Kit

Change the pointer to the Grid Control or DB Control Agent
The agtvfy.bat file has a hardcoded pointer to the ORACLE_HOME environment variable. This is the 'fallback' value in case nothing is found in the environment when the tool is launched.
To change this value:

Edit the file EMDIAG_HOME/bin/agtvfy.bat
Change:
IF NOT DEFINED ORACLE_HOME (SET OH=C:\ORA\agent10g)

Into:
IF NOT DEFINED ORACLE_HOME (SET OH=)
Example:
IF NOT DEFINED ORACLE_HOME (SET OH=c:\app\oracle\product\agent10g)

Determine the location of the PERL binaries EMPERLOHBIN
Check the directory %ORACLE_HOME\perl directory
If this directory contains a sub directory with the version of PERL (Example 5.8.3)
The location of the perl binaries will be either:
- perl\5.8.3\bin\MSWin32-x86
or
- perl\5.8.3\bin\MSWin32-x86-multi-thread
If this directory does not contains a sub directory with the version of PERL
The location of the perl binaries will be perl\bin
The directory %ORACLE_HOME%\ must exist
Determine the version of PERL
cd to the %ORACLE_HOME%\ determined in the previous step
execute the command:

C> perl -version
This is perl, v5.10.0 built for MSWin32-x86-multi-thread
Create the file %ORACLE_HOME%\bin\commonenv.bat with the following content if it does not exist:
Example of commonenv.bat content for the Grid Control Agent
set EMPERLVER=5.8.3
set EMPERLOHBIN=perl\5.8.3\bin\MSWin32-x86
Example of commonenv.bat content for the DB Control 11.1.0.x Agent
set EMPERLVER=5.8.3
set EMPERLOHBIN=perl\5.8.3\bin\MSWin32-x86-multi-thread
Example of commonenv.bat content for the DB Control 11.2.0.X Agent
set EMPERLVER=5.10.0
set EMPERLOHBIN=perl\5.8.3\bin

Check the installation of the EMDIAG AGTVFY kit

Set the ORACLE_HOME environment variable:

$ set ORACLE_HOME
Verify the installation by running a check on the EMDIAG AGTVFY kit
version of the Grid Control or DB Control Agent

On Unix:
$ cd EMDIAG_HOME/bin
$ ./agtvfy version
On Windows
C> cd EMDIAG_HOME\bin
C> agtvfy -version

Tips and Tricks for using AGTVFY

On startup, AGTVFY needs to know the location of the Agent state directory.
This location is obtained by issuing the following command from the Grid Control Agent $ORACLE_HOME/bin directory or from the database $ORACLE_HOME/bin directory for a DB Control agent:

$ ./emctl getemhome

This command will take a second or two to execute, slowing down the initial response of AGTVFY.

If AGTVFY is going to get executed several times in a short period of time, the startup of AGTVFY can be sped up by setting the EMHOME environment variable to the location of the Agent state files.
The best way to specify this is to edit the file EMDIAG_HOME/cfg/agtvfy.cfg file and add a line to set the EMHOME variable:

$ setenv EMHOME=
or
$ export EMHOME=
or
$ set EMHOME=

References

NOTE:421053.1 - EMDIAG Troubleshooting Kits Master Index
NOTE:1374441.1 - EMDIAG Agtvfy 12c Kit - Download and Install

Attachments

EMDIAG Agtvfy Kit Release 2013.0315 for Agent 10g and 11g(98.31 KB)

EMDIAG Agtvfy 10g and 11g Kit - Download and Install (Doc ID 1210814.1)