[설치] nGrinder 3.4 설치 방법

사전 준비 사항

• nGrinder는 Controller는 .WAR 형태의 웹 애플리케이션이고, Agent와 Monitor는 JAVA 애플리케이션임
• JAVA가 실행될 수 있도록 환경변수 PATH를 설정해야 함
• 아래와 같은 포트에 대해서는 방화벽 등 열려있어 접근이 가능해야 함

Agent : Any ==> Controller : 16001

Agent : Any ==> Controller : 12000 ~ 12000+(the number of concurrent tests allowed)

Controller : Any ==> Monitor : 13243

Controller ==> Public user : This is dependent on your tomcat configuration. By default, it is set as 8080.

다운로드

버전 3.4

https://github.com/naver/ngrinder/releases

[참고1] Controller는 JDK 1.7 이상 지원함, Agent는 JDK 1.6 이상 지원함

[참고2] 다운로드된 Controller 파일명은 ngrinder-controller-3.4.war 임

참고로 버전 3.3 이전

http://sourceforge.net/projects/ngrinder/files

JDK 1.6 이상 지원함

Controller 실행 

실행하는 방법에는 아래와 같이 3가지가 있음

1) Docker 상에서 실행

2) 자체 Standalone으로 실행 (기본 port는 8080 임)

   예시) java -XX:MaxPermSize=200m -jar  ngrinder-controller-3.4.war

3) Tomcat 상에 배포하여 사용

   예시) 

          3-1) ${TOMCAT_HOME}/webapps 디렉토리에  ngrinder-controller-3.4.war 파일명을 ROOT.war로 변경하여 저장

          3-2) 기동하는 JAVA Heap 관련 옵션 변경

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

                set JAVA_OPTS=-Xms600m -Xmx1024m -XX:MaxPermSize=200m # for catalina.bat 

          3-3) Tomcat 실행 (startup.sh 또는 startup.bat 이용)

          3-4) 브라우저에서 실행 (http://localhost:8080)

자세한 내용은 "Controller Configuration Guide" 참조할 것

Agent 설치

1. Controller 기동 후에 브라우저에서 "http://localhost:8080"로 접속하여, admin/admin으로 로그인 함

2. 위의 "admin" 메뉴에서 "Download Agent" 메뉴를 선택하면, 다운로드 됨

3. tar 파일 형태로 다운로드 되므로, Windows의 7zip 또는 tar xvf 명령어로 압축을 품

4. Agent 실행 (run_agent.sh 또는 run_agent.bat 파일 이용)

    이때, 반드시 알아두어야 할 사항은 첫번쨰 실행 시에 [사용자홈]/.ngrinder_agent 디렉토리를 생성하여, 설치한 __agent.conf 파일을 복사하고, 두번째 실행 부터는 [사용자홈]/.ngrinder_agent 디렉토리의 agent.conf 파일을 이용하는 것에 주의

5. 기존 구성 파일을 신규 업데이트 하고 싶으면, "-o" 옵션을 이용

    예시)  run_agent.sh -o  또는 run_agent.bat -o

    참고로, run_agent_bg.sh 은 백그라운드로 agent를 실행 

6. Agent 중지 (stop_agent.sh 또는 stop_agent.bat 이용)

7. Controller에서 agent 접속 허용 (2가지 방법)

    1) 관리 콘솔 "Agent Management"에서 "approval" 함

    2) 자동으로 승인하기 위해서는 "__agent.conf" 파일에

        controller.enable_agent_auto_approval=true  설정

8. 기본 설정과 다른 장비에 배포

   1) __agent.conf 파일 설정

agent.controller_host=xx.xx.xx.xx   // Controller가 설치되어 있는 IP로 설정agent.controller_port=16001 agent.region=NONE

   2) tar로 압축하여, 다른 Agent 머신으로 복사

9. 기타 옵션 및 파라미터는  아래 URL에서 참조

* Agent 실행 시 다양한 옵션

https://github.com/naver/ngrinder/wiki/Agent-Configuration-Guide

* 커널 파라미터 권장값

https://github.com/naver/ngrinder/wiki/Installation-Guide