1.저장소 만들기
 mkdir c:\server\SVNRepository
 svnadmin create c:\server\SVNRepository
 
2. 프로젝트 만들기 : 프로젝트를 포함하고 있는 폴더에서 수행한다.
 svn import -m "메지시 추가" . file:///c:/server/SVNRepository/testSVN/trunk 

3. 서버에서 프로젝트 가져오기
 svn co file:///c:/server/SVNRepository/testSVN/trunk testSVN

4. 프로젝트 확인
 svn status 파일명   => 지역 작업본의 상태를 보여준다.
 svn status --show-updates(-u)  => 현재 작업본에서 수정된 정보를 보여준다.
 svn diff 파일명   => 저장소와의 차이를 보여준다.
 svn diff -rHEAD 파일명  => 가장 최근의 리비전과 비교한 정보를 보여준다.
 
5. 변경된 프로젝트 서버에 저장
 svn commit(ci) -m "메시지 추가"  => 파일명을 쓰지 않아도 변경된 파일만 저장소에 저장한다.
           => 버전이 낮을 경우에는 update를 먼저 수행해야 한다.
           => update를 했을때 충돌이 있을 경우에는 해결한 후에 resolved를 수행해야 한다.

6. 메시지 확인
 svn log 파일명
 svn log --verbose 파일명  => 자세한 정보를 보여준다.
 svn log -r5(리비전번호) 파일명  => 리비전 r5에 대한 정보를 보여준다.
 
7. 프로젝트 업데이트
 svn update => 저장소의 최신 내용을 가져와 현재 작업본의 파일과 병합한다.
 
8. 프로젝트 충돌해제 확인
 svn resolved 파일명
 
9. 저장소에 파일추가
 svn add 파일명 => 추가한 후에는 commit을 해주어야 한다.
 svn commit -m "추가 메시지"

10. ssh 사용
 Putty설치 : http://www.chiark.greenend.org.uk/~sgtatham/putty/에서 plink.exe를 다운 받는다.
 다운받은 파일을 c:\windows\system32폴더에 복사한다.
 echo %APPDATA% : 응용 프로그램 자료 디렉토리를 찾는다. 이 안의 Subversion 디렉토리에 있는 config파일을 연다.
10.  
 

window 환경에서 openssl을 설치하는 방법은 소스를 받아서 컴파일하는 방법과 openssl.exe , ssleay32.dll , libeay32.dll 파일을 system32에 복사하여 사용하는 2가지 입니다.

둘다 openssl을 사용하는데에는 별로 큰 영향은 없는것 같습니다.

첫번째 컴파일 방법은 다음과 같습니다.

1. Perl

http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl

MSI는 Microsoft Installer가 깔려있어야 합니다. 없을 경우에는 업데이트를 하시는 것 잊지 마시기 바랍니다.

2.OpenSsl 라이브러리

 http://www.openssl.org 가서 받으시면 됩니다.

우선 파일 받으신 다음에 압축을 해지하시면 됩니다.
모든 명령은 압축을 해지한 폴더에서 하셔야 합니다.

예를 들어 c:\openssl 폴더에다가 압축을 해지 하셨으면 c:\openssl 폴더에 가서 실행을 하셔야 한다는 겁니다.

첫번째로 perl 명령으로 Configure라는 것을 실행하게 되는데 다음과 같이 치시면 됩니다.
C:\openssl>perl Configure VC-WIN32

C:\openssl>ms\do_masm

C:\openssl>ms\do_ms

C:\openssl>nmake -f ms\ntdll.mak

환경변수에 PATH부분에 nmake.exe가 있는 경로를 추가해 주셔야 합니다.(제어판-시스템-고급-시스템변수)

정상적으로 설치 되었는지 test

소개 (Introduction)

이 문서는 Subversion을 사용하여 소스코드의 버전 컨트롤을 하고자 하는 모든 소프트웨어 종사자를 위해 작성되었습니다. 상당수의 경우 오픈 소스 소프트웨어의 높은 진입장벽 중 하나는 어려운 설치 방법입니다. 이러한 진입장벽을 제거하고, 보다 많은 개발자가 Subversion을 사용할 수 있도록 돕고자 작성되었습니다.

