이 문서는 Redmine의 관리자에 대한 일반적인 가이드를 제공한다.

1. Projects

Administration > Projects에서는 기본적으로 모든 Active 프로젝트의 리스트를 보여준다. 모든 프로젝트를 확인하기 위해서는 Filters의 Status를 All로 변경할 수 있다.

프로젝트 리스트에서 프로젝트를 선택하면 각 프로젝트의 settings로 이동하며, 프로젝트에 대한 정보를 수정할 수 있다.

1.1 프로젝트 상태

레드마인에서 프로젝트 상태는 다음과 같이 분류 될 수 있다.

• Active : 프로젝트가 정상적으로 운영되고 있는 상태
• Closed : 프로젝트가 Read Only인 상태
• Archived : 사용자에게 더이상 보이지 않는 상태

1.2 프로젝트 생성

새로운 프로젝트를 만들기 위해 프로젝트 메뉴의 상단의 New project 링크를 선택한다. 혹은 프로젝트 리스트에서 복사를 희망하는 프로젝트에서 Copy 링크를 선택하면 해당 프로젝트의 정보를 복사하여 프로젝트를 생성할 수 있다.

• Name : 프로젝트 이름을 설정한다.
• Description : 프로젝트에 대한 설명을 설정한다.
• Identifier : 프로젝트 식별자를 설정한다.
• Homepage : 관련 홈페이지의 링크를 설정한다.
• Public : 프로젝트를 공용으로 설정한다.
• Subproject of : 서브프로젝트로 설정한다.
• Inherit members : 사용자를 상속 받는다.
• Modules : 프로젝트에 활성화하기를 원하는 모듈을 선택한다.
• Tracker : 프로젝트에서 사용하기 원하는 이슈 타입을 선택한다.
• Custom fields : 프로젝트에서 사용하기 원하는 커스텀 필드를 선택한다.

1.3 프로젝트 삭제

프로젝트를 삭제를 위해 프로젝트 리스트에서 삭제를 원하는 프로젝트의 Delete 링크를 선택해준다. 

2. Users

Administration > Users에서 사용자 리스트와, 상태 관리, 정보수정, 추가, 삭제 등을 수행할 수 있다.

2.1 사용자 검색

기본적으로 active되어 있는 사용자가 표시되며, 전체 사용자 리스트를 보기위해서는 Filters에서 Status를 변경하면 된다. 다음 그림은 사용자 리스트 조회 화면을 보여준다.

2.2 사용자 정보 수정

사용자 리스트에서 특정 사용자 Login 아이디를 선택하면, 해당 사용자의 정보를 수정할 수 있다. 

Information 

• Login : 로그인 아이디
• First name : 이름
• Last name : 성
• Email : 이메일
• Language : 사용하고자 하는 언어 선택
• Administrator : 관리자 권한 여부

Email notifications

• For any event on all my projects
  
  • 나의 모든 프로젝트의 알림을 받음
• For any event on the selected projects only...
  • 선택된 프로젝트만 알림을 받음
• Only for things I watch or I'm involved in
  • 내가 포함되어 있거나 보고 있는 이슈
• Only for things I am assigned to 
  • 내가 할당된 이슈
• Only for things I am the owner of
  • 내가 소유자인 이슈
• No events
  • 받지 않음
• I dont want to be notified of changes that I make myself
  • 내가 만든 수정에 대한 알림을 받지 않음

Preferences

• Hide my email address : 이메일 주소 숨김
• Time zone : 표시를 원하는 시간 대역
• Display comments : 코멘트 출력 방식
• Warn me when leaving a page with unsaved text : 저장 알림

Authentication

• Authentication mode
  • 내부 사용자 관리를 사용할지? 아니면 외부 Directory를 선택

2.3 사용자 추가

새로운 사용자를 추가하기 위해서는 사용자 리스트 페이지에서 New user 링크를 선택한다.

2.4 사용자 삭제 혹은 Lock

사용자를 삭제하기 위해서 사용자 리스트이 끝 컬럼에서 Delete 버튼을 선택한다.

