INSTALLATION VON EM-AGENTEN MIT EINEM GOLD-IMAGE

13.
Januar
2022
Veröffentlicht von: Kurt Sauer

In einer komplexen Enterprise Manager Architektur mit vielen zu überwachenden Komponenten ist es von Vorteil, eine einheitliche Kategorisierung für die auf den Zielsystemen zu installierenden Software-Pakete und Plugins im Bereich der Agenten vorzunehmen.

Dieser Monatstipp beschreibt die Installation eines Enterprise Manager Agenten als Referenz-System sowie die Generierung eines sogenannten „Gold-Image“, das als Basis für die Verteilung auf neu zu installierenden als auch auf bereits existierenden Agenten-Systemen dient.

Ein Gold Image umfasst einheitliche Release-und Patchstände und die für die Agentensoftware verfügbaren Plugins, um alle auf den Host-Systemen betriebenen Applikationen (Oracle- und  Thirdparty-Produkte) überwachen zu können. Eine Liste aller Plugins kann dem Kapitel „Plug-ins Resources“ innerhalb der  Oracle Enterprise Manager Cloud Control 13.5 Dokumentation entnommen werden.

Die Erstellung und Verteilung erfolgt mit dem Command-Line Utility „emcli“, um diese Prozesse ggf. auch automatisieren zu können. Ansonsten kann auch die Web-Oberfläche benutzt werden.

 

INSTALLATION AGENT

Wie oftmals bei Oracle, gibt es unterschiedliche Möglichkeiten, einen Agenten zu installieren.

Es gibt die Pull-Methode, bei der die Software-Installation des Agenten direkt auf dem Client-System mit Hilfe eines von Oracle zur Verfügung gestellten Skriptes erfolgt. Das Skript lädt die Software automatisch aus der zentralen Enterprise Manager Software-Library. Bei der Push-Methode wird die Installation vom zentralen EM System entweder über die Browser-Oberfläche des Enterprise Managers bzw. durch die „emcli“-Kommando-Struktur angestoßen. Mit Hilfe der Push-Methode wird das Gold-Image später innerhalb dieses Tipps auf alle dafür bestimmten Agenten vom zentralen EM-System ausgerollt.

Für die Installation eines einzelnen Agenten (wie hier im Beispiel)  kommt als Weiteres die Agent- Deploy-Methode zum Einsatz.


VORBEREITUNG AUF ZENTRALEM EM-SYSTEM

Dazu muss eine Anmeldung am OMS-Service des Enterprise Managers erfolgen:

$OMS_HOME/bin/emcli login -username=sysman

Hinweis: OMS_HOME referenziert das Installationsverzeichnis der zentralen EM-Installation

Nach Eingabe des Passworts ist folgendes Kommando auszuführen:

$OMS_HOME/bin/emcli get_agentimage -destination='/u01/app/oracle/agent_software'  \
-platform="Linux x86-64"                                                          \
-version=13.5.0.0.0

Damit erhält man die Agentensoftware als ZIP-File in der Version 13.5 für Linux  in das angegebene Verzeichnis sowie ein Response File.

Das Reponse-File muss im Standard mit folgenden Angaben ergänzt werden:

OMS_HOST=Hostname der installierten  OEM-Software  z.B. "srv0rn00300.muniqsoft.de"
EM_UPLOAD_PORT=HTTPS-Port für den Upload                z.B. 4903
AGENT_REGISTRATION_PASSWORD=


Den EM-UPLOAD-PORT kann man mit folgendem Kommando ermitteln:

$OMS_HOME/bin/emctl status oms –details

Output:

Console Server Host        : srv0rn00300.muniqsoft.de
HTTP Console Port          : 7788
HTTPS Console Port         : 7803
HTTP Upload Port           : 4889
HTTPS Upload Port          : 4903
(..)


Das Agent-Registrierungs-Passwort wird bei der Installation der OEM-Software erstellt. Falls es nicht mehr bekannt ist, kann es mit folgendem Befehl neu vergeben werden:

$OMS_HOME/bin/emctl secure setpwd


Nach Anpassung des Response-Files kann das gesamte Verzeichnis in einen Staging-Bereich des Hosts, auf dem der Agent installiert werden soll, übertragen und das 13.5.0.0.0_AgentCore_226.zip entpackt werden.
 

DURCHFÜHRUNG  AUF CLIENT-SYSTEM

Zur Installation der Software auf dem Zielhost folgendes ausführen:

<STAGE-DIR>agent_software/agentDeploy.sh                      \
AGENT_BASE_DIR=/u01/app/oracle/embase/agent_13c               \
RESPONSE_FILE=<STAGE-DIR> /agent.rsp


Der Output sieht dann folgenermaßen aus (Auszug)