이 문서의 주요 섹션은 다음과 같습니다.

• Subversion 설치
• SVNSERVE Manager 설치
• WebSVN 설치
• 디렉토리 보안 설정
• 테스트
• 기타
• 피드백과 지원 (Feedback and Support)

왜 Subversion인가?

이 세상에는 유용한 소스버전 컨트롤 시스템이 많습니다. 그런데 왜 Subversion을 선택했을까요? Subversion과CVS를 비교한 다음 문서에 자세한 비교 설명이 실려 있습니다.

• Subversion 사용 HOWTO
• CVS와 Subversion을 이용한 소스 코드 버전 관리

문서 ‘CVS와 Subversion을 이용한 소스 코드 버전 관리’는 분실을 대비해서 로컬파일로 준비했습니다.

시스템 요구사항 (System Requirements)

이 문서 상에 기술된 내용이 테스트된 환경은 다음과 같습니다.

• Microsoft Windows® 2000 Professional operating system

참고 문헌 (Related Links)

이 문서는 다음 문서를 참고하여 만들어졌습니다.

• Subversion 사용 HOWTO
• Subversion Setup

이 문서는 설치 가이드이므로, Subversion의 사용법이나 노하우를 익히려면 다음 문서를 참고하십시오.

• Subversion 사용 HOWTO
• Subversion Setup
• Version Control with Subversion

설치 (Installation)

1. Subversion 설치

   1. 설치 파일 구하기

      Windows용 설치파일(.exe)을 다운로드 합니다. 현재는 버전 1.2.0이 나왔습니다만, 이 설치 가이드에서는 버전 1.1.4를 사용합니다.버전 1.2.0이 나오면서 Berkeley DB의 새 버전을 사용하게 됐습니다. 이 때문에 이전 버전과의 호환성 문제가 발생합니다. 문서 작성자인 저의 컴퓨터엔 이미 1.1.1 버전이 설치되어 있기 때문에 부득이 버전 1.1.4를 사용합니다.

   2. Subversion 설치하기

      설치 프로그램(예. svn-1.1.4-setup.exe)을 더블 클릭하면 아래와 같은 설치화면이 나옵니다. 지시사항에 맞춰 Subversion을 설치하면 됩니다.

      

      만약 후에 WebSVN과 같은 Subversion 웹 인터페이스를 설치하려고 하면 주의해야 할 점이 있습니다. Windows의 IIS를 웹서버로 사용하면 별다른 주의가 필요 없지만 Apache 서버를 사용할 때는 Subversion 설치 전에 Apache를 설치합니다. 이미 Subversion을 설치한 경우에는 다시 한번 Subversion을 설치합니다. 이 문서에서는 IIS 서버를 사용하는 경우를 다루기 때문에 자세한 사항은 언급하지 않습니다.

   3. Subversion PATH 설정

      Subversion의 바이너리가 설치된 경로를 환경변수 PATH에 등록합니다. 제어판 -> 시스템 -> 고급 -> 환경변수 -> 시스템변수 -> PATH를 선택합니다. 변수값에 바이너리가 설치된 경로를 추가합니다. 기본값은 다음과 같습니다.

      C:\Program Files\Subversion\bin

      환경변수 값이 제대로 설정되었는지 확인하려면 다음과 같이 작업합니다. 시작 -> 실행 -> 창에 cmd를 입력한 후 확인 버튼을 누릅니다.

      

      검은 화면의 명령창이 나타날 것입니다. Svnlook 을 입력하고 엔터를 누릅니다. 다음과 같은 메시지가나오면 환경설정이 올바른 것입니다.

      

      만약 다음과 같은 메시지가 나타나면 환경설정 값이 올바른지 다시 확인해야 합니다.

      'svnlook'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치파일이 아닙니다.

