EMCLI: Eigene Target Properties mit festen Wertelisten in Cloud Control 13c

von Ralf Durben

In Cloud Control ist es möglich den Zielsystemen Eigenschaften über das Setzen von Properties zuzuordnen. Damit kann zum Beispiel eine Zuordnung in Gruppen und damit auch eine Zuteilung der Verantwortlichkeit, inklusive Rechtevergabe, erfolgen. Wenn eine größere IT-Landschaft mit Cloud Control betrieben werden soll, ist die Nutzung von Properties ein wichtiges Hilfsmittel. Nach der Installation stehen dabei folgende globale Properties zur Verfügung, die Sie leicht mit EMCLI (Enterprise Manager Command Line Interface) auflisten können:

$EMCLI list_target_property_names
Name                          
Comment                       
Contact                       
Cost Center                   
Customer Service Identifier   
Department                    
Downtime Contact              
LifeCycle Status              
Line of Business              
Location                      
Operating System              
Platform                      
Site                          
Target Version

Hinweis: Alle Beispiele benutzen die Umgebungsvariable $EMCLI, die vorher mit export EMCLI="Pfad zum emcli executable" gesetzt wurde.

Die vorgegebenen Properties können Sie sowohl in der GUI, als auch in EMCLI verwenden. In der GUI navigieren Sie dazu auf der jeweiligen Zielsystem-Homepage über "Home -> Target Setup -> Properties", wobei "Home" für den Type des Zielsystem steht, also bei Oracle Datenbanken ist das Menü zum Beispiel mit "Oracle Database" benannt. In Oracle Enterprise Manager Cloud Control können Sie aber auch seit der Version 12c eigene Properties und ab Version 13c feste Wertelisten erstellen. Dazu müssen Sie EMCLI verwenden, denn in der GUI funktioniert das nicht. Als Beispiel soll hier die neue Eigenschaft eines Support Levels dienen. Ein solches Property können Sie für einzelne Zielsystemtypen, oder für alle Zielsystemtypen erstellen. Letzteres wird erreicht mit:

$EMCLI add_target_property -target_type=* -property="Support Level"
Property "Support Level" added successfully

$EMCLI list_target_property_names
Name                          
Comment                       
Contact                       
Cost Center                   
Customer Service Identifier   
Department                    
Downtime Contact              
LifeCycle Status              
Line of Business              
Location                      
Operating System              
Platform                      
Site                          
Support Level                 
Target Version

Beachten Sie dabei, dass als Zielsystemtyp (target_type) ein * angegeben wurde. An dieser Stelle könnten Sie auch einen einzelnen Zielsystemtyp wie zum Beispiel "oracle_database" festlegen. Das Property "Support Level" ist also erstellt und kann in der GUI auch sofort neben den bereits bestehenden verwendet werden:

Interessant sind diese selbst definierten Properties ab der Version 13c auch für die Definition von dynamischen Gruppen, denn sie können als Kriterium zur Mitgliedschaft einer Gruppe verwendet werden. Der folgende Screenshot zeigt, dass eine neue dynamische Gruppe das eben erstellte Property "Support Level" als Kriterium zur Mitgliedschaft einbeziehen kann.

Das oben erstellte Property kann nun für jedes Zielsystem frei mit einem Wert gefüllt werden. Dazu wird in der GUI von Cloud Control ein einfaches Textfeld angezeigt. Bei einem Property wie dem Support Level ist dieses aber ungünstig da sicherlich vorher festlegte Werte verwendet werden sollen, wie zum Beispiel "Gold", "Silber" und "Bronze". Um dieses durchzusetzen können Sie für das neue Property eine feste Werteliste erstellen, aus der dann später nur noch ausgewählt werden kann. Dazu gehen Sie wie folgt in EMCLI vor (in der GUI ist dieses nicht möglich):

Aktivieren Sie die Nutzung einer Werteliste für das Property.

$EMCLI use_target_properties_master_list -property_name="Support Level" -enable
Target Properties Master list enabled for property : Support Level

Definieren Sie die Werte der Werteliste. Die Werte werden später in alphabetischer Reihenfolge angezeigt.

$EMCLI add_to_target_properties_master_list -property_name="Support Level" -property_value="Gold"
Successfully set 1 value(s) for property: Support Level 

$EMCLI add_to_target_properties_master_list -property_name="Support Level" -property_value="Silber"
Successfully set 1 value(s) for property: Support Level 

$EMCLI add_to_target_properties_master_list -property_name="Support Level" -property_value="Bronze"
Successfully set 1 value(s) for property: Support Level 

$EMCLI add_to_target_properties_master_list -property_name="Support Level" -property_value="Blech"
Successfully set 1 value(s) for property: Support Level

Prüfen Sie die neue Werteliste.

$EMCLI list_target_properties_master_list_values -property_name="Support Level"
Target Properties Master list of values for property : Support Level
Blech
Bronze
Gold
Silber

Wenn Sie jetzt das Property für ein Zielsystem setzen möchten, erscheint automatisch die neue Werteliste.

Im vorliegenden Beispiel wurde der Wert auf "Blech" gesetzt. Sie können die Werteliste mit weiteren Werten ergänzen, aber auch bestehende Werte löschen, solange sie noch nicht genutzt wurden. Wenn zum Beispiel der Support Level "Blech" entfernt werden soll, weil dieser Name unangemessen erscheint, versuchen Sie es mit

$EMCLI delete_from_target_properties_master_list -property_name="Support Level" -property_value="Blech"

One or more targets are using this property-value

Sie ermitteln alle Zielsysteme, die diesen Wert verwenden mit

$EMCLI list_targets_having_property_value -property_name="Support Level" -property_value="Blech"
List of targets using value "Blech" for property "Support Level"
radu162	oracle_database

und setzen für diese Zielsysteme einen anderen Wert. Dann kann der Wert "Blech" auch gelöscht werden.

$EMCLI set_target_property_value -property_records="radu162:oracle_database:Support Level:Bronze"
Properties updated successfully

$EMCLI delete_from_target_properties_master_list -property_name="Support Level" -property_value="Blech"
Successfully deleted property-value

Für das Zielsystem ist nun der neue Propertywert gesetzt.

In der GUI sind alle möglichen Werte in der Select-Liste vorgegeben. Aber auch in EMCLI können Sie keine Werte setzen, die nicht in der Werteliste vorgegeben sind. Im folgenden Beispiel wird versucht, den Support Level auf "Platin" zu setzen, welcher aber nicht erlaubt ist. Es erfolgt eine entsprechende Fehlermeldung.

$EMCLI set_target_property_value -property_records="radu162:oracle_database:Support Level:Platin"
Target Properties Master list is enabled for property Support Level and Platin is not a valid value. 
Run emcli list_target_properties_master_list_values to see the list of valid values.

Fazit

Sie können eigene Properties erstellen, um zum Beispiel darüber eine flexible Zuordnung zu dynamischen Gruppen zu implementieren. Dabei ist es möglich festgelegte Wertelisten zu erstellen, damit die Nutzung einer begrenzten und vorgegebenen Anzahl von Werten forciert werden kann.

Hinweis zur Lizenzierung

Die Nutzung von Properties in Cloud Control ist Bestandteil der Grundfunktionalität. Diese ist über die Lizenz der Zielsysteme (im obigen Beispiel die Oracle Datenbank) abgedeckt.

Weitere Informationen

Zurück zum Anfang des Artikels

Zurück zur Community-Seite