Fehlerbehebung beim Setup des ACC 7.1

Sie können die in den Vorgehensweisen weiter unten beschriebenen Behelfslösung für folgende Probleme anwenden, die bei der Verwendung des ACC 7.1 auftreten:

Die Computersysteme oder -services in der Ansicht Resources zeigen einen falschen Status an.
Es treten Berechtigungsausnahmen während der Anmeldung am ACC auf.
Es treten SLD-Ausnahmen während der Anmeldung am ACC auf.
Wenn Sie einen Service starten, stoppen oder verschieben wird die Ausnahme Sie haben keine Berechtigung angezeigt.
Wenn Sie einen Service starten, stoppen oder verschieben wird die Ausnahme Sie haben keine Berechtigung angezeigt.
Der Agent zum Stoppen einer Instanz schlägt fehl mit der Meldung HTTP 401 Unauthorized Error.

Vorgehensweise

Computersysteme oder Services melden falschen Status

Wenn die Computersysteme nicht keinen grünen Status haben oder der Status der Services falsch gemeldet wird, führen Sie folgende Prüfungen durch:

Überprüfen Sie die Verfügbarkeit der SAP-Hostagenten.
1. Melden Sie sich über die URL http://<host>:<port>/tc~lm~itsam~core~computersys~web/csdp_test.jsp auf der Testseite des Computersystemdaten-Providers an.
2. Wählen Sie Show availability information (directly from SAP_ITSAMComputerSystems).
  All your AC managed computer systems should appear as available: true in the list.
  
  Wenn einige Computersysteme in der Liste als nicht verfügbar, also "false" aufgeführt werden, gehen Sie folgendermaßen vor:
  1. Überprüfen Sie, ob der Host von dem Verwaltungssystem aus erreichbar ist, indem Sie im Verwaltungssystem in einem Browserfenster die URL http://<hostagent_host>:1128/SAPHostControl/?wsdl öffnen. Sie sollten die SAP-Hostagent-WSDL als Ergebnis erhalten (z.B. indem Sie einen Ping-Test beim Host durchführen) und der Port des Hostagenten (meist '1128') sollte nun nicht mehr blockiert sein.
  2. Überprüfen Sie, ob der Hostagent auf dem entsprechenden Host läuft.
Überprüfen Sie, ob der NetWeaver Scheduler eingeschaltet ist.
1. Melden Sie sich am SAP Java EE Config Tool an.
2. Navigieren Sie zu Services und wählen Sie dann die Scheduler-Servicekonfiguration.
3. Stellen Sie sicher, dass Sie für den Schlüssel enableJobExecution den Wert true und für den Schlüssel removeTasksOnSingletonStart den Wert false gesetzt haben.
4. Wenn Sie die Werte im vorherigen Schritt geändert haben, sichern Sie die Änderungen und starten Sie den Java-AS-Cluster erneut.
Überprüfen Sie, ob Prefetch-Jobs eingeplant sind.
1. Melden Sie sich über die URL http://<host>:<port>/SchedulerAdministrator am SchedulerAdministrator an.
2. Navigieren Sie zu Scheduler Tasks.
  Stellen Sie sicher, dass mindestens vier Prefetch-Jobs und ein Routing-Job aufgelistet sind.
3. Wenn diese Jobs nicht aufgeführt sind, führen Sie im SAP NetWeaver Administrator erneut den Konfigurationsassistenten für den ACC aus.
Überprüfen Sie, ob die Prefetch-Service-Daten-Provider fehlerfrei ausgeführt werden.
1. Melden Sie sich über die URL http://<host>:<port>/SchedulerAdministrator am SchedulerAdministrator an.
2. Navigieren Sie zur Liste der abgeschlossenen Jobs und öffnen Sie das Protokoll eines beliebigen abgeschlossenen Prefetch-Jobs.
  Wenn die Liste der abgeschlossenen Jobs leer ist, ist der Job Scheduler nicht eingeschaltet. Führen Sie die Schritte aus, die unter Überprüfen Sie, ob der NetWeaver Scheduler eingeschaltet ist aufgeführt sind.
  
  Wenn Protokollnachrichten mit einer Warnmeldung vorhanden sind, wie z. B. WARNUNG: Daten-Provider SAP_ITSAMComputerSystemDataProvider nicht gefunden, führen Sie den SAP NetWeaver Administrator erneut den Konfigurationsassistenten für den ACC aus.
