[스크랩] Mantis(이슈/Bug트래킹) Windows-2003 설치하기
개발 버그리포팅을 위해서 mantis를 설치 하였습니다.
먼저 matis설치 하기 위해선 몇가지 선행 작업이 필요합니다.
설치 플랫폼은 윈도우 2003 입니다
http://neojijon.pe.kr/entry/Mantis-%EC%84%A4%EC%B9%98 님의 글을 퍼왔습니다.
이분은 여기서 퍼오셨더군요(http://woohaha.egloos.com/1006717)
[설치과정]
1. 우선 mantis는 php 기반으로 되어 있기 때문에 윈도우즈 웹서버인 IIS에서 PHP를 돌릴 수가 있어야 했다.
다행히도 이미 사용해본 경험이 있는 PHP Setup for IIS 를 사용하였다.
이번에는 mantis를 다운로드받았다.
설치작업은 다운로드받은 압축파일을 풀어서 통째로 디렉토리에 밀어넣는 방법을 사용하였다.
물론 mantis를 위한 가상디렉토리를 만들어 주어야 한다.
2. 그리고나서 바로 돌려보니(가상디렉토리로 접근해보니) 동작 안하는건 당연지사...
DB설치가 필요했다.
설치에 필요한 내용은 mantis 홈페이지의 매뉴얼 페이지를 적극 활용하였다.
DB를 하나 만들고나서 해당 DB에 대고 mantis 의 sql 폴더에 있는 db_generate.sql 을 돌렸다.
3. 여기까지 수행한 뒤 다시 한번 가상디렉토리로 접근해보니 administrator 계정에 접근 불가라는 메시지를 보여준다.
즉 2.에서 생성한 DB에 접근할 수 있는 계정을 설정해 주어야 한다.
이 계정 및 DB접속정보에 대한 설정내용은 config_inc.php 파일에 기록을 해주면 된다.
$g_hostname = "localhost";
$g_db_username = "DB접속을위한계정";
$g_db_password = "비밀번호";
$g_database_name = "mantis데이터베이스이름";
4. 성격도 급하지...다시 한번 가상디렉토리 접근 시도.
신규 사용자 추가하고 email 로 들어온 사용자확인 링크 누르고 다시 사용자 로그인 시도.
음하하...성공!!
[설치시 애로점]
1. mantis는 사용자계정 등록시 email 로 확인 메일을 보내고 그 메일을 통해서 사용자계정 추가 작업을 완료하는데, email 발송 루틴에서 문제가 있어서 조금 고생을 하였다.
이 문제는 config_inc.php 에 다음과 같은 전역 변수 설정을 추가하여 해결하였다.
$g_smtp_host = "메일서버IP";
$g_smtp_username = "메일서버에접근하기위한계정";
$g_smtp_password = "비밀번호";
$g_phpMailer_method = 2; //SMTP로 메일보내기 방법
그리고 메일계정에 대한 다음 설정도 수정해 주어야 한다.
$g_administrator_email = '관리자이메일계정';
$g_webmaster_email = '웹마스터이메일계정';
# the "From: " field in emails
$g_from_email = '메일송신시표시계정';
# the return address for bounced mail
$g_return_path_email = '리턴메일받을계정';
2. 사용자계정의 권한 및 기타 잡다구리한 설정들을 변경하기 위해서 어드민으로 로그인하고자 했으나
다음과 같은 에러 메시지를 보여줌.
오류: 계정이 사용 정지 됐거나, 사용자이름/비밀번호가 올바르지 않습니다.
관리자로 등록한 계정이 보호계정으로 설정되었는데, 이 보호계정을 푸는 방법을 몰라서 조금 고생했다.
결국엔 phpmyadmin 으로 들어가서 mantis 데이터베이스의 mantis_user_table 테이블에 있는 값을 직접 수정하여 해결하였다.(이런 방법밖엔 없는지...)
새로 추가한 계정의 권한(access_level) 필드값을 관리자 계정의 값과 동일하게 설정하여 로그인한 후 관리자 계정의 패스워드를 초기화시켜버리고 다시 설정하였다.(메일 계정을 설정해 주어야 해당 메일로 관리자계정의 패스워드를 설정할 수 있는 메일이 발송된다)
나머지 설치 과정은 그다지 어려운 편은 아니었다.
/////////////////////////////////////////////////////////////////////
mantis 1.0.5 설치 기록 (Windows XP)
http://anyons.net/tt/entry/mantis-105-%EC%84%A4%EC%B9%98-%EA%B8%B0%EB%A1%9D-Windows-XP 출처 입니다
//////////////////////////////////////////////////////////
1. APM (Apache, PHP, MySQL) 설치
mantis를 설치하기 위해서는 Apache, PHP, MySQL이 필요하다.
(아파치 설치가 불가능한 경우라면 IIS나 기타 PHP설치가 가능한 다른 웹서버도 괜찮다)
내 경우엔 Apache 2.2 + PHP 5 + MySQL 5 각각 최신 버전으로 설치했다.
이건 다른 사이트에서 충분히 많은 레퍼런스가 있으니 설명은 패스.
잘 모르면 APM을 통합 설치해 주는 프로그램을 사용해도 무방하다.
설치후 각각의 세팅은 역시 알아서 잘... (무책임 모드)
2. mantis 설치
http://mantisbt.org/download.php 에서 mantis를 다운받는다. (1.0.5 기준)
받은 파일을 [웹루트]/mantis 에 압축을 풀고 브라우저로 실행한다.
설치화면이 나오는데 알아서 잘;;; 입력하면 일단 기본적인 설치는 완료된다.
설치완료후 /mantis/admin 폴더는 통째로 삭제하거나 다른 곳에 옮겨 둔다.
(그냥 두면 경고문구가 계속 보이고 또한 보안상 좋지 않다)
3. mantis 설정
/[mantis]/config_inc.php 에서
$g_default_language 와 $g_back_language를 'korean_utf8'로 수정한다.
(그냥 korean으로 해도 상관없다. 하지만 본인은 UTF8을 너무 좋아한다;;;)
$g_back_language = 'korean_utf8';
영문판이 좋다면 그냥 넘어가도 무방하나 한글로 이슈를 등록할 경우 무참히 깨진다.
다만 굳이 영문판으로 써야겠다면 /mantis/lang 폴더에 언어셋 파일들이 있는데
그 중 strings_english.txt를 열어 s_charset 을 euc-kr, ms949, utf-8 등으로 바꿔주면
영문판을 쓰면서 한글로 이슈를 등록할 수 있다.
기타 다른 설정은 http://manual.mantisbt.org 를 참고한다.
이제 관리자로 로그인한 뒤 세부설정을 한다.
mantis 기본 설치시 관리자의 아이디는 administrator, 비밀번호는 root 로 되어 있다.
로그인이 되었다면, 보안관계상 제일 먼저 비밀번호/이메일 등을 바꾸고 나서
입맛에 맞게 환경설정이나 프로젝트 또는 유저 등록을 해주면 되겠다.
잠깐 살펴본 수준이지만 거의 직관적 인터페이스라 특별한 설명은 없어도 될 듯 하다.
4. mantis + SVN 연동 작업
svn 연동을 하지 않는다면 건너뛴다.
subversion이 이미 설치되어 있고 저장소를 만들었다고 가정한다.
아래의 내용을 post-commit.bat 란 이름으로 작성한다.
REM Post-commit hook for MantisBT integration
REM #################################
SET REPOS=%1
SET REV=%2
SET DETAILS_FILE=E:\svnfile_%REV%
SET LOG_FILE=E:\svnfile_%REV%_Log
echo ****** Source code change ******>>%DETAILS_FILE%
svnlook log -r %REV% %REPOS%>>%DETAILS_FILE%
echo SVN Revision:%REV%>>%DETAILS_FILE%
svnlook diff -r %REV% %REPOS%>>%DETAILS_FILE%
D:\DEV\PHP\php.exe D:\DEV\APACHE\htdocs\mantis\core\checkin.php <%DETAILS_FILE% >%LOG_FILE%
DEL %DETAILS_FILE%
DEL %LOG_FILE%
E: : 임시파일이 저장될 폴더... 아무데나 정해 준다.
D:\DEV\PHP\php.exe : php 인터프리터의 위치
D:\DEV\APACHE\htdocs\mantis : mantis가 설치된 위치
작성한 후 SVN 저장소가 있는 곳 (주의: svn서버가 설치된 곳 말고 저장소의 위치다)에
보면 hooks 폴더가 있다. 이곳에 위에서 작성한 파일을 복사한다.
/[mantis]/config_inc.php 파일을 수정 (아래의 내용이 없다면 추가, 있으면 당근 수정)
$g_source_control_account = 'administrator';
$g_source_control_notes_view_status = VS_PUBLIC;
$g_source_control_set_status_to = ON;
$g_source_control_regexp = "/\bissue [#]{0,1}(\d+)\b/i";
$g_source_control_account = 이슈를 기록할 유저 (mantis에서 등록된 사용자여야 한다)
$g_source_control_notes_view_status = 공개 여부 : (VS_PUBLIC | VS_PRIVATE 중 하나)
$g_source_control_set_status_to = 상태변경 여부 (ON | OFF)
$g_source_control_regexp = 이슈를 감지할 정규표현
이제 시험 가동...
mantis에서 시험용으로 이슈를 하나 등록한다. 그러면 이슈번호가 생성된다.
이제 Eclipse에서 테스트로 프로젝트를 만들고 commit해 본다.
이때 comment란에 $g_source_control_regexp 에서 정의한 정규식에 맞게
코멘트를 작성한다. 예를 들면 위와 같은 경우라면...
issue #0000002 오타 수정후 버그 완료
같은 식으로...
mantis에 접속한 후 해당 이슈를 보면 SVN변경기록과 함게 이슈노트가 등록된 것을 알 수 있다...
일단 여기까지...
///
설치가 끝나고 나서 몇가지 확인 작업을 하였습니다.
메일이 안되서 설치 막판에 힘들었는데.. 간단하게 outlook을 설치 해서 메일 확인해보고 버그리포트에서 사용할 메일을 받아서 메일 계정에 넣었더니 메일이 잘되고 인증받고 설치 완료 하였습니다.
사내 웹에서 확인을 해보았는데.. 컴퓨터 이름에 '_'이 포함되어 있으면 에러 메세지가 나오더군요.. 컴퓨터이름도 바꾸고 하니 비스타에서도 잘됩니다.ㅋㅋ