사용자를 Lock하기 위해서는 사용자 리스트의 끝 부분 컬럼에서 Lock 버튼을 선택한다. 사용자 Lock은 해당 사용자의 로그인 및 접근 제한, 이슈 할당 제한, Watcher 제한, 이메일 노티 제한, 그리고 프로젝트 멤버에서 보여지지 않는다.

3. Groups

Administration > Groups 에서는 레드마인에서 사용될 수 있는 그룹을 생성 및 삭제하고 해당 그룹에 사용자를 할당할 수 있다.

다음 그림은 Groups 페이지에 대한 예제를 보여준다.

3.1 Group 생성

새로운 그룹을 생성하기 위해 Groups 리스트의 상단의 New group 링크를 선택한다. 적절한 그룹 명을 입력하고 하단 Create 버튼을 클릭한다.

생성한 그룹명은 리스트에서 변경을 원하는 특정 그룹을 선택하고 General 탭에서 그룹명 변경 후 Save 버튼을 클릭한다.

3.2 Group에 사용자 할당

그룹에 사용자를 할당하기 위해, 리스트에서 특정 그룹을 선택하고 Users 탭에서 New user 링크를 통해 사용자를 추가한다. 

다음 그림은 Group에 사용자를 추가하는 예제를 보여준다.

특정 그룹을 프로젝트로 할당하기 위해 Projects 탭에서 Add Projects 링크를 클릭 후 적용을 원하는 프로젝트와 Roles을 선택한다.

3.3 Group 삭제

특정 그룹을 삭제하기위해 프로젝트 리스트에 Delete 버튼을 클릭한다.

4. Roles and Permissions

Administration > Roles and Permissions에서는 프로젝트에서 사용되는 사용자의 역할과 해당 역할에 대한 권한을 설정할 수 있다.

4.1 새로운 역할 추가

새로운 역할을 추가하기 위해 상단 New role 링크를 선택한다.

공통

• Name : 새로운 역할 이름
• Issues can be assigned to this role : 역할에 이슈 할당
• Issue visibility : 볼 수 있는 이슈들
• Time logs visibility : 볼 수 있는 타임로그
• Users visibility : 볼 수 있는 사용자
• Copy workflow from : 워크플러우 복사 대상

Permissions

• Project : 프로젝트 관련 권한
• Forums : 포럼 관련 권한
• Calendar : 달력 관련 권한
• Documents : 문서 관련 권한
• Files : 파일 관련 권한
• Gantt : Gantt 관련 권한
• Issue tracking : 이슈 트래킹 관련 권한
• News : 뉴스 관련 권한
• Repository : 저장소 관련 권한
• Time tracking : 타임 트래킹 관련 권한
• Wiki : 위키 관련 권한

4.3 Permissions Report

Permissions Report를 통해 각 역할 별로 권한을 표로 보거나 부여할 수 있다. 

4.4 역할 삭제

각 역할은 역할 리스트에서 Delete 버튼을 통해 삭제할 수 있다.

5. Tracker

Administration의 Tracker에서는 레드마인에서 사용하는 이슈 타입(Tracker)의 리스트를 확인할 수 있다. 

5.1 새로운 이슈타입 추가

새로운 이슈타입을 만들기 위해 상단 New tracker 링크를 선택한다. 

공통

• Name : 이슈타입의 이름
• Default status : 이슈가 생성되었을 때 기본 상태
• Issues displayed in roadmap : 로드맵에 표시 여부
• Standar fields : 이슈에 사용할 표준 필드
• Custom fields : 이슈에 사용할 커스텀 필드
• Copy workflow from : 워크플로우를 복사할 대상

프로젝트

프로젝트에 영역에서는 해당 이슈를 적용할 프로젝트를 선택한다.

5.2 Summary

상단 Summary 링크를 선택하면, 다음 그림과 같이 이슈 타입 별로 사용하는 필드의 리스트를 보거나 선택할 수 있다.

6. Issue statuses

Administration의 Issue statuses에서는 Redmine 이슈에서 사용하는 이슈의 상태의 리스트를 확인할 수 있다. 

6.1 새로운 상태 추가