2. SVNSERVE Manager 설치

   1. 개요

      SVNSERVE Manager은 Windows 시작시 Subversion을 자동으로 띄워주는 등, Subversion 서버를 편리하게 관리하도록 도와주는 소프트웨어입니다.

   2. 다운로드 및 설치

      여기에서 Windows용 설치 파일을 다운로드 받은 후실행시킵니다.

      

      설치 후에 SVNSERVE Manager가 자동 실행되지 않습니다. 바탕화면에 바로가기(SVNSERVE Manager) 메뉴를 더블클릭합니다. 아래와 같은 트레이 아이콘이 뜹니다. 빨간색으로 표시한 것이 SVNSERVE Manager의 트레이 아이콘입니다.

      

      트레이 아이콘을 더블클릭하면 다음과 같은 메뉴를 볼 수 있습니다.

      

      알맞은 값을 설정한 다음에 ‘Hide’ 또는 ‘X’를 클릭합니다.

3. WebSVN 설치

   1. 개요

      WebSVN은 대표적인 Subversion 전용 웹 인터페이스입니다. 이 외에도 Subversion을 지원하는 웹 인터페이스는 ViewCVS, ViewSVN, SubView 등이 있습니다. WebSVN을 사용하면 Subversion의 저장소(Repository)를 웹상에서 접근할 수 있습니다. 다음은 KDE 프로젝트의 WebSVN 사이트입니다.

      

   2. 설치

      우선 WebSVN 을 다운로드 받습니다. 현재 버전은 1.61입니다. WebSVN_161.zip 파일의 압축을 풀면 install.txt 파일이 있습니다. 해당 파일을참조하시거나 다음의 설명에 따라 작업하십시오.

      1. IIS 서버 설치 및 작동

         우선 IIS 서버가 설치되어 있는지 확인합니다. 제어판 -> 관리도구 -> 인터넷 정보 서비스(IIS) 관리를 클릭합니다.

         

         기본 웹 사이트가 (중지됨) 등으로 표시되어 있으면 시작시킵니다. 만약 위의 메뉴를찾을수 없다면 IIS 서버를 설치해야 합니다. 제어판 -> 프로그램 추가/제거 -> 윈도우 구성요소 추가/제거 -> 응용프로그램 서버(Windows 2003 Server의 경우에만 해당함) -> 인터넷 정보 서비스를 체크하고 확인 버튼을 클릭합니다.

      2. PHP 설치

         여기서는 버전 4.3.11을 설치하겠습니다. Windows installer로 된 설치 프로그램을 다운로드 받아서 실행합니다. 설치 프로그램의 안내에 따라 PHP를설치합니다. 설치 작업 마지막에 아래 두 메시지 창이 연달아 팝업되면 작업이 성공한 것입니다.

         

         

         만약 둘 중 하나라도 보이지 않는다면 IIS서버에 문제가 있는 것일 수 있습니다. 특히 다음의 사항을점검해야 합니다.

         1. IIS 서버가 설치되었는가.
         2. 기본 웹사이트가 시작되었는가.
         3. 기본 웹사이트의 TCP 포트가 80인가.

         만약 Apache 를 웹서버로 사용한다면 첫번째 메시지는 팝업되지 않습니다.

      3. IIS 설정

         제어판 -> 관리도구 -> 인터넷 정보 서비스(IIS) 관리 -> 기본 웹 사이트 -> 속성을 선택합니다.

         

         기본 웹 사이트 등록정보 -> 문서를 선택합니다. 추가 버튼을 클릭하고 index.php를 써넣은 후 확인 버튼을 클릭합니다.

         

      4. GnuWin32 Packages 설치

         WebSVN의 install.txt 문서를 읽으면 다음 소프트웨어를 설치해야 합니다.

         • Diff/Sed/Gzip/Tar
         • Enscript

         위의 사이트에서 다운로드 받아도 되며 GnuWin32 Packages 사이트에서 다운로드 받아도 됩니다. 후자 쪽이 더 편할 것입니다.

         전자와 후자의 경우 각각 응용프로그램이 설치되는 경로가 다릅니다. 기본 경로값은 다음과 같습니다.

         전자: C:\cygwin\bin
         후자: C:\Program Files\GnuWin32\bin

         위의 경로를 환경변수 PATH에 등록합니다. 방법은 Subversion의 바이너리 경로를 등록했을 때와동일합니다.

      5. WebSVN을 IIS 홈디렉토리(Document Root)에 복사하기

         WEBSVN 사이트에서 다운로드 받은 PHP 소스 디렉토리를 IIS서버 Document Root에 복사합니다. Document Root의 기본값은 다음과 같습니다.

         C:\Inetpub\wwwroot

         Document Root의 값을 모를 때는 다음의 절차를 따릅니다.

         1. 제어판 -> 관리도구 -> 인터넷정보서비스

         2. 기본 웹사이트를 선택한 후 마우스 오른쪽 버튼을 클릭합니다. Context Menu 중 등록정보를선택합니다.

            

         3. 홈디렉토리 -> 로컬경로를 보면 Document Root의 경로를 알수있습니다

            

      6. WebSVN 설정하기

         명령창에서 다음 명령어를 실행시킵니다. 이때 distconfig.inc 파일의 구체적 경로는 Document Root 경로에 따라 달라진다는 점을 주의하십시오.

         copy C:\Inetpub\wwwroot\WebSVN\include\distconfig.inc C:\Inetpub\wwwroot\WebSVN\include\config.inc

         

         그리고 메모장으로 복사된 C:\Inetpub\wwwroot\WebSVN\include\config.inc 파일을 불러들입니다.

         1. config.inc 파일 수정 ? Platform 설정

            [변경 전]

            // Uncomment the next line if your running a windows server
            //
            // $config->setServerIsWindows(); 

            
            

            [변경 후]

            // Uncomment the next line if your running a windows server
            //
            $config->setServerIsWindows();

         2. config.inc 파일 수정 - Subversion Binary와 GnuWin32 Packages의 경로 설정s

            [변경 전]

            // Configure these lines if your commands aren't on your path. 
            //
            // $config->setSVNCommandPath("Path/to/svn and svnlook/ e.g. c:\\program files\\subversion\\bin");
            // $config->setDiffPath("Path/to/diff/command/");
            
            // For syntax colouring, if option enabled...
            // $config->setEnscriptPath("Path/to/enscript/command/");
            // $config->setSedPath("Path/to/sed/command/"); 
            
            // For delivered tarballs, if option enabled...
            // $config->setTarPath("Path/to/tar/command/");
            
            // For delivered GZIP'd files and tarballs, if option enabled...
            // $config->setGZipPath("Path/to/gzip/command/");

            
            

            [변경 후]

            // Configure these lines if your commands aren't on your path. 
            //
            $config->setSVNCommandPath("c:\\program files\\subversion\\bin");
            $config->setDiffPath("C:\\Program Files\\GnuWin32\\bin"); 
            
            // For syntax colouring, if option enabled...
            $config->setEnscriptPath("C:\\Program Files\\GnuWin32\\bin");
            $config->setSedPath("C:\\Program Files\\GnuWin32\\bin"); 
            
            // For delivered tarballs, if option enabled...
            $config->setTarPath("C:\\Program Files\\GnuWin32\\bin");
            
            // For delivered GZIP'd files and tarballs, if option enabled...
            $config->setGZipPath("C:\\Program Files\\GnuWin32\\bin"); 

         3. config.inc 파일 수정 ? Subversion 저장소 경로 설정

            여기서는 Subversion의 저장소(Repository)를 설정해보겠습니다. Config.inc의 주석에 따르면저장소 설정에는 크게 두 가지 방법이 있습니다. 첫번째는 각각의 저장소를 하나씩 추가하는 것입니다. 두번째는 저장소 Root 디렉토리를 설정하는 것입니다. 이 방법은 Root 디렉토리 하부에저장소를 두었을때 사용할 수 있습니다. 두 번째가 일반적이기 때문에 여기서는 두 번째 방법을 따르겠습니다.

            [변경 전]

            // To use the parent path method, uncomment the newt line and and replace the path with your one.  You
            // can call the function several times if you have several parent paths.
            //
            // $config->parentPath("Path/to/parent (e.g. c:\\svn)");

            
            

            [변경 후]

            // To use the parent path method, uncomment the newt line and and replace the path with your one.  You
            // can call the function several times if you have several parent paths.
            //
            $config->parentPath("D:\\SVNRepository"); 

            
            

            현재 문서작업 중인 컴퓨터의 Subversion 저장소 Root 디렉토리 경로는 "D:\SVNRepository" 입니다. 여러분의 환경에 따라 경로 값을 조정해야 합니다.

         4. config.inc 파일 수정 ? 웹사이트 템플릿(디자인) 선택하기

            원하는 템플릿의 주석만 제거하면 됩니다.

            // --- LOOK AND FEEL ---
            //
            // Uncomment ONLY the display file that you want.  
            
            $config->setTemplatePath("$locwebsvnreal/templates/Standard/");
            // $config->setTemplatePath("$locwebsvnreal/templates/BlueGrey/");
            // $config->setTemplatePath("$locwebsvnreal/templates/Zinn/");
            
            

         5. config.inc 파일 수정 ? 언어 설정

            WebSVN은 다양한 언어(인코딩)을 지원합니다. Config.inc 파일 중“// --- LANGUAGE SETUP ---“ 섹션에서 원하는 언어를 선택하면 됩니다. 아무것도 선택하지 않으면 English가 기본값입니다.

         6. config.inc 파일 수정 ? Tarball Download 활성화

            Tarball Download도 Subversion 저장소 설정과 같이 개별 저장소마다 활성화 여부를 지정할 수도 있습니다. 여기서는 모든 저장소에 대해 tarball download 기능을 활성화하겠습니다.

            [변경 전]

            // --- TARBALLS ---
            
            // You need tar and gzip installed on your system.  Set the paths above if necessary
            //
            // Uncomment the line below to offer a tarball download option across all your
            // repositories.
            //
            // $config->allowDownload();

            
            

            [변경 후]

            // --- TARBALLS ---
            
            // You need tar and gzip installed on your system.  Set the paths above if necessary
            //
            // Uncomment the line below to offer a tarball download option across all your
            // repositories.
            //
            $config->sallowDownload();

         7. config.inc 파일 수정 ? Syntax Colorization

            [변경 전]

            // --- COLOURISATION ---
            
            // Uncomment this line if you want to use Enscript to colourise your file listings
            //
            // You'll need Enscript version 1.6 or higher AND Sed installed to use this feature. 
            // Set the path above.
            //
            // $config->useEnscript(); 

            
            

            [변경 후]

            // --- COLOURISATION ---
            
            // Uncomment this line if you want to use Enscript to colourise your file listings
            //
            // You'll need Enscript version 1.6 or higher AND Sed installed to use this feature. 
            // Set the path above.
            //
            $config->useEnscript(); 

