Så här använder du proxyserververktyget

Proxyservern fungerar som en mellanliggande server som vidarebefordrar begäranden mellan en klient och en server. Proxyservern håller reda på alla klient-server-interaktioner och genererar en logg över hela TCP-kommunikationen. På så sätt kan du övervaka exakt vad som händer, utan att behöva komma åt huvudservern.

Proxyservern finns i AEM här:

crx-quickstart/opt/helpers/proxy-2.1.jar

Du kan använda proxyservern för att övervaka all klient-server-interaktion, oavsett vilket kommunikationsprotokoll som ligger till grund för det. Du kan till exempel övervaka följande protokoll:

HTTP för webbsidor
HTTPS för säkra webbsidor
SMTP för e-postmeddelanden
LDAP för användarhantering

Du kan till exempel placera proxyservern mellan två program som kommunicerar via ett TCP/IP-nätverk; t.ex. en webbläsare och AEM. På så sätt kan du övervaka exakt vad som händer när du begär en CQ-sida.

Starta proxyserververktyget

Starta servern på kommandoraden:

java -jar proxy-2.1.jar <host> <remoteport> <localport> [options]

Parametrar

<host>

Det här är värdadressen för den CRX-instans som du vill ansluta till. Om instansen finns på din lokala dator är det localhost.

<remoteport>

Det här är värdporten för mål-CRX-instansen. Standardinställningen för en nyinstallerad AEM är 4502 och standardinställningen för en ny AEM författarinstans är 4502.

<localport>

Det här är den port på den lokala datorn som du vill ansluta till för att komma åt CRX-instansen via proxyn.

Alternativ

-q (tyst läge)

Skriver inte utdata till konsolfönstret. Använd det här alternativet om du inte vill göra anslutningen långsammare eller om du loggar utdata till en fil (se alternativet -logfile).

-b(binärt läge)

Om du letar efter specifika bytekombinationer i trafiken ska du aktivera binärt läge. Utdata kommer då att innehålla hexadecimala utdata och teckenutdata.

-t (tidsstämpelloggposter)

Lägger till en tidsstämpel i varje loggutdata. Tidsstämpeln är i sekunder, så den kanske inte är lämplig för att kontrollera enstaka begäranden. Använd den för att hitta händelser som inträffar vid en viss tidpunkt om du använder proxyservern under en längre tidsperiod.

-logfile <filename>(skriv till loggfil)

Skriver klient-server-konversationen till en loggfil. Den här parametern fungerar även i tyst läge.

-i <numIndentions>(lägg till indrag)

Varje aktiv anslutning är indragen för bättre läsbarhet. Standardvärdet är 16 nivåer. Den här funktionen introducerades med proxy.jar version 1.16.

Loggformat

Loggposterna som skapas med proxy-2.1.jar har följande format:

[timestamp (optional)] [Client|Server]-[ConnectionNumber]-[BytePosition] ->[Character Stream]

En begäran om en webbsida kan till exempel se ut så här:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102938422341 HTTP/1.1 ]

C anger att den här posten kommer från klienten (det är en begäran om en webbsida)
0 är anslutningens nummer (anslutningsräknaren startar vid 0)
#00000 förskjutningen i byteflödet. Detta är den första posten, så förskjutningen är 0.
[GET <?>] är innehållet i begäran, i exemplet en av HTTP-rubrikerna (url).

När en anslutning stängs loggas följande information:

C-6-Finished: 758 bytes (1.0 kb/s)
S-6-Finished: 665 bytes (1.0 kb/s)

Detta visar antalet byte som skickas mellan klienten ( C) och servern ( S) på den sjätte anslutningen och med den genomsnittliga hastigheten.

Ett exempel på loggutdata

Som ett exempel kan du titta på en sida som skapar följande kod när den efterfrågas:

Exempel

Ett exempel är ett mycket enkelt HTML-dokument som finns i databasen på

/content/test.html

tillsammans med en bildfil som finns på

/content/test.jpg

Innehållet i test.html är:

<html>
<head>
    <title>Test</title>
</head>
<body>
    Test<br>
    <img src="test.jpg">
</body>
</html>

Anta att AEM körs localhost:4502 så här startar vi proxyn:

java -jar proxy.jar localhost 4502 4444 -logfile test.log

CQ/CRX-instansen kan nu nås via proxyn på localhost:4444 och all kommunikation via den här porten loggas på test.log.

Om vi nu tittar på utdata från proxyn ser vi interaktionen mellan webbläsaren och AEM.

Vid start skickar proxyn följande:

starting proxy for localhost:4502 on port 4444
using logfile: <some-dir>/crx-quickstart/opt/helpers/test.log

Sedan öppnar vi en webbläsare och öppnar testsidan:

