禪道的安裝使用和升級
注：本文參考禪道官網的使用手冊；
1.專案管理工具禪道
1.1.什麼是禪道
禪道由青島易軟天創網路科技有限公司開發，國產開源專案管理軟體。它集產品管理、專案管理、質量管理、文件管理、組織管理和事務管理於一體，是一款專業的研發專案管理軟體，完整覆蓋了研發專案管理的核心流程。禪道管理思想注重實效，功能完備豐富，操作簡潔高效，介面美觀大方，搜尋功能強大，統計報表豐富多樣，軟體架構合理，擴充套件靈活，有完善的API可以呼叫。
1.2.禪道的主要功能
- 產品管理：包括產品、需求、計劃、釋出、路線圖等功能。
- 專案管理：包括專案、任務、團隊、版本、燃盡圖等功能。
- 質量管理：包括bug、測試用例、測試任務、測試結果等功能。
- 文件管理：包括產品文件庫、專案文件庫、自定義文件庫等功能。
- 事務管理：包括todo管理，我的任務、我的Bug、我的需求、我的專案等個人事務管理功能。
- 組織管理：包括部門、使用者、分組、許可權等功能。
- 統計功能：豐富的統計表。
- 搜尋功能：強大的搜尋，幫助您找到相應的資料。
- 擴充套件機制，幾乎可以對禪道的任何地方進行擴充套件。
- api機制，所見皆API，方便與其他系統整合。
- 雙擊解壓縮到某一個分割槽的根目錄，比如c:\xampp，或者d:\xampp， 必須是根目錄。
- 進入xampp資料夾，雙擊start.bat（新的windows一鍵安裝包右鍵以管理員身份執行 啟動禪道.exe）啟動控制面板程式，介面如下：
2.禪道的安裝
2.1.一鍵安裝包安裝(windows推薦)
2.1.1.下載安裝
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.升級步驟：
- 下載新的原始碼包(zip格式)。（注意，不是.exe的整合執行環境，如果你下載這個，會造成資料被覆蓋）
- 將其解壓縮到zentao安裝目錄下面的/xampp/zentao下面。比如你原來是在c:/xampp/目錄下面，那麼將原始碼包解壓縮到c:/xampp/zentao，覆蓋原來xampp/zentao目錄下面的東西（操作方法：在zentaopms/下面的所有檔案覆蓋到 xampp/zentao/ 下面）。
5.1.2.注意事項
- 不要解壓縮成c:/xampp/zentao/zentao)
- 不要將原來的程式移走，再解壓縮新的版本，注意是覆蓋！
- 不要下載.exe的一鍵安裝包覆蓋。
- 如果你使用的一鍵安裝包版本比較舊，還需要修改下apache的配置。
編輯\xampp\apache\conf\httpd.conf檔案。
AccessFileName .htaccess
將.htaccess改為.ztaccess，然後重新啟動apache服務。
5.2.通過原始碼方式升級(通用)
5.2.1.升級步驟
- 在禪道網站下載新版本的原始碼包，以.zip結尾。
- 解壓縮新的程式，覆蓋到原來的目錄。比如之前禪道安裝的目錄是在c:\xampp\zentao下面，則將程式碼覆蓋到c:\xampp\zentao，操作方法：zentaopms/ 下面複製所有的檔案到 xampp/zentao/ 下面粘帖。
- 執行升級程式。假設禪道的訪問路徑是http://192.168.1.99/zentao/，升級路徑為http://192.168.1.99/zentao/upgrade.php。
- 根據嚮導，選擇對應的版本，按照提示進行即可。
- 不要將原來的程式移走，再解壓縮新的版本，注意是覆蓋！不要拷貝成c:\xampp\zentao\zentao
- 注意：不要下載.exe結尾的程式進行升級，那樣子會覆蓋原來的資料！
5.2.2.外掛相容問題
如果升級之前有安裝過第三方朋友開發的外掛，需要注意檢查下是否和新版本的禪道相容。如果發現升級之後無法訪問，可以用下面的方法來解決：
1.將原來的禪道目錄備份。
2.下載新的原始碼包，改名為zentao。
3.將原來備份目錄中的config/my.php和www/data目錄分別拷貝到新下載的原始碼包目錄中，my.php是配置檔案，www/data是附件