TNSNAMES.ORA beherrschen. Michael A. Istinger EDV-Beratung Istinger

Transkript

1 TNSNAMES.ORA beherrschen Michael A. Istinger EDV-Beratung Istinger

2 Gestatten Sie, dass ich mich vorstelle: Name: Michael A. Istinger Firma: EDV-Beratung Istinger In der IT-Branche tätig seit 1977 Erste bewusst erlebte Oracle-Version: Ein klassischer freiberuflicher Oracle-Berater Ich biete Dienstleistungen im Datenbank-Umfeld an Datenbank-Design, Datenbank-Implementierung, Design Reviews, PL/SQL-Entwicklung, Performance-Tunings, Datenbank-Administration Enge Zusammenarbeit mit Herrmann & Lenz Services GmbH

3 Agenda Warum dieser Vortrag? Struktur TNSNAMES.ORA Probleme ein Beispiel aus der Praxis Lessons learned Tools zur Bearbeitung von TNSNAMES.ORA Scripts zur Bearbeitung von TNSNAMES.ORA Mögliche Vorgehensweise bei Problemen NETCHECK ein geplantes Analysetool.

4 Warum dieser Vortrag? Die TNSNAMES.ORA ist eine der ältesten Mechanismen zur Auflösung von Net Service Names und damit bei vielen Installationen ein unverzichtbares Hilfsmittel zum Zugriff auf nicht-lokale Datenbanken. In der Praxis gibt es immer wieder Probleme bei Modifikationen an dieser Datei. Ich möchte hier aufzeigen, wodurch solche Probleme entstehen, und welche Vorgehensweisen es zur Analyse dieser Probleme gibt.

5 Struktur TNSNAMES.ORA (1) Prinzipieller Aufbau eines TNSNAMES.ORA Eintrags: net_service_name= (DESCRIPTION= (ADDRESS=(protocol_address_information)) (CONNECT_DATA= (SERVICE_NAME=service_name))) Nur der net_service_name darf auf Spalte 1 beginnen Zeilen, in denen in Spalte 1 ein Blank steht, werden als logische Folgezeilen der vorhergehenden Zeile interpretiert. Der Connect-Descriptor besteht aus einer Folge von Angaben der Form: PARAMETER=VALUE Verschachtelte Angaben sind möglich: (ADDRESS=(PROTOCOL=tcp)(HOST=host1)(PORT=1630))

6 Struktur TNSNAMES.ORA (2) Nur eingeschränkter Zeichensatz in TNSNAMES.ORA zulässig A-Z a -z 0-9 ( ) < > / \,. : ; ' "=- _ $ + * # &! <Space> <Tab> <Carriage Return> <Newline>

7 Auftretende Probleme Syntaxfehler werden oft nicht an der Stelle erkannt, an der der Fehler liegt fehlende schliessende Klammer Net Service Name beginnt nicht in Spalte 1 Ein Teil eines Connect-Descriptors beginnt in Spalte 1. Ungültige Zeichen in TNSNAMES.ORA lösen schwer erklärbare Effekte aus.

8 Ein Problem aus der Praxis (1) Datenbank-Server Linux (Red Hat) Oracle 10gR2 Datenbank TNSNAMES.ORA wurde über Windows XP Zwischenstation auf dem Server installiert Merkwürdige Phänomene bei Zugriff auf remote liegende Datenbanken: sqlplus SQL*Plus: Release Production on Fr Nov 16 14:02: Copyright (c) 1982, 2006, Oracle. All Rights Reserved. ERROR: ORA-12169: TNS: Der als Connect Identifier angegebene Net Service Name ist zu lang

9 Ein Problem aus der Praxis (2) Der entsprechende TNSNAMES.ORA Eintrag lautet: BIUMS = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = anonzitevip)(port = 1521)) (ADDRESS = (PROTOCOL = TCP)(HOST = anonzitfvip)(port = 1521)) (LOAD_BALANCE = yes) (CONNECT_DATA =... ) ) Der Net Service Name ist sicher nicht länger als 255 Zeichen

10 Ein Problem aus der Praxis (3) Ergebnis von tnsping BIUMS... Adapter TNSNAMES zur Auflösung des Alias benutzt )DELAY = 5)180))BIUMS) TCP)(HOST = anonzitfvip)(port = 1521)) TNS-12545: CONNECT nicht erfolgreich, da Ziel- Host oder -Objekt nicht vorhanden Andere Fehlermeldung wegen Test im eigenen Netzwerk. Interessant: Verstümmelte Anzeige des Connect- Descriptors.

