ITM 커스텀 에이전트 SDA 지원 (공개 미리 보기)

1단계: 사용자 지정 에이전트 이미지 구축

XML 구성을 수정한 후(예: MQ 에이전트의 경우):

# Navigate to Agent Builder directory
cd $CANDLEHOME/bin

# Build the agent image
./itmcmd agent build -p <product_code> -v <version>

사용자 정의 에이전트 팩토리의 경우:

# Example for custom MQ agent (KMQ)
./itmcmd agent build -p KMQ -v 063700000

2단계: 에이전트 이미지를 저장소에 추가하기

# Login to TEMS
tacmd login -s <tems_hostname> -u <username> -p <password>

# Add the agent bundle to depot
tacmd addBundles -t <product_code> -v <version> -p <path_to_agent_image>

# Example for custom MQ agent
tacmd addBundles -t KMQ -v 063700000 -p /opt/IBM/ITM/InstallITM/images/KMQ_063700000.tar

3단계: 에이전트 업데이트 배포

옵션 A: 노드 이름을 기준으로 특정 에이전트를 업데이트합니다.

tacmd agentUpdate -t KMQ -v 063700000 -n "node1:KMQ node2:KMQ node3:KMQ"

옵션 B: 관리 대상 시스템 목록을 통해 업데이트합니다.

tacmd agentUpdate -t KMQ -v 063700000 -m "MQAGENT01 MQAGENT02 MQAGENT03"

옵션 C : 특정 유형의 모든 에이전트를 업데이트합니다.

# First, get list of all agents
tacmd listSystems -t KMQ > kmq_agents.txt

# Then update all
tacmd agentUpdate -t KMQ -v 063700000 -a

옵션 D: 강제 업데이트 (기존 버전 덮어쓰기).

tacmd agentUpdate -t KMQ -v 063700000 -n "node1:KMQ" -f

4단계: 업데이트 상태 확인

# Check update status
tacmd getAgentUpdateStatus -t KMQ

# View detailed status for specific node
tacmd getAgentUpdateStatus -t KMQ -n "node1:KMQ"

5단계: 에이전트 재시작 (필요한 경우)

# Restart specific agent
tacmd executeCommand -m MQAGENT01 -o -r -l -c "restart"

# Or use itmcmd on the agent system
./itmcmd agent -o <product_code> restart

시나리오 1: 단계적 도입

대규모 환경의 경우 단계적 접근 방식을 사용하십시오:

# Phase 1: Test environment
tacmd agentUpdate -t KMQ -v 063700000 -n "test-node1:KMQ test-node2:KMQ"

# Wait and verify (24-48 hours)
tacmd getAgentUpdateStatus -t KMQ -n "test-node1:KMQ"

# Phase 2: Production subset
tacmd agentUpdate -t KMQ -v 063700000 -n "prod-node1:KMQ prod-node2:KMQ"

# Phase 3: Full production rollout
tacmd agentUpdate -t KMQ -v 063700000 -a

시나리오 2: 에이전트 업데이트 정책 사용

업데이트 정책 파일을 생성합니다 (agent_update_policy.xml):

<?xml version="1.0" encoding="UTF-8"?>
<AgentUpdatePolicy>
    <ProductCode>KMQ</ProductCode>
    <Version>063700000</Version>
    <Schedule>
        <StartTime>2026-03-30T22:00:00</StartTime>
        <EndTime>2026-03-31T06:00:00</EndTime>
    </Schedule>
    <TargetAgents>
        <Agent>node1:KMQ</Agent>
        <Agent>node2:KMQ</Agent>
    </TargetAgents>
    <Options>
        <AutoRestart>true</AutoRestart>
        <Rollback>true</Rollback>
    </Options>
</AgentUpdatePolicy>

정책 적용:

tacmd applyAgentUpdatePolicy -f agent_update_policy.xml

시나리오 3: 자동 배포 스크립트

자동 배포를 위한 셸 스크립트를 작성합니다:

#!/bin/bash
# distribute_custom_agent.sh

PRODUCT_CODE="KMQ"
VERSION="063700000"
TEMS_HOST="tems.example.com"
USERNAME="sysadmin"
AGENT_IMAGE="/opt/IBM/ITM/images/KMQ_063700000.tar"
LOG_FILE="/var/log/itm_agent_update_$(date +%Y%m%d_%H%M%S).log"

# Function to log messages
log_message() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
}

# Login to TEMS
log_message "Logging into TEMS..."
tacmd login -s "$TEMS_HOST" -u "$USERNAME" -p "$PASSWORD" >> "$LOG_FILE" 2>&1

