Installation/Registrierung der CCMS-Agenten für Experten

Die CCMS-Agenten ergänzen die Monitoring-Architektur, indem sie neben der ABAP-Schnittstelle einen weiteren Verbindungsweg vom zentralen Monitoring-System zu beliebigen Servern zur Verfügung stellen. Sie ermöglichen damit:

• die Einbindung von SAP-Komponenten ohne ABAP-Schnittstelle
• die Einbindung von Nicht-SAP-Komponenten
• eine Optimierung der Performance beim Lesen und Schreiben der Monitoring-Daten
• einen von Fehlerzuständen der überwachten SAP-Instanz unabhängigen Zugangsweg

• Bei der Installation eines CCMS-Agenten unter Windows NT oder Windows 2000 benötigen Sie auf dem entsprechenden Host Administrator-Rechte.
• Installieren Sie SAPCCM4X undSAPCM3X unter dem Benutzer <SID>adm (UNIX) bzw. SAPService<SID> (Windows) des überwachten Systems, um zu gewährleisten, dass der Agent auf das Shared Memory zugreifen kann.
• Falls auf einem Host Instanzen mehrerer SAP-Systeme mit Release-Stand 3.X laufen, beachten Sie die folgenden Punkte:
  • Installieren Sie pro Host nur einen SAPCM3X-Agenten.
  • Der Agent überwacht nur eine Instanz, falls Sie ein Profil angeben; geben Sie also beim Start des Agenten kein Profil (mit pf=) an.
  • Damit der Agent die Shared-Memory-Segmente aller Systeme lesen kann, installieren Sie den Agenten im Benutzer root.
• Bei den Agenten SAPCCM4X und SAPCCMSR mit Option -j2ee benötigen Sie pro Instanz einen eigenen Agenten.

1. Laden Sie den gewünschten CCMS-Agenten aus dem Software Catalog des SAP Service Marketplace herunter (siehe CCMS-Agenten herunterladen).
2. Kopieren Sie den CCMS-Agenten, den Sie installieren möchten, je nach Plattform in das folgende Verzeichnis:

   CCMS-Agent	Windows	Unix
   SAPCCMSR SAPCM3X	\\<host>\saploc\prfclog	/usr/sap/ccms/bin
   SAPCCMSR ‑j2ee SAPCCM4X	\\<host>\usr\sap\<SysID> \SYS\exe\run	/usr/sap/<SysID>/SYS/exe/run

   Hinweis

   Das Verzeichnis saploc kann auch einen anderen Namen haben; entscheidend ist, dass es als Share unter dem Namen saplocfreigegeben ist. Standardmäßig ist es das Verzeichnis <drive:>\usr\sap. Fall das Verzeichnis nicht existiert, erstellen Sie es bei der Installation selbst.

3. Falls Sie mit dem CCMS-Agenten Protokolldateien überwachen möchten, erstellen Sie eine oder mehrere Logfile-Templates (siehe Aufbau der Logfile-Templates des Logfile-Agenten).
4. Falls Sie die Überwachung von Betriebssystemdaten individuell konfigurieren möchten, erstellen Sie eine SAPOSCOL-Filterdatei, mit der Sie Teile der Betriebssystem-Überwachung explizit ein- und ausschalten können (siehe Überwachung von Betriebssystemdaten mit CCMS-Agenten).
5. Bei der Registrierung eines CCMS-Agenten geben Sie mit pf=<Profilpfad> eine Profildatei an. Beim Agenten SAPCCM4X ist dies obligatorisch, die Profildatei muss die der überwachten Instanz sein. Ebenso müssen Sie beim Agenten SAPCCMSR mit Option j2ee eine Profildatei angeben. Diese Profildatei muss ebenfalls die der überwachten Instanz sein. Beide Profildateien befinden sich in:

   <drive>:\usr\sap\<SysID>\SYS\profile\<SysID>_<InstDir>_<Host> (Windows)

   /usr/sap/<SysID>/SYS/profile/<SysID>_<InstDir>_<Host> (Unix)

   Bei den Agenten SAPCM3X und SAPCCMSR ohne Option -j2ee dagegen ist die Angabe einer Profildatei optional und meist nicht notwendig. Informationen, welche Profilparameter Sie in einer solchen Profildatei setzen können, finden Sie unter Profildatei der CCMS-Agenten.

