버그 tracking으로 많이 쓰고 있는 Mantis와 dokuWIKI를 상호간에 인증을 포함하여(SSO) 연동시켜 보다 효율적으로 Mantis와 WIKI를 쓰는 방법 KNOW-HOW를 공유하고자 한다. Issue 위주의 tracking 은 mantis에 맡기고, 이로 인한 howto, 제품 및 개발에 관련된 지적재산은 wiki를 통해서 지식을 쌓는 장점이 있다.
기초문서 : Integration DokuWiki with Mantis
설정환경 : CentOS/RHEL 5.0, mantis 1.0.7, Xampp 1.6.2(AMP)
■ 기본적인 순서는
1. Xampp 환경 설정 / 초기 환경 설정
1) Xampp 설치 : CentOS 5.0에 XAMPP 1.6.1 설치 참조
2) PHP 환경 설정 : #vi /opt/lampp/etc/php.ini 하여 memory_limit을 20M 로 상향 조정 (초기 설정 8M)
202 memory_limit = 20M
3) Mantis 설치 : CentOS/RHEL 5.0에 Mantis 설치 참조
4) WIKI 설치 : CentOS/RHEL 5.0에 DokuWIKI 설치 참조
2. DokuWiki 설정
1) 기본 설정
#vi /opt/lampp/htdocs/dokuwiki/conf/dokuwiki.php 에서
— 하단 부분 새로 생성
efine( ‘MANTIS_ROOT’, ‘/opt/lampp/htdocs/mantis/’ ); // file path to Mantis, must terminate with /
define( ‘MANTIS_URL’, ‘http://(hostname을기재)/mantis/’ ); // url to Mantis, must terminate with /
— 하단 부분 설정값 변경
$conf[‘useacl’] = 1;
$conf[‘authtype’] = ‘mantis’;
$conf[‘defaultgroup’] = ‘VIEWER’;
2) SSO 설정 파일 생성(mantis의 인증 체계를 따라감)
# vi /opt/lampp/htdocs/dokuwiki/inc/auth/mantis.class.php 하여 파일 생성 (내용은 여기 내용을 copy & paste할 것)
3) 인증 구성 내용 변경
# vi /opt/lampp/htdocs/dokuwiki/conf/acl.auth.php 의 내용을 변경 (내용은 여기 내용을 copy & paste할 것)
4) mantis plugin 설치
# vi /opt/lampp/htdocs/dokuwiki/lib/plugins/mantis/syntax.php의 내용을 변경 (내용은 여기 내용을 copy & paste할 것)
3. Mantis 설정
1) 환경 설정 변경
# vi /opt/lampp/htdocs/mantis/config_defaults_inc.php 하여 맨 끝부분에 내용을 추가 (내용은 여기 내용을 copy & paste할 것)
2) wiki_api.php 생성
# vi /opt/lampp/htdocs/mantis/core/wiki_api.php 하여 파일을 생성 (내용은 여기 내용을 copy & paste할 것)
3) wiki_dokuwiki_api.php 생성
# vi /opt/lampp/htdocs/mantis/core/wiki_dokuwiki_api.php 하여 파일을 생성 (내용은 여기 내용을 copy & paste할 것)
4) html_api.php 변경
# vi /opt/lampp/htdocs/mantis/core/html_api.php 의 내용에 아래와 같은 내용을 추가
— 하단 부분 새로 생성
59 require_once( $t_core_dir . ‘wiki_api.php’ );
— print_menu() 부분 변경 생성
507 # Project Wiki
508 if ( wiki_is_enabled() ) {
509 $t_current_project = helper_get_current_project();
510 $t_menu_options[] = ‘<a href=”wiki.php?type=project&id=’ . $t_current_project . ‘”>’ . lang_get(
‘wiki’ ) . ‘</a>’;
511 }
512
— 하단 부분 새로 생성
1093 # ——————–
1094 # Print a button to create a wiki page
1095 function html_button_wiki( $p_bug_id ) {
1096 if ( ON == config_get( ‘wiki_enable’ ) ) {
1097 if ( access_has_bug_level( config_get( ‘update_bug_threshold’ ), $p_bug_id ) ) {
1098 html_button( ‘wiki.php’,
1099 lang_get_defaulted( ‘Wiki’ ),
1100 array( ‘id’ => $p_bug_id, ‘type’ => ‘issue’ ),
1101 ‘get’ );
1102 }
1103 }
1104 }
1105
— 하단 부분 변경
856 # ——————–
857 # Print an html button inside a form
858 function html_button ( $p_action, $p_button_text, $p_fields = null, $p_method = ‘post’ ) {
859 $p_action = urlencode( $p_action );
860 $p_button_text = string_attribute( $p_button_text );
861 if ( null === $p_fields ) {
862 $p_fields = array();
863 }
864
865 if ( strtolower( $p_method ) == ‘get’ ) {
866 $t_method = ‘get’;
867 } else {
868 $t_method = ‘post’;
869 }
870
871 PRINT “<form method=”$t_method” action=”$p_action”>n”;
872
873 foreach ( $p_fields as $key => $val ) {
874 $key = string_attribute( $key );
875 $val = string_attribute( $val );
876
877 PRINT ” <input type=”hidden” name=”$key” value=”$val” />n”;
878 }
879
880 PRINT ” <input type=”submit” class=”button” value=”$p_button_text” />n”;
881 PRINT “</form>n”;
882 }
883
884
5) wiki.php 설정
# vi /opt/lampp/htdocs/mantis/wiki.php 하여 파일을 생성 (내용은 여기 내용을 copy & paste할 것)
6) bug_view_page.php 설정
# vi /opt/lampp/htdocs/mantis/bug_view_page.php 하여 파일을 수정
— 하단 부분 추가
61 <!– Title –>
62 <span class=”small”>
63 <?php print_bracket_link( ‘wiki.php?id=’.$f_bug_id, lang_get( ‘wiki’ ) ) ?>
64 </span>
7) bug_view_advanced_page.php 설정
# vi /opt/lampp/htdocs/mantis/bug_view_advanced_page.php 하여 파일을 수정
— 하단 부분 추가
59 <!– Title –>
60 <span class=”small”>
61 <?php print_bracket_link( ‘wiki.php?id=’.$f_bug_id, lang_get( ‘wiki’ ) ) ?>
62 </span>
63
■ 사용 방법은
Mantis로 로그인을 하여 ‘이슈’ 보기를 누르면 상단 이슈 시작 부분에 앙증맞게 ‘wiki’라는 메뉴가 보이고 이 wiki를 클릭하면 dokuwiki로 인증 로그인되어 접속 된다. 이후에는 wiki 문법에 맞추어 작성/ 연결하면 된다.
Technorati Tags: wiki, mantis, dokuwiki
Powered by ScribeFire.