에이전트 관리 대상 시스템 이름 변경

다양한 Cloud APM 에이전트의 관리 대상 시스템 이름을 변경할 때는 각각 서로 다른 프로시저가 적용됩니다. 일부 에이전트의 경우 관리 대상 시스템의 이름을 변경하는 것은 관리 대상 시스템 이름의 호스트 이름 또는 에이전트 이름(또는 둘 다)을 변경하는 것을 의미합니다. 그 외 에이전트의 경우에는 관리 대상 시스템 이름을 변경하는 데 특정 프로시저가 필요합니다.

시작하기 전에

관리 대상 시스템 이름에 설명되어 있는 관리 대상 시스템 이름 형식 및 이름 지정 제한사항에 대해 잘 알아야 합니다.

이 태스크 정보

대부분의 Cloud APM 에이전트의 경우, CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름에 사용된 호스트 이름을 변경할 수 있습니다. 멀티 인스턴스 에이전트의 관리 대상 시스템 이름에서 에이전트 인스턴스 이름을 변경하려는 경우에는 에이전트 구성 매개변수를 사용할 수 있습니다. 에이전트를 구성하는 경우, 다른 에이전트 인스턴스 이름이 지정되도록 이를 다시 구성해야 합니다. 에이전트를 다시 구성한 후에는 이전 에이전트 인스턴스가 수집한 데이터를 검색할 수 없습니다.

변경하려는 관리 대상 시스템 이름의 부분에 따라, 하나의 프로시저로 관리 대상 시스템 이름을 변경하지 못할 수도 있습니다.

원하는 에이전트에 대한 관리 대상 시스템 이름 변경 방법을 알아보려면 표 1의 내용을 참조하십시오.

예외: HTTP Server 에이전트, Node.js 에이전트 또는 Synthetic Playback 에이전트에서는 관리 대상 시스템 이름 변경을 지원하지 않습니다.
표 1. Cloud APM 에이전트의 관리 대상 시스템 이름 변경
에이전트 관리 대상 시스템 이름 변경 방법
Amazon EC2 에이전트 에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 EC2 하위 노드 이름을 변경하십시오(Amazon EC2 에이전트의 구성 매개변수 참조).
Amazon ELB 에이전트

새 인스턴스 이름을 가진 새 에이전트 인스턴스를 작성하여 관리 대상 시스템 이름을 변경하십시오.

Azure Compute 에이전트 에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 하위 노드 이름을 변경하십시오(Azure Compute 에이전트의 구성 매개변수 참조).
Cassandra 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Cisco UCS 에이전트 에이전트 구성 매개변수를 사용하여 에이전트 인스턴스 이름을 변경하십시오(에이전트의 구성 매개변수 참조).
Citrix VDI 에이전트 에이전트 구성 매개변수를 사용하여 Citrix 사이트 이름을 변경하십시오(Citrix VDI 에이전트의 구성 매개변수 참조).
Db2® 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

DataPower® 에이전트 에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름을 변경하십시오(DataPower 에이전트 구성 참조).
DataStage® 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Hadoop 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
HMC Base 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

IBM® Cloud 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

IBM Integration Bus 에이전트 IBM Integration Bus 에이전트에 대해 고유한 관리 대상 시스템 이름 지정
JBoss 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Linux KVM 에이전트 에이전트 구성 매개변수를 사용하고 Linux KVM 모니터링 구성의 내용을 참조하십시오.
Linux OS 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Microsoft .NET 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Microsoft Active Directory 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Microsoft Exchange Server 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Microsoft Hyper-V Server 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Microsoft IIS 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Microsoft Office 365 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Microsoft SQL Server 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Microsoft SharePoint Server 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
MongoDB 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

MySQL 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

NetApp Storage 에이전트 에이전트 구성 매개변수를 사용하고 NetApp 스토리지 모니터링 구성의 내용을 참조하십시오.
OpenStack 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Oracle Database 에이전트 에이전트 구성 매개변수를 사용하고 Oracle 데이터베이스 모니터링 구성의 내용을 참조하십시오.
PHP 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

PostgreSQL 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

RabbitMQ 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Response Time Monitoring 에이전트 Response Time Monitoring 에이전트의 고유한 관리 대상 시스템 이름 지정
Ruby 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
SAP 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

SAP HANA Database 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

SAP NetWeaver Java™ Stack 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Siebel 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Skype for Business Server 에이전트(이전에 Microsoft Lync Server 에이전트라고도 함)

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
Sterling File Gateway 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Sterling Connect Direct 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

