禅道的安裝使用和更新

1.項目管理工具禅道

1.1.什麼是禅道

禅道由青島易軟天創網絡科技有限公司開發，國産開源項目管理軟體。它集産品管理、項目管理、品質管理、文檔管理、組織管理和事務管理于一體，是一款專業的研發項目管理軟體，完整覆寫了研發項目管理的核心流程。禅道管理思想注重實效，功能完備豐富，操作簡潔高效，界面美觀大方，搜尋功能強大，統計報表豐富多樣，軟體架構合理，擴充靈活，有完善的API可以調用。

1.2.禅道的主要功能

1. 産品管理：包括産品、需求、計劃、釋出、路線圖等功能。
2. 項目管理：包括項目、任務、團隊、版本、燃盡圖等功能。
3. 品質管理：包括bug、測試用例、測試任務、測試結果等功能。
4. 文檔管理：包括産品文檔庫、項目文檔庫、自定義文檔庫等功能。
5. 事務管理：包括todo管理，我的任務、我的Bug、我的需求、我的項目等個人事務管理功能。
6. 組織管理：包括部門、使用者、分組、權限等功能。
7. 統計功能：豐富的統計表。
8. 搜尋功能：強大的搜尋，幫助您找到相應的資料。
9. 擴充機制，幾乎可以對禅道的任何地方進行擴充。
10. api機制，所見皆API，友善與其他系統內建。
11. 在禅道的站點（http://www.zentao.net/download.html）下載下傳新的windows內建運作環境(.exe結尾)。
12. 輕按兩下解壓縮到某一個分區的根目錄，比如c:\xampp，或者d:\xampp， 必須是根目錄。
13. 進入xampp檔案夾，輕按兩下start.bat（新的windows一鍵安裝包右鍵以管理者身份運作 啟動禅道.exe）啟動控制台程式，界面如下： 

2.禅道的安裝

2.1.一鍵安裝包安裝(windows推薦)

2.1.1.下載下傳安裝

 1. 在禅道的站點（http://www.zentao.net/download.html）下載下傳新的windows內建運作環境(.exe結尾)。

2. 輕按兩下解壓縮到某一個分區的根目錄，比如c:\xampp，或者d:\xampp， 必須是根目錄。

3. 進入xampp檔案夾，輕按兩下start.bat（新的windows一鍵安裝包右鍵以管理者身份運作 啟動禅道.exe）啟動控制台程式，界面如下： 

4. 修改apache和mysql的啟動端口(注意：預設系統會自動切換可以使用的端口，如果需要指定特定端口可以按以下步驟操作)：

1)、點選控制台（運作xampp/啟動禅道.exe後出現的控制台）左上角 服務-解除安裝服務；

2)、點選控制台左上角 服務-配置預設端口，修改端口号後儲存；

3)、退出控制台後重新以管理者身份運作 xampp/啟動禅道.exe

4)、點選啟動禅道

2.1.2.啟動并通路禅道

1. 啟動控制台之後，點選“啟動禅道”按鈕，系統會自動啟動禅道所需要的apache和mysql服務。

2. 啟動成功之後，點選“通路禅道”，即可打開禅道環境的首頁。5秒鐘之後，頁面會自動跳轉到禅道的頁面。

2.1.3.相關密碼

1.禅道項目管理軟體的登入帳号是admin,密碼是123456，請登入之後盡快修改自己的密碼。

2.mysql資料庫的管理者帳号是root，密碼為空。(如果您修改了root帳号的密碼，請一定記得修改zentao/config/my.php裡面的資料庫密碼)

3.資料庫管理是使用的phpmyadmin程式，基于安全方面的考慮，隻能在禅道所在的機器上面通路，從其他機器通路會被禁止。（禅道伺服器本機浏覽器通路127.0.0.1，點選資料庫管理。）

2.1.4.關于該環境

1.禅道通路位址為http://禅道機器的ip位址:端口号/zentao/，ip位址換成禅道機器實際的ip位址，端口号換成實際的端口号。

2.該控制台會自動安裝apache和mysql為服務，服務名分别是apachezt, mysqlzt。

3.該環境是從xampp版本精簡而來。

2.1.5.控制腳本啟動

如果無法通過控制台啟動禅道程式，我們還提供了指令行的控制腳本來啟動禅道：

1.切換到xampp\service目錄