http://localhost:4444/content/test.html

och vi ser att webbläsaren gör en GET begäran om sidan:

C-0-#000000 -> [GET /content/test.html HTTP/1.1 ]
C-0-#000033 -> [Host: localhost:4444 ]
C-0-#000055 -> [Connection: keep-alive ]
C-0-#000079 -> [User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/536.11 (KHTML, like Gecko) Chrome/20.0.1132.57 Safari/536.11 ]
C-0-#000212 -> [Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8 ]
C-0-#000285 -> [Accept-Encoding: gzip,deflate,sdch ]
C-0-#000321 -> [Accept-Language: en-US,en;q=0.8 ]
C-0-#000354 -> [Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.3 ]
C-0-#000402 -> [Cookie: login-token=179ba6bd-e0a7-4909-a965-e11c7f2bc2fc%3a618bd8a8-fbaf-43c5-827d-c84c62248c5e_22ee860cc9036fee%3acrx.default%3b21148fb0-eb6c]
C-0-#000543 -> [-43c9-a2b9-c8d40618d8ae%3ad87a3d1a-5e9a-4d5a-bab1-0ee60ad6d8df_d0e4ddce0fcd84b6%3acrx.default%3b5cb95227-ea51-47bf-850b-68ad1dfd7297%3af3bbb6]
C-0-#000684 -> [59-7913-4285-8857-832c087bafd5_c484727d3b3665ad%3acrx.default; ys-cq-siteadmin-tree=o%3Awidth%3Dn%253A240%5EselectedPath%3Ds%253A/content ]
C-0-#000824 -> [ ]

AEM svarar med filens innehåll test.html:

S-0-#000000 -> [HTTP/1.1 200 OK ]
S-0-#000017 -> [Connection: Keep-Alive ]
S-0-#000041 -> [Server: Day-Servlet-Engine/4.1.24  ]
S-0-#000077 -> [Content-Type: text/html;charset=utf-8 ]
S-0-#000116 -> [Content-Length: 104 ]
S-0-#000137 -> [Date: Mon, 16 Jul 2012 11:23:38 GMT ]
S-0-#000174 -> [Last-Modified: Mon, 16 Jul 2012 11:19:27 GMT ]
S-0-#000220 -> [ ]
S-0-#000222 -> [<html>]
S-0-#000229 -> [<head>]
S-0-#000236 -> [    <title>Test</title>]
S-0-#000260 -> [</head> ]
S-0-#000269 -> [<body>]
S-0-#000276 -> [ Test<br>]
S-0-#000286 -> [    <img src="test.jpg">]
S-0-#000311 -> [</body>]
S-0-#000319 -> [</html>]

Proxyserverns användning

Följande scenarier visar några av de syften som proxyservern kan användas för:

Kontrollera om det finns cookies och deras värden

I följande exempel på loggpost visas alla cookies och deras värden som klienten skickade på den sjätte anslutningen som öppnats sedan proxyn startades:

C-6-#000635 -> [Cookie: cq3session=7e39bc51-ac72-3f48-88a9-ed80dbac0693; Show=ShowMode; JSESSIONID=68d78874-cabf-9444-84a4-538d43f5064d ]

Söker efter rubriker och deras värden

I följande exempel på loggpost visas att servern kan skapa en keep-alive-anslutning och att innehållets längdhuvud är korrekt inställt:

S-7-#000017 -> [Connection: Keep-Alive ]
 ...
 S-7-#000107 -> [Content-Length: 124 ]

Kontrollera om Keep-Alive fungerar

Keep-alive är en funktion i HTTP som gör att en klient kan återanvända TCP-anslutningen till servern för att göra flera begäranden (för sidkod, bilder, formatmallar och så vidare). Utan att hålla kontakten vid liv måste klienten upprätta en ny anslutning för varje begäran.

Så här kontrollerar du om keep-alive-funktionen fungerar:

Starta proxyservern.
Begär en sida.
Om keep-alive fungerar bör anslutningsräknaren aldrig gå över 5 till 10 anslutningar.
Om keep-alive inte fungerar ökar anslutningsräknaren snabbt.

Söker efter förlorade begäranden

Om du förlorar begäranden i en komplex serverinställning, till exempel för en brandvägg och en dispatcher, kan du använda proxyservern för att ta reda på var begäran förlorades. Vid brandvägg:

Starta en proxy före en brandvägg
Starta en annan proxy efter en brandvägg
Använd dessa för att se hur långt förfrågningarna kommer.

Hängande förfrågningar

Om du ibland får väntande förfrågningar:

Starta proxyn.
Vänta eller skriv åtkomstloggen i en fil där varje post har en tidsstämpel.
När begäran börjar hänga kan du se hur många anslutningar som var öppna och vilken begäran som orsakar problem.