4. 디렉토리 보안 설정

   1. tarball download

      WebSVN은 C:\WINNT\Temp 또는 C:\\Windows\Temp 디렉토리에 tarball 파일을 생성합니다. 그러므로 일반 웹사이트 사용자가 tarball download 기능을 사용하려면 IUSR_<machinename>에게 C:\WINNT\Temp에 대한 읽기 접근 권한을 부여해야 합니다. 다음의 절차를 따릅니다.

      • C:\WINNT\Temp를 선택하고 마우스 오른쪽 버튼을 클릭합니다. 컨텍스트 메뉴에서 등록 정보를선택합니다.

        

      • 보안 -> 추가를 선택하면 다음과 같은 창이 뜹니다.

        

      • IUSR_<machinename>를 추가하고 확인 버튼을 누릅니다.

      • IUSR_<machinename>에게 읽기 권한을 부여합니다.

        

   2. Cache

      • C:\Inetpub\wwwroot\WebSVN\cache를 선택하고 마우스 오른쪽 버튼을 클릭합니다. 컨텍스트 메뉴에서 등록 정보를 선택합니다.

      • 보안 -> 추가를 선택합니다.

      • IUSR_<machinename>를 추가하고 확인 버튼을 누릅니다.

      • IUSR_<machinename>에게 읽기, 쓰기 권한을 부여합니다.

        