if [ $? -ne 0 ]; then
    log_message "ERROR: Failed to login to TEMS"
    exit 1
fi

# Add bundle to depot
log_message "Adding agent bundle to depot..."
tacmd addBundles -t "$PRODUCT_CODE" -v "$VERSION" -p "$AGENT_IMAGE" >> "$LOG_FILE" 2>&1

if [ $? -ne 0 ]; then
    log_message "ERROR: Failed to add bundle to depot"
    exit 1
fi

# Get list of target agents
log_message "Retrieving list of target agents..."
tacmd listSystems -t "$PRODUCT_CODE" > /tmp/agent_list.txt

# Update agents
log_message "Starting agent update..."
tacmd agentUpdate -t "$PRODUCT_CODE" -v "$VERSION" -a >> "$LOG_FILE" 2>&1

if [ $? -ne 0 ]; then
    log_message "ERROR: Agent update command failed"
    exit 1
fi

# Monitor update status
log_message "Monitoring update status..."
sleep 60

tacmd getAgentUpdateStatus -t "$PRODUCT_CODE" >> "$LOG_FILE" 2>&1

log_message "Agent update process completed. Check log for details: $LOG_FILE"

# Logout
tacmd logout >> "$LOG_FILE" 2>&1

배포 전 점검 목록

• 개발 환경에서 수정된 XML 구성을 테스트합니다
• 에이전트 이미지 빌드가 성공적으로 검증되었습니다
• 에이전트 저장소에 충분한 공간이 있는지 확인하십시오
• 현재 에이전트 구성에 대한 백업 생성
• XML 구성에 적용된 변경 사항
• 롤백 계획 수립

배포 모범 사례

• 테스트 우선: 항상 비운영 환경에서 테스트하십시오
• 단계적 배포: 전체 배포에 앞서 소규모 그룹에 먼저 배포
• 유지보수 시간대: 활동이 적은 시간대에 업데이트를 예약하세요
• 소통: 업데이트 전 이해관계자에게 알리기
• 모니터링: 업데이트 진행 중 및 완료 후 에이전트 상태 모니터링
• 롤백 준비 완료: 롤백 절차를 문서화하고 테스트를 마쳤습니다

배포 후 검증

# Verify agent version
tacmd listSystems -t KMQ -d | grep -i version

# Check agent status
tacmd listSystems -t KMQ -s

# Verify data collection
tacmd viewDepot -t KMQ -n "node1:KMQ"

# Check for errors in agent logs
# On agent system:
tail -f $CANDLEHOME/logs/KMQ_*.log

일반적인 문제점 해결

문제: 에이전트 업데이트에 실패했습니다.

# Check depot connectivity
tacmd listBundles -t KMQ

# Verify agent can reach TEMS
# On agent system:
ping <tems_hostname>
telnet <tems_hostname> 1918

# Check agent update logs
tail -f $CANDLEHOME/logs/agent_update.log

문제: 업데이트 후 에이전트가 응답하지 않습니다.

# Check agent status
tacmd listSystems -t KMQ -n "node1:KMQ"

# Restart agent
tacmd executeCommand -m MQAGENT01 -o -r -l -c "restart"

# If still not responding, rollback
tacmd agentUpdate -t KMQ -v <previous_version> -n "node1:KMQ" -f

방법 1: 수동 배포

중앙 집중식 저장소가 없는 환경의 경우:

# 1. Copy agent image to target systems
scp KMQ_063700000.tar user@target-host:/tmp/

# 2. On each target system, install manually
cd $CANDLEHOME/bin
./itmcmd agent -o KMQ stop
tar -xvf /tmp/KMQ_063700000.tar -C $CANDLEHOME
./itmcmd agent -o KMQ start

방법 2: 구성 관리 도구

Ansible, Puppet, Chef와 같은 도구를 사용하세요:

# Ansible playbook example
---
- name: Update ITM Custom Agent
  hosts: itm_agents
  tasks:
    - name: Stop agent
      command: "{{ candlehome }}/bin/itmcmd agent -o KMQ stop"

    - name: Copy agent image
      copy:
        src: /depot/KMQ_063700000.tar
        dest: /tmp/KMQ_063700000.tar

    - name: Extract agent image
      unarchive:
        src: /tmp/KMQ_063700000.tar
        dest: "{{ candlehome }}"
        remote_src: yes

    - name: Start agent
      command: "{{ candlehome }}/bin/itmcmd agent -o KMQ start"

    - name: Verify agent status
      command: "{{ candlehome }}/bin/itmcmd agent -o KMQ status"
      register: agent_status

    - name: Display status
      debug:
        var: agent_status.stdout