Überprüfen Sie, ob der Computersystemdaten-Provider funktioniert.
1. Melden Sie sich über die URL http://<host>:<port>/tc~lm~itsam~core~computersys~web/csdp_test.jsp auf der Testseite des Computersystemdaten-Providers an.
2. Geben Sie im Feld Hostname den Hostnamen eines Ihrer mit AC verwalteten Computersysteme ein und wählen Sie anschließend Get prefetched computer system data.
  Die Prefetch-Zeitstempeldetails werden ausgegeben. Zum Beispiel: Tue Mar 06 15:39:15 CET 2007
  
  Der Prefetch-Zeitstempel darf höchstens einige Minuten alt sein, da der Daten-Provider alle 60 Sekunden angestoßen wird.
Überprüfen Sie, ob der Computerstatusdaten-Provider funktioniert.
1. Melden Sie sich über die URL http://<host>:<port>/tc~lm~itsam~core~acservicestatus~web/statdp_test.jsp auf der Testseite des Computersystemdaten-Providers an.
2. Wählen Sie get status data for all SAP instances.
  Die Prefetch-Zeitstempeldetails werden ausgegeben. Zum Beispiel: Wed Mar 07 12:54:53 CET 2007
  
  Die Anwendung zeigt die Statusinformationen aller mit AC verwalteten Instanzen an, die mithilfe des Prefetch-Services gesammelt wurden.
  
  Der Zeitstempel darf höchstens einige Minuten alt sein, da der Daten-Provider alle 60 Sekunden angestoßen wird.

SAP-Systeme, die in der ACC-Servicekonfiguration nicht angezeigt werden

Installierte SAP-Systeme sind in der ACC-Servicekonfiguration nicht verfügbar und können hier nicht konfiguriert und verwaltet werden. In diesem Fall haben Sie folgende Möglichkeiten:

Überprüfen Sie, ob das SAP-System im SLD registriert ist.
1. Melden Sie sich über die URL http://<host>:5<instance #>00/sld am System an.
  1. Wählen Sie unter CIM-Instanzen / CIM-Klassen das entsprechende SLD für ihr SAP-System (z.B. ein All-in-One-System oder ein BC-System).
  2. Geben Sie unter Filter Ihre SAP-System-ID ein.
  3. Wählen Sie Start.
    Ihr SAP-System sollte nun in der Tabelle CIM Instances angezeigt werden.
Wenn ihr SAP-System nicht im SLD angezeigt wird, kann dies folgende Ursachen haben:
- es sind Fehler bei der Installation aufgetreten
- das SAP-System wurde bisher noch nie gestartet
- die SAP-Systemkomponenten wurden nicht richtig im SLD registriert; möglicherweise müssen ein oder mehrere Data Supplier konfiguriert oder ein Patching durchgeführt werden
Wenn ihr SAP-System nicht im SLD angezeigt wird, kann dies folgende Ursachen haben:
- die für Ihr SAP-System geeignete CTC-Vorlage wurde noch nicht ausgeführt oder die Ausführung wurde nicht fehlerfrei abgeschlossen
in diesem Fall gehen Sie zurück in das zentrale SAP NetWeaver Administrator und führen Sie die CTC-Vorlage NWA Add Managed System erneut für das fehlende SAP-System aus.

Berechtigungsausnahme bei der Anmeldung am ACC (fehlende Berechtigungen)

Berechtigungsausnahme bei der Anmeldung am ACC treten auf, wenn ein Benutzer nicht über die benötigten Berechtigungen verfügt. In diesem Fall haben Sie folgende Möglichkeiten:

Melden Sie sich an der UME an, legen Sie ein neue Rolle an (z.B. ACC_Admin) und ordnen sie ihr die folgenden 10 Aktionen zu:

Type	Service/Application	Name
UME	tc~lm~aci~engine~app	OperationExceptionHandling
UME	tc~lm~aci~engine~app	ServerEnable
UME	tc~lm~aci~engine~app	Archiving
UME	tc~lm~aci~engine~app	Configuration
UME	tc~lm~aci~engine~app	Operation
UME	tc~lm~aci~engine~app	ServiceEnable
UME	jmx	JmxManageAll
UME	tc~lm~aci~engine~app	Schedule
UME	tc~lm~aci~engine~app	Observing
UME	tc~lm~aci~engine~app	CustomizeLink

Ordnen Sie die Rolle der Gruppe Administrators zu und allen Benutzern, die mit dem ACC arbeiten.

SLD-Ausnahme bei der Anmeldung am ACC

ACC 7.1 benötigt die SAP-SLD-Modellversion 1.5.18 oder höher. An SLD exception Failed to find adaptive controller instance. Make sure the sap.com /tc~lm~aci~engine~app application is deployed, running and configured occurs when the model version of the SLD is less than 1.5.18. In this case of SLD exception, perform the following checks:

Überprüfen Sie die SLD-Modellversion.
Melden Sie sich über die URL http://<host>:<port>/sld am SLD-Administrations-UI an.
Wählen Sie Administration Details .
Überprüfen Sie auf dem Register Data, die Modellversion des Namensraums sld/active.
Die Version muss 1.5.18 oder höher sein.
Wenn die SLD-Modellversion niedriger als 1.5.18 ist, laden Sie unter \\rrrdev\lid\landscape\CR_exports\requiredModel\dev eine höhere Version herunter.
Wählen Sie Administration Import .
Markieren Sie das heruntergeladene Modell (ZIP-Datei) und wählen Sie Import....

Ausnahme: 'Sie haben keine Berechtigung'

Wenn ein Benutzer nicht über ausreichende Berechtigungen verfügt, um geschützte Operationen auszuführen (z.B. um eine Instanz zu starten oder zu stoppen), wird die Ausnahme Sie haben keine Berechtigung ausgelöst.

The host agent connection user (sapadm) requires the write permissions to the sapstartsrv executable in the executable directory of the host agent (UNIX: /usr/sap/hostcontrol/exe)

Nachrichten-Code	Schweregrad	Nachricht
... ACC	... Information	... Executing the operation process step with ID'process-723017a-03c4-11dc -8937-0002b3c0b411-step' now. Type of operation" 'Start of an adaptive installed instance via HostAgent'
ACC	Information	Using the follwong argumetns. ServiceID: 'SystemID.NYA.Number.24.InstanceHost. scsnys',Hostname:'aip4224n0',SID:'NYA',StstemNumber:'24',SAPLOCALHOST:' scsnya',USerExit:'false',HostAgentProtocol:'http',HostAgentuser:'sapadm', HostAgentPort:'1128'
ACC	Information	Preparing the nost 'aip4224n0' now (calling'ACOSPrepare()' on host agent).
ACC	Error	RemoteException thrown by HostAgent when executing ACOSPrepare:'Server Exception: Permission denied; nested exception is: javex.xml.rpc.soap.SOAPFaultException: Permission denied'

Um dieses Problem zu beheben, führen Sie folgende Aktivitäten durch:

Stellen Sie sicher, dass das Executable sapstartsrv dem Benutzer sapadm zugeordnet ist und er Schreibberechtigung hierfür hat.
Stellen Sie mit dem Benutzer sapadm oder einem beliebigen anderen Benutzer mit Schreibzugriff auf das Executable sapstartsrv eine Verbindung zum Hostagenten her.

Ausnahme: 'Invalid Credentials'