5. 테스트

   인터넷 익스플로러를 열고 주소 창에 다음 주소를 입력합니다.

   http://localhost/WebSvn/ 또는 http://localhost/WebSvn/index.php

   1. ‘Directory Listing Denied’ 에러

      

      위의 메시지는 PHP 설정 후 IIS의 기본 콘텐트 페이지에 index.php를 추가하지 않았기 때문에 보이는 것입니다.sss

   2. 404 에러

      만약 다음과 같은 ‘404, 페이지를 찾을 수 없습니다’ 에러가 발생하면 PHP에 문제가 있을 가능성이 높습니다.

      

      PHP를 다시 설치할 때는 다음 순서에 유의해야 합니다.

      1. 제어판 -> 프로그램 추가/제거 -> PHP 4.3.11

      2. C:\WINNT\php.ini 또는 C:\Windows\php.ini 파일을 제거합니다.

      3. PHP 4.3.11 을 다시 설치합니다.

   3. dl.php 오류

      Tarball Download 기능을 사용해 봅시다.

      

      만약 다음과 같은 메시지가 뜬다면 디렉토리 보안 설정이 잘못된 것입니다.

      Warning: chdir(): No such file or directory (errno 2) in c:\inetpub\wwwroot\websvn\dl.php on line 65
      Warning: filesize(): Stat failed for branches.tar.gz (errno=2 - No such file or directory) in c:\inetpub\wwwroot\websvn\dl.php on line 70
      Unable to open file branches.tar.gz
      Warning: fclose(): supplied argument is not a valid stream resource in c:\inetpub\wwwroot\websvn\dl.php on line 86s

   4. permission 오류

      Warning: gzopen(.\cache\D__SVNRepository_public_mods_17): failed to open stream: Permission denied in c:\inetpub\wwwroot\websvn\include\svnlook.inc on line 301

      위와 같은 Permission 오류가 발생하면 메시지를 유심히 살펴봐야 합니다. 위의 메시지를 읽어보면 cache 디렉토리에 파일 쓰기를 하려다가 실패한 것을 알 수 있습니다. 해당 디렉토리에 적절한 권한(이 경우에는 쓰기권한)을 부여하면 됩니다.

