Technische Mitteilung. Nutzung von Oracle für die VIP CM Suite 8 Offene Cursor

Transkript

1 Technische Mitteilung Nutzung von Oracle für die VIP CM Suite 8 Offene Cursor

2 Informationen zum Dokument Kurzbeschreibung Dieses Dokument gibt Hinweise zur Konfiguration des RDBMS Oracle und von VIP ContentManager im Hinblick auf die Anzahl parallel geöffneter Cursor. Autor(en) Gauss Interprise AG, Hamburg Kontakt Für weitere Informationen wenden Sie sich bitte an folgende Adresse: Technical Support Version Produktversion: VIP CM Suite 8 Dokumentenversion: De-01, Januar 2003 Freigegeben für Partner Kunden Seite 2 von 9

3 Copyright Dieses Dokument sowie die zugehörige Software sind Eigentum der Gauss Interprise AG oder ihrer Zulieferer und durch Gesetze zum Schutze des Urheberrechts und andere Gesetze geschützt. Sie werden unter einer Lizenz vertrieben, durch welche die Nutzung, Reproduktion, Vertrieb und Dekompilierung eingeschränkt wird. Weder der Erhalt noch der Besitz dieses Dokumentes ermächtigt Sie, dessen Inhalte ganz oder teilweise auf Papier, elektronisch oder einem anderen Medium zu reproduzieren, weiterzugeben oder anderen den Zugang darauf zu ermöglichen. Kein Teil dieses Dokumentes darf in irgendeiner Form und Weise ohne vorherige schriftliche Zustimmung der Gauss Interprise AG oder Gauss Interprise, Inc. reproduziert werden. Darüber hinaus gelten für diese Dokumentation die Bestimmungen des Softwarelizenzvertrags. Alle Warenzeichen oder Handelsmarken, die in diesem Dokument erwähnt wurden, sind Eigentum der entsprechenden Firmen. Seite 3 von 9

4 Inhaltsverzeichnis 1 Was sind Cursor? 5 2 Konfiguration der Cursor-Anzahl Konfiguration von Oracle Konfiguration der VIP CM Suite Konfiguration der VIP CM Suite 8.0 und Konfiguration der VIP CM Suite 8.1 und Berechnung der maximal benötigten Anzahl von Cursorn 7 3 Fehlermeldungen und behebung 9 Seite 4 von 9

5 1 Was sind Cursor? Ein Datenbank-Cursor ist ein Bereich im Arbeitsspeicher der Datenbank, in dem interne Informationen zwischengespeichert werden. Auch VIP ContentManager öffnet Cursor in der Datenbank. Diese werden vor allem für zwei Zwecke benötigt: Jedem Oracle-Statement, das sowohl lesend als auch schreibend mehr als eine Zeile bearbeitet, wird von der Datenbank ein Cursor zugewiesen. Mithilfe dieses Cursors können Ergebnisse zeilenweise bearbeitet werden. Nach Auswertung der Abfrage durch VIP ContentManager wird der Cursor geschlossen, d.h. der reservierte Speicher freigegeben. Jeder Anweisung, die VIP ContentManager an die Datenbank schickt (in Form von Prepared Statements), wird ein Cursor zugewiesen. In diesem Fall dient der Cursor der beschleunigten Ausführung der Anweisung. Dieses Dokument beschreibt, wie die Cursor-Anzahl in Oracle und VIP ContentManager konfiguriert werden kann. Außerdem werden Lösungen bei konkreten Fehlern aufgezeigt. Seite 5 von 9

6 2 Konfiguration der Cursoranzahl Die Anzahl gleichzeitig geöffneter Cursor wird in der Konfiguration von Oracle festgelegt. Außerdem ist es möglich, über das VIP-Administrationsprogramm festzulegen, wie viele Cursor VIP ContentManager pro JDBC-Pool öffnet. 2.1 Konfiguration von Oracle Achtung: Informationen zu den möglichen Fehlermeldungen und Lösungsvorschläge bei Überschreitung der Cursoranzahl erhalten Sie im Abschnitt 3 Fehlermeldungen und behebung. Passen Sie den Wert für die Anzahl der offenen Cursor pro Sitzung in der Datenbank entsprechend der Konfiguration Ihres VIP-CM-Systems an (siehe auch Abschnitt 2.3 Berechnung der maximal benötigten Anzahl von Cursorn ). Dieser Wert wird nur durch die gegebenen Betriebssystemressourcen begrenzt. Setzen Sie den Parameter open_cursors in der Datei init.ora im Verzeichnis \{Oracle- Installationsverzeichnis}\admin\ {Name der Datenbank}\pfile\ für den Anfang z.b. auf Hinweise: Es empfiehlt sich, einen möglichst großen Wert für die Anzahl der gleichzeitig geöffneten Cursor einzustellen. Sollte die festgesetzte Anzahl offener Cursor einmal durch VIP ContentManager überschritten werden, erzeugt Oracle eine entsprechende Fehlermeldung; die betroffene Aktion in VIP ContentManager schlägt fehl. 2.2 Konfiguration der VIP CM Suite VIP ContentManager verursacht durch die verstärkte Nutzung von Prepared Statements eine große Anzahl offener Cursor. Die Verbindungen von VIP ContentManager zur Datenbank werden in JDBC-Pools verwaltet. Pro JDBC-Pool kann ein minimaler und ein maximaler Wert für die Cursoranzahl angegebenen werden. Seite 6 von 9