Der Hostagent authentifiziert den Benutzer (sapadm) der Verbindung mithilfe der Authentifizierungsfunktionen von Betriebssystemen (wie z.B. PAM auf UNIX). Der Hostagent löst die Ausnahme Invalid Credentials aus, wenn die Authentifizierung beim Starten, Stoppen oder Verschieben eines Services fehlschlägt.

Message Code	Severity	Message
... ACC	... Information	... Using the follwoing arguments. ServiceId: 'SystemID.TRX.Number.02. InstanceHost.vqe2tx', HostnameL'Is2105', SID: 'TRX', SystemNumber: '02', SAPLOCALHOST: 'vqe2tx', UserExit:'false', HostAgentProtocol: 'http', HostAgentUser: 'sapadm', HostAgentPOrt: '1128'
ACC	Information	Executing the stop of instance on host 'Is2105' now (calling 'stopInstance()'on Host Agent).
ACC	Error	Error occurred when trying to stop instance. (RemoteException: 'Server Exception: Invalid Credentials; nested exception is: javax.xml.rpc.soap.SOAP FaultException:Invalid Credentials')

Um dies zu beheben, führen Sie folgende Aktivitäten durch:

Stellen Sie sicher, dass der Verbindungsbenutzer auf dem Host verfügbar ist und Sie das richtige Kennwort verwenden.
Verifizieren Sie auf UNIX Ihr PAM-Setup.
Weitere Informationen finden Sie im SAP-Hinweis 927637.

SAPControl mit Fehlermeldung 'HTTP 401 Unauthorized Error'

Problembeschreibung: Beim Starten oder Stoppen einer Instanz oder eines Instanzagenten tritt eine Ausnahme auf.

Der Hostagent verwendet das Programm SAP Control, um eine SAP-Instanz zu kontrollieren. SAP Control kann eine vertrauenswürdige Verbindungsfunktion für das Setup einer lokalen Verbindung zu einem Instanzagenten ohne Benutzer und Kennwort verwenden. Auf UNIX wird die vertrauenswürdige Verbindungsfunktion durch ein UNIX Domain Socket (UDS) implementiert.

1. Der Instanzagent entfernt dieses UDS unbeabsichtigt, wenn es seine Instanz stoppt.

2. Die UDS-Datei gehört nicht zu den Instanzen <sid>adm user und/oder <sid>adm user hat keine Schreibberechtigung für diese Datei.

Beim Starten oder Stoppen einer Instanz oder, wenn der Instanzagent fehlschlägt, werden folgende Nachrichten in den Protokolldetails des ACC-Operationsprotokolle angezeigt:

Nachrichten-Code	Schweregrad	Nachricht
... sapcontr	... Information	... StopService
sapcontr	Information	FAIL: HTTP error, HTTP/1.1 401 Unauthorized
saphostc	Fehler	Sapcontrol terminated with error
ACC	Error	Error occured when trying to stop instance. (Operation Exception: 'Command Execution failed.' Fault Code: '127')

Problembehebung:

Führen Sie ein Upgrade des Instanzagenten durch. Weitere Informationen: SAP-Hinweis 877795.
Schließen Sie den Instanzagenten, löschen Sie die UDS-Datei und starten Sie den Instanzagenten neu, der daraufhin die UDS-Datei mit den richtigen Zugehörigkeiten und Berechtigungen anlegt. Gehen Sie dazu wie folgt vor:
- Melden Sie sich als Benutzer <sid>adm an.
- Schließen Sie den Agenten, indem Sie folgenden Befehl ausführen:
  sapcontrol -nr <NR> -function StopService -user <sid>adm<password>
- Ändern Sie den Benutzer root und entfernen Sie die UDS-Datei. Die Datei befindet sich im Verzeichnis /tmp und die Namenskonventionen lautet “.sapstream5<NR>13”.
- Wechseln zurück in den Benutzer <sid>adm und starten Sie den Instanzagenten, z.B. mit folgendem Befehl:
  sapcontrol -nr <NR> -function StartService <SID>