Der Proxyserver fungiert als Zwischenserver, der Anforderungen zwischen einem Client und einem Server weiterleitet. Der Proxyserver verfolgt alle Interaktionen zwischen Client und Server und gibt ein Protokoll der gesamten TCP-Kommunikation aus. Auf diese Weise können Sie genau überwachen, was passiert, ohne auf den Hauptserver zugreifen zu müssen.
Sie finden den Proxyserver im entsprechenden Installationsordner:
Sie können den Proxy-Server verwenden, um alle Interaktionen zwischen Client und Server unabhängig vom zugrunde liegenden Kommunikationsprotokoll zu überwachen. Sie können beispielsweise die folgenden Protokolle überwachen:
Sie können beispielsweise den Proxyserver zwischen zwei Anwendungen positionieren, die über ein TCP/IP-Netzwerk kommunizieren, z. B. einem Webbrowser und AEM. Auf diese Weise können Sie genau überwachen, was bei der Anforderung einer AEM passiert.
Das Tool befindet sich im Ordner /opt/helpers Ihrer AEM-Installation. Geben Sie Folgendes ein, um es zu starten:
java -jar proxy.jar <host> <remoteport> <localport> [options]
In den folgenden Szenarien werden ein paar Einsatzzwecke demonstriert, für die das Proxyserver-Tool eingesetzt werden können:
Suchen nach Cookies und ihren Werten
Das folgende Beispiel für einen Protokolleintrag zeigt alle Cookies und deren Werte, die vom Client bei der sechsten seit dem Proxy-Start geöffneten Verbindung gesendet werden:
C-6-#000635 -> [Cookie: cq3session=7e39bc51-ac72-3f48-88a9-ed80dbac0693; Show=ShowMode; JSESSIONID=68d78874-cabf-9444-84a4-538d43f5064d ]
Überprüfen von Kopfzeilen und ihren Werten Das folgende Beispiel für einen Protokolleintrag zeigt, dass der Server eine Keep-Alive-Verbindung herstellen kann und der Header für die Inhaltslänge ordnungsgemäß festgelegt wurde:
S-7-#000017 -> [Connection: Keep-Alive ]
...
S-7-#000107 -> [Content-Length: 124 ]
Überprüfen der Funktionsfähigkeit von Keep-Alive
Keep-Alive bedeutet, dass ein Client die Verbindung zum Server wiederverwendet, um mehrere Dateien (Seiten-Code, Bilder, Stylesheets usw.) zu transportieren. Ohne Keep-Alive muss der Client für jede Anfrage eine neue Verbindung aufbauen.
So überprüfen Sie, ob Keep-Alive funktioniert:
Finden verlorener Anfragen
Wenn Sie Anforderungen in einer komplexen Servereinstellung verlieren, z. B. mit einer Firewall und einem Dispatcher, können Sie den Proxy-Server verwenden, um herauszufinden, wo die Anforderung verloren ging. Wenn eine Firewall vorhanden ist:
Hängende Anfragen
Gehen Sie wie folgt vor, wenn gelegentlich hängende Anfragen auftreten:
Die von proxy.jar erstellten Protokolleinträge haben alle das folgende Format:
[timestamp (optional)] [<b>C</b>lient|<b>S</b>erver]-[ConnectionNumber]-[BytePosition] ->[Character Stream]
So kann eine Web-Seitenanfrage zum Beispiel wie folgt aussehen:
C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102938422341 HTTP/1.1 ]
Wenn eine Verbindung geschlossen wird, werden die folgenden Informationen protokolliert:
C-6-Finished: 758 bytes (1.0 kb/s)
S-6-Finished: 665 bytes (1.0 kb/s)
Dies zeigt die Anzahl der Bytes, die zwischen Client und Server bei der sechsten Verbindung und mit der durchschnittlichen Geschwindigkeit übergeben wurden.
Überprüfen Sie eine einfache Vorlage, die bei Bedarf den folgenden Code erzeugt:
<html>
<head>
<title>Welcome</title>
</head>
<body>
Welcome to Playground<br>
<img src="/logo.gif">
</body>
</html>
Wenn AEM auf localhost:4303 ausgeführt wird, starten Sie den Proxyserver wie folgt:
java -jar proxy.jar localhost 4303 4444 -logfile test.log
Sie können auf den Server zugreifen (localhost:4303
) ohne den Proxy-Server, aber wenn Sie über darauf zugreifen localhost:4444
, protokolliert der Proxyserver die Kommunikation. Öffnen Sie einen Browser und greifen Sie auf eine mit der obigen Vorlage erstellte Seite zu. Sehen Sie sich danach die Protokolldatei an.
Bis Version 1.14 von proxy.jar werden die Protokolleinträge einer Verbindung nicht synchronisiert, was bedeutet, dass die Protokolleinträge einer Client/Server-Verbindung nicht in der richtigen sequenziellen Reihenfolge benötigt werden. In den neueren Versionen (>=1.14) des Proxyservers tritt dieses Problem nicht auf.
Beim Start werden die folgenden Informationen in das Protokoll geschrieben:
starting proxy for localhost:4303 on port 4444
using logfile: C:\CQUnify355default\opt\helpers\test.log
Die folgenden Kopfzeilenfelder werden am Anfang der ersten Verbindung (0) aufgelistet, die die Hauptseite der HTML anfordert:
C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102936796533 HTTP/1.1 ]
C-0-#000053 -> [Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-powerpoint, application/vnd.ms-excel, application/msword, appl]
C-0-#000194 -> [ication/x-shockwave-flash, */* ]
C-0-#000227 -> [Accept-Language: de-ch ]
C-0-#000251 -> [Accept-Encoding: gzip, deflate ]
C-0-#000283 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-0-#000347 -> [Host: localhost:4444 ]
Der Client fordert eine Keep-Alive-Verbindung an, damit der Server mehrere Dateien über dieselbe Verbindung senden kann:
C-0-#000369 -> [Connection: Keep-Alive ]
Der Proxy-Server ist ein gutes Tool, um zu überprüfen, ob Cookies richtig gesetzt sind oder nicht. Hier sehen Sie Folgendes:
C-0-#000393 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-0-#000514 -> [ ]
S-0-#000000 -> [HTTP/1.0 200 OK ]
Der Server schließt die Verbindung 0 nach der Anfrage. Keep-Alive ist nicht möglich, da die Anfrage ein Fragezeichen aufweist. Das bedeutet, dass der Server keine zwischengespeicherte Version zurückgeben kann und daher die Inhaltslänge zu diesem Zeitpunkt nicht ermitteln kann, was für eine Keep-Alive-Verbindung erforderlich ist.
S-0-#000017 -> [Connection: Close ]
S-0-#000036 -> [Server: Communique Servlet Engine/3.5.5 ]
S-0-#000077 -> [Content-Type: text/html;charset=iso-8859-1 ]
S-0-#000121 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-0-#000158 -> [Set-Cookie: JSESSIONID=4161a56b-f193-d8-88a5-e09c5ff7ef2a;Path=/author ]
S-0-#000232 -> [ ]
Hier beginnt der Server, den HTML-Code bei Verbindung 0 zu senden:
S-0-#000234 -> [<html> ]
S-0-#000242 -> [.<head> ]
S-0-#000251 -> [..<title>Welcome</title> ]
S-0-#000277 -> [.</head> ]
S-0-#000287 -> [.<body> ]
S-0-#000296 -> [..Welcome to Playground<br> ]
S-0-#000325 -> [..<img src="/author/logo.gif"> ]
S-0-#000357 -> [.</body> ]
S-0-#000367 -> [</html>]
Die Verbindung 0 wird unmittelbar nach dem Bereitstellen der HTML-Datei geschlossen:
C-0-Finished: 516 bytes (0.0 kb/s)
S-0-Finished: 374 bytes (0.0 kb/s)
Jetzt beginnt die Ausgabe für Verbindung 1, die das im HTML-Code enthaltene Bild herunterlädt:
C-1-#000000 -> [GET /author/logo.gif HTTP/1.1 ]
C-1-#000031 -> [Accept: */* ]
C-1-#000044 -> [Referer: http://localhost:4444/author/prox.html?CFC_cK=1102936796533 ]
C-1-#000114 -> [Accept-Language: de-ch ]
C-1-#000138 -> [Accept-Encoding: gzip, deflate ]
C-1-#000170 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-1-#000234 -> [Host: localhost:4444 ]
Der Client fordert erneut eine Keep-Alive-Verbindung an:
C-1-#000256 -> [Connection: Keep-Alive ]
C-1-#000280 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-1-#000401 -> [ ]
S-1-#000000 -> [HTTP/1.0 200 OK ]
Für Verbindung 1 kann der Server Keep-Alive-Funktion bereitstellen, da das Bild statisch ist und daher die Inhaltslänge bekannt ist.
S-1-#000017 -> [Connection: Keep-Alive ]
S-1-#000041 -> [Server: Communique Servlet Engine/3.5.5 ]
S-1-#000082 -> [Content-Type: image/gif ]
Der Server gibt die Inhaltslänge des Bildes für Verbindung 1 zurück:
S-1-#000107 -> [Content-Length: 124 ]
S-1-#000128 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-1-#000165 -> [ ]
Nachdem die Inhaltslänge festgelegt ist, sendet der Server die Bilddaten für Verbindung 1:
S-1-#000167 -> [GIF87a..........................,.......
...I....0.A..8......YDA.W...1..`i.`..6...Z...$@.F..)`..f..A.....iu.........$..;]
Nachdem der Keep-Alive-Timeout erreicht wurde, wird auch die Verbindung 1 geschlossen:
S-1-Finished: 291 bytes (0.0 kb/s)
C-1-Finished: 403 bytes (0.0 kb/s)
Das obige Beispiel ist vergleichsweise einfach, da die beiden Verbindungen nacheinander auftreten:
In der Praxis kann eine Seite viele parallele Anforderungen für Bilder, Stylesheets, JavaScript-Dateien usw. generieren. Dies bedeutet, dass die Protokolle überlappende Einträge von parallelen offenen Verbindungen aufweisen. In diesem Fall empfiehlt Adobe die Verwendung von Option -i, um die Lesbarkeit zu verbessern.