..
Starting execution of prerequisite checks
Total No of checks: 10
..
Performing check for CertifiedVersions_agent
Is the software certified on the current operating system?
Expected result: One of enterprise-6, oracle-8, oracle-7, SuSE-11, SuSE-12, SuSE-15, redhat-6, redhat-7, redhat-8
Actual Result: redhat-7.9
Check complete. The overall result of this check is: Passed
(..)
Validated the agent port :- ----3872
shared agent value is :false
chain install is :false
Agent Configuration completed successfully
The following configuration scripts need to be executed as the "root" user. Root script to run :
/u01/app/oracle/embase/agent_13c/agent_13.5.0.0.0/root.sh
/u01/app/oracle/embase/agent_13c/agent_13.5.0.0.0/cfgtoollogs/agentDeploy/agentDeploy_2021-12-21_14-58-49-PM.log
Waiting for agent targets to get promoted...


Anschließend als root das folgende Skript ausführen:

/u01/app/oracle/embase/agent_13c/agent_13.5.0.0.0/root.sh


ÜBERPRÜFUNG AUF ZENTRALEM EM-SYSTEM

Die Überprüfung, ob der nun mit der Agent-Software installierte Host vom zentralen OMS-Server erkannt wird, kann mit folgendem Befehl auf dem OMS-Server durchgeführt werden:

$OMS_HOME/bin/emcli get_targets -target="oracle_emd"

Output:

Status     Status     Target Type     Target Name
1          Up         oracle_emd      srv0rn00100.muniqsoft.de:3872

Nun kann der Agent-Host gepatcht werden, z.B mit dem Patch 33416868: WLS PATCH SET UPDATE 12.2.1.4.210930. Die Installationsanleitung ist in dem README des Patches enthalten.


ERSTELLUNG GOLD-IMAGE

Auf Basis des erstellten Referenz-Agenten kann ein sogenanntes Gold-Image(GI) erstellt werden. Mit diesem GI können dann 1-n Zielsysteme mit einem einheitlichen Release und Patch-Stand neu erstellt bzw. modifiziert werden. Die folgenden Schritte werden ausschließlich vom zentralen EM-System aus ausgeführt:

$OMS_HOME/bin/emcli create_gold_agent_image                            \
 -source_agent=srv0rn00100.muniqsoft.de:3872                           \
-image_name= GI_INT_Agent13.5                                          \
-version_name= GI_INT_Agent13.5_20210930

Source-Agent ist die Host-Adresse des Referenz-Agenten, Version_Name wird in den Pfad des Agent-Home-Verzeichnisses  aufgenommen (dazu später).

Als Job-Output erhält man folgende Information:

A gold agent image create operation with name
"GOLD_AGENT_IMAGE_CREATE_2021_12_20_15_46_23_166" has been submitted.
You can track the progress of this session using the command "emcli
get_gold_agent_image_activity_status -
operation_name=GOLD_AGENT_IMAGE_CREATE_2021_12_20_15_46_23_166"
Compatibility
        Percentage(%) of subscribed agents that can be updated with this gold image version once its
created.
            No subscribed agents found

 

Nach anfänglichem Job-Ausführungsstatus „IN_PROGRESS“ erscheint nach einigen Minuten der Status „PASSED“:

Inputs
------

Gold Image Name         :  GI_INT_Agent13.5
Gold Image Version Name :  GI_INT_Agent13.5_20210930
Source Agent            :  srv0rn00100.muniqsoft.de:3872
Working Directory       :  %agentStateDir%/install

Status
-------
Step Name               Status  Error  Cause  Recommendation
Create Gold Agent Image  PASSED


Das GI ist nun erzeugt, aber noch nicht aktiv („DRAFT“). Um es auf einen oder mehrere Server verteilen zu können, muss es in den Status “CURRENT“ gebracht werden:

$OMS_HOME/bin/emcli promote_gold_agent_image                           \
-version_name="GI_INT_Agent13.5_20210930"                              \
 -maturity="Current"


Die Details zu dem nun erstellten GI können mit folgendem Befehl eingesehen werden:

$OMS_HOME/bin/emcli get_gold_agent_image_details                       \
 -version_name=GI_INT_Agent13.5_20210930

Output:

Gold Agent Image    :  GI_INT_Agent13.5
Version Name        :  GI_INT_Agent13.5_20210930
Gold Image Version  :  1
Status              :  Current

Platform Details
----------------
Platform      :  Linux x86-64
Core Version  :  13.5.0.0.0

Source Agent Details
----------------
Agent Name        :  srv0rn00100.muniqsoft.de:3872
Oms Host and Port :  srv0rn00300.muniqsoft.de:4903
Oracle Home       :  /u01/app/oracle/embase/agent_13c/agent_13.5.0.0.0
Instance Home     :  /u01/app/oracle/embase/agent_13c/agent_inst
Image Type        :  GENERAL