2.輕按兩下install.bat這個腳本，系統會自動嘗試安裝apache和mysql為服務，并啟動。

3.安裝成功之後，在這個目錄下面會有port.apache和port.mysql來記錄apache和mysql的端口号，如果您想更改端口，可以将這兩個檔案删掉，重新運作install.bat腳本。

2.2.使用源碼包安裝(各系統通用)

除了我們的一鍵安裝包之外，您還可以通過源碼包安裝的時候來部署禅道的運作環境。

2.2.1.部署PHP、 MySQL運作環境

PHP, MySQL的安裝教程網上很多，不再詳述。但請大家注意下面幾點：

1. 禅道需要使用pdo, pdo_mysql, json, filter這幾個子產品。請大家確定PHP環境有加載這幾個子產品。

2. 推薦使用Linux + Apache + PHP + MySQL組合。Nginx其次，不推薦IIS + PHP組合。

3. 不推薦國内開發的那些WAMP內建運作環境。

4. Linux下面不推薦自己編譯安裝，好使用作業系統自帶的包管理器安裝PHP的運作環境。

2.2.2.下載下傳禅道源代碼

1. 從禅道官網下載下傳禅道新版本的源代碼，以.zip結尾。

2. 将其解壓縮，得到zentaopms目錄。拷貝到webserver對應的目錄，比如Apache的www或者htdocs目錄。

3.通過浏覽器通路http://ip/zentaopms/www/index.php，系統會自動轉入安裝程式。

2.2.3.安裝步驟

3.建立分組和使用者

3.1.建立部門結構

禅道安裝成功之後，管理者的第一件要做的事情就是設定部門結構。

1.以管理者身份登入。

2.進入組織視圖

3.選擇部門維護。

4.在部門維護頁面，維護公司的組織結構即可。

3.2.        添加一個賬号

部門建立之後，下一步的操作就是往系統中添加使用者。步驟如下：

1.進組織視圖

2.選擇使用者清單

3.然後選擇“添加使用者”，即可進入添加使用者頁面。

4.使用者添加完之後，即可将其關聯到某一個分組中。

注意點：

1.從4.0版本開始增加了職位字段，在添加帳号的時候可以選擇對應的職位。職位會影響到指派清單的順序，比如建立bug的時候，預設會把研發職位的同學放在前面。職位還會影響到我的地盤裡面内容的排列順序。比如産品經理角色的人登入之後，我的地盤首先會顯示我的需求，而研發的同學登入之後，會看到我的任務。

2.使用者的權限都是通過分組來獲得的，是以為使用者指定了一個職位之後，還需要将其關聯到一個分組中。

3.其中源代碼送出帳号是subversion或者其他源代碼管理系統中對應的使用者，如果沒有啟用subversion內建功能，可以留白。

3.3.批量維護賬号

從4.0版本開始，我們提供了批量添加帳号的功能，可以很友善的批量建立帳号。

1.使用管理者登入禅道系統，進入“組織”頁面。

2.選擇“使用者”，然後選擇右側的“批量添加”

除了批量添加使用者，還可以在使用者清單頁面選擇使用者，進行批量編輯。

3.4.設定分組，建立權限體系

在禅道中，使用者權限都是通過分組來獲得的。是以在完成部門結構劃分之後，就應該建立使用者分組，并為其配置設定權限。有的朋友可能會問，使用者分組和部門結構有什麼差別？我們來解釋下這個問題。

部門結構是公司從組織角度來講的一個劃分，它決定了公司内部人員的上下級彙報關系。而禅道裡面的使用者分組則主要用來區分使用者權限。二者之間并沒有必然的關系。比如使用者A屬于産品部，使用者B屬于研發部，但他們都有送出bug的權限。

3.4.1.建立分組

1.使用管理者登入禅道，進入組織視圖。

2.選擇權限分組，進入分組的清單頁面。

3.點選新增，即可建立分組。

4.在這個分組清單頁面，還可以對某一個分組進行權限的維護、成員維護、或者複制。

3.4.2. 維護權限

1.管理者身份登入

2.進入組織試圖

3..點選”權限分組“，進入權限分組清單頁面。

4..選擇某一個分組，點選“權限維護”，即可維護該分組的權限。

5.點選某一個子產品名後面的複選框，可以全選該子產品下面的所有權限，或者全部取消選擇。還可以檢視某一個版本新增的權限清單，即下圖的紅框位置