11 Ein Beispiel aus der Praxis (4) Metalink-Suche liefert in Dokument Hinweis auf Carriage-Returns in TNSNAMES.ORA. Das wirkt glaubhaft, da die Datei von einer Windows XP Workstation übertragen wurde. Versuch diese störenden CR's mittels vi zu löschen liefert:

12 Ein Beispiel aus der Praxis (5) Untersuchung mittels od zeigt

13 Ein Problem aus der Praxis (6) vi versucht seit einigen Versionen einen intelligenten Ansatz zur Behandlung von Zeilenenden. Deshalb erkennt vi die <carriage returns> nicht mehr, da sie für den Editor Teil des Zeilenendes geworden sind. Utilities, mit denen wir seit mehr als 20 Jahren arbeiten, können bei neuen Versionen ihr Verhalten in unvorhersehbarer Weise ändern. Lösung des beschriebenen Problems: Die <carriage returns> wurden mit sed entfernt: sed --in-place 's/^m//' tnsnames.ora

14 Lessions learned Vorsicht beim Transport von TNSNAMES.ORA Dateien zwischen unterschiedlichen Betriebssystemen. Der Transfer sollte nie binär erfolgen wegen unterschiedlicher Zeilenende-Behandlung Metalink hat sich auch in diesem Fall als exzellente Sammlung von Dokumenten zu unterschiedlichsten Probemfällen bewiesen. Leider war in diesem Fall eine vorgeschlagene Vorgehensweise nicht zielführend, da sich das Verhalten des verwendeten Tools geändert hat. Es müssen immer ALLE Hinweise berücksichtigt werden (tnsping-ausgabe!)

15 Tools zur Bearbeitung von TNSNAMES.ORA (1) Mir sind keine kommerziell erhältlichen Tools zur Bearbeitung von TNSNAMES.ORA bekannt. Meistens werden solche Funktionalitäten im Rahmen von umfangreicheren, kommerziell erhältlichen Tools mit angeboten: netmgr von Oracle TNSNAMES Editor ist Bestandteil von TOAD für Oracle der Firma Quest. Ich möchte hier untersuchen, ob und wie gut diese Tools zur Analyse von Problemen in TNSNAMES.ORA verwendet werden können.

16 Tools zur Bearbeitung von TNSNAMES.ORA (2) <cr>'s stören nicht und werden beim Speichern von netmgr entfernt. Problem: net service name nicht in Spalte 1 Problem: Connect Descriptor in Spalte 1

17 Tools zur Bearbeitung von TNSNAMES.ORA (3) Tool arbeitet nur am Client. Deshalb <cr>- Problem nicht feststellbar net service names müssen nicht in Spalte 1 beginnen. Problem: Connect- Descriptor in Spalte 1.

18 Tools zum Bearbeiten von TNSNAMES.ORA (4) Sowohl der NetMgr als auch der TNSNAMES Editor in TOAD sind leistungsfähige Tools zur Erstellung/Wartung der TNSNAMES.ORA Die Anwendungsbereiche sind unterschiedlich (NetMgr sowohl am Server als auch am Client, TNSNAMES Editor nur am Client). Keines der beiden Tools ist wirklich dazu geeignet um Probleme in TNSNAMES.ORA zu analysieren: manchmal zu laxe Prüfung (TNSNAMES Editor) Syntax-Fehler führen bei beiden Tools häufig zu schweren Funktionsfehlern.

