.NET 에이전트와 Enterprise Manager의 연결 구성
에이전트는 메트릭을 보고하기 위해 Enterprise Manager에 연결해야 합니다. 기본 통신 설정을 사용할 경우 에이전트는 포트 5001을 사용하여 로컬 Enterprise Manager에 연결할 수 있습니다. 그러나 일반적으로 에이전트와 Enterprise Manager는 동일한 시스템에 있지 않습니다. 에이전트를 설치할 때 또는 에이전트를 설치한 후에 기본 설정을 수정할 수 있습니다. <에이전트 홈> 디렉터리에 있는 IntroscopeAgent.profile을 수정하여 설정을 구성하십시오.
apmdevops104kr
에이전트는 메트릭을 보고하기 위해 Enterprise Manager에 연결해야 합니다. 기본 통신 설정을 사용할 경우 에이전트는 포트 5001을 사용하여 로컬 Enterprise Manager에 연결할 수 있습니다. 그러나 일반적으로 에이전트와 Enterprise Manager는 동일한 시스템에 있지 않습니다. 에이전트를 설치할 때 또는 에이전트를 설치한 후에 기본 설정을 수정할 수 있습니다.
<에이전트 홈>
디렉터리에 있는 IntroscopeAgent.profile을 수정하여 설정을 구성하십시오.요구 사항에 따라 다음을 사용하도록 에이전트와 Enterprise Manager 간의 통신을 구성할 수 있습니다.
- 직접 소켓 연결
- HTTP 터널링 연결
- 프록시 서버를 통한 HTTP 터널링
- HTTPS(HTTP over Secure Sockets Layer) 연결
- SSL(Secure Socket Layer) 연결
직접 소켓 연결을 사용하여 Enterprise Manager에 연결
에이전트에서 Enterprise Manager에 연결하는 가장 일반적인 방법은 직접 소켓 연결을 사용하는 것입니다. 가능한 경우 직접 소켓 연결을 사용하여 Enterprise Manager에 연결하는 것이 좋습니다. 에이전트가 연결해야 하는 Enterprise Manager, 수집기 또는 MOM의 URL을 지정하려면 다음과 같은 시스템 속성을 사용하십시오.
시스템 속성 이름
: agentManager.url.1약식 이름
: agentManager정규화된 시스템 속성 이름은 약식 이름보다 우선하며 Java 명령줄이나 에이전트 프로필에서 지정됩니다. 약식 이름은 첫 번째 연결 항목
agentManager.url.1
에 대한 별칭입니다("에이전트 프로필에서 하나 이상의 관리자 지정" 참조). 약식 형식은 JVM 명령줄에서만 사용해야 합니다. 속성 값은 URL입니다.serverHostOrIP
값은 IP 주소(IPv4 또는 IPv6), 호스트 이름 또는 정규화된 도메인 이름일 수 있습니다. 사용 환경에 최적의 값을 지정하십시오. 기본값이 유추되지 않으므로 모든 경우에 속성의 일부로 포트를 지정해야 합니다.다음 단계를 따르십시오.
- IntroscopeAgent.profile을 텍스트 편집기에서 엽니다.
- agentManager.url.1속성을 찾습니다. 에이전트가 연결하는 Enterprise Manager의 호스트 이름 또는 IP 주소와 기본 수신 대기 포트를 지정합니다. 예:agentManager.url.1=sfcollect01:5001Enterprise Manager가 둘 이상 있는 클러스터를 사용하는 경우에는 MOM을 지정해야 합니다. 그러면 MOM은 에이전트를 수집기에 할당합니다.
- (선택 사항) 기본 Enterprise Manager에 대한 연결이 끊어질 경우에 에이전트에서 연결할 백업 Enterprise Manager를 하나 이상 지정합니다.
- IntroscopeAgent.profile 파일을 저장하고 닫습니다.
직접 TCP 연결
직접 TCP 연결을 사용하려면 다음 형식 중 하나를 지정하십시오.
agentManager=serverHostOrIP:Port
형식은 네임스페이스에 대해 tcp://
접두사가 있는 것으로 가정합니다.agentManager=serverHostOrIP:PortagentManager=tcp://serverHostOrIP:Port
HTTP 터널링을 사용하여 Enterprise Manager에 연결
Enterprise Manager에 대한 직접 소켓 연결이 적절하지 않은 경우 HTTP를 통해 Enterprise Manager에 연결하도록 에이전트를 구성할 수 있습니다. 이 구성을 사용하면 HTTP 트래픽만 허용하는 방화벽을 통과하여 통신할 수 있습니다.
터널링 기술을 사용하여 정보를 보내도록 에이전트를 구성하면 에이전트를 Enterprise Manager에 원격으로 연결할 수 있습니다. 이 경우 HTTP 터널링 웹 서비스가 호스트되는 Enterprise Manager의 포함된 웹 서버에 연결하도록 에이전트를 구성해야 합니다.
HTTP 터널링은 응용 프로그램 서버 및 Enterprise Manager에 직접 소켓 연결보다 많은 CPU 및 메모리 오버헤드를 발생시킵니다.
다음 단계를 따르십시오.
- IntroscopeAgent.profile을 텍스트 편집기에서 엽니다.
- agentManager.url.1속성을 에이전트가 기본적으로 연결하는 Enterprise Manager의 호스트 이름 또는 IP 주소로 설정합니다. 호스트 이름 또는 IP 주소 다음에 콜론을 추가하고 Enterprise Manager에 포함된 웹 서버의 HTTP 수신 대기 포트를 지정하십시오. 예:agentManager.url.1=http://webhost:8081/포트 번호가 <EM 홈>/config/IntroscopeEnterpriseManager.properties 파일의introscope.enterprisemanager.webserver.port속성 값과 일치하는지 확인합니다. 기본 포트 값은 8081입니다.
- (선택 사항) 기본 Enterprise Manager에 대한 연결이 끊어질 경우에 에이전트에서 연결할 백업 Enterprise Manager를 하나 이상 지정합니다.
- IntroscopeAgent.profile 파일을 저장하고 닫습니다.
HTTP 터널링을 위한 프록시 서버 구성
HTTP 터널링 에이전트가 프록시 서버를 통해 Enterprise Manager에 연결하도록 구성할 수 있습니다. 이 구성은 전달 프록시 서버에 필요합니다. 에이전트가 프록시 서버를 통해 라우트된 아웃바운드 HTTP 트래픽만 허용하는 방화벽 뒤에서 실행되는 경우에 이 구성을 사용하십시오.
프록시 서버 구성 속성은 에이전트가 HTTP를 통해 터널링되도록 구성된 경우에만 적용됩니다. 프록시 서버 구성은 단일 연결뿐 아니라 에이전트에 구성된 모든 HTTP 터널링 연결에 적용됩니다. 이 구성은 여러 Enterprise Manager가 각각 HTTP를 통해 연결되는 경우 Enterprise Manager 간의 장애 조치를 구성할 때 특히 고려해야 할 점입니다.
중요!
- 에이전트 HTTP 터널링을 사용하려면 HTTP/1.1이 필요합니다. 또한 프록시 서버에서 HTTP Post를 지원해야 합니다.
- 프록시에 연결할 수 없으면 에이전트는 이 프록시를 건너뛰고 Enterprise Manager와 직접 연결합니다. 프록시에 연결할 수 있지만 인증이 실패하는 경우 에이전트는 이 프록시를 통해 계속 Enterprise Manager에 연결을 시도합니다.
다음 단계를 따르십시오.
- IntroscopeAgent.profile을 텍스트 편집기에서 엽니다.
- agentManager.httpProxy.host속성을 프록시 서버의 호스트 이름 또는 IP 주소로 설정합니다.
- agentManager.httpProxy.port속성을 프록시 서버의 포트 번호로 설정합니다.
- (선택 사항) 프록시 서버에서 인증을 위한 사용자 자격 증명이 필요한 경우 다음 중 하나를 수행합니다.
- 일반 텍스트 인증을 사용하려면 다음 속성을 설정합니다.agentManager.httpProxy.username=<user_name>agentManager.httpProxy.password=<user_password>
- 암호를 암호화하려면 다음 단계를 따릅니다.
- wily\tools\PropertiesUtil.jar에서 암호화 도구에 액세스합니다.
- 다음 명령을 사용하여 도구를 실행합니다.java -jar <directory path>\wily\tools\PropertiesUtil.jar encrypt <user_password>암호화된 암호가 제공됩니다.
- IntroscopeAgent.profile 파일에서 다음 속성을 설정합니다.agentManager.httpProxy.username=<user_name>agentManager.httpProxy.password=<encrypted_password>
- IntroscopeAgent.profile을 저장하고 닫습니다.
HTTPS 터널링을 사용하여 Enterprise Manager에 연결
IntroscopeAgent.profile 파일의 속성을 구성하여, 에이전트가 HTTPS(HTTP over Secure Sockets Layer)를 사용하여 Enterprise Manager에 연결하도록 할 수 있습니다.
다음 단계를 따르십시오.
- IntroscopeAgent.profile을 텍스트 편집기에서 엽니다.
- agentManager.url.1속성을 대상 Enterprise Manager의 호스트 이름이나 IP 주소 중 하나로 설정합니다. 호스트 이름 또는 IP 주소 다음에 콜론을 추가하고 Enterprise Manager에 포함된 웹 서버의 HTTPS 수신 대기 포트를 지정하십시오. 예:agentManager.url.1=https://172.31.255.255:8444/
- (선택 사항) 기본 Enterprise Manager에 대한 연결이 끊어질 경우에 에이전트에서 연결할 백업 Enterprise Manager를 하나 이상 지정합니다.
- IntroscopeAgent.profile을 저장하고 닫습니다.
SSL을 통해 Enterprise Manager에 연결
직접 SSL(Secure Socket Layer) 연결을 사용하는 경우 HTTP 터널링 없이 SSL을 사용하여 에이전트와 Enterprise Manager의 통신을 구성할 수 있습니다.
다음 단계를 따르십시오.
- IntroscopeAgent.profile을 텍스트 편집기에서 엽니다.
- SSL 소켓 팩터리를 사용하여 Enterprise Manager의 SSL 수신 대기 포트에 연결하도록 에이전트를 구성합니다.
- agentManager.url.1속성을 대상 Enterprise Manager의 호스트 이름 또는 IP 주소로 설정합니다. 호스트 이름 또는 IP 주소 다음에 콜론을 추가하고 Enterprise Manager의 SSL 수신 대기 포트를 지정하십시오. 예:agentManager.url.1=ssl://172.31.255.255:8444
- 에이전트가 Enterprise Manager를 인증하도록 구성합니다.
- agentManager.trustStore.1속성의 주석 처리를 제거합니다.
- agentManager.trustStore.1을 Enterprise Manager 인증서가 포함된 신뢰 저장소 위치로 설정합니다.신뢰 저장소를 지정하지 않으면 에이전트는 모든 인증서를 신뢰합니다. 절대 경로나 에이전트 프로필을 기준으로 한 상대 경로를 지정할 수 있습니다. 예:agentManager.trustStore.1=/certs
- 필요한 경우agentManager.trustStorePassword.1속성을 설정하여 신뢰 저장소 암호를 지정합니다.
- Enterprise Manager에 클라이언트 인증이 필요한 경우agentManager.keyStore.1속성을 에이전트 인증서가 포함된 키 저장소의 위치로 설정합니다. 절대 경로나 에이전트 프로필을 기준으로 한 상대 경로를 지정할 수 있습니다. Windows에서는 백슬래시를 이스케이프해야 합니다. 예:agentManager.keyStore.1=C:\\keystore
- 필요한 경우agentManager.keyStorePassword.1속성을 키 저장소 암호로 설정합니다.
- agentManager.cipherSuites.1속성을 설정합니다.접미사 번호를 증가시키며 속성을 추가하여 허용되는 다른 암호 그룹을 정의할 수 있습니다. 예:agentManager.cipherSuites.2,등.이 속성 값을 지정하지 않으면 기본 암호 그룹이 사용됩니다.
- (선택 사항) 기본 Enterprise Manager에 대한 연결이 끊어질 경우에 에이전트에서 연결할 백업 Enterprise Manager를 하나 이상 지정합니다.
- IntroscopeAgent.profile을 저장하고 닫습니다.