禪道的安裝使用和升級

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是附件