用戶指南 － Install Guide

  From ：Installation Guide  By JunHo.Yoon

  本文將展示，nGrinder的安裝的確是很是的簡單的。

  最新最簡潔的15分鐘安裝視頻，請猛擊：nGrinder－最簡單且潛力無限的壓力工具

   先決條件    

    nGrinder是Web應用（Controller)和Java應用（Agent）的組合。
    － 安裝nGrinder controller，須要預先安裝JDK1.6和Tomcat6.X或更高版本（3.1版本以後，controller的安裝包已經整合了Tomcat）。
    － 安裝nGrinder agent,只須要預裝JDK1.6。
    若是你還沒有了解controller和agent的含義，請參考架構說明：nGrinder Architecture。

   下載

    nGrinde在Sourceforge提供歷史版本的下載：http://sourceforge.net/projects/ngrinder/files/?source=navbar , 請同時下載controller和agent。
    注：3.1版本以後，controller的安裝包已經整合了Tomcat，所以你能夠看到兩種controller安裝包：
    1. ngrinder-controller-{VersionNumber}-with-tomcat.zip
    2. ngrinder-controller-{VersionNumber}.war

    安裝Controller

    1.安裝Controller是很簡單的，只須要將nGrinder controller的war壓縮包放置到 $/ngrinder-controller-3.1.2-with-tomcat.zip/webapps 文件夾。
    2.在放置好以後，請將下面的項目加入tomcat的 ${TOMCAT_HOME}/bin/catalina.sh(linux) 或catalina.bat（Windows)文件。nGrinder controller使用了大量的庫文件所以須要足夠的PermGem內存空間。    

JAVA_OPTS="-Xms600m -Xmx1024m -XX:MaxPermSize=200m"    # for catalina.sh

    3.而後，使用startup.sh(Linux)或 startup.bat(Windows)運行tomcat。
    4.而後，經過web瀏覽器訪問nGrinder ： http://hostname:8080/ngrinder-controller。 就這樣，你已經準備好使用nGrinder了。
        

     ※想更詳細地配置nGrinder controller，請參考Advanced Controller Configuration。

   安裝Agent       

       

   1. 請確認你安裝了JDK在你的agent機器上，並配置了JAVA_HOME環境變量。 
   2. 安裝agent是很是簡單的。只須要下載agent安裝文件並解壓縮。 
   - Window  :  ngrinder-core-{VersionNumber}-agent-package.zip  
   - Linux  :  ngrinder-core-{VersionNumber}-agent-package.tar.gz  
   3. 解壓縮以後，你會發現ngrinder-core-{VersionNumber}.jar和幾個文件夾。  
   4. 移動到解壓縮過的文件夾並運行下面的命令,請注意須要在nGrinder agent安裝的文件夾下運行：

run_agent.sh 或 run_agent.bat ＆

   5. Agent此時會第一次以monitor模式運行，並在你的帳號的根目錄下建立 .ngrinder_agent文件夾。  
   6. 若是你想以agent模式（壓力生成）運行agent而且鏈接到運行在其餘機器的controller，請先殺掉正在運行的agent。
   7. 而後進入${user.home}/.ngrinder_agent目錄。 
      － Window : C:\Users\{username}\.ngrinder_agent or C:\Users\{username}\.ngrinder_agent 
      － Linux : /home/{username}/.ngrinder_agent

   8. 改變下面的agent.conf文件。 

start.mode=agentagent.console.ip=please specify your controller IP
 #monitor.listen.port=3243#monitor.collector.interval=1
 #monitor.controller.cache.size=128
 #monitor.collector.interval=1 
 #start.mode=agent
 #agent.console.port=7001
 #agent.region=

    9. 再從新運行agent。

run_agent.sh 或 run_agent.bat &

 
   10. 如今agent將試着鏈接controller服務器。 
   11. 當你試圖關閉agent的時候，你能夠運行下面的腳本： 

stop_agent.sh 或 stop_agent.bat &

    12. 爲使agent被識別爲有效，你須要在controller端approve鏈接上的agent。請參考 Administration Guide。

     有時候，Java在一些Linux分發包中可能不能監測到當前的IP，因此controlle有可能無發鏈接到某個agent。最簡單的解決辦法是從/etc/hosts中刪除「127.0.0.1 localhost」，而且添加你的hostname和IP信息。

   
  安裝監控（monitor）

  你須要作的只是用下面的命令行運行相同的agent程序，十分簡單，無需任何其餘步驟。 

run_monitor.sh 或 run_monitor.bat &

   
   nGrinder端口 

   nGrinder使用許多端口來跟agent和monitor通訊。若是其中一些端口被你的防火牆阻止了，你應該向網絡管理員申請開通防火牆下面的端口：   Agent : Any ==> Controller : 16001   Agent : Any ==> Controller : 12000 ~ 12000+(目前併發測試所容許的數字)     * 這是能夠配置的。   Controller : Any ==> Monitor : 13243   Controller ==> Public user : 這個依賴於你的Tomcat配置。默認狀況下的配置是8080。