문자고 » 문자고 CS 및 기술지원

이건 제이제이입니다.

*문자고 비즈뿌리오(다우기술) 가입 계정 정보
https://www.bizppurio.com/

• Master(운영): itn0204 / aptlwld0276!
• Slave(개발): itn0204_slave / itn0204!

개발가이드: https://bizppurio.github.io/
통합발송모듈: 파일 첨부 O

*인비토 Agent 설치 관련 최종 확인사항

• 현재 인비토측 기술담당자가 외근 중으로 바로 통화는 불가하며, 관련 내용에 대해 메일을 통해 빠른 안내 가능하다고 합니다.
• 해당 설치 파일에 필요한 모든 것이 들어있다고 하여, 함께 첨부드리는 파일 확인 부탁드립니다.

■ 무결성 확인

  압축을 푸신 뒤 먼저 확인해 주십시오.

sha256sum -c checksums.sha256





■ 설치 전 확인

  - 서버에서 edge.hanjulgw.com 9443/TCP 로 나가는 연결이 열려 있어야 합니다.

    인바운드 포트는 열 필요가 없습니다.

  - 데이터베이스 계정에 발송 테이블 SELECT 권한과 상태 갱신용 UPDATE 권한이 필요합니다.

  - 데이터베이스가 TLS 접속만 허용하는 설정이면 agent-config.yaml 의 source 에 use_tls: true 를 추가해 주십시오.





■ 설정 파일 작성

  agent-config.yaml 에서 데이터베이스 접속 정보(source)와 발송 테이블명(table), 컬럼 매핑(field_map)만 귀사 환경에 맞게 입력해 주십시오.

  서비스 주소·포트·인증 토큰은 이미 입력되어 있습니다.

  항목별 설명은 동봉 안내서 3절에 있습니다.





■ 설치

아래 명령 하나면 끝납니다.

sudo bash first-install.sh



  패키지 배치 · 파일 설치 · 사전 점검 · 서비스 등록 · 기동 확인을 차례로 진행합니다.

  사전 점검(doctor)에서 FAIL 이 나오면 서비스를 만들지 않고 그 자리에서 멈추며, 같은 줄에 원인과 고칠 설정 항목이 함께 표시됩니다.





■ 상태 확인

  sudo systemctl status bito-agent-itensms03

  sudo journalctl -u bito-agent-itensms03 -f





■ 문의

진행 중 막히시면 doctor 실행 결과 전문을 보내주세요. 원인 대부분이 그 출력으로 확인됩니다.

  인증 토큰과 데이터베이스 비밀번호는 회신에 남기지 마시고 가려 보내주시면 됩니다.

[root@webwas bito]# sudo bash first-install.sh
[1/5] 패키지 배치
[2/5] 파일 설치
[INFO] 기존 설정을 그대로 둡니다: /opt/bito-agent-itensms03/agent-config.yaml
[3/5] 사전 점검
═══════════════════════════════════════════
  ViTO Agent — doctor
═══════════════════════════════════════════
  Agent ID : itensms03
  Gateway  : edge.hanjulgw.com:9443
  Source   : mysql@1.201.116.6:3306/mjon_advc
  Table    : SMSQ_SEND

[PASS] Config — config 파일을 읽을 수 있습니다
       /opt/bito-agent-itensms03/agent-config.yaml
[PASS] ConfigDir — config 디렉터리를 확인했습니다
       /opt/bito-agent-itensms03
[WARN] LogDir — 로그 디렉터리 점검을 건너뛰었습니다
       --log-dir를 지정하면 서비스 로그 경로 쓰기 권한을 확인합니다
[PASS] FieldMap — 필수 field_map이 모두 설정되어 있습니다
       seq, status, phone, callback, message, msg_type
[PASS] StatusValues — pending/claimed/sent/done/failed 상태값이 확정되어 있습니다
[PASS] StatePolicy — transition_column 모드입니다
       Agent가 고객사 status 컬럼을 claimed/sent/done/failed 단계로 갱신합니다
[PASS] MsgTypeValues — 메시지 타입 값이 설정되어 있습니다
[WARN] SendTime — 예약발송 시간 컬럼이 설정되지 않았습니다
       즉시 발송 전용 테이블이면 허용 가능하지만 고객사 시간 기준을 확인하십시오
[PASS] GatewayToken — gateway.token이 설정되어 있습니다
       length=43
[FAIL] Gateway — GW TCP 연결 실패
       dial tcp 58.227.193.65:9443: i/o timeout
[PASS] DB — 고객사 DB 연결 성공
       mysql@1.201.116.6:3306/mjon_advc · 평문
[PASS] DBClock — DB와 Agent 서버 시각 차이가 허용 범위입니다
       db=2026-09-07T16:24:35+09:00 local=2026-09-07T16:24:35+09:00 skew=0s
[WARN] RuntimeWrite — 런타임 UPDATE 권한 점검을 건너뛰었습니다
       --check-runtime-write를 지정하면 트랜잭션 롤백 기반 probe를 수행합니다
[PASS] DryRun — pending row 조회와 필드 검증 성공
       rows=10

Summary: PASS=10 WARN=3 FAIL=1
[root@webwas bito]#

현재 Fail 이 동일하게 뜨고있으며, outbound 는 0.0.0.0/0 으로 모든것을 열어둔 상태입니다.

해당 상태포함하여 문의 부탁드립니다.
감사합니다.

인비토측 확인 결과, 방화벽 관련하여 문제가 발생했던 것으로 확인되었습니다.
기존 파일 삭제 후 수정 파일로 연동 안내를 받아 함께 첨부드리는 파일 재확인 부탁드립니다.
감사합니다.

인비토 메일 내용 확인 부탁드립니다!

안녕하세요.

인비토 모바일지원팀입니다.



저희 쪽에 Agent 연동 서버 IP를 알려주신게 119.193.215.98입니다.

그런데 접속하는 걸 보면 IP가 1.201.116.44입니다.



저희 등록 IP랑 다른데 확인 부탁드립니다.



또한 저희 쪽으로 넘어오는 패킷을 확인하려고 합니다.

하기 실행 부탁드립니다.

( 실행 시 모니터링이 필요하여 해당 건 실행 시간을 지정하여 알려주시면 감사드리겠습니다. )



timeout 10 bash -c "</dev/tcp/58.227.193.65/9443" && echo "9443 OPEN" || echo "9443 BLOCKED"; curl -sS -m 10 -o /dev/null -w "443=%{http_code}\n" https://edge.hanjulgw.com/



감사합니다.