Eigenschaften in SAP NetWeaver Java ändern
Ziel dieses Blogbeitrags ist es, die verschiedenen Arten von Eigenschaften zu erläutern, die in einem SAP NetWeaver for Java-System vorhanden sind, sowie die verschiedenen Hierarchien und deren Release-Versionen. Die von SAP bereitgestellten Werkzeuge zur Änderung von Java-Eigenschaften werden ebenfalls vorgestellt, zusammen mit einer kurzen Beschreibung des Zugriffs und der Verwendung. Dieser Beitrag enthält zudem eine Reihe von Empfehlungen zur Änderung der einzelnen Eigenschaftstypen, abhängig von der SAP NetWeaver-Version und dem Systemstatus.
Verschiedene Arten von Java-Eigenschaften
Systemeigenschaften
Wenn wir von den Systemeigenschaften in einem SAP NetWeaver Java-System sprechen, beziehen wir uns auf alle Eigenschaften, die mit den zugrunde liegenden Konfigurationen zusammenhängen, wie beispielsweise Kernel- und Services-Module sowie JVM-Parameter, einschließlich der Speicherverwaltung. Dazu gehören gegebenenfalls auch spezifische Konfigurationen für Java-Anwendungen. Zusammenfassend lässt sich sagen, dass die Systemeigenschaften für alle Konfigurationen der Architektur und der im System ausgeführten Anwendungen zuständig sind.
Beispiele für wichtige Systemeigenschaften:
- Dienst: servlet_jsp. Eigenschaft: EnableInvokerServletGlobally
- JVM: debuggbar
- Kernel: MaxThreadCount
UME Properties
Diese Art von Eigenschaft steht im Zusammenhang mit der User Management Engine (UME), die die Verwaltung der in verschiedenen Datenquellen angelegten Systembenutzer zentralisiert, beispielsweise aus dem LDAP-Verzeichnis oder der SAP NetWeaver ABAP-Datenbank sowie der SAP NetWeaver Java-Datenbank. Die UME ist als Dienst in das übrige System integriert und kann daher mit denselben Verwaltungstools verwaltet werden.
Die folgende Abbildung veranschaulicht die UME-Architektur. Zur Kommunikation mit den einzelnen Datenquellen kommen jeweils eigene Persistenzadapter zum Einsatz.
Die UME-Eigenschaften decken verschiedene Konfigurationsaspekte ab:
- Benutzerverwaltung: hauptsächlich Verwaltungsaufgaben.
- Sicherheitseinstellungen: beispielsweise eine Passwortrichtlinie.
- Selbstbedienungsszenarien
- Sicherheitsprotokollierung
- usw.
Die UME-Eigenschaften sind ebenfalls Teil des Dienstes „com.sap.security.core.ume.service “.
Änderungen an der SAP-Architektur
Beide Arten von Eigenschaften können auf verschiedenen Hierarchieebenen definiert werden. Je nach NetWeaver-Version gibt es einige Unterschiede in der SAP-Architektur.
SAP NetWeaver 7.0X
Es gibt nur zwei Konfigurationsebenen : die globale Ebene und die Instanzebene . Jede Ebene ist in die Kategorien „Dispatcher“ und „Server“ unterteilt. Jede Eigenschaft verfügt über einen Standardwert und kann einenbenutzerdefinierten Wert haben. Der Standardwert wird verwendet, sofern der Benutzer keinen benutzerdefinierten Wert festlegt; dieser Wert gilt dann für die Eigenschaft auf dieser Ebene. Die globale Konfiguration wird an die Instanzkonfiguration vererbt.
SAP NetWeaver 7.10 und höher
Der Konfigurationshierarchie wird zwischen der globalen Ebene und der Instanzebene eine neue Ebene namens „Vorlage“ hinzugefügt.
Die aktiven Werte der unteren Ebenen werden von den auf den übergeordneten Ebenen festgelegten Standard- oder benutzerdefinierten Werten übernommen. Auf jeder Ebene kann ein eindeutiger benutzerdefinierter Wert festgelegt werden, wodurch die Vererbung von oben unterbrochen wird, während die Vererbung des neuen Werts nach unten fortgesetzt wird.
Es ist möglich, mehrere Vorlagen mit unterschiedlichen Konfigurationen zu haben, aber nur eine davon ist aktiv und wird von allen Instanzen im System verwendet. Außerdem gibt es in dieser Architektur auf keiner Ebene eine Unterscheidung zwischen Dispatcher und Server . Die Werte „Standard“ und „Benutzerdefiniert“ sind weiterhin vorhanden und funktionieren wie bisher: Der Standardwert der Eigenschaft wird verwendet, sofern er nicht durch einen benutzerdefinierten Wert überschrieben wird.
Eigenschaften in verschiedenen NetWeaver-Versionen je nach Typ ändern
Es gibt mehrere Links zu SAP-Dokumentationen und -Foren, in denen je nach Art der Eigenschaft (System- oder UME-Eigenschaft), der SAP-NetWeaver-Version und dem Status des Systems (online oder offline) verschiedene Methoden zum Ändern von Eigenschaften in einem Java-System empfohlen werden. Der folgende Abschnitt fasst all diese Informationen zusammen, um mehr Klarheit darüber zu schaffen, welches Werkzeug unter den gegebenen Bedingungen am besten geeignet ist.
Von SAP bereitgestellte Tools
SAP stellt verschiedene Werkzeuge zur Verfügung, mit denen sich sowohl System- als auch UME-Eigenschaften ändern lassen:
- Das bekannte configtool (Konfigurationstool): ist nützlich, um Änderungen vorzunehmen, wenn das System offline ist. Es kann auch die globale Clusterkonfiguration ändern. Das Skript „configtool“ befindet sich im Ordner:
- <SAP_install_dir>/<system_name>/<instance_name>/j2ee/configtool
- Der NetWeaver-Administrator: ist ein Tool zur Verwaltung, Konfiguration und Überwachung des Systems. Es ist zudem die bevorzugte Methode, um Änderungen an den Systemeigenschaften vorzunehmen, während das System online ist. Der Zugriff erfolgt über einen Webbrowser unter folgender URL:
- http(s)://<AS_Java_hostname>:<http(s)_port>/nwa
- Die Benutzerverwaltung: ist eine spezielle Anwendung zur Verwaltung der UME, wenn das System online ist. Sie ist in den SAP NetWeaver Administrator (NWA) und das SAP NetWeaver Portal (NWP) integriert. Sie kann jedoch auch als eigenständige (UM-)Anwendung ausgeführt werden. Für jede Variante gibt es einen anderen Weg, auf die Benutzerverwaltung zuzugreifen:
- NWA: http(s)://<AS_Java_hostname>:<http(s)_port>/nwa/identity. Choose (User Management) Configuration and open the Expert Mode.
- NWP: http(s)://<AS_Java_hostname>:<http(s)_port>/irj. Choose System Administration → System Configuration → UME Configuration.
- UM: http(s)://<AS_Java_hostname>:<http(s)_port>/useradmin. Choose (User Management) Configuration
Systemeigenschaften online ändern
Wie bereits erläutert, unterscheidet sich die Hierarchie der Eigenschaften je nach SAP-NetWeaver-Version, und auch die von SAP bereitgestellten Werkzeuge haben sich in Bezug auf ihr Erscheinungsbild und ihre Funktionalität verändert.
Der NetWeaver-Administrator wird bei beiden Architekturtypen verwendet, um System-Eigenschaften zu ändern, während das System online ist; der Pfad zur Funktion „System-Eigenschaften“ ist jedoch unterschiedlich:
In SAP NetWeaver 7.0x: „NWA > Konfiguration > Systemeigenschaften“
Von dort aus können die JMV-Eigenschaften nicht geändert werden, sondern nur die Eigenschaften von „Kernel“ und „Services“. Für jede Eigenschaft wird der aktuelle Wert angezeigt, aber durch Klicken auf die Schaltfläche„Alle Werte anzeigen“ können alle in der Hierarchie definierten Werte angezeigt werden:
- In SAP NetWeaver ab Version 7.10: „NWA > Konfiguration > Infrastruktur > Java-Systemeigenschaften“
Diese Version der NWA ermöglicht Änderungen auf Vorlagen- und Instanzebene, jedoch nicht auf globaler Ebene. Zusätzliche Eigenschaften sowie die Registerkarten „Filter“ und „Gemeinsame Tabellen“ werden nach dem Klickenaufdie Schaltfläche„Erweiterte Eigenschaften anzeigen“angezeigt. Über die entsprechenden Schaltflächen können Eigenschaften hinzugefügt, entfernt oder geändert werden. Außerdem ist es möglich, den benutzerdefinierten Wert der Eigenschaft mit der Schaltfläche„Standardwert wiederherstellen“auf den Standardwertzurückzusetzen.
Es gibt eine spezielle Spalte„Änderbar“, die anzeigt, dass die Eigenschaft online geändert werden kann und die Änderung sofort wirksam wird.
Auch wenn der SAP NetWeaver Administrator die Änderung von Systemeigenschaften im laufenden Betrieb ermöglicht, werden einige davon erst nach einem Neustart des Systems wirksam.
UME-Eigenschaften online ändern
- In SAP NetWeaver 7.0x: Verwenden Sie den NWA wie im vorherigen Abschnitt beschrieben. Die UME-Eigenschaften sind Teil des Services „com.sap.security.core.ume.service“ und sollten nur auf globaler Ebene geändert werden. Nach den Änderungen muss das System neu gestartet werden.
- In SAP NetWeaver ab Version 7.10: Für diese Versionen stehen zwei verschiedene Tools zur Verfügung.
- Der erste ist der Expertenmodus des Benutzerverwaltungstools (in diesem Blogbeitrag wird nur der Zugriff über die NWA behandelt). Es erscheint ein Popup-Fenster mit einer Liste aller im System vorhandenen UME-Eigenschaften und deren globalen Werten:
- Das zweite Werkzeug ist der NWA im Service „com.sap.security.core.ume.service“. SAP empfiehlt, alle UME-Eigenschaften auf globaler Ebene festzulegen, um Inkonsistenzen bei den Benutzern zu vermeiden; es kann jedoch Fälle geben, in denen es möglich ist, bestimmte Eigenschaften auf Instanzebene festzulegen. Wie im vorigen Abschnitt erläutert, gibt es ein Kennzeichen, das angibt, ob die Eigenschaft dynamisch ist oder nicht.
Auch wenn der SAP NetWeaver-Administrator und die Benutzerverwaltung es ermöglichen, UME-Eigenschaften zu ändern, während das System online ist, werden einige davon erst nach einem Neustart des Systems wirksam.
Eigenschaften offline ändern
Endlich gibt es ein Tool, das in allen SAP-NetWeaver-Versionen im Wesentlichen gleich funktioniert und das zum Einsatz kommt, wenn das System offline ist: das Configtool. Das Configtool ist ein eigenständiges Java-Programm, das in jedem SAP-System vorhanden ist und über das Betriebssystem gestartet wird.
Sobald es geöffnet ist, wird eine Baumstruktur angezeigt, die der im NetWeaver-Administrator angezeigten Struktur entspricht; diese unterscheidet sich natürlich je nach NetWeaver-Version. Es gelten dieselben Empfehlungen hinsichtlich der Hierarchieebene, auf der Änderungen vorgenommen werden sollten. Sobald das System gestartet ist, werden alle im ConfigTool vorgenommenen Änderungen wirksam.
Fazit
Es gibt zwei Arten von Eigenschaften: System- und UME-Eigenschaften. In der SAP-NetWeaver-Architektur gibt es zudem Unterschiede zwischen den verschiedenen Versionen sowie unterschiedliche Werkzeuge, um die jeweiligen Eigenschaften entsprechend anzupassen. Die folgende Tabelle fasst zusammen, welches SAP-Werkzeug je nach NetWeaver-Version und Systemstatus zur Änderung der einzelnen Eigenschaftstypen zu verwenden ist:
Jeder Aspekt der Tabelle wird in diesem Blogbeitrag erläutert.
OP umfasst rund 40 Module, die verschiedene Java-Eigenschaften prüfen und für alle NetWeaver-Versionen ausgeführt werden. OP berücksichtigt die Hierarchie der jeweiligen Systemarchitektur sowie die Priorität der Eigenschaftswerte, um für jede Eigenschaft nur den aktuellen Wert zu ermitteln, unabhängig davon, mit welcher Methode dieser gesetzt wurde.
Literaturverzeichnis
Über den Autor