7 2.2.1 Konfiguration de r VIP CM Suite 8.0 und Wenn Sie bei der Installation angegeben haben, dass die Benutzerdaten in einem RDBMS verwaltet werden, wird bei der Installation standardmäßig der Pool rdbadmin angelegt. Dieser erhält als Minimalwert für die Cursoranzahl 250 und als Maximalwert 280. Wenn Sie nach der Installation über das VIP-Administrationsprogramm einen JDBC- Pool anlegen, betragen die Standardwerte für die Cursoranzahl 40 (Minimum) und 45 (Maximum). Die Werte für die minimale und maximale Cursoranzahl eines JDBC-Pools können nur durch Bearbeiten einer internen Konfigurationsdatei geändert werden. Bitte wenden Sie sich deshalb an den Technical Support der Gauss Interprise AG, wenn Sie diese Versionen der VIP CM Suite verwenden Konfiguration de r VIP CM Suite 8.1 und Wenn Sie bei der Installation angegeben haben, dass die Benutzerdaten in einem RDBMS verwaltet werden, wird bei der Installation standardmäßig der Pool rdbadmin (8.1) bzw. userpool (8.1.1) angelegt. Dieser erhält als Minimalwert für die Cursoranzahl 250 und als Maximalwert 280. Wenn Sie nach der Installation über das VIP-Administrationsprogramm einen JDBC- Pool anlegen, betragen die Standardwerte für die Cursoranzahl 200 (Minimum) und 250 (Maximum). Sie können die Werte für die minimale und maximale Cursoranzahl eines JDBC- Pools über das VIP-Administrationsprogramm bearbeiten (Konfiguration Pools {JDBC-Pool-Name} Registerkarte RDBMS-Parameter Schaltfläche Erweiterte Einstellungen). 2.3 Berechnung der maximal benötigten Anzahl von Cursorn Die in der Konfiguration des JDBC-Pools festgelegte maximale Cursoranzahl bedeutet, dass jede Verbindung des Pools diese maximale Zahl öffnen kann. Wird der Pool von mehreren VIP-CM-Servern genutzt, so kann jeder Server die im Pool angegebene maximale Verbindungsanzahl nutzen. Hinweis: Die maximale Anzahl an Verbindungen pro Pool legen Sie in den Einstellungen des JDBC-Pools auf der Registerkarte Instanzen (VIP CM Suite 8.0.x) bzw. Verbindungen (VIP CM Suite 8.1.x) fest. Der theoretische maximale Wert der von VIP ContentManager benötigten Cursor berechnet sich demnach wie folgt: Seite 7 von 9

8 (Maximale Anzahl Verbindungen pro Pool * Maximale Cursoranzahl pro Pool * Anzahl Server, die den Pool verwenden) + offene Cursor für Abfragen Daraus ergibt sich eine sehr hohe, theoretisch mögliche Zahl an offenen Cursorn, die für VIP ContentManager benötigt werden. Dieser Wert wird jedoch in der Praxis nie erreicht. Versuchen Sie vielmehr, eventuelle Probleme durch schrittweises Erhöhen der Cursoranzahl zu beseitigen. Tipp: Um festzustellen, wie viele Verbindungen des JDBC-Pools tatsächlich während des laufenden Betriebs genutzt werden, überprüfen Sie in regelmäßigen Abständen den PoolManager-Bericht (Systemverwaltung Laufende Server {Servername} Berichte PoolManager). Zu jedem verwendeten JDBC-Pool gibt es einen separaten Abschnitt, in dem die Nutzung der Verbindungen ausgewertet wird. Wird die Anzahl der maximal möglichen Verbindungen pro Pool nicht erreicht, kann diese heruntergesetzt werden. Seite 8 von 9

9 3 Fehlermeldungen und behebung Im Zusammenhang mit Datenbank-Cursorn können zwei Fehlermeldungen auftreten: Fehlermeldung von Oracle ORA maximum open cursors exceeded Problem Die maximale Anzahl offener Cursor der Datenbank ist überschritten. VIP ContentManager versucht einen Cursor zu öffnen, die Datenbank lässt dies jedoch nicht mehr zu. Lösung Die Aktion, bei der der Fehler aufgetreten ist, muss erneut aufgerufen werden. Erhöhen Sie die Anzahl der maximal zulässigen Cursor der Datenbank (siehe Abschnitt 2.1 Konfiguration von Oracle ). Sollte dies nicht möglich sein, senken Sie gegebenenfalls den maximalen Wert offener Cursor für einige JDBC-Pools von VIP ContentManager (siehe Abschnitt 2.2 Konfiguration der VIP CM Suite ). Fehlermeldung von VIP ContentManager &X#ALL_STATEMENTS_IN_USE_;_INCREASE_NUMBER_OF_OPEN_CURSORS_ON_ DATABASE_CONNECTION_AND_CONFIGURATION Problem Die in VIP ContentManager für den Pool festgelegte maximale Anzahl offener Cursor ist erreicht. Sämtliche der zur Zeit zwischengespeicherten Prepared Statements sind in Benutzung. Es ist deshalb nicht möglich, einige der Prepared Statements zu löschen. Lösung Die Aktion, bei der der Fehler aufgetreten ist, muss erneut aufgerufen werden. Tritt dieser Fehler häufiger auf, sollten Sie die maximale Anzahl offener Cursor für den entsprechenden Pool erhöhen (siehe Abschnitt 2.2 Konfiguration der VIP CM Suite ). Sollte die Datenbank nach dieser Änderung mehrmals den im Abschnitt Fehlermeldung von Oracle beschriebenen Fehler liefern, so müssen Sie auch die Anzahl der maximal zulässigen Cursor der Datenbank erhöhen (siehe Abschnitt 2.1 Konfiguration von Oracle ). Seite 9 von 9