6. Erstellen Sie die Konfigurationsdatei SAPCCMSR.INI vor der Installation eines CCMS-Agenten, falls Sie mindestens eine der folgenden Funktionen nutzen:
   • eigene Einstellungen in der Überwachung von Protokolldateien
   • Konfiguration der Überwachung der Betriebssystemdaten
   • Alert-Protokollierung von CCMS-Agenten
   • Verwendung von zusätzlichen Shared Libraries
     Hinweis

     Sie können die Konfigurationsdateien der Punkte 3 bis 6 auch nach der Registrierung des CCMS-Agenten erstellen, müssen dann aber dafür sorgen, dass der Agent diese Dateien berücksichtigt. Starten Sie hierzu den Agenten durch (siehe Steuerung von CCMS-Agenten).

7. Registrieren Sie den CCMS-Agenten; Sie machen den Agenten dem zentralen Monitoring-System bekannt. SAP empfiehlt, dass Sie die hierfür benötigten Daten vom zentralen Monitoring-System erstellen lassen (siehe Startdatei CSMCONF automatisch erstellen). Sie können die Registrierung auf verschiedene Arten durchführen:
   • Registrierung mit dem Agentenregistrierungs-Tool; verwenden Sie dieses Tool für die Registrierung des Agenten SAPCCMSR an genau einem CEN. Die entsprechenden Vorgehensweisen finden Sie im Prozess CCMS-Agenten für SAP-NetWeaver-Komponenten installieren.
   • Registrierung im Dialog (siehe Registrierung der CCMS-Agenten im Dialog)
   • dialogfreie Registrierung mit Hilfe einer Startdatei (siehe Dialogfreie Registrierung der CCMS-Agenten)
     Hinweis

     Die Besonderheiten der Registrierung des SAPCCMSR mit Option j2ee werden in Registrierung des SAPCCMS mit Option -j2ee behandelt.

8. Unter Windows wurde der Agent als Service eingetragen und gestartet. Bei jedem Neustart des Servers wird der Agent automatisch mit gestartet. Falls Sie den CCMS-Agenten auf unter UNIX installiert haben, wurde der Agent noch nicht gestartet. Starten Sie ihn durch:

   Agent	Startaufruf
   SAPCCMSR	sapccmsr -DCCMS [pf=<Profilpfad>]
   SAPCCMSR -j2ee	sapccmsr -j2ee -DCCMS pf=<Profilpfad>
   SAPCCM4X	sapccm4x -DCCMS  pf=<Profilpfad>
   SAPCM3X	sapcm3x  -DCCMS [pf=<Profilpfad>]

   Außerdem müssen auf einer UNIX-Plattform selbst dafür sorgen, dass der CCMS-Agent nach einem Neustart des Servers automatisch gestartet wird (z.B. durch Eintrag des Startaufrufs in die INITTAB).

9. Dieser Punkt gilt nur für die Installation des Agenten SAPCCM4X: Falls das überwachte System des Agenten bereits vor der Registrierung des Agenten bei der Monitoring-Architektur des zentralen Monitoring-Systems bekannt ist, dann existieren alle notwendigen RFC-Verbindungen bereits. Ansonsten müssen Sie das überwachte System im zentralen Monitoring-System noch als entferntes System eintragen (siehe SAP-NetWeaver-Komponenten und Hosts im CEN registrieren).
10. Die übermittelten Daten des CCMS-Agenten stehen nun im zentralen Monitoring-System zur Verfügung. Falls Sie einen bequemeren Zugang zu diesen Daten benötigen, können Sie Monitore der CCMS-Agenten im zentralen Monitoring-System anlegen.

 Startseite CCMS-Agenten