6.禅道7.2.stable版本開始，還提供視圖維護權限。可以設定某個分組僅能檢視某個産品或者項目等

7..限制通路框裡填寫了相關内容，就是表示該分組僅有權限通路限制通路框裡的内容。

3.4.3.維護成員

1.管理者身份登入

2.進入組織視圖中的權限分組。

3.點選”成員維護“，進入使用者維護頁面

3.4.4.其他快捷的操作

除了上面所講的按照維護權限和維護帳号操作外，還可以通過複制或者“按照子產品來維護”權限。複制操作很簡單，選擇某一個分組，然後點選後面的複制操作，即可。下面我們來講下按照子產品來配置設定權限。

1.管理者身份登入

2.進入組織視圖中的權限分組。

3.點選頁面右上方的“按子產品配置設定權限”按鈕。

可以将某一個子產品的多個方法同時配置設定給多個分組。

4.工具的版本更新

在公司的配置管理伺服器上，安裝有版本管理工具Subversion、變更管理工具JIRA和項目管理工具禅道，它們都有固定的版本，當這兩個工具出現新版本時，我們要考慮以下幾項：

1.工具新釋出的版本與伺服器中安裝的版本的相容性；

2.工具中安裝的一些插件是否仍可用：工具新版本釋出時，安裝在工具中的老版本的插件是否仍繼續可用，或插件的版本更新後與此工具的相容性等；

3.工具版本更新前，要做好保留老版本工具的安裝程式和對其中的資料的備份工作，以便新版本出現各種問題時仍更換為老版本。

5.禅道的更新

5.1.windows一鍵安裝包的更新

如果你現在使用的是windows xampp 內建運作環境，那麼請按照下面的步驟進行：

5.1.1.更新步驟：

1. 下載下傳新的源代碼包(zip格式)。（注意，不是.exe的內建運作環境，如果你下載下傳這個，會造成資料被覆寫）
2. 将其解壓縮到zentao安裝目錄下面的/xampp/zentao下面。比如你原來是在c:/xampp/目錄下面，那麼将源代碼包解壓縮到c:/xampp/zentao，覆寫原來xampp/zentao目錄下面的東西（操作方法：在zentaopms/下面的所有檔案覆寫到 xampp/zentao/ 下面）。

3. 然後通路http://localhost/zentao/upgrade.php，按照頁面提示進行更新就可以了。

   如果是88端口的話，路徑是http://localhost:88/zentao/upgrade.php

5.1.2.注意事項

1. 不要解壓縮成c:/xampp/zentao/zentao)
2. 不要将原來的程式移走，再解壓縮新的版本，注意是覆寫！
3. 不要下載下傳.exe的一鍵安裝包覆寫。
4. 如果你使用的一鍵安裝包版本比較舊，還需要修改下apache的配置。

編輯\xampp\apache\conf\httpd.conf檔案。

AccessFileName .htaccess

将.htaccess改為.ztaccess，然後重新啟動apache服務。

5.2.通過源代碼方式更新(通用)

5.2.1.更新步驟

1. 在禅道網站下載下傳新版本的源碼包，以.zip結尾。
2. 解壓縮新的程式，覆寫到原來的目錄。比如之前禅道安裝的目錄是在c:\xampp\zentao下面，則将代碼覆寫到c:\xampp\zentao，操作方法：zentaopms/ 下面複制所有的檔案到 xampp/zentao/ 下面粘帖。
3. 執行更新程式。假設禅道的通路路徑是http://192.168.1.99/zentao/，更新路徑為http://192.168.1.99/zentao/upgrade.php。
4. 根據向導，選擇對應的版本，按照提示進行即可。
5. 不要将原來的程式移走，再解壓縮新的版本，注意是覆寫！不要拷貝成c:\xampp\zentao\zentao
6. 注意：不要下載下傳.exe結尾的程式進行更新，那樣子會覆寫原來的資料！

5.2.2.插件相容問題

如果更新之前有安裝過第三方朋友開發的插件，需要注意檢查下是否和新版本的禅道相容。如果發現更新之後無法通路，可以用下面的方法來解決：

1.将原來的禅道目錄備份。

2.下載下傳新的源碼包，改名為zentao。

3.将原來備份目錄中的config/my.php和www/data目錄分别拷貝到新下載下傳的源碼包目錄中，my.php是配置檔案，www/data是附件