19 Skripts zum Bearbeiten von TNSNAMES.ORA (1) Es muss nicht immer ein großes Tool mit graphischer Oberfläche sein! Die hier vorgestellten kleinen Skripte wurden unter Linux entwickelt und getestet. Unter Windows können diese Skripte eingesetzt werden, wenn Zusatzsoftware wie z.b. cygwin ( installiert wurde.

20 Skripte zum Bearbeiten von TNSNAMES.ORA (2) Beispiel: Das folgende Skript liefert alle net service namen, die in einer TNSNAMES.ORA enthalten sind: awk '/^[A-Za-z0-9]/ {i = index($0, "="); print substr($0,1,i-1);}' $TNSNAMES Die Ausgabe dieses Skripts kann bei Fehlersuche sehr hilfreich sein: Was ist der letzte richtig reportete net service name? Fehlen net service names, die erwartet werden?

21 Skripte zum Bearbeiten von TNSNAMES.ORA (3) TNSNAMES.ORA kann häufig verwendet werden, um Code zu erzeugen, der für alle definierten Net Service Names verwendet werden soll: Erzeugen von Datenbank-Links auf alle Datenbanken, für die Net Service Names definiert sind Erzeugen von Connection-Informationen für SqlDeveloper für alle definierten Net Service Names. Die genannten Skripte können Sie bei Interesse von mir erhalten. Allerdings ohne jede Gewähr!

22 Mögliche Vorgehensweise bei Problemen (1) Bei Problemanalysen mit Low-Level Utilities beginnen tnsping Alle Ausgaben der Utilities genau analysieren. Selbst kleinste Details können wichtige Hinweise enthalten. Sollten tnsping-ausgaben nicht verständlich sein, kann es helfen, für tnsping ein Tracing einzuschalten. Setzen Sie dazu die folgenden Parameter in SQLNET.ORA: TNSPING.TRACE_LEVEL TNSPING.TRACE_DIRECTORY

23 Mögliche Vorgehensweise bei Problemen (2) Beachten Sie, dass oft der Text der Fehlermeldung viel darüber aussagt, wo die Fehlerursache zu suchen sein könnte: ORA-12169: TNS: Der als Connect Identifier angegebene Net Service Name ist zu lang Dieser Fehler hat sicher mit dem Inhalt der TNSNAMES.ORA zu tun. ORA-12705: invalid or unknown NLS parameter value specified Diese Fehlermeldung bezieht sich fast immer auf den Server!

24 NETCHECK ein Analysetool im Entstehen (1) Ich kenne kein einziges Tool, dass verlässlich alle Probleme, die in TNSNAMES.ORA auftreten können, sinnvoll reporten kann. Ich arbeite privat an einem Tool (Codename NETCHECK), das genau diese Analysen vornehmen soll. Das Tool wird nie kommerziell verwendet werden. Wenn es Produktionsreife erreicht hat, so werde ich das Tool über die DOAG kostenlos (und ohne Gewährleistung) zur Verfügung stellen

25 NETCHECK Ein Analysetool im Entstehen (2) Geplant ist ein reines Kommandozeilen-Tool. Sowohl syntaktische als auch semantische Überprüfung der TNSNAMES.ORA. Robustes Tool, das auch bei schwerwiegenden Fehlern in der TNSNAMES.ORA vernünftig reagiert. Fehler sollen so nahe wie möglich an der Stelle, an der sie auftreten, gemeldet werden Fehlermeldungen sollen so klar wie möglich sein, um es auch weniger geschulten Personal zu ermöglichen, gefundene Probleme mit vertretbarem Aufwand zu beheben.

26 NETCHECK Ein Analysetool im Entstehen (3) Derzeit ist das Tool definitiv pre-alpha. Vor allem semantische Analysen sind noch nicht wirklich gelöst: Änderung der Semantik zwischen Oracle-Releases Ich benötige dringend Testmaterialien. Die mir vorliegenden Beispiele von TNSNAMES.ORA Dateien reichen mir nicht aus, um Aussagen über Stabilität und Robustheit von NETCHECK zu machen. Sollten Sie Interesse an der Idee von NETCHECK haben, wäre ich Ihnen dankbar, wenn Sie mir Kopien Ihrer TNSNAMES.ORA Dateien zukommen lassen könnten.

27 NETCHECK Ein Analysetool im Entstehen (4) Ich werde solche mir zugesendeten TNSNAMES.ORA Dateien selbstverständlich vertraulich und ausschliesslich zu Tests von NETCHECK verwenden. Mir zugesendete TNSNAMES.ORA Dateien werden prinzipiell anonymisiert (anonymisierte Hostnamen). Selbstverständlich können Sie mir auch bereits von Ihnen selbst anonymisierte TNSNAMES.ORA Dateien zusenden. Die Dateien müssen auch nicht fehlerfrei sein. TNSNAMES.ORA Dateien mit exotischen Fehlern helfen mir sehr bei der Beurteilung des Reifezustands von NETCHECK.

28 NETCHECK ein Analysetool im Entstehen (5) Sollten Sie mir Beispiel-Dateien zusenden wollen/können/dürfen, so bitte an die -Adresse

29 Zum Abschluss Ich hoffe, ich konnte Ihnen hier einige nützliche Informationen zum Umgang mit TNSNAMES.ORA liefern. Es würde mich freuen, wenn die eine oder andere der hier gezeigten Ideen Ihre Arbeit in Zukunft erleichtern könnte.