Show TOC

 Steuerung von CCMS-AgentenLocate this document in the navigation structure

Achtung

CCMS-Agenten werden für reine SAP-NetWeaver-7.1-Landschaften nicht mehr benötigt; Ihre Funktionen werden durch NetWeaver-Management-Agenten übernommen. Informationen, wann Sie für SAP NetWeaver 7.1 noch CCMS-Agenten benötigen, finden Sie unter CCMS-Agenten: Zentrales Monitoring für Komponenten bis SAP NetWeaver 7.0.

Verwendung

Zur Steuerung der CCMS-Agenten direkt von der Betriebssystem-Eingabeaufforderung stehen Ihnen die stehen Ihnen die folgenden Befehle zur Verfügung:

Befehl Bedeutung

-R [-f <Startdatei>]    [pf=<Profilpfad>]

Registrieren des Agenten (siehe Installation und Registrierung von CCMS-Agenten)

-U [pf=<Profilpfad>]

Deregistrieren des Agenten

-DCCMS [pf=<Profilpfad>]

Starten des Agenten

-stop [pf=<Profilpfad>]

Stoppen des Agenten

-status [pf=<Profilpfad>]

Anzeigen des Agentenstatus

-noservice

Registrieren und Deregistrieren ohne Installation bzw. Deinstallation eines Services (nur Windows)

-V

Anzeigen der Version des Agenten

Sie können sich die Liste der verfügbaren Befehle jederzeit anzeigen lassen, indem Sie in der Betriebssystem-Eingabeaufforderung den Namen des Agenten ohne Befehle und Optionen eingeben (z. B. sapccmsr).

Funktionsumfang

Deregistrieren von CCMS-Agenten

Zur Deregistrierung eines Agenten geben Sie den Parameter -U an. Falls Sie bei der Registrierung einen Profilpfad angegeben haben, geben Sie diesen Pfad auch zur Deregistrierung an:

CCMS-Agent Deregistrierungsaufruf

SAPCCMSR

sapccmsr -U [pf=<Profilpfad>]

SAPCCMSR -j2ee

sapccmsr -j2ee -U pf=<Profilpfad>

SAPCCM4X

sapccm4x -U  pf=<Profilpfad>

SAPCM3X

sapcm3x  -U [pf=<Profilpfad>]

Bei der Deregistrierung wird die Startdatei CSMCONF gelöscht. Außerdem werden bei der Deinstallation die Anmeldedaten zum CEN abgefragt, um im System die folgenden Einträge des Agenten automatisch zu löschen:

  • Eintrag in der Topologieanzeige der Monitoring-Architektur (Sie starten die Topologieanzeige über die Transaktion RZ21; wählen sie dort im Gruppenrahmen Topologie einen der Auswahlknöpfe, die Ihnen die an diesem System registrierten CCMS-Agenten anzeigen)
  • RFC-Verbindungen zum Agenten (Kontrolle über die Transaktion SM59)
  • Eintrag im System Component Repository (SCR); zeigen Sie das SCR an, indem Sie in der Transaktion RZ21 Techn.Infrastruktur → System Repository → Anzeigen wählen
    Hinweis

    Bei einem älteren Release-Stand als SAP Web AS 6.20 werden diese Einträge nicht gelöscht. Sie sollten auf jeden Fall den Agenten in der Topologieanzeige auf Offline setzen, um Probleme im System zu verhindern.

Starten und Stoppen von CCMS-Agenten

Stoppen und starten Sie einen CCMS-Agenten immer dann, wenn Sie Änderungen in seiner Konfigurationsdatei SAPCCMSR.INI vorgenommen haben, da diese Datei nur beim Start des Agenten gelesen wird. Gehen sie dabei in Abhängigkeit der Betriebssystemplattform wie folgt vor:

  • Unter UNIX stoppen Sie die Agenten durch die Option -stop, also z. B. beim Agenten SAPCCMSR durch den Befehl sapccmsr -stop [pf=<Profilpfad>]. Um den Agenten später wieder zu starten, verwenden Sie die Option -DCCMS.
  • Unter Windows empfiehlt SAP, dass Sie den Agenten stoppen und starten, indem Sie den gleichnamigen Service stoppen und starten.

Registrieren und Deregistrieren eines Agenten ohne Installation/Deinstallation eines Services (nur Windows)

Unter Windows können Sie mit der Option -noservice in Verbindung mit den Befehlen -R (Agent registrieren) und -U (Agent deregistrieren) verhindern, dass bei der Registrierung der zugehörige Service installiert bzw. bei der Deregistrierung der zugehörige Service deinstalliert wird.

Diese Option steht Ihnen seit Patch Collection 2005/5 zur Verfügung. Sie ist vor allem dann nützlich, wenn Sie unter einem Benutzer einen Agenten registrieren oder deregistrieren müssen, der nicht über Administratorberechtigung auf dem entsprechenden Host verfügt.

Status eines CCMS-Agenten anzeigen

Der Status eines CCMS-Agenten gibt das Arbeitsverzeichnis und das Konfigurationsverzeichnis des Agenten aus; falls der Agent läuft, zusätzlich Informationen über das zentrale Monitoring-System, in dem der Agent registriert ist. Rufen Sie hierzu den Agenten mit der Option -status auf (z. B. beim Agenten SAPCCMSR):

> sapccmsr -status

INFO: CCMS agent sapccmsr working directory is /usr/sap/tmp/sapccmsrINFO: CCMS agent sapccmsr config file is       /usr/sap/tmp/sapccmsr/csmconfINFO: Checking shared memory status of sapccmsr******** CCMS agent running on this machine: **********      sapccmsr without profile **      registered at central system BCE **      CCMS version  20010925, 32 bit*      Process Id    28807 *      relno         6200*      patchno       45*      intno         20020600*****************************************************EXITING with code 0

Version eines CCMS-Agenten anzeigen

Rufen Sie den Agenten mit der Option -V auf (z. B. den Agenten SAPCCMSR):

> sapccmsr -v

CCMS version 20010925, 32 bit, multithreaded, Non-Unicodecompiled at  Sep 17,2002systemid  560 (PC with Windows NT)relno  6200Patch text patch collection 2003/2, SAP note 584136patchno 344intno  20023800running on P57373 Windows NT 5.0 2195 Service Pack 2 Intel 80686

Die Version entnehmen Sie der Release-Nummer (relno) und der Patch-Nummer (patchno). Daneben erhalten Sie in der Zeile running on genau das Betriebssystem, auf dem der Agent gerade läuft. In Patch text wird die Patch Collection angegeben. Welche Sammlung welche Veränderungen enthält, entnehmen Sie SAP-Hinweis 202591.

 Startseite CCMS-Agenten