=====Cloudcontrol 12c - Agents und Repository überwachen und prüfen====

Die wichtigsten Befehlt für den Oracle 12c OEM Agent:



Status abfragen:
<code bash>
emctl status agent  
</code>

OMS erreichbar?:
<code bash>
emctl pingOMS
</code>

Blackout für den ganzen Host für 5 Minuten setzen:
<code bash>
emctl start blackout AGENT_BLACKOUT_$HOSTNAME -nodeLevel -d 00:05 -allow_jobs
</code>


Stoppen/starten des Agent
<code bash>
emctl stop agent
emctl start agent
</code>

Blackout wieder beenden:
<code bash>
emctl stop blackout AGENT_BLACKOUT_$HOSTNAME
</code>

Metrik Daten zum OMS hochladen:
<code bash>
emctl upload agent
</code>


Clear all severity state des Agenten:
<code bash>
emctl clearstate agent
</code>

Targets des Agenten anzeigen lassen:
<code bash>
emctl config agent listtargets
</code>


Eine Metric für ein Target abfragen:
<code bash>
#emctl getmetric agent TARGETNAME,TARGETTYPE,METRICNAME 
emctl getmetric agent GPIDB,oracle_database,instance_efficiency
</code>

Status des Metrik Caches abfragen:
<code bash>
#Parameter TARGETNAME,TARGETTYPE
emctl status agent mcache GPIDB,oracle_database
</code>

Displays severity state for the target, zeigt auch die ganzen Metrik Namen an!
<code bash>
#Parameter TARGETNAME,TARGETTYPE
emctl status agent target GPIDB,oracle_database
</code>

Status der DB Connect anzeigen
<code bash>
emctl status agent dbconnections
</code>

Alle Parameter des Agents mit "EMDAllParameters" anzeigen lassen:
<code>
emctl getmetric agent <agent_name>,oracle_emd,EMDAllParameters
</code>

Trace Level für die PERL Scripte setzen (INFO,WARN,DEBUG):
<code>

emctl getproperty agent -name EMAGENT_PERL_TRACE_LEVEL


emctl setproperty agent -name EMAGENT_PERL_TRACE_LEVEL -value DEBUG

emctl reload

emctl getproperty agent -name EMAGENT_PERL_TRACE_LEVEL

</code>




=====Agent diagnostic utility=====


	* Download from https://support.oracle.com  - EMDIAG Agtvfy 12c Kit - Download and Install (Doc ID 1374441.1) 
	* Installation in das $ORACLE_HOME des Agent wie /opt/oracle/agent/12c/core/12.1.0.4.0/emdiag<code bash>
#Agent Umgebung setzen
cd $ORACLE_HOME
mkdir emdiag
unzip agtvfy12c20141126.zip -d  $ORACLE_HOME/emdiag
</code>

Einsatz:

	* EMDIAG Agtvfy 12c Kit - How to Use it (Doc ID 1375428.1)
	* EMDIAG Kits: Diagnostic Levels (Doc ID 1288036.1)

Beispiele:

<code bash>
cd /opt/oracle/agent/12c/core/12.1.0.4.0/emdiag/bin

./agtvfy verify all -level 9 -details

./agtvfy target properties -name  gpidbserver -type oracle_database

</code>

===== Repository Diagnose EMDIAG =====

Mit repvfy läßt sich sehr gut die Konsitenz des EM Repostiories überprüfen.
Da die dabei verwendeten SQL's als Text verfügbar sind, bietet sich diese SQL Statements sehr gut als Basis für eigenen Check Scripte an.


=== Installation ===

see Support Node: 

  * EMDIAG REPVFY Kit for Cloud Control 12c - Download, Install/De-Install and Upgrade (Doc ID 1426973.1)
  * EMDIAG Repvfy 12c Kit - How to Use the Repvfy 12c kit (Doc ID 1427365.1)


Installation:

Software bereitstellen:
<code bash>
#Umgebung auf das Repository Datenbank Home setzen
#prüfen

echo $ORACLE_HOME


unzip repvfy12c20141126.zip -d $ORACLE_HOME/emdiag

#prüfen ob repvfy ausführbar ist

ls -la $ORACLE_HOME/emdiag/bin/repvfy

#bei Bedarf setzen

chmod +x  $ORACLE_HOME/emdiag/bin/repvfy
</code>

Parameter einstellen:

  * EMDIAG REPVFY Kit - How to Configure the 'repvfy.cfg' File (Doc ID 421600.1)


<code bash>

cd $EMDIAG_HOME/cfg

cp repvfy.cfg.template repvfy.cfg

vi repvfy.cfg

...
#
# ora_tns = TNS descriptor to use to connect to the repository
#
ora_tns=localhost:1521:EMREP

...


</code>


Registrieren:
<code bash>

cd $ORACLE_HOME/emdiag/bin


#EMDIAG Home Setzen

export EMDIAG_HOME=export EMDIAG_HOME=$ORACLE_HOME/emdiag
echo $EMDIAG_HOME

./repvfy install

# testen
./repvfy -version

repvfy 2014.1126 - EMDIAG - 12c Repository verification


# Umgebungsvariablen anzeigen lassen

./repvfy -h2


</code>

Fehler "repvfy.pl not found. Aborting" => EMDIAG_HOME nicht richtig gesetzt, muss das Base Verzeichnis der EMDIAG Installation sein!

Repository testen:

  * EMDIAG Repvfy 12c Kit - How to Use the Repvfy 12c kit (Doc ID 1427365.1)

<code bash>
cd $EMDIAG_HOME

./repvfy verify all -detail -level 9


</code>

==Upgrade ==

  - Bei einem Upgrade das alte "emdiag" Verzeichnis in emdiag_old umbenennen
  - dann die neue Software (Zur Zeit EMDIAG REPVFY Kit Release 2015.0205 von EMDIAG REPVFY Kit for Cloud Control 12c - Download, Install/De-Install and Upgrade (Doc ID 1426973.1) herunterladen und nach $ORACLE_HOME/emdiag entpacken
  - repvfy.cfg Datei aus dem alten Home (emdiag_old/cfg) in das Neue Home (emdiag/cfg) kopieren 
  - mit "./repvfy install" das DB Repositoriy neu initialisieren




=== Quellen ===

  * http://jhdba.wordpress.com/2010/08/20/the-power-of-emdiag/