6. 기타

   1. WebSVN에 .NET C# Syntax Colourisation 기능 추가하기

   2. csharp.st 파일 다운로드

      아래 사이트에서 csharp.st 파일을 구합니다.

      http://www.xml-blog.com/archives/000282.html
      tps://sourceforge.net/tracker/?func=detail&atid=368760&aid=690128&group_id=18760
      Download

      만약 두 번째 사이트에서 csharp.st 파일의 내용을 복사해서 csharp.st 파일을 만들 때는 주의해야 합니다. 메모장으로 csharp.st 파일을 만들면 안 됩니다. ‘UNIX 종료 ? LF’ 형식을 지원해 주는 텍스트 편집기를 사용해야 합니다.

      다운로드 받은 csharp.st 파일을 [Enscript-install-path]\share\enscript\hl 디렉토리 안에 복사합니다.
      (예: “C:\Program Files\GnuWin32\share\enscript\hl”)

   3. setup.inc 파일 수정

      [WebSVN-install-path]\include\setup.inc (예: C:\Inetpub\wwwroot\WebSVN\include\setup.inc) 파일을 메모장으로 불러옵니다. 그리고 다음과 같이 setup.inc 파일을 수정합니다.

      [변경 전]

      // List of extensions recognised by enscript.
      
      $extEnscript = array
      (
      ".ada"     => "ada",
      ".adb"     => "ada",
      ".ads"     => "ada",
      ".awk"     => "awk",
      ".c"       => "c",
      ".c++"     => "cpp",
      ".cc"      => "cpp",
      ".cpp"     => "cpp",
      이하 생략……

      
      

      [변경 후]

      // List of extensions recognised by enscript.
      
      $extEnscript = array
      (
      ".ada"     => "ada",
      ".adb"     => "ada",
      ".ads"     => "ada",
      ".awk"     => "awk",
      ".c"       => "c",
      ".c++"     => "cpp",
      ".cc"      => "cpp",
      ".cpp"     => "cpp",
      ".cs"      => "csharp", 

* StarUML 5.0 사용자 가이드(한글) :
http://staruml.sourceforge.net/docs/user-guide(ko)/toc.html

1. LOG4J 구조

일단 log4j를 잘 모르지만 그 구조만 살짝 살펴보고 넘어갑시다
log4j는 크게 3가지 요소로 구성되며 그 구조는 다음과 같습니다

① Logger(Category) : 로그의 주체 (로그 파일을 작성하는 클래스)
     
     로깅 메세지를 Appender에 전달합니다.
     Log4j의 심장부에 위치하며, 개발자가 로그출력 여부를 런타임에 조정되도록 해준다.
     Logger는 로그레벨을 가지고 있으며, 로그의 출력여부는 로그문의 레벨과 로거의 레벨을 가지고 결정된다.

     어플리케이션을 작성하기전 어떤 로거를 사용해야 할지 정해야 한다.
     ex) static Logger logger = Logger.getLogger(SimpleLog.class);

     [참고] Commons-Logging 는 레퍼클래스도 존재함

② Appender : 로그를 출력하는 위치

     전달된 로깅 메세지를 파일에다 기록할 것인지, 콘솔에 출력할 것인지
     아니면 DB에 저장할 것인지 매개체 역활을 합니다.

     Log4J API문서의 XXXAppender로 끝나는 클래스들의 이름을 보면,
     출력위치를 어느정도 짐작할 수 있다.

     http://logging.apache.org/log4j/docs/api/index.html

③ Layout : Appender의 출력포맷

　　Appender가 어디에 출력할 것인지 결정했다면 어떤 형식으로 출력할 것이지
　　출력 layout을 결졍합니다.

　　일자, 시간, 클래스명등 여러가지 정보를 선택하여 로그정보내용으로 지정할 수 있다.
　　자세한 패턴은 아래의 클래스정보를 살펴보면 알수있다.

　　※ Layout의 종류

  　　  1) DateLayout
 　　   2) HTMLLayout
 　　   3) PatternLayout ( 일반적으로 PatternLayout을 사용하는 것이 디버깅에 가장 적합함 )
  　　  4) SimpleLayout
  　　  5) XMLLayout

