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.
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.
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
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.
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&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.
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
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
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.
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.