오픈소스 버그 트래킹 도구인 Mantis를 정리 한다.


설치 가이드



설치전 사전 준비 사항

{{wamp 준비}}


Mantis용 DB 설정

{{MySQL DB 설정|Mantis|mantisdb|mantis}}


Mantis 설치

{{Apache 접속 설정|matis}}

  • 다운로드 사이트에서 mantisbt-1.1.6.zip 파일을 다운로드 한다.
    • 압축을 풀어 Apache HTTP Server의 docroot의 mantis 폴더(저는d:/www/mantis)로 복사한다.

  • http://localhost/mantis/로 접속하여 설치를 진행한다.
    • Type of Database : "MySql (default)" 선택
    • Hostname (for Database Server) : localhost
    • Username (for Database) : mantis
    • Password (for Database) : 암호
    • Database name (for Database) : mantisdb
    • Admin Username (to create Database) : root
    • Admin Password (to create Database) : DBMS의 root 사용자 암호
    • Print SQL Queries instead of Writing to the Database : 선택하지 않음
    • "Attempt Installation" 버튼을 선택하여 설치를 시작 한다.

  • 설치가 완료되면 $MANTIS_HOME/admin 폴더를 삭제한다.

  • http://localhost/mantis/로 접속하여 사용한다.
    • administrator / root 사용자로 로그인 한다.



Mantis 설치 후 환경 설정

  • 한글 설정

    • $MANTIS_HOME/config_inc.php를 수정한다.
      $g_default_language = 'korean_utf8';
      $g_back_language = 'korean_utf8';
    • "My Account" 메뉴에서 "Preferences" 탭을 선택 한다.
    • 한단의 Language를 "Korean"로 선택한 후 "Update Prefs" 버튼을 선택 한다.
    • 로그아웃 후 다시 로그인을 하면 한글이 적용된다.

  • 신규 사용자 생성을 위한 메일 계정 설정

    • Mantis에서는 신규 사용자 생성시 암호를 등록하기 위해서는 메일에서 "비밀번호 변경 확인" 메일을 받아 처리 한다. 해당 메일을 받기 위해서는 다음과 같이 작업 한다.
      $MANTIS_HOME/config_inc.php를 수정한다.
      $g_smtp_host = "메일 서버";
      $g_smtp_username = "메일 사용자 아이디";
      $g_smtp_password = "메일 사용자 암호";
      $g_phpMailer_method = 2; // SMTP로 메일보내기
      

    $g_administrator_email = 'temp@jopenbusiness.com'; // 관리자 이메일 계정 $g_webmaster_email = 'temp@jopenbusiness.com'; // 웹 마스터 이메일 계정 $g_from_email = 'temp@jopenbusiness.com'; // 메일 송신시 표시 계정 $g_return_path_email = 'temp@jopenbusiness.com'; // 리턴 메일 받을 계정




사용자 가이드




Mantis 기능

![700px](img/Mantis function.png) {| cellspacing="1" cellpadding="1" border="1" width="100%" |- |width="20%" bgcolor="cyan" align="center" valign="middle"|기능 |width="80%" bgcolor="cyan" align="center" valign="middle"|설명 |- |align="center"|프로젝트 |

  • BTS(Bug Tracking System)인 Mantis는 프로젝트 단위로 이슈를 관리 한다.
  • 프로젝트는 상태와 버전 정보를 가진다.
  • 각각의 프로젝트는 이슈에 대한 분류를 별도로 관리 한다.
    |- |align="center"|이슈/RSS |
  • 이슈는 분류, 중요도, 우선순위, 첨부 파일 등의 정보를 가진다.
  • 각각의 이슈는 상태를 가지는데 접근레벨에 따라 상태의 워크플로우를 설정할 수 있어 권한에 따라 단계적으로 작업을 진행할 수 있다.
  • 이슈와 관련된 각종 통계와 보고서를 제공하고 파일로 다운로드가 가능 하다. (엑셀, 워드, CSV)
  • 이슈는 RSS Feed로 받아 볼 수 있다.
    |- |align="center"|뉴스/RSS |
  • 사용자에게 공지할 사항을 뉴스로 등록하여 공지 한다.
  • 뉴스는 RSS Feed로 받아 볼 수 있다.
    |- |align="center"|사용자 관리 |
  • 사용자를 등록, 수정, 삭제 등 사용자 정보를 관리 한다.
  • 사용자의 설정, 권한 등을 관리 한다.
    |- |align="center"|관리 |
  • 사용자의 접근 레벨로 이슈의 상태에 따른 워크플로우를 설정 한다.
  • 사용자의 성격과 접근 레벨에 따라 이메일 알림을 설정 한다.
  • 접근 레벨 : 볼수만 있음, 보고가능, 갱신가능, 개발자, 매니저, 관리자
  • 사용자 성격 : 이슈를 보고한 사용자, 이슈를 다루고 있는 사용자, 이 이슈를 감시하는 사용자 들, 버그 노트를 추가할 사용자
    |- |align="center"|외부 연동 |
  • Mantis를 Wiki(Mediawiki, xWiki 등)와 연동할 수 있다.
  • Mantis를 이슈 번호로 CVS/Subversion과 연동할 수 있다. 이를 통해 변경이 발생할 때 그 정보가 Matis의 이슈에도 저장 된다.
  • FTP Server 정보를 등록하여 첨부파일을 FTP로 관리할 수 있다.
    |}

Mantis Workflow

  • 프로젝트에 등록된 이슈는 다양한 상태 정보를 가지는데 이를 권한(접근레벨)에 따라 Workflow를 설정하여 관리할 수 있다.
  • 이슈 상태에 대한 Workflow는 프로젝트별로 다르게 설정이 가능하므로 프로젝트의 특성에 맞는 관리가 가능하다.
  • 아래 그림은 오픈소스 비즈니스 컨설팅에서 권장하는 디폴트 상태 Workflow 이다. 이를 참조하여 접근 레벨에 따라 불필요한 연결을 제거하는 방식으로 Workflow를 설정할 수 있다.
    ![700px](img/Mantis workflow.png)

관리자 가이드



JOSSO 적용

SSO (Single-Sign-On) 솔루션인 JOSSO를 적용 한다.

  • 로그인 (login_page.php)
    return : 전환하는 페이지
    -   /core/authenticatin_api.php
        auth_ensure_user_authenticated() : 로그인 확인
    -   login.php
      
  • 로그아웃 (logout_page.php)
    -   /core/authenticatin_api.php
        config_get( 'logout_redirect_page' )


Subversion 연계



참고 문헌


공유하기