2. LOG4J 로깅 레벨

log4j는 다양한 로깅레벨을 지원합니다.

① FATAL : 가장 크리티컬한 에러가 일어 났을 때 사용합니다.
② ERROR : 일반 에러가 일어 났을 때 사용합니다.
③ WARN : 에러는 아니지만 주의할 필요가 있을 때 사용합니다.
④ INFO : 일반 정보를 나타낼 때 사용합니다.
⑤ DEBUG : 일반 정보를 상세히 나타낼 때 사용합니다.

레벨을 설정하면 그 이상의 레벨만 로깅하게 된다.
예를 들어 INFO로 설정한 경우 INFO, WARN, ERROR, FATAL이 로깅된다.

3. 샘플코드

파일명 : TestServlet.java

import javax.servlet.*;
import javax.servlet.http.*;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

public class TestServlet extends HttpServlet {
    static Logger logger = Logger.getLogger(TestServlet.class);

    public void init(ServletConfig config) throws ServletException {
         super.init(config);
    }

    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
         try {
              ...
              logger.info("Hellow World~");
              ...

          } catch (Exception e) {
              logger.error("Error at TestServlet", e);
          }
     }
}

4. LOG4J 설정

log4j.properties를 만들어 /WEB-INF/classes 밑에 놓으세요