Tomcat 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

UNIX OS 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.
WebSphere® Applications 에이전트

관리 대상 시스템 이름의 호스트 이름을 변경하려면 WAS 에이전트 인스턴스의 관리 대상 시스템 이름에 사용된 호스트 이름 변경 방법을 참조하십시오.

관리 대상 시스템 이름의 서버 별명을 변경하려면 대화식으로 데이터 콜렉터 재구성의 내용을 참조하십시오.

WebSphere Infrastructure Manager 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

에이전트 구성 매개변수를 사용하여 관리 대상 시스템 이름의 인스턴스 이름을 변경하십시오.

WebSphere MQ 에이전트 복수의 큐 관리자에 고유한 관리 대상 시스템 이름 지정
Windows OS 에이전트

CTIRA_HOSTNAME 매개변수를 사용하여 관리 대상 시스템 이름의 호스트 이름을 변경하십시오. 관리 대상 시스템 이름의 호스트 이름 변경을 참조하십시오.

관리 대상 시스템 이름의 호스트 이름 변경

이 태스크 정보

일반적으로 관리 대상 시스템 이름의 호스트 이름은 변경하지 않습니다. 호스트 이름은 에이전트 구성 중에 자동으로 발견되어 설정됩니다. 필요한 경우에만 관리 대상 시스템 이름의 호스트 이름을 변경하고, 지정하는 값이 관리 대상 시스템 이름 지정 제한사항으로 인해 잘리지 않도록 하십시오.

프로시저

  1. 에이전트의 모든 기존 인스턴스를 중지하고 Cloud APM 콘솔에서 해당 에이전트 및 하위 노드가 오프라인 상태임을 표시할 때까지 대기하십시오. 기존 에이전트 인스턴스가 없는 경우에는 다음 단계를 진행하십시오.

    에이전트 인스턴스 중지에 대한 자세한 정보는 에이전트 명령 사용의 내용을 참조하십시오.

  2. 에이전트가 단일 인스턴스 에이전트인 경우, 다음 단계를 완료하여 CTIRA_HOSTNAME 매개변수를 변경하십시오. CTIRA_HOSTNAME 매개변수에 대해 지정하는 값이 모든 새 에이전트 인스턴스에 적용되는 값입니다.
    1. 다음 파일에 대한 백업 사본을 작성하십시오.
      • Linux 또는 AIXinstall_dir/config/pc.environment
      • Windowsinstall_dir/TMAITM6_x64/kpccma.ini
      여기서,
    2. 다음과 같이 CTIRA_HOSTNAME 매개변수 값을 변경하여 파일을 편집하십시오. 여기서, newhostname은 에이전트가 설치된 컴퓨터의 실제 호스트 이름 대신 사용되는 사용자 정의 문자열입니다.
      • Linux 또는 AIXCTIRA_HOSTNAME=newhostname
      • WindowsCTIRA_HOSTNAME=newhostname .TYPE=REG_EXPAND_SZ
    3. 변경사항을 저장하십시오.
  3. 에이전트가 멀티 인스턴스인 경우, 다음 단계를 완료하여 CTIRA_HOSTNAME 매개변수를 변경하십시오. 일반적으로 컴퓨터의 모든 에이전트 인스턴스는 동일한 호스트 이름 값을 사용합니다. 에이전트 인스턴스가 다른 값을 사용하도록 해야 하는 경우, 이 단계를 수행할 때 CTIRA_HOSTNAME에 지정하는 값을 다르게 하십시오.
    1. 다음 파일의 백업 사본을 작성하십시오.
      • Linux 또는 AIXinstall_dir/config/pc_instance.environment
      • Windowsinstall_dir/TMAITM6_x64/kpccma_instance.ini
    2. 파일을 편집하여 다음과 같이 CTIRA_HOSTNAME 매개변수 값을 변경하십시오.
      • Linux 또는 AIXCTIRA_HOSTNAME=newhostname
      • WindowsCTIRA_HOSTNAME=newhostname .TYPE=REG_EXPAND_SZ
    3. 변경사항을 저장하십시오.
  4. Windows 기존 에이전트 인스턴스를 다시 구성하십시오.
  5. 모든 에이전트 인스턴스를 시작하십시오.

다음에 수행할 작업

에이전트 관리 대상 시스템 이름을 변경한 후에는 Cloud APM 콘솔을 시작하고, 애플리케이션에서 이전 관리 대상 시스템 이름을 제거한 후 그 위치에 새 관리 대상 시스템 이름을 추가하여 애플리케이션을 수정하십시오.