파일을 이용한 callhome.ini 모니터링 시스템
‘Call Home’ 기능은 파일 callhome.ini 내의 구성 매개변수를 사용하여 사전 예방적 모니터링 및 자동 원격 측정 기능을 위한 데이터 수집, 전송 및 보관 설정을 제어합니다.
개요
Call Home 구성 파일(callhome.ini)은 인스턴스 디렉터리의 하위 /srvmon 디렉터리에 있습니다. 이 파일은 데이터 수집 간격, 전송 설정, 보관 정책 및 하드웨어 식별 정보를 포함하여 ‘Call Home ’ 기능의 모든 측면을 제어합니다.
설정 변경 사항이 적용되려면 서버를 다시 시작해야 합니다.
구성 파일 위치
구성 파일은 다음 위치에 있습니다:
Linux 그리고 AIX : instance-path/srvmon/callhome.ini
Windows: instance-path\srvmon\callhome.ini
callhome.ini참고:, servermon.ini, 및 commands.ini 파일은 디렉터리에 <instance-path>/srvmon/ 있습니다. callhome.ini 파일을 수동으로 업데이트한 경우, 구성 변경 사항을 적용하려면 서비스를
servermon 다시 시작하십시오.구성 매개변수
다음 표에는 사용 가능한 모든 Call Home 구성 매개변수가 설명되어 있습니다:
| 매개변수 | 기본값 | 필수 | 설명 |
|---|---|---|---|
| callhome_enabled_tickers | inventory |
예 | 활성화된 데이터 수집 모듈을 지정합니다. 이 inventory 티커는 하드웨어 세부 정보, 소프트웨어 버전, 스토리지 풀, 정책 및 시스템 상태 지표를 포함한 전체 구성 스냅샷을 수집합니다. |
| callhome_inventory_interval | 1440 |
예 | 재고 데이터 수집 주기를 분 단위로 설정합니다. 기본값인 1440분은 24시간(일일 수집)에 해당합니다. 이 간격은 최신 정보와 최소한의 시스템 부하 사이의 균형을 맞춥니다. dsmserv.opt 참고: CALLHOMEINVENTORYINTERVAL 옵션을 사용하여 이 값을 설정할 수 있습니다. 서버는 시작될 때마다 의 dsmserv.opt 값을 이 매개변수에 반영하므로, 를 수동으로 수정할 callhome.ini 필요가 없습니다.
|
| callhome_output_dir | callhome |
예 | 인스턴스 경로 srvmon 아래 폴더 중, 전송 전 Call Home 데이터 파일이 저장되는 하위 디렉터리 이름. 이렇게 하면 관리 및 문제 해결을 위해 출력 파일을 별도의 위치에 정리할 수 있습니다. |
| callhome_filename | callhome.json |
예 | 수집된 텔레메트리 데이터가 포함된 JSON 파일의 이름. 이는 일관된 처리 및 전송을 위해 출력 파일 이름을 표준화합니다. |
| callhome_max_retries | 3 |
예 | 네트워크 문제나 서버 가용성 문제로 인해 IBM 로의 전송이 실패할 경우, 재시도할 수 있는 최대 횟수입니다. 이를 통해 신뢰할 수 있는 데이터 전송을 보장하는 동시에 시스템 성능에 영향을 미칠 수 있는 무한 재시도 루프를 방지합니다. |
| callhome_transmit_url | https://dev.esupport.ibm.com/ |
예 | IBM ( eSupport ) API 엔드포인트 URL 는 텔레메트리 데이터가 전송되는 곳입니다. 이 설정은 IBM 의 지원 인프라로 전송되는 자동 텔레메트리 데이터의 전송 대상을 지정합니다. 기본값인 ` URL `은 개발 환경을 가리킵니다. |
| callhome_archive_enabled | true |
아니오 | 전송된 Call Home 데이터 파일을 로컬에 보관할 수 있게 합니다. 이 기능이 활성화되면 감사 추적, 문제 해결 및 규정 준수 요건을 위해 전송된 데이터의 로컬 기록을 보관합니다. |
| callhome_archive_dir | archive |
아니오 | 전송이 성공적으로 완료된 후 압축된 Call Home 파일이 저장되는 하위 디렉터리 이름. 이를 통해 활성 파일과 과거 데이터를 구분하여 체계적으로 관리할 수 있습니다. |
| callhome_archive_prune_days | 7 |
아니오 | 자동 삭제되기 전까지 보관된 Call Home 파일을 유지할 일수. 이를 통해 최근 데이터를 검토할 수 있는 적절한 기간을 유지하면서도 디스크 공간이 무제한으로 소모되는 것을 방지합니다. dsmserv.opt 참고: CALLHOMEARCHIVEPRUNEDAYS 옵션을 사용하여 이 값을 설정할 수 있습니다. 서버는 시작될 때마다 의 dsmserv.opt 값을 이 매개변수에 반영하므로, 를 수동으로 수정할 callhome.ini 필요가 없습니다.
|
| callhome_machine_type_model | 없음 | 예 | IBM Storage Protect를 실행하는 하드웨어의 기기 유형 및 모델 식별자. 이는 특정 하드웨어 플랫폼에 대한 고유 식별자입니다(예: 8284-22A). 이를 통해 IBM 은 정확한 하드웨어 구성을 파악하여 대상 지원 및 호환성 분석을 수행할 수 있습니다. |
| callhome_serial_number | 없음 | 예 | IBM 하드웨어 시스템의 고유 일련 번호(예: 10ABCDE). 이 번호는 보증 추적, 지원 사례 연계 및 하드웨어 관련 진단 시 특정 머신 인스턴스를 고유하게 식별하는 데 사용됩니다. |
| callhome_target_space | prod |
아니오 | 환경 유형 또는 차량 그룹 범주를 식별합니다. 이를 통해 IBM 는 환경 유형별로 텔레메트리 데이터를 분류하고 분석할 수 있어, 배포 시나리오에 대한 더 깊은 통찰력을 얻고 운영 환경의 문제 해결 우선순위를 정하는 데 도움이 됩니다. |
구성 파일 예시
다음 예제는 완전한 Call Home 구성 파일을 보여줍니다:
; Call Home Configuration for IBM Storage Protect
; This file is used for proactive monitoring and automated telemetry
[CallHome]
; Callhome enabled collection tickers: inventory
callhome_enabled_tickers = inventory
; Collection intervals in minutes
; Full configuration snapshot interval in minutes (default: 1440 = 24 hours)
callhome_inventory_interval = 3
; Output configuration
; Directory name under instance_dir/srvmon/ for storing call home JSON files
callhome_output_dir = callhome
; Output JSON filename for call home payload under instance_dir/srvmon/<callhome_output_dir>
callhome_filename = callhome.json
; Transmission settings
; Maximum number of retry attempts for failed transmissions (default: 3)
callhome_max_retries = 3
; IBM ESS API endpoint URL for transmitting call home data
callhome_transmit_url = https://dev.esupport.ibm.com/connect/api/v1
; Local archival & pruning (recommended)
; Enable local archival of transmitted payloads (true/false, default: true)
callhome_archive_enabled = true
; Subdirectory name for storing archived payloads under instance_dir/srvmon/<callhome_output_dir>
callhome_archive_dir = archive
; Number of days to retain archived payloads before automatic pruning (default: 7)
callhome_archive_prune_days = 7
; Hardware machine type and model identifier (MTM) for asset identification
callhome_machine_type_model = 8284-22A
; Hardware serial number for unique asset identification
callhome_serial_number = 10ABCDE
callhome_target_space = prod
"callhome.ini" [dos] 39L, 1542Cdsmserv.opt 의 설정 옵션
두 callhome.ini 가지 매개변수는 에서 dsmserv.opt 직접 제어할 수 있으므로, 초기 설정 후에는 를 수정할 callhome.ini 필요가 없습니다:
- callhome_inventory_intervalCALLHOMEINVENTORYINTERVAL — 인벤토리 수집 간격을 분 단위로 설정합니다 (에 매핑됨).
- callhome_archive_prune_daysCALLHOMEARCHIVEPRUNEDAYS — 아카이브된 페이로드를 보관할 일수를 설정합니다 (다음과 매핑됩니다).
callhome.ini서버가 재시작될 때마다 에 dsmserv.opt 지정된 값이 에 기록되며, 이 과정에서 해당 두 매개변수에 대해 수동으로 변경한 내용은 모두 덮어쓰게 됩니다. dsmserv.opt에서 두 옵션 모두 설정되지 않은 경우, 위 표에 표시된 기본값이 적용됩니다.
데이터 수집 및 전송
‘Call Home ’ 기능은 다음을 IBM Storage Protect 통해 자동화된 사전 예방적 모니터링을 가능하게 합니다:
- 서버 구성 및 상태에 대한 일일 현황 정보 수집
- IBM 지원 인프라로 데이터를 안전하게 전송
- 설정된 보존 기간 동안 로컬 아카이브 유지
- 대상 지원에 필요한 구체적인 하드웨어 및 환경 파악
- 안정적인 데이터 전송을 위한 재시도 로직 구현