Bito Agent 설치 안내 (itensms03)
============================================================

이 묶음에 들어 있는 파일

  Bito-Agent-v1.0.26-linux-amd64.tar.gz      설치 패키지
  agent-config.yaml                          귀사 전용 운영 설정
  first-install.sh                           최초 설치 스크립트
  Bito-Agent-Install-Manual-v1.0.26.pdf      설치 안내서
  checksums.sha256                           무결성 확인값

1. 설치 전 확인

  - 이 서버에서 게이트웨이 주소로 나가는 TCP 연결이 열려 있어야 합니다.
    주소와 포트는 agent-config.yaml의 gateway 항목에 있습니다.
  - DB 계정에 발송 테이블 SELECT 권한과 상태 갱신용 UPDATE 권한이 필요합니다.

2. 설정 파일에서 채우실 항목

  agent-config.yaml의 source 항목(DB 주소·포트·DB명·계정·비밀번호)과
  table·field_map(발송 테이블명과 컬럼 매핑)입니다. 나머지는 그대로 두십시오.

  DB가 TLS 접속만 허용하면 source에 use_tls: true 를 추가하십시오.
  켠 뒤에도 인증서 오류가 나면 아래를 참고하십시오.

    tls_ca_file      CA 파일을 받을 수 있을 때 (그 경로를 적습니다)
    tls_skip_verify  CA 파일을 구할 수 없을 때 (검증만 건너뜁니다)
    tls_server_name  접속 주소와 인증서 이름이 다를 때

  DB 종류에 따라 지원 범위가 다릅니다.

    PostgreSQL
      tls_server_name 을 지원하지 않습니다(지정하면 시작 중단).
      host 를 인증서에 적힌 이름과 같게 지정하십시오.
      tls_ca_file 과 tls_skip_verify 는 함께 쓸 수 없습니다.
      검증을 건너뛰려면 tls_ca_file 을 지우십시오.

    Oracle
      tls_ca_file 을 지원하지 않습니다(지정하면 시작 중단).
      사설 CA 가 필요하면 담당자에게 문의하십시오(wallet 방식).
      tls_server_name 은 지정해도 적용되지 않습니다.
      host 를 인증서에 적힌 이름과 같게 지정하십시오.

  카카오를 사용하시므로 발신프로필 키와 템플릿코드 컬럼을 field_map에
  kakao_sender_key / kakao_template 로 지정해 주셔야 합니다.

3. 설치

  아래 명령 하나면 끝납니다. 별도 인증값은 필요 없습니다.

  sudo bash first-install.sh

  패키지 배치, 파일 설치, 사전 점검, 서비스 등록, 기동 확인을
  차례로 진행합니다.
  사전 점검에서 FAIL이 나오면 서비스를 만들지 않고 그 자리에서 멈춥니다.

4. 상태 확인

  sudo systemctl status bito-agent-itensms03

문제가 생기면 doctor 실행 결과 전문을 담당자에게 보내주십시오.
비밀번호는 가리고 보내주시면 됩니다.

설치 경로 기준: /opt/bito-agent-itensms03