새로운 상태를 추가하기 위해서 상단 New status 링크를 선택한다. New status 화면이 나타나면 이슈 제목을 선택하고 해당 상태가 Closed를 나타내는지 여부를 체크해서 Create를 선택한다.

7. Workflow

Administration의 Workflow에서는 역할 별 이슈 타입의 워크플로우를 선택할 수 있다.

7.1 Workflow 수정

워크플로우를 수정하기 위해 상단  Role에서 수정하고자하는 역할을 선택하고 Tracker에서 수정을 원하는 이슈를 선택한다.

좌측은 현재 상태이고 우측 상단의 상태들은 이동할 수 있는 상태를 나타낸다.

만약 진행에서 해결로 이동하기를 원하면 진행을 체크하면 된다.

7.2 Fields Permissions

Workflow 상태별로 접근할 수 있는 필드를 설정하기 위해서는 Fields permissions 탭을 선택한다.

이 역시 상태 별로 해당 필드를 Edit 모드로 할지? Read only로 할지?를 선택한다.

8. Custom fields

레드마인에서는 기본 레드마인 표준 필드 외에 추가적인 정보를 포함할 수 있는 커스텀 필드를 제공한다.

8.1 Custom fields 생성

새로운 커스텀 필드를 생성하기 위해 Administration > Custom fields > New custom field를 선택한다.  New custom field 페이지가 나타나면 먼저 커스텀 필드의 범주를 선택한다. 

Select the type of object to which the custom field is to be attached :

• Issues : 이슈
• Spent time : 시간
• Projects : 프로젝트
• Versions : 버전
• Documents : 문서
• Users : 사용자
• Groups : 그룹
• Activities : 활동
• Issue priorities : 이슈 우선순위
• Document categories : 문서 카테고리

다음 정보를 참고하여 필요한 정보를 선택한다. 

• Format : 지원되는 Format은 다음과 같다. 
  • Boolean : 체크박스
  • Date : 날짜
  • Float : floating 포인트 수
  • Integer : 양수 혹은 음수
  • Link : URL
  • List : 드랍다운 리스트
  • Long Text : 멀티라인 텍스트 
  • User : 사용자
  • Version : 버전
• Name : 필드명
• Description : 설명
• Min - Max length : 최소 - 최대 길이
• Regular expression : 정규표현식 적용
• Text formatting : 선택 시, 위키 문법 지원
• Default value : 기본가격
• Link values to URL : 다음과 같은 변수를 사용하는 URL 생성
  • %value% : 커스텀 필드 값
  • %Id% : 커스텀 오브젝트의 아이디
  • %project_id% : 커스터마이즈된 오브젝트의 프로젝트 아이디
  • %project_identifier% : 커스터마이즈된 오브젝트의 프로젝트의 식별자 
  • %m1%, %m2% : 커스텀 필드 정규식에 매치되는 그룹 캡처
• Required : 이슈를 생성하거나 저장하기 위해 요구되는 필드
• For all projects : 만약 체크된다면, 모든 프로젝트를 위해 사용된다.
• Searchable : 레드마인에서 검색 가능한지 여부
• Visible : 사용자 프로파일 여부

9. Enumerations

Enumeration은 Document categories, Issue priorities, Activities(time tracking)에서 사용되는 Enumerations 값을 설정한다. 

9.1 Enumerations 추가

각 Enumerations에 값을 추가하기 위해 하위에 New value 링크를 선택한다. 

다음 항목을 참고하여 입력하고 Create 버튼을 클릭한다.

• Name : 새로운 Enumerations 값을 입력
• Active : 체크 시 활성화 된다.
• Default value : 기본 값으로 설정한다.

9.2 Enumerations 삭제

리스트에서 삭제를 원하는 아이템에서 Delete 버튼을 클릭한다.

10. Settings

Settings에서는 레드마인의 전역에 적용될 수 있는 다양한 설정을 변경할 수 있게 해준다. 설정을 위해 Administration > Settings를 선택한다.

10.1 General

General 탭에서는 다음에 대한 설정을 적용할 수 있다. 