파일명 : log4j.properties

log4j.rootLogger=INFO, stdout, rolling
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=output.log
# 기본 경로는 %CATALINA_HOME%bin 디렉토리이다.
# 경로를 바꾸고 싶을 때에는 다음과 같이 C:/web/WEB-INF/logs/ssg.log 바꾼다.
log4j.appender.file.Append=true
log4j.appender.file.MaxFileSize=500KB
log4j.appender.file.DatePattern='.'yyyy-MM-dd
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n

** 설명

#최상위 카테고리에 INFO로 레벨 설정 및 appender로 stdout, file을 정의
log4j.rootLogger=INFO, stdout, file

#stdout 어펜더는 콘솔에 뿌리겠다는 정의
log4j.appender.stdout=org.apache.log4j.ConsoleAppender

#stdout 어펜더는 patternlayout을 사용하겠다는 정의
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

#페턴은 다음과 같이 포맷팅 하겠다는 것을 정의
log4j.appender.stdout.layout.ConversionPattern=%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n

#역시나 rolling 어펜더는 파일로 처리한다라고 정의
log4j.appender.rolling=org.apache.log4j.RollingFileAppender

#로그 파일 이름은 output.log
log4j.appender.rolling.File=output.log

#true면 톰캣을 내렸다 올려도 파일이 리셋되지 않습니다.
log4j.appender.rolling.Append=true

#파일 최대 사이즈는 500KB로 설정
log4j.appender.rolling.MaxFileSize=500KB

#파일 포맷은 output.log.2005-03-10 으로 관리하겠다고 정의
log4j.appender.rolling.DatePattern='.'yyyy-MM-dd

#역시나 rolling 어펜더는 패턴 레이아웃을 사용하겠다고 정의
log4j.appender.rolling.layout=org.apache.log4j.PatternLayout

#rolling 어펜더는 패턴 레이아웃 포맷
log4j.appender.rolling.layout.ConversionPattern=%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n

☆☆☆☆☆☆☆☆☆☆☆☆☆
log4j.xml 관련 내용 추가 예정
☆☆☆☆☆☆☆☆☆☆☆☆☆


5. 설정 포맷

① 로그파일명 포맷 (DatePattern)

로그파일명 포맷입니다. 날짜, 시간 및 분단위로까지 로그 파일을 분리할 수 있습니다.
  
   ※ 형식 설명
      '.'yyyy-MM 매달 첫번째날에 로그파일을 변경합니다 
      '.'yyyy-ww 매주의 시작시 로그파일을 변경합니다.  
      '.'yyyy-MM-dd 매일 자정에 로그파일을 변경합니다. 
      '.'yyyy-MM-dd-a 자정과 정오에 로그파일을 변경합니다. 
      '.'yyyy-MM-dd-HH 매 시간의 시작마다 로그파일을 변경합니다.
      '.'yyyy-MM-dd-HH-mm 매분마다 로그파일을 변경합니다. 

② PatternLayout 포맷

로그자체를 어떤 포맷으로 남길지 결정합니다.
layout에는 HTMLLayout, PatternLayout, SimpleLayout, XMLLayout등이 있으며
PatternLayout이 일반적으로 가장 많이 쓰입니다.

예시) (같은 색끼리 보시면 됩니다)

위의 test.jsp를 다음 포맷으로 출력해본다면
[%c] [%C] [%d] [%F] [%l] [%L] [%m] [%M] [%n] [%p] [%r] [%t] [%x] [%X]는 다음과 같다

[test.jsp] [org.apache.jsp.test_jsp] [2005-03-10 12:37:23,561] [test_jsp.java] [org.apache.jsp.test_jsp._jspService(test_jsp.java:64)] [64] [fatal!!] [_jspService] [개행] [FATAL] [765567] [http-8080-Processor25] [] []