tinyget 사용법
IIS 리소스 킷에 보면, tinyget이라는 유용한 툴이 있습니다.
Internet Information Services (IIS) 6.0 Resource Kit Tools
; http://www.microsoft.com/download/en/details.aspx?id=17275
국내 자료를 검색해 보면, 다음과 같은 사용법이 나옵니다.
tinyget을 이용한 웹 서비스 점검하기
; http://ntfaq.co.kr/4314
tinyget을 이용한 SQL Injection 테스트 해보기
; http://ntfaq.co.kr/4316
가끔씩 이 도구를 사용할 일이 있지만, 개인적으로도 유용한 듯 싶어서 여러분들도 쉽게 이해하실 수 있도록 활용 사례를 들어 정리를 해보았습니다. ^^
1. 특정 웹 페이지로의 단순 호출
형식: tinyget -srv:[서버주소] -uri:[URL의 경로부분] -r:[포트]
예)
tinyget -srv:win2003x86 -uri:/ -r:8000
위와 같이 호출하면 "http://win2003x86:8000/" 주소로 호출을 합니다. 그런데, "호출만 하는 것"이므로 정상적으로 호출되었는지에 대한 결과 출력이 없습니다. 명령행에서 알고 싶다면 "-d" 옵션을 주면 다음과 같이 결과가 함께 출력됩니다. 다음은 존재하지 않는 페이지를 호출한 경우의 예입니다.
D:\temp>tinyget -srv:win2003x86 -uri:/test.aspx -r:8000 -d
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<HTML><HEAD><TITLE>The page cannot be found</TITLE>
<META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">
<STYLE type="text/css">
BODY { font: 8pt/12pt verdana }
H1 { font: 13pt/15pt verdana }
H2 { font: 8pt/12pt verdana }
A:link { color: red }
A:visited { color: maroon }
</STYLE>
</HEAD><BODY><TABLE width=500 border=0 cellspacing=10><TR><TD>
<h1>The page cannot be found</h1>
The page you are looking for might have been removed, had its name changed, or is temporarily unavailable.
<hr>
<p>Please try the following:</p>
...[생략]...
</TD></TR></TABLE></BODY></HTML>
-d 옵션 외에도, -h는 헤더를 보여주며, -t를 사용할 시에는 주고 받는 모든 HTTP 내용을 보고 싶을 때 사용할 수 있습니다. (특히 "-t"의 경우에는 가끔 이 정보를 확인하기 위해 fiddler2를 구동하는 경우가 있는데 간단한 경우에는 tinyget으로도 해결이 됩니다.)
2. 특정 웹 페이지로의 호출 오류 확인
대개의 경우 특정 웹 페이지를 호출하면 200 OK가 반환되는 것을 기대할 것입니다. 이런 경우 다음과 같이 -status 옵션을 추가해서 호출할 수 있습니다.
D:\temp>tinyget -srv:win2003x86 -uri:/ -r:8000 -status 200
그런데, 만약 없는 웹 페이지를 호출하면 다음과 같은 오류를 얻을 수 있습니다.
D:\temp>tinyget -srv:win2003x86 -uri:/testqwer.aspx -r:8000 -status 200
ERROR: 0x4b8 : returned status code (404) does not match expected one (200)
Received status/error info: 404 Not Found - HTTP 404. The resource you are looking for (or one of its dependencies) could have been removed, had
"-status" 옵션을 지정하는 또 다른 장점은 배치 파일에서 ERRORLEVEL 값이 설정된다는 것입니다. 이 옵션을 제거하고 호출하면 성공여부에 관계없이 무조건 ERRORLEVEL == 0으로 설정되지만, 옵션 설정 후에는 기대했던 status 값이 아닌 경우 ERRORLEVEL == 1로 설정되어 오류 여부를 알 수 있습니다. 예를 들어 다음과 같이 배치 파일을 작성해서 실패하면 더 이상의 테스트를 하지 않을 수 있게 만들 수 있습니다.
tinyget -srv:win2003x86 -uri:/testqwer.aspx -r:8000 -status 200
if ERRORLEVEL 1 goto CALL_ERROR
3. 특정 웹 페이지의 응답 내용에 기반한 오류 확인
웹 페이지에 대한 단위 테스트를 하는 경우, 특정 입력 값에 대해서 기대되는 값이 반환되어야 하는 경우가 있습니다. 예를 들어, 제 웹 사이트에서 "
CLR JIT 컴파일러가 생성한 기계어 코드 확인하는 방법" 글을 읽으면 그 내용 안에 ".load sos"라는 문자열이 포함되어 있기 때문에 이를 확인하는 방법을 tinyget에서는 다음과 같이 할 수 있습니다.
tinyget -srv:www.sysnet.pe.kr -uri:/2/0/975 -r:80 -testcontainstring:".load sos"
if ERRORLEVEL 1 pause
위의 실행에서는 ".load sos"라는 문자열을 포함하고 있지 않은 tinyget은 ERRORLEVEL을 1로 설정합니다. (즉, exe 프로세스의 반환값이 1입니다.) 이렇게 내용에 대해 테스트 하는 옵션으로는 다음과 같은 것들이 제공되고 있습니다.
[-testContainString:value] - response body has to contain string
[-testNotContainString:value] - response body must not contain string
[-testEqString:value] - response body has to equal string
[-testEqFile:filename] - response body has to be the same as given file content
4. 간단한 부하 테스트
다중 스레드 및 다중 호출을 하는 것이 가능합니다.
예를 들어, 10명의 동시 사용자를 시뮬레이션하고 싶다면 이런 식으로 명령을 내리면 됩니다.
tinyget -srv:win2003x86 -uri:/ -r:8000 -x:10 -status 200
if ERRORLEVEL 1 pause
또는 연속으로 10개의 호출을 단일 스레드로 호출하고 싶은 경우는 이렇게 하고,
tinyget -srv:win2003x86 -uri:/ -r:8000 -loop:10 -status 200
10명의 동시 사용자가 10개의 호출을 하는 경우는 아래와 같이 -x 옵션과 -loop 옵션을 조합해 주면 됩니다.
tinyget -srv:win2003x86 -uri:/ -r:8000 -x:10 -loop:10 -status 200
5. 스크립트를 통한 호출
배치 파일로 tinyget 호출을 나열하는 것도 가능하겠지만, 스크립트 파일을 지정하는 방법도 제공됩니다. 예를 들어, 다음과 같은 2라인의 텍스트 파일을 만들고,
[http_call.txt 파일 내용 - 이 파일은 ASCII 인코딩만 지원됩니다. (UTF-8/Unicode 인코딩으로 하면 tinyget이 동작되지 않습니다.)]
-srv:win2003x86 -uri:/ -r:8000 -loop:10 -status 200
-srv:win2003x86 -uri:/empty.aspx -r:8000 -loop:10 -status 200
이렇게 호출해 줄 수 있습니다.
C:temp>tinyget -script:http_call.txt
Script name: http_call.txt
http_call.txt -------------- Succeeded: 2 Failed: 0
Running TOTAL - Succeeded: 2 Failed: 0
스크립트로 하는 경우 (다른 몇몇 옵션을 포함해서) "-x" 옵션이 지원되지 않습니다. 기본동작은 차례대로 호출을 하지만, "-y" 옵션을 주면 무작위로 라인을 읽어들여 호출을 합니다.
tinyget -script:http_call.txt -y
무작위 순서라서, 10개의 라인이 있다면 그 중에 5라인만 2번씩 호출되는 것도 가능합니다. 즉, 모든 라인이 불려지지 않을 수 있으니 주의하셔야 합니다.
어떠세요? 간단하게 써 먹기에 유용하지 않나요? ^^
이 외에도, 제 경우에 필요가 없어서 제외시켰지만 '인증' 및 Proxy도 지정하는 것이 가능합니다. (^^ 나중에 필요해지면 추가하겠습니다.)
(참고로, tinyget을 그냥 실행하면 도움말이 나오니 그 안에서 많은 정보를 얻을 수 있습니다.)
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]