🚀 개발 서버 내 JMeter 설치 및 실행 방법
개발 서버 내에 JMeter를 설치하고 실행하는 방법은 크게 두 가지가 있습니다.
1. 독립된 JMeter 설치 (권장)
개발 서버 내에 별도의 디렉토리에 JMeter를 설치하고 **CLI(Command Line Interface)**를 통해 실행하는 방법입니다. 가장 안정적이고 일반적인 방식입니다.
1) JMeter 설치 준비
- Java 설치: JMeter는 Java 기반이므로, 서버에 **Java (JRE 또는 JDK)**가 설치되어 있어야 합니다.
- JMeter 다운로드: Apache JMeter 공식 사이트에서 최신 버전을 다운로드하고 서버의 적절한 위치(예: /opt/apache-jmeter-x.x)에 압축을 풉니다.
- Kafka Plugin 설치: Kafka Consumer 샘플러를 사용하려면, JMeter Plugins Manager를 사용하여 "Kafka" 또는 "Kafka Client" 관련 플러그인(예: )을 설치해야 합니다.
- 로컬 PC에서 테스트 계획(.jmx) 생성: 먼저 로컬 PC의 GUI 모드에서 JMeter 테스트 계획을 만들 때 Plugins Manager로 Kafka 플러그인을 설치하고, 이 테스트 계획 파일(.jmx)을 서버로 전송합니다.
2) 비GUI 모드 실행
서버에서는 리소스를 절약하고 안정적인 성능을 위해 비GUI 모드로 실행해야 합니다.
- 실행 명령어:
- -n: 비GUI 모드로 실행
- -t: 테스트 계획 파일(.jmx) 경로
- -l: 결과 파일(.jtl) 저장 경로
- -e -o: 테스트 종료 후 HTML 리포트 자동 생성 옵션 (권장)
-
Bash
/opt/apache-jmeter-x.x/bin/jmeter -n -t /path/to/your/testplan.jmx -l /path/to/results.jtl -e -o /path/to/html/report
📦 개발 서버로 옮겨야 할 파일 및 경로
1. 옮겨야 할 경로
PC에 설치된 JMeter의 최상위 폴더 전체를 개발 서버의 /opt/ 하위에 복사해야 합니다.
- PC 경로: C:\apache-jmeter-5.6.3\apache-jmeter-5.6.3
- 서버 경로: /opt/apache-jmeter-5.6.3 (또는 원하는 이름)
💡 최상위 폴더 복사 이유: JMeter는 bin, lib, extras 등 여러 디렉토리에 있는 파일들을 참조하여 실행됩니다. 특히 Kafka Consumer 테스트를 위해 설치한 Kafka Plugin 관련 .jar 파일들은 lib/ext 또는 lib 폴더에 위치하므로, 이 모든 파일이 함께 옮겨져야 합니다.
2. 추가로 옮겨야 할 파일
JMeter를 옮긴 후에도 추가로 개발 서버에 전송해야 하는 파일이 있습니다.
| 파일 | 역할 | 위치 (PC) | 위치 (서버) |
| 테스트 계획 파일 | Kafka Consume 시나리오가 담긴 파일 | PC의 아무 경로 (C:\Users\...\KafkaTest.jmx) | 서버의 아무 경로 (예: /home/user/test/KafkaTest.jmx) |
🛠️ 개발 서버로 옮기는 방법 (SCP 사용)
사내 개발 서버는 보통 리눅스(Linux) 환경이며, 파일 전송은 SSH/SCP를 이용하는 것이 가장 안전하고 일반적입니다.
1. 전송 준비: 압축 파일 만들기
전체 폴더를 한 번에 쉽게 옮기기 위해 먼저 JMeter 최상위 폴더를 압축합니다.
- PC의 경로: C:\apache-jmeter-5.6.3\
- apache-jmeter-5.6.3 폴더를 마우스 우클릭하여 .zip 또는 .tar.gz 형식으로 압축합니다. (예: apache-jmeter-5.6.3.zip)
2. 파일 전송 (Windows 기준)
Windows 로컬 PC에서 개발 서버(Linux)로 파일을 전송하는 가장 일반적인 방법은 다음과 같습니다.
A. Secure Copy Protocol (SCP) 사용 (권장)
Windows PowerShell 또는 CMD 환경에서 scp 명령어를 사용할 수 있습니다.
- 전송 명령어 형식:
-
Bash
scp -r [로컬 파일/폴더 경로] [서버 사용자명]@[서버 IP]:[서버 도착 경로] scp -P 2022 C:\apache-jmeter-5.6.3\apache-jmeter-5.6.3.tar hura@10.101.101.95:/opt/
JMeter 파일 압축 해제 및 권한 설정:
cd /svc/testtool/
tar -xf apache-jmeter-5.6.3.tar
chmod +x /svc/testtool/apache-jmeter-5.6.3/bin/jmeter
이제 서버에서 비GUI 모드로 테스트를 실행할 준비가 완료됩니다. 비밀번호를 입력하고 파일 전송을 완료해 주세요!
테스트 실행 명령어 예시:
/svc/testtool/apache-jmeter-5.6.3/bin/jmeter \
-n \
-t /svc/testtool/push_aws.jmx \
-l /svc/testtool/push_aws_test_result.jtl \
-e \
-o /svc/testtool/html_report
| 옵션 | 설명 |
| -n | Non-GUI Mode로 실행 (서버 환경에서는 필수) |
| -t | 테스트할 JMX 파일 경로 지정 |
| -l | 테스트 결과를 저장할 JTL 파일 경로 지정 |
| -e | 테스트 종료 후 HTML 보고서를 생성하도록 함 |
| -o | HTML 보고서를 저장할 디렉토리 지정 (존재하지 않아야 함) |
📦 JMX 파일 권장 이동 (선택 사항)
만약 JMX 파일이 실행에 필요한 최종 파일이라면, JMeter의 bin 디렉토리보다 한 단계 위에 두는 것이 JMeter 파일 구조상 더 좋습니다.
- JMX 파일들을 상위 디렉토리로 이동:이 명령은 JMX 파일들을 /svc/testtool/apache-jmeter-5.6.3/ 경로로 이동시킵니다.
-
Bash
mv *.jmx ..
jmeter로 jmx 스크립트 실행해서 테스트
9982 2025.11.24 13:43:27 10.101.101.192 hura ./jmeter -n -t ../push_aws.jmx -l push_aws_results.jtl
테스트 중단
1) ps -ef | grep 'jmeter' -> kill -9 PID
2) ctrl + c 탈출~
'IT > Backend | All' 카테고리의 다른 글
| DLL지옥 탈출기: 어셈블리 바인딩 실패, Fusion Log Viewer로 범인 찾기 (0) | 2026.02.25 |
|---|---|
| 테스트 더블 |"가짜"라도 다 같은 가짜가 아니다. 5가지 테스트더블, 상황에 맞게 선택하기 (0) | 2026.02.25 |
| 🧪테스트주도개발(TDD) 하기 | Apache Jmeter를 이용한 부하테스트 (1) | 2025.11.19 |
| 비동기 처리의 핵심 | 스레드, 멀티스레드, 큐 (0) | 2025.11.14 |
| 🧪테스트주도개발(TDD) 하기 | JUnit5 단위 테스트 프레임워크 (0) | 2025.11.12 |