mantis 설치방법

Mantis는 웹기반의 버그 추적 시스템입니다. PHP로 작성되어 있어 ?MySQL^ 서버와 웹브라우저만 있으면 가능합니다. 프로젝트 관리 및 소프트웨어 설계시 단위별로 사용자가 작업한 내용을 기록할 수 있으므로 버그 추적까지도 유용하게 사용할 수 있습니다. 또한 필터 기능을 제공하여 사용자가 원하는 내용만 쉽게 찾을 수 있습니다.

한마디로 Mantis는 공동으로 여러 개발자가 프로그램을 개발할 때 발생할 수 있는 버그를 문서화 하여 체계적으로 관리하는 시스템이라고 할 수 있습니다.

설치 과정

1. mantis 홈페이지(http://www.mantisbt.org/)에 들어가서 최신 버전을 다운로드 받습니다.
2. 다운로드 받은 파일을 압축을 풉니다. 이 문서에서는 mantis/에 압축을 풀었다고 가정합니다.
3. 이제 mantis의 설정 파일을 구성해야 합니다. mantis의 설치 경로로 이동합니다. 여기서는 mantis/ 입니다. config_defaults_inc.php파일을 config_inc.php라는 이름으로 복사합니다. 이제 config_inc.php 파일을 수정합니다. 우선 데이터베이스 설정 부분부터 수정합니다.

   $g_hostname = 'localhost';
   $g_db_username = 'root';
   $g_db_password = 'xxxx'; 
   $g_database_name = 'mantis'; 
   $g_db_type = 'mysql';

   그리고 나서 메일 설정을 합니다. 각자의 환경에 알맞게 설정하면 되겠습니다.

   $g_phpMailer_method = 2; 
   $g_smtp_host = 'localhost'; 
   $g_smtp_username = 'kaistizen'; 
   $g_smtp_password = 'xxxxx';

   마지막으로 한글화 설정을 하겠습니다.

   $g_default_language = 'korean';

4. 이제 설치하기 전에 점검을 해보겠습니다. http://localhost/mantis/admin/ 에 접속합니다. 설치 경로는 각자 다를 수 있습니다. Check your installation 메뉴를 클릭하면 설치 전에 필요한 사항을 한번 더 점검할 수 있습니다.
5. 이제 최종 설치를 할 때입니다. http://localhost/mantis/admin/install.php 에 접속합니다. 지시사항 대로만 따르면 무사히 설치과정이 끝납니다.
6. http://localhost/mantis/ 에 접속합니다. 다음과 같은 화면이 보입니다. 

   
   붉은색으로 표시된 지시 사항에 따라 admin 디렉토리를 삭제하거나 다른 이름으로 변경합니다. administrator 계정은 삭제하지 않고 암호를 바꾸겠습니다. 최초 설치 후에 administrator/root 로 로그인할 수 있습니다. 로그인한 후 관리->administrator를 선택하여 사용자편집 창에 들어갑니다.

   우선 이메일 주소를 입력하고 정보갱신을 클릭합니다. 반드시 비밀번호를 전송받을 수 있는 유효한 이메일 주소를 입력해야 합니다. 그리고 계정 보호 체크박스를 해제합니다. 정보 갱신 후에 다시 사용자편집에 들어가서 비밀번호 초기화를 선택합니다. 방금 전에 입력한 이메일 주소로 비밀번호 확인 메일이 발송되었습니다. 메일을 확인하여 비밀번호를 수정합니다.

mantis 한글 설정(UTF-8)

1. mantis 의 설정 파일을 수정하기 위해 연다.

   sudo vi /etc/mantis/config.php

2. $g_default_language 와 $g_fallback_language 를 ‘korean_utf8’ 로 수정한 후 저장한다.

   $g_default_language     = 'korean_utf8';
   $g_fallback_language    = 'korean_utf8';

3. /usr/share/mantis/gui/config_defaults_inc.php 를 연다.

   sudo vi /usr/share/mantis/gui/config_defaults_inc.php

4. $g_language_choices_arr 에 ‘korean’ 밑에 ‘korean_utf8’ 을 추가한다.
    
5. $g_language_auto_map 에 “‘ko’ => ‘korean'” 를 “‘ko’ => ‘korean_utf8′” 로 수정한 후 저장한다.

           ...
           $g_language_auto_map = array(
                   'en-us, en-gb, en-au, en' => 'english',
                   'zh-cn, zh-sg, zh' => 'chinese_simplified',
                   'zh-hk, zh-tw' => 'chinese_traditional',
                   'cs' => 'czech',
                   'da' => 'danish',
                   'nl-be, nl' => 'dutch',
                   'et' => 'estonian',
                   'fi' => 'finnish',
                   'fr-be, fr-ca, fr-ch, fr' => 'french',
                   'de-de, de-at, de-ch, de' => 'german',
                   'hu' => 'hungarian',
                   'it-ch, it' => 'italian',
                   'ja' => 'japanese_sjis',
                   'ko' => 'korean_utf8',
                   'lt' => 'lithuanian',
                   'no' => 'norwegian',
                   'pl' => 'polish',
                   'pt-br' => 'portugese_brazil',
                   'pt' => 'portugese_standard',
                   'ro-mo, ro' => 'romanian',
                   'ru-mo, ru' => 'russian',
                   'sr' => 'serbian',
                   'sk' => 'slovak',
                   'sl' => 'slovene',
                   'es-mx, es-co, es-ar, es-cl, es-pr, es' => 'spanish',
                   'sv-fi, sv' => 'swedish',
                   'tr' => 'turkish'
           );

설치시 애로점

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. 설치를 하고 나서 위의 한글 설정(UTF-8)을 하였는데도, 로그인을 했을 때 euc-kr을 지원하지 않는다는 warning 메시지가 뜨는 경우가 잇다. 이럴 경우에는 /lang/strings_korean.txt 파일의 내용중 아래 부분을 다음과 같이 수정한다.

   $s_charset = 'cp1252';