Plugin Details
----------------
Plugin Name              Plugin Id            Content Type      Version     Revision
Oracle Home              oracle.sysman.oh     Plugin            13.5.0.0.0      0
Systems Infrastructure   oracle.sysman.si     Plugin            13.5.1.0.0      0
Oracle Database          oracle.sysman.db     Discovery         13.5.1.0.0      0
Oracle Exadata           oracle.sysman.xa     Discovery         13.5.1.0.0      0
Oracle Fusion Middleware oracle.sysman.emas   Discovery         13.5.1.0.0      0
Oracle Home              oracle.sysman.oh     Discovery         13.5.0.0.0      0
Systems Infrastructure   oracle.sysman.si     Discovery         13.5.1.0.0      0

Patch Details
----------------
Patch Id  Aru Id  Core Version  Bug Number  Bug Description                                                              Component
..
33416868  226     13.5.0.0.0    18183882    ONE WAY CALL TO WEB SERVICE RETURNING 200 CAUSES ERROR TO BE THROWN IN SOA   oacle.rsa.crypto:N/A:12.2.1.4.0
33416868  226     13.5.0.0.0    25219796    WLS 12.2.1 FAILS TO FETCH JAX-WS WEB SERVICES                                oracle.rsa.crypto:N/A:12.2.1.4.0
33416868  226     13.5.0.0.0    25348765    DIFFERENT OVERLOAD BEHAVIOR IN WORK.OVERLOAD TESTS JDK8&amp;JDK9, CONSISTENT oracle.rsa.crypto:N/A:12.2.1.4.0
33416868  226     13.5.0.0.0    25900775    SECURE MODE V2 WARNINGS TO ADD TO SECURE MODE VALIDATION
..

Hinweis: Die zentralen Agenten auf den OMS-Systemen können nicht als Referenz-System herangezogen werden.

Nach diesen Schritten kann das GI auf die in Frage kommenden Zielsysteme verteilt werden. Das Verteilverfahren unterscheidet sich danach, ob es sich um sogenannte „Unmanaged“ oder „Managed“- Hosts“, also mit bereits installierter Agenten-Software, handelt.


UNMANAGED HOSTS

Die Voraussetzungen für die Installation einer Agenten-Software können dem Kapitel “Meeting the Generic Prerequisites for Installing Standalone Management Agents Using Add Host Targets Wizard or EM CLI“ innerhalb des “Cloud Control Basic Installation Guides“ entnommen werden.

Bei „Unmanaged“ Hosts verwendet man zur Installation der GI Software das folgende Kommando:

$OMS_HOME/bin/emcli submit_add_host                                                  \
-host_names="SRV0RN00200.muniqsoft.de; SRV0RN00400.muniqsoft.de "                    \
-platform=226                                                                        \        
-installation_base_directory=/u01/app/oracle/embase                                  \
-credential_name=ssh-oracle                                                          \       
-version_name=GI_INT_Agent13.5_20210930                                              \
-privilege_delegation_setting=sudo                                                   \
-postinstallation_script_run_as_root                                                 \
-postinstallation_script=/u01/app/oracle/embase/agent_13c/agent_13.5.0.0.0/root.sh

 

Erklärung zu den Parametern:

  Platform   226     Linux
  Installation Base Directory   Name des Basis-Pfades für die Installation
  Credential Name    Name der Zugangsdaten für den OS-User Passwort/SSH
  Version Name   Name des Golden Images




                                     

 


Die folgende Meldung erscheint:

An Add Host session with the name "ADD_HOST_SYSMAN_Dec_27_2021_3:23:28_PM_CET" has been submitted.
You can track the progress of this session using the command "emcli get_add_host_status -session_name=ADD_HOST_SYSMAN_Dec_27_2021_3:23:28_PM_CET"


Nach ein paar Minuten den Output der Session anzeigen:

$OMS_HOME/bin/emcli get_add_host_status                                              \
-session_name=ADD_HOST_SYSMAN_Dec_27_2021_3:23:28_PM_CET

Output:

OverAll Status : Agent Deployment succeeded

Host              Platform Name   Initialization   Remote Prerequisite   Agent Deployment   Error
SRV0RN00200……     Linux x86-64    Succeeded        Succeeded             Succeeded
SRV0RN00400……     Linux x86-64    Failed           Not Run               Not Run            SSH
connection check failed


Beim Knoten “SRV0RN00400. muniqsoft.de” kann das Kommando nach Behebung des SSH-Fehlers folgendermaßen wiederholt werden:

$OMS_HOME/bin/emcli retry_add_host                                              \
-session_name=”ADD_HOST_SYSMAN_Dec_27_2021_3:23:28_PM_CET”                      \
-retry_using_same_inputs

 

MANAGED HOSTS