• Application title : 레드마인 헤딩에 나타나는 제목
• Welcome text : 레드마인 홈페이지에 표시되는 텍스트로 HTML을 지원한다.
• Attachment max. size : 업로드 파일의 최대 사이즈
• Objects per page options : Issues, Comments 등 페이지에 보여지는 기본 숫자
• Days displayed on project activity : 프로젝트 엑티비티 내의 보여주는 일 수
• Host name and path : 레드마인 서버의 호스트 이름과 경로
• Protocol : 접속을 위한 프로토콜 http 혹은 https
• Text formatting : 텍스트 필드의 에디터를 위한 포멧 
• Cache formatted text : 포멧 텍스트의 캐싱 활성화
• Wiki history compression : 위키 히스토리 저장소의 압축 활성화
• Feed content limit : RSS 피드에 포함되는 최대 피드 수
• Max size of text files displayed inline KB : 텍스트 파일의 최대 사이즈
• Max number of diff lines displayed : 변경 라인 최대 수

10.2 Display

Display 탭에는 다음에 대한 설정을 적용할 수 있다. 

• Theme : 커스텀 테마를 선택할 수 있게 해준다. 
• Default language : 기본 언어 설정
• Date format : 날짜 포멧
  • Based on user's language : 사용자 언어에 따라 설정됨
  • Other formats : 사용자가 설정한 포멧
• Time format : 타임 포멧
  • Based on user's language : 사용자 언어에 따라 설정됨
  • Other foramts : 사용자가 설정한 포멧
• Users display format : username이 보여지는 방식
• Use Gravatar user icons : Gravatars 사용자 아이콘 사용
• Default Gravatar image : 기본 Garavatar 이미지

10.3 Authentication

Authentication 탭에는 다음에 대한 설정을 적용할 수 있다. 

• Authentication required : 체크되어 있다면, anonymous 사용자의 페이지 접근을 차단
• Autologin : 자동으로 로그인 기간 혹은 기능 사용 여부
• Self-registration : 이 옵션은 회원가입을 활성화 하거나 비활성화할 수 있음
• Minimum password length : 최소 패스워드 길이
• Lost password : 이 옵션이 체크되어 있다면, 패스워드 찾기 기능이 활성화 된다.
• Allow OpenID login and registration : OpenID 로그인과 등록 가능 여부
• Session expiration : 
  
  • Session maximum lifetime : 세션의 최대 라이프 타임 설정
  • Session inactivity timeout : 비활동 시 세션 타임아웃 설정 

10.4 Projects

Project 탭에서는 다음에 대한 설정을 적용할 수 있다. 

• New projects are public by default : 새로운 프로젝트의 공개 여부
• Default enabled modules for new projects : 새로운 프로젝트를 위한 기본적으로 활성화되는 모듈 설정
• Default trackers for new projects : 새로운 프로젝트를 위한 기본 이슈 타입 설정
• Generate sequential project identifiers : 이 옵션을 사용 시, 레드마인의 식별자를 순차적으로 생성함
• Role given to a non-admin user who creates a project : 관리자가 아닌 역할에 프로젝트 생성 권한을 부여함.

10.5 Issue tracking

Issue tracking 탭에서는 다음에 대한 설정을 적용할 수 있다. 

• Allow cross-project issue relations : 설정 시 다른 프로젝트로부터 이슈들 사이의 관계를 생성할 수 있다.
• Link issues on copy : 복사한 이슈의 링크 여부
• Allow cross-project subtasks : 서브 태스크에 대한 제한
• Allow issue assignment to groups : 이슈를 그룹에 할당하는 것을 허락
• Use current date as start date for new issues : 새로운 이슈를 생성 시, 현재 시점을 시작 날짜로 사용
• Display subprojects issues on main projects by default : 설정 시, 서브 프로젝트의 이슈는 메인 프로젝트의 리스트에 보여짐
• Calculate the issue done ratio with : 이슈 완료 % 설정
• Non-working days : 휴일 설정
• Issues export limit : 이슈 Export 제한
• Maximum number of items displayed on the gantt chart : 간트차트에 출력되는 최대 아이템의 수
• Default columns displayed on the issue list : 이슈 리스트에 보여지는 기본 컬럼

