EM CLI wird unterschätzt bei Cloud Control

Die Enterprise Manager-Befehlszeilenschnittstelle (EM CLI) ermöglicht Administratoren den Zugriff auf Enterprise Manager-Funktionen über die Befehlszeilenschnittstelle. 
Sie können Aufgaben mit EM CLI mit den gleichen Privilegien wie mit der OEM-Konsole ausführen.  
In diesem Blogeintrag wird die Installation von EM CLI sowie die Agenteninstallation und das Target Discovery einer Datenbank mit EM CLI vorgestellt. 
 

Die Installation erfolgt in diesem Beispiel auf Linux.

Vorbereitung:  - Anlegen eines Zielordners
                         - JAVA_HOME definieren (JAVA Version der der Datenbank 19c kann genutzt werden)
                         - emclikit.jar  auf dem Zielhost im Zielordner speichern

$ export JAVA_HOME=/u01/app/oracle/product/19.0.0/dbhome_1/jdk

#-- Zielordner anlegen

$ mkdir /home/oracle/emcli

$ scp emclikit.jar /home/oracle/emcli

Installation von EM CLI:

$ $JAVA_HOME/bin/java -jar emclikit.jar -install_dir=/home/oracle/emcli

Oracle Enterprise Manager 13c Release 5.
Copyright (c) 2012, 2021 Oracle Corporation.  All rights reserved.

EM CLI client-side install completed successfully.
Execute "emcli help setup" from the EM CLI home (the directory where you have installed EM CLI) for further instructions.

Im nächsten Schritt erfolgt das Setup für den Administrator (hier ist der priviligierter Administrator: TESTUSER ):

$  cd /home/oracle/emcli
$ ./emcli setup  -url=https://OMS-HOST:PORT/em -username=TESTUSER
Oracle Enterprise Manager 13c Release 5.

Enter password 
. . .
Do you trust the certificate chain? [yes/no] yes
Emcli setup successful

#-- Kontrolle zur Umgebung  incl.Speicherort der  Log files  
$ ./emcli status
..
Instance Home          : /home/oracle/.emcli
. ..
Java Version           : 1.8.0_331
Log file               : /home/oracle/.emcli/.emcli.log
Log level              : SEVERE
EM URL                 : https://OMS-HOST:PORT/em
EM user                : testuser
... 

Nach der erfolgreichen Installation ist es hilfreich, EM CLI in den Path zu integrieren.
Mit "emcli help" kann die umfangreiche Hilfe genutzt werden. 

#-- in den PATH einbinden 

export PATH=$PATH:/home/oracle/emcli

#-- Anmeldung emcli

$ emcli login -username=testuser
Enter password : 

Login successful

Bevor ein Agent mit EM CLI installiert werden kann, muss ein Named Credential (Benutzername+Passwort) für den neuen Host hinterlegt werden.
Das kann grafisch, auch mit ssh Key oder mit EM CLI erfolgen. Diese Credentials werden defaultmäßig in der Repository Datenbank verschlüsselt abgelegt. 

#-- Anmeldung 
$ emcli login -username=TESTUSER
password:


#--Syntax: 
  emcli create_named_credential -cred_name=<Credential Name> -auth_target_type=host - 
  cred_type=HostCreds  -attributes="HostUserName:<USER>;HostPassword:<Password>"

#-- Beispiel named Credential für host01 und den Betriebssystem Benutzer oracle

 $ emcli create_named_credential -cred_name=nc_host01 -auth_target_type=host -cred_type=HostCreds  -attributes="HostUserName:oracle;HostPassword:oracle"

Credential NC_TESTHOST created

Die Installation des Agenten erfolgt aus der Software Library: 

# Syntax
emcli create_named_credential -cred_name=nc_xhost -auth_target_type=host -cred_type=HostCreds  -attributes="HostUserName:oracle;HostPassword:oracle"


$ emcli  submit_add_host -host_names="host01" -credential_name=NC_TESTHOST -installation_base_directory=/u01/app/oracle/agent -platform=226

#-- Hinweis: 226 = Linux64


$ emcli  submit_add_host -host_names="host01" -credential_name=NC_TESTHOST -installation_base_directory=/u01/app/oracle/agent -platform=226


#-- Kontrolle der Installation 
$ emcli get_add_host_status -session_name=ADD_HOST_TESTUSER_Nov_10_2022_1:26:38_PM_CET
OverAll Status : Initialization in Progress

Host              Platform Name  Initialization  Remote Prerequisite  Agent Deployment  
host01            Linux x86-64   Succeeded       Succeeded            In Progress         


#-- Agent installiert?

$ emcli get_targets  -targets="oracle_emd"
Status  Status           Target Type           Target Name                        
 ID                                                                               
1       Up               oracle_emd            host01:3872    

#-- als letzter Schritt noch root Skript ausführen

$ ssh root@host01
$ /u01/app/oracle/agent/agent_13.5.0.0.0/root.sh

Mit EM CLI können einzelne Targets oder ein Agent mit allen von ihm überwachten Targets gelöscht werden.

#-- Löschen einer Datenbank 

$  emcli delete_target -name="MY_DemoCDB" -type="oracle_database"
Target "MY_DemoCDB:oracle_database" deleted successfully


#-- Löschen eines Agenten mit allen targets

$ emcli delete_target  -name="host01:3872"  -type="oracle_emd"  -delete_monitored_targets -async

In diesem Beitrag wurden die ersten Beispiele für den Einsatz mit EM CLI gezeigt.