DAA Agent

  = 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 aus dem SAP Support Portal heruntergeladen (z. B. <code>SAPJVM8_108-80000202.SAR</code>).
   * 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>.


  == 1. Neues Verzeichnis anlegen ==
  Zuerst muss ein neues Verzeichnis für die Ziel-Version der JVM erstellt und dem DAA-Admin zugewiesen werden.


  Melde dich als <code>root</code> (oder mit <code>sudo</code>) an:
  <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
  

 == 2. SAP JVM entpacken ==
 Das Entpacken erfolgt als User daaadm direkt in das neu erstellte Verzeichnis.

 Wechsle zum User daaadm:

  su - daaadm
  cd /usr/sap/DAA/SYS/exe/jvm/linuxx86_64/sapjvm_8.1.108
  

 Entpacke das Archiv mit SAPCAR (Pfade ggf. an den Ablageort der Datei anpassen):

  /usr/sap/DAA/SYS/exe/uc/linuxx86_64/SAPCAR -xvf /Pfad/zur/Datei/SAPJVM8_108-80000202.SAR
  

 Hinweis: Falls SAPCAR und die .SAR-Datei eine Ebene darüber liegen, kann auch ../SAPCAR -xvf ../SAPJVM8_108-80000202.SAR genutzt werden.

 == 3. Instanzprofil anpassen ==
 Damit das Programm sapcpe beim Starten des Agenten die neuen Binaries in das Ausführungsverzeichnis kopiert, muss die Version im Profil aktualisiert werden.

 Öffne das Profil mit einem Texteditor (z. B. vi):

  vi /usr/sap/DAA/SYS/profile/DAA_SMDA98_<Hostname>
  

 Suche nach der Variable SAPJVM_VERSION und ändere den Wert auf die neue Version (hier im Beispiel von 8.1.097 auf 8.1.108):

  Vorher:
  SAPJVM_VERSION = 8.1.097

  Nachher:
  SAPJVM_VERSION = 8.1.108
  

 Speichern und schließen.

 == 4. Diagnostics Agent neustarten ==
 Damit die Änderungen aktiv und die neuen Dateien per sapcpe in das Ausführungsverzeichnis (/usr/sap/DAA/SMDA98/exe/) kopiert werden, muss der Agent neu gestartet werden.

 Als User daaadm ausführen:

  stopsap
  startsap
  

 == 5. Überprüfung ==
 Nach dem Neustart kann mit folgenden Befehlen (als daaadm) verifiziert werden, ob die neue JVM aktiv ist:

 1. Java-Version im Ausführungsverzeichnis prüfen:

  /usr/sap/DAA/SMDA98/exe/sapjvm_8/bin/java -version
  

 Erwartete Ausgabe: Die neue Version (z.B. 8.1.108) wird angezeigt.

 2. Laufenden Prozess überprüfen:

  ps -ef | grep DAA | grep java
  

 Der Pfad zum laufenden Java-Prozess sollte auf /usr/sap/DAA/SMDA98/exe/sapjvm_8/bin/java zeigen.

 3. Copy-Log (sapcpe) kontrollieren:
 Um sicherzugehen, dass sapcpe das korrekte Quellverzeichnis genutzt hat:

  grep "source" /usr/sap/DAA/SMDA98/work/sapcpe.log | tail -n 5
  

 Hier sollte das neu angelegte Verzeichnis sapjvm_8.1.108 als Quelle (Source) gelistet sein.