Zunächst ist zu überprüfen, welche Managed-Hosts zur Verfügung stehen:

$OMS_HOME/emcli get_targets -target="oracle_emd"

Output:

Status     Status     Target Type     Target Name 
ID
1          Up         oracle_emd      srv0rn01100.muniqsoft.de:3872
1          Up         oracle_emd      srv0rn01300.muniqsoft.de:3872
1          Up         oracle_emd      srv0rn01700.muniqsoft.de:3872
1          Up         oracle_emd      srv0rn01800.muniqsoft.de:3872
1          Up         oracle_emd      srv0rn02400.muniqsoft.de:3872
1          Up         oracle_emd      srv0rn02600.muniqsoft.de:3872

 

Bei Managed-Hosts wird der folgende Befehl benutzt, um die GI-Software zu installieren:

$OMS_HOME/bin/emcli update_agents                           \
-image_name=GI_INT_Agent13.5                                \
-agents="srv0rn01100.muniqsoft.de:3872"


Bei der Ausführung kann es zu folgender Fehlermeldung kommen:

Total Agents           Status           Started        Ended           Severity     Reason
srv0rn01100..:3872     NotUpdatable     2021-12-21     12:53:19 GMT     -                                      
ERROR         Agent is not subscribed to the gold image. Subscribe the agent to the gold image.


Für den Host muss sozusagen ein Abonnement erstellt werden, damit er berichtigt ist, mit der GI-Software versorgt zu werden:

$OMS_HOME/bin/ emcli subscribe_agents                                                     \
-image_name=GI_INT_Agent13.5                                                                     \
-agents="srv0rn01100.muniqsoft.de:3872"

Output:

Subscribed agents are
Agent
-----
srv0rn01100.muniqsoft.de:3872


Nach erneuter Ausführung des Update-Befehles werden während der Job-Ausführung die Phasen “PendingUpdateInprogress“,“Updatable“ und “ Inprogress“ angezeigt-  bis schließlich nach wenigen Minuten folgende Meldung erscheint:

Total Agents            Status      Started                 Ended                   Severity     Reason
srv0rn001100….:3872     Success     2021-12-21 13:16:04     2021-12-21 13:18:30     -            -


Was ist auf dem Agent-Host passiert?
Der Output von dem folgenden Kommando zeigt näheres:

$OMS_HOME/bin/emcli get_agent_properties  -agent_name=srv0rn01100.muniqsoft.de:3872

Output:

Name                    Value
agentVersion            13.5.0.0.0
agentTZRegion           Europe/Brussels
emdRoot                 /u01/app/oracle/embase/agent_13c/GoldImage_GI_INT_Agent13.5_20210930/agent_13.5.0.0.0
agentStateDir           /u01/app/oracle/embase/agent_13c/agent_inst
perlBin                 /u01/app/oracle/embase/agent_13c/GoldImage_GI_INT_Agent13.5_20210930/agent_13.5.0.0.0/perl/bin
scriptsDir              /u01/app/oracle/embase/agent_13c/GoldImage_GI_INT_Agent13.5_20210930/agent_13.5.0.0.0/sysman/admin/scripts
EMD_URL                 srv0rn01100.muniqsoft.de/emd/main/
localListeningHost
localListeningPort
REPOSITORY_URL          srv0rn00300.muniqsoft.de/empbs/upload
externalProxyPort
EMAGENT_PERL_TRACE_LEVEL        INFO
UploadInterval           15
Total Properties :       13


Man erkennt, dass die Installationsroutine den Namen der GI-Version in den Verzeichnispfad der Agenten-Software übernimmt.

Noch ein letzter Überblick darüber, welche Agenten das GI erhalten haben:

$OMS_HOME/bin/emcli list_agents_on_gold_image  -image_name=GI_INT_Agent13.5

Output:

Agent Name
srv0rn00200.muniqsoft.de:3872
srv0rn00400.muniqsoft.de:3872
srv0rn01100.muniqsoft.de:3872


Anschließend das Abmelden vom emcli:

$OMS_HOME/bin/emcli logout

 

Fazit

Mit der Verwendung eines Gold-Images erzielt man in einer Enterprise Manager-Umgebung einen einheitlichen Software-Stand der Agenten. Mit Hilfe des Command Line Tools „emcli“  können die Generierung und Verteilung der Software automatisiert innerhalb von Shell-Skripten oder „Ansible“ durchgeführt werden. Ansonsten kann auch für jeden der vorher gezeigten Schritte die Web-Oberfläche benutzt werden.

 

Jede Menge Know-how für Sie!

In unserer Know-How Datenbank finden Sie mehr als 300 ausführliche Beiträge zu den Oracle-Themen wie DBA, SQL, PL/SQL, APEX und vielem mehr.
Hier erhalten Sie Antworten auf Ihre Fragen.