DAA Agent: Unterschied zwischen den Versionen

Aus XccesS Wiki
Zur Navigation springen Zur Suche springen
VisuellWikitext
Die Seite wurde neu angelegt: „ <pre> = Update der SAP JVM für den SAP Diagnostics Agent (DAA) = Diese Anleitung beschreibt das manuelle Update der SAP JVM für den Diagnostics Agent (DAA) unter Linux. Da der Agent seine JVM nicht automatisch patchen kann, muss das Update manuell über das Anlegen eines neuen Verzeichnisses und die Anpassung des Instanzprofils erfolgen (gemäß SAP Hinweis 3408212). == Voraussetzungen == * Die aktuelle SAP JVM 8.1 im .SAR-Format wurde…“
 
KKeine Bearbeitungszusammenfassung
 
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
  <pre>
=== Beschreibung ===
  = Update der SAP JVM für den SAP Diagnostics Agent (DAA) =
Diese Anleitung beschreibt das manuelle Update der SAP JVM für den Diagnostics Agent (DAA) unter Linux. Da der Agent seine JVM nicht automatisch patchen kann, muss das Update manuell über das Anlegen eines neuen Verzeichnisses und die Anpassung des Instanzprofils erfolgen.


=== Download ===
Die aktuelle SAP JVM 8.1 im `.SAR`-Format muss aus dem SAP Support Portal (Software Center) heruntergeladen werden.
* Dateibeispiel: `SAPJVM8_108-80000202.SAR`


  Diese Anleitung beschreibt das manuelle Update der SAP JVM für den Diagnostics Agent (DAA) unter Linux. Da der Agent seine JVM nicht automatisch patchen kann, muss das Update manuell über das Anlegen eines neuen Verzeichnisses und die Anpassung des Instanzprofils erfolgen
=== Installation ===
  (gemäß SAP Hinweis 3408212).
''Die Erstinstallation des Diagnostics Agents ist nicht Teil dieses Artikels. Dieser Artikel behandelt ausschließlich das Update der zugrundeliegenden SAP JVM.''


=== Konfiguration ===
Es ist keine spezielle Vorab-Konfiguration auf Betriebssystemebene nötig, außer dass das Tool `SAPCAR` verfügbar sein muss und Root-Rechte für die Verzeichniserstellung benötigt werden.


  == Voraussetzungen ==
=== Update ===
  * Die aktuelle SAP JVM 8.1 im .SAR-Format wurde aus dem SAP Support Portal heruntergeladen (z. B. <code>SAPJVM8_108-80000202.SAR</code>).
Das Update erfolgt durch das Anlegen eines neuen JVM-Verzeichnisses und dem Anpassen der Profil-Datei.  
  * Das Tool <code>SAPCAR</code> ist auf dem Server verfügbar.
  * Root-Rechte (bzw. <code>sudo</code>) zum Anlegen der Berechtigungen sowie Zugriff auf den User <code>daaadm</code>.


<syntaxhighlight lang="bash" line="1">
# 1. Neues Verzeichnis als root/sudo anlegen und Rechte setzen (Version im Namen anpassen)
mkdir -p /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108
chown daaadm:sapsys /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108


  == 1. Neues Verzeichnis anlegen ==
# 2. Zum DAA-User wechseln und in das neue Verzeichnis gehen
  Zuerst muss ein neues Verzeichnis für die Ziel-Version der JVM erstellt und dem DAA-Admin zugewiesen werden.
su - daaadm
cd /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108


# 3. Das heruntergeladene Archiv entpacken (Pfade anpassen)
/usr/sap/DAA/SYS/exe/uc/linuxx86_64/SAPCAR -xvf /Pfad/zur/Datei/SAPJVM8_108-80000202.SAR
</syntaxhighlight>


  Melde dich als <code>root</code> (oder mit <code>sudo</code>) an:
Im Anschluss muss das Instanzprofil des Diagnostics Agents angepasst werden:
  <pre>
  mkdir -p /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108
  chown daaadm:sapsys /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108
  </pre>


<syntaxhighlight lang="bash" line="1">
# Profil editieren (Hostname anpassen)
vi /usr/sap/DAA/SYS/profile/DAA_SMDA98_<Hostname>
</syntaxhighlight>


  == 2. SAP JVM entpacken ==
Dort die Variable `SAPJVM_VERSION` auf die neue Version ändern:
  Das Entpacken erfolgt als User <code>daaadm</code> direkt in das neu erstellte Verzeichnis.
<syntaxhighlight lang="ini" line="1">
# Vorher:
SAPJVM_VERSION = 8.1.097


# Nachher:
SAPJVM_VERSION = 8.1.108
</syntaxhighlight>


  Wechsle zum User <code>daaadm</code>:
Den Agenten als `daaadm` neu starten, damit `sapcpe` die neuen Binaries kopiert:
  <pre>
<syntaxhighlight lang="bash" line="1">
  su - daaadm
stopsap
  cd /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108
startsap
  </pre>
</syntaxhighlight>


=== Test ===
Nach dem Neustart prüfen, ob die neue JVM aktiv ist (als User `daaadm`):


  Entpacke das Archiv mit <code>SAPCAR</code> (Pfade ggf. an den Ablageort der Datei anpassen):
<syntaxhighlight lang="bash" line="1">
  <pre>
# 1. Java-Version im Ausführungsverzeichnis prüfen
  /usr/sap/DAA/SYS/exe/uc/linuxx86_64/SAPCAR -xvf /Pfad/zur/Datei/SAPJVM8_108-80000202.SAR
/usr/sap/DAA/SMDA98/exe/sapjvm_8/bin/java -version
  </pre>
  ''Hinweis: Falls SAPCAR und die .SAR-Datei eine Ebene darüber liegen, kann auch <code>../SAPCAR -xvf ../SAPJVM8_108-80000202.SAR</code> genutzt werden.''


# 2. Prüfen, ob der laufende Agent-Prozess den korrekten Java-Pfad nutzt
ps -ef | grep DAA | grep java


  == 3. Instanzprofil anpassen ==
# 3. sapcpe-Log prüfen, ob aus dem neuen Verzeichnis kopiert wurde
  Damit das Programm <code>sapcpe</code> beim Starten des Agenten die neuen Binaries in das Ausführungsverzeichnis kopiert, muss die Version im Profil aktualisiert werden.
grep "source" /usr/sap/DAA/SMDA98/work/sapcpe.log | tail -n 5
</syntaxhighlight>


  Öffne das Profil mit einem Texteditor (z. B. <code>vi</code>):
=== Fehlerbehebung===
  <pre>
====Starten/Stoppen funktioniert nicht====
  vi /usr/sap/DAA/SYS/profile/DAA_SMDA98_<Hostname>
Wenn `startsap` oder `stopsap` mit Fehlern abbrechen oder der Agent nicht hochfährt:
  </pre>


=====Lösung 1=====
Prüfen, ob die Berechtigungen des neu angelegten Verzeichnisses korrekt sind und ob die Versionsnummer im Profil (`SAPJVM_VERSION`) exakt dem Namen des Verzeichnisses entspricht.
<syntaxhighlight lang="bash" line="1">
# Berechtigungen prüfen (muss daaadm:sapsys sein)
ls -ld /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108


  Suche nach der Variable <code>SAPJVM_VERSION</code> und ändere den Wert auf die neue Version (hier im Beispiel von <code>8.1.097</code> auf <code>8.1.108</code>):
# Falls falsch, als root korrigieren:
  <pre>
chown -R daaadm:sapsys /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108
  Vorher:
</syntaxhighlight>
  SAPJVM_VERSION = 8.1.097


  Nachher:
=== Codeschnipsel ===
  SAPJVM_VERSION = 8.1.108
Entpacken, wenn `SAPCAR` und die `.SAR`-Datei eine Ebene über dem neuen JVM-Verzeichnis liegen:
  </pre>
<syntaxhighlight lang="bash" line="1">
  Speichern und schließen.
# Als daaadm aus dem neu erstellten sapjvm_8.1.x Ordner heraus ausführen
../SAPCAR -xvf ../SAPJVM8_108-80000202.SAR
</syntaxhighlight>


 
=== Nützliche Links ===
  == 4. Diagnostics Agent neustarten ==