10.6 Email notifications

Email notifications 탭에서는 이메일 알림과 관련되 다음 설정을 적용할 수 있다. 

• Emission email address : 알림 이메일의 From에 사용되는 이메일 주소
• Blind carbon copy recipients(bcc) : 설정 시, 이메일은 숨은 참조로 알림을 보낸다.
• Plain text mail (no HTML) : 설정 시, 이메일은 text 모드로 보내진다.
• Default notification option : 기본 알림 설정
• Select actions for which email notifications should be sent : 이메일 알림 액션 설정
• Email header : 이메일 헤더 설정
• Email footer : 이메일 푸터 설정

10.7 Incoming emails

Incoming emails 탭에는 다음 설정을 적용할 수 있다. 

• Truncate emails after one of these lines : incoming 메일로부터 signatures 제거 사용
• Exclude attachments by name : 첨부파일 제거
• Enable WS for incoming emails API key : 레드마인은 이메일로부터 이슈 생성 혹은 커멘트 작성을 구성할 수 있으며, 이를 위해 받는 메일의 API를 활성화해아 한다.

10.8 Repositories

Repositories 탭에는 다음 설정을 적용할 수 있다.

• Enabled SCM : 프로젝트에 연결할 수 있는 SCM 설정
• Fetch commits automatically : 저장소로 부터 자동으로 새로운 버전의 리비전을 가져온다.
• Enable WS for repository management : 자동 SVN 저장소 생성 스크립트가 설치되어 있다면, 활성화할 수 있다.
• Maximum number of revisions displayed on file log : 파일 로그에 보여지는 최대 리비전 수
• Referencing keywords : Commit 메시지에서 이슈와 연계를 위해 참조할 키워드
• Allow issues of all the other projects to be referenced and fixed : 다른 프로젝트의 이슈와의 연계
• Enable time logging : Commit 메시지로부터 타임 로깅 허락
  • ex) Implement feature #1234 @3h15m
• Activity for logged time : Time logging을 위한 Activity 설정

11. LDAP authentication

레드마인은 LDAP을 통한 사용자 인증 기능을 제공하고 있다. 이를 설정하기 위해 Administration > LDAP authentication 메뉴를 선택한다.

11.1 New authentication mode

새로운 LDAP 인증 모드를 생성하기 위해 상단 New authentication mode를 선택한다.

• Name : 디렉토리 별칭 명
• Host : LDAP 호스트 네임
• Port : LDAP 포트
• Account : LDAP에 읽기 접근을 위한 사용자이름 
• Password : 계정을 위한 패스워드
• Base DN : LDAP 디렉토리 트리의 최상위 레벨의 DN
• LDAP filter : LDAP 적용을 위한 Filter
• Timeout : 타임아웃 시간
• On-the-fly user creation : 체크 시, 특정 LDAP 사용자가 레드마인에 로그인 시 레드마인 계정이 생성됨
• Login attribute : 로그인에 사용될 아이디 매핑
• Firstname attribute : 이름 매핑
• Lastname attribute : 성 매핑
• Email attribute : 이메일 매핑

12. Plugins

Plugins 메뉴에는 현재 설치되어 있는 플러그인의 리스트와 구성을 설정할 수 있게 해준다.

13. Information

설치된 레드마인의 정보를 확인할 수 있다.

14. 알림 메일 구성

이메일 구성은 configuration.yml에서 설정할 수 있다. 다음은 구글 이메일을 보내는 메일로 설정한 예제를 보여주고 있다. 

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      enable_starttls_auto: true
      address: "smtp.gmail.com" 
      port: '587'
      domain: "smtp.gmail.com" 
      authentication: :plain
      user_name: "your_email@gmail.com" 
      password: "your_password" 

다음은 지원되는 이메일 인증(authentication) 방식을 보여준다.

• nil
• plain
• login
• cram_md5

다음은 지원되는 이메일 발송 방식(delivery_method)을 보여준다.

• smtp
• sndmail
• async_smtp
• async_sendmail

15. 참고도서

다음은 참고할 수 있는 레드마인 도서를 보여준다.