Steuerung von CCMS-Agenten
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>] |
Registrieren des 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
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.
Stoppen Sie ebenfalls die CCMS-Agenten SAPCCM4X und SAPCCMSR –j2ee, falls Sie für das entsprechende überwachte System ein Upgrade durchführen möchten. Starten Sie nach dem Upgrade die Agenten wieder.
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/sapccmsr
INFO: CCMS agent sapccmsr config file is
/usr/sap/tmp/sapccmsr/csmconf
INFO: 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-Unicode
compiled at Sep 17,2002
systemid 560 (PC with Windows
NT)
relno 6200
Patch text patch collection 2003/2, SAP
note 584136
patchno 344
intno 20023800
running 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 Collectionangegeben. Welche Sammlung welche Veränderungen enthält, entnehmen Sie SAP-Hinweis 202591.
Startseite
CCMS-Agenten