* [https://me.sap.com/notes/3408212 SAP Note 3408212 - Diagnostics Agent - How To Switch or Update SAP JVM]
  Damit die Änderungen aktiv und die neuen Dateien per <code>sapcpe</code> in das Ausführungsverzeichnis (<code>/usr/sap/DAA/SMDA98/exe/</code>) kopiert werden, muss der Agent neu gestartet werden.
 
  Als User <code>daaadm</code> ausführen:
  <pre>
  stopsap
  startsap
  </pre>
 
 
  == 5. Überprüfung ==
  Nach dem Neustart kann mit folgenden Befehlen (als <code>daaadm</code>) verifiziert werden, ob die neue JVM aktiv ist:
 
 
  '''1. Java-Version im Ausführungsverzeichnis prüfen:'''
  <pre>
  /usr/sap/DAA/SMDA98/exe/sapjvm_8/bin/java -version
  </pre>
  ''Erwartete Ausgabe: Die neue Version (z.B. 8.1.108) wird angezeigt.''
 
 
  '''2. Laufenden Prozess überprüfen:'''
  <pre>
  ps -ef | grep DAA | grep java
  </pre>
  ''Der Pfad zum laufenden Java-Prozess sollte auf <code>/usr/sap/DAA/SMDA98/exe/sapjvm_8/bin/java</code> zeigen.''
 
 
  '''3. Copy-Log (sapcpe) kontrollieren:'''
  Um sicherzugehen, dass <code>sapcpe</code> das korrekte Quellverzeichnis genutzt hat:
  <pre>
  grep "source" /usr/sap/DAA/SMDA98/work/sapcpe.log | tail -n 5
  </pre>
  ''Hier sollte das neu angelegte Verzeichnis <code>sapjvm_8.1.108</code> als Quelle (Source) gelistet sein.''
  </pre>

Aktuelle Version vom 6. März 2026, 10:30 Uhr

Beschreibung

Diese Anleitung beschreibt das manuelle Update der SAP JVM für den Diagnostics Agent (DAA) unter Linux. Da der Agent seine JVM nicht automatisch patchen kann, muss das Update manuell über das Anlegen eines neuen Verzeichnisses und die Anpassung des Instanzprofils erfolgen.

Download

Die aktuelle SAP JVM 8.1 im `.SAR`-Format muss aus dem SAP Support Portal (Software Center) heruntergeladen werden.

  • Dateibeispiel: `SAPJVM8_108-80000202.SAR`

Installation

Die Erstinstallation des Diagnostics Agents ist nicht Teil dieses Artikels. Dieser Artikel behandelt ausschließlich das Update der zugrundeliegenden SAP JVM.

Konfiguration

Es ist keine spezielle Vorab-Konfiguration auf Betriebssystemebene nötig, außer dass das Tool `SAPCAR` verfügbar sein muss und Root-Rechte für die Verzeichniserstellung benötigt werden.

Update

Das Update erfolgt durch das Anlegen eines neuen JVM-Verzeichnisses und dem Anpassen der Profil-Datei. 

# 1. Neues Verzeichnis als root/sudo anlegen und Rechte setzen (Version im Namen anpassen)
mkdir -p /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108
chown daaadm:sapsys /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108

# 2. Zum DAA-User wechseln und in das neue Verzeichnis gehen
su - daaadm
cd /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108

# 3. Das heruntergeladene Archiv entpacken (Pfade anpassen)
/usr/sap/DAA/SYS/exe/uc/linuxx86_64/SAPCAR -xvf /Pfad/zur/Datei/SAPJVM8_108-80000202.SAR

Im Anschluss muss das Instanzprofil des Diagnostics Agents angepasst werden: 

# Profil editieren (Hostname anpassen)
vi /usr/sap/DAA/SYS/profile/DAA_SMDA98_<Hostname>

Dort die Variable `SAPJVM_VERSION` auf die neue Version ändern: 

# Vorher:
SAPJVM_VERSION = 8.1.097

# Nachher:
SAPJVM_VERSION = 8.1.108

Den Agenten als `daaadm` neu starten, damit `sapcpe` die neuen Binaries kopiert: 

stopsap
startsap

Test

Nach dem Neustart prüfen, ob die neue JVM aktiv ist (als User `daaadm`): 

# 1. Java-Version im Ausführungsverzeichnis prüfen
/usr/sap/DAA/SMDA98/exe/sapjvm_8/bin/java -version

# 2. Prüfen, ob der laufende Agent-Prozess den korrekten Java-Pfad nutzt
ps -ef | grep DAA | grep java

# 3. sapcpe-Log prüfen, ob aus dem neuen Verzeichnis kopiert wurde
grep "source" /usr/sap/DAA/SMDA98/work/sapcpe.log | tail -n 5

Fehlerbehebung

Starten/Stoppen funktioniert nicht

Wenn `startsap` oder `stopsap` mit Fehlern abbrechen oder der Agent nicht hochfährt:

Lösung 1

Prüfen, ob die Berechtigungen des neu angelegten Verzeichnisses korrekt sind und ob die Versionsnummer im Profil (`SAPJVM_VERSION`) exakt dem Namen des Verzeichnisses entspricht. 

# Berechtigungen prüfen (muss daaadm:sapsys sein)
ls -ld /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108

# Falls falsch, als root korrigieren:
chown -R daaadm:sapsys /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108

Codeschnipsel

Entpacken, wenn `SAPCAR` und die `.SAR`-Datei eine Ebene über dem neuen JVM-Verzeichnis liegen: 

# Als daaadm aus dem neu erstellten sapjvm_8.1.x Ordner heraus ausführen
../SAPCAR -xvf ../SAPJVM8_108-80000202.SAR

Nützliche Links

Abgerufen von „https://wiki.fam-puls.de/index.php?title=DAA_Agent&oldid=528“