Edit DocumentEMS Agent를 소개합니다.
EMS Agent는 특정 파일 혹은 시스템 이벤트를 EMS서버에 보내는 프로그램입니다.
Agent의 항목에 따라 EMS서버가 아닌 특정 DB 혹은 특정 기능을 수행하도록 할 수도 있습니다.
사양 : Windows 2003, Windows 2008, Windows 7, Linux계열
최송요구사항 : Jdk1.5이상 설치
다운로드 : Confluence 에서 EMS -Agent.zip 을 다운로드
설치: 다운받은 파일의 압축을 푼후 폴더를D:¥에 이동한후
“ D:¥ EMS-Agent” 에 다음과 같은 디렉토리 구조로 되어있는지 확인합니다.
디렉토리 구조 :
디렉토리 | 이름 | 설명 | 비고 |
config | emsagent.xml | E MS Client Agent의 환경설정 파일입니다. |
|
NTService.conf | 레지스트리에 서비스를 등록하기 위한설정파일입니다. (Windows계열에서만 사용) |
| |
temp |
| 임시파일 생성을 합니다. |
|
lib |
| 시스템에서 필요로 하는 라이브러리 디렉토리 입니다. |
|
history |
| Agent가 데이터를 취합해서 서버에 보냈을 경우, 보내는 정보를 기록합니다.s |
|
logs |
| 시스템 로그 정보를 기록합니다. |
|
/ | installNTService.bat | E MS Agent를 윈도우 서비스로 등록합니다. | System 부팅시 자동실행 |
ReleaseNote.txt | EMS Agent의 release note를 출력합니다. |
| |
run.bat | Windows계열의 E MS Agent를 시작합니다. |
| |
R un.sh | 리눅스 계열에서의 EMS Agent를 시작합니다 | 부팅시 자동실행안됨 | |
uninstallNTService.bat | EMS Agent를 원도우 서비스에서 삭제합니다. |
| |
NTService.exe | 윈도우레지스트리 등록용 파일입니다. |
|
* 설치 디렉토리 변경시에는 상기 디렉토리 및 파일구조를 유지해주세요.
환경파일( emsagent.xml ) 설명
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<emsAgentConfig>
1. <agentId>E997-58F1-D95E-48A6</agentId>
2. <cipherKey>SuPeRmInJaE</cipherKey>
3. <tempDir>temp</tempDir>
4. <sender sendMethod="http" name="MantechEMS">
4.1. <address>219.240.75.59</address>
4.2. <port>8080</port>
4.3. <uri>ems/uploadLog.do</uri>
4.4. <className>com.mantech.ems.agent.sender.EMSUseHttp</className>
</sender>
5. <monitor use="true" interval="10000" logType="H" name="file_0">
5.1 <className>com.mantech.ems.agent.monitor.FileMonitoring</className>
5.2 <filter log="c:\mccs\mccs.log"/>
5.3 <makeClass>com.mantech.ems.agent.make.EMSFileGlobalMake</makeClass>
5.4 <server>MantechEMS</server>
</monitor>
6. <monitor use="true" interval="10000" logType="S" name="window_0">
6.1. <className>com.mantech.ems.agent.monitor.WindowsEventMonitoring</className>
6.2. <filter level="0,1,2,4" source="Service Control Manager" log="System">
6.2.1. <includes>.*</includes>
6.2.2. <excludes></excludes>
</filter>
6.3. <makeClass>com.mantech.ems.agent.make.EMSFileGlobalMake</makeClass>
6.4. <server>MantechEMS</server>
</monitor>
7. <monitor use="true" interval="60000" name="checker">
7.1. <className>com.mantech.ems.agent.monitor.AliveCheckService</className>
7.2. <makeClass>com.mantech.ems.agent.make.EMSFileGlobalMake</makeClass>
7.3. <server>MantechEMS</server>
</monitor>
<history backupLimit="10" use="true">
<file>./history/AgentHistory.txt</file>
<fileSize>2MB</fileSize>
</history>
</emsAgentConfig>
환경 정보는 EMS Agent를 용도로 설명 합니다.
(환경설정파일 emsagent.xml 는 XML 파일입니다. EMS SERVER를 통해 생성하지 않을 경우 XML의구조에 주의 해야 합니다)
1. agentId : EMS 서버에 등록된 서버 라이센스(16자리)영숫자 를 설정합니다. “ EMS서버등록 ” 화면에서 확인할수 있습니다. (ex. “ D87EA-87F7-76HJ-8976 ” 등)
2. cipherKey : EMS Agent 가 감시하는 로그 파일의 내용을 EMS서버에 전송할때 사용하는 데이터 암호화용 키입니다. (기본적으로 변경 불가능합니다.)
3. tempDir : EMS 서버에 전송될 데이터를 패키징 하기 위해 사용하는 영역입니다.
MONITOR_TYPE는 모니터링 하려는 정보를 정의합니다. 현재 모니터링 타입은 파일과 윈도우 이벤트를 모니터링 할 수 있습니다.
4. sendMethod 속성 : EMS 서버에 데이터를 전송하기 위한 타입을 지정합니다. (Default: Http )
N ame 속성: 데이터를 전송할 EMS서버의 이름을 입력합니다.
4.1. address : 데이터를 전송할 EMS서버의 주소를 입력합니다. (Default : 219.240.75.59)
4.2. port : 데이터를 전송할 EMS서버의 포트 번호를 입력합니다.
4.3. uri : 데이터를 전송하기 위한 서버 접근URL 을 입력합니다. (Default : ems/uploadLog.do )
4.4. className : 데이터를 전송하기 위한 타입에 해당하는 class명을 입력합니다.( 변경불가 )
5. use 속성 : 실제로 지정된 파일 감시타입을 사용할 것인지 지정합니다. (Default : true)
Interval 속성 : 지정된 대상에의 감시간격을 미리초로 설정합니다. (Default & Min value : 10000 )
Name 속성 : 감시 프로세스 에 이름을 지정합니다.
logType 속성 : EMS 서버에 저장될 로그의 종류를 지정합니다.
H: HA 관련 로그로 저장됩니다. (파일감시만 지정가능)
A: Application 관련 로그로 저장됩니다. (파일감시만 지정가능)
S: Windows system event 로그로 저장됩니다. (Windows event감시만 지정가능)
P: Process 관련 로그로 저장됩니다. (파일감시만 지정가능)
5.1. className : 파일 감시 타입에 해당하는 class 명을 입력
5.2. log : 실제 감시할 대상파일명을 Full path 로 입력합니다.
5.3. makeClass : 파일 감시 결과를 전송하기 위해 Packaging할 Class 명을 입력합니다. ( 변경불가 )
5.4. server : 파일 감시 결과를 전송할 서버명을 입력합니다. (4. N ame 속성 참조)
6. use 속성 : 5. use 속성과 동일합니다.
Interval 속성 : 5. Interval 속성과 동일합니다.
name 속성 : 5. name 속성과 동일합니다.
logType 속성 : 5. logType 속성과 동일합니다.
6.1. className : Windows event 감시 타입에 해당하는 class 명을 입력
6.2. level 속성 : Windows system event 의 감시레벨을 입력합니다. (변경불가)
S ource 속성 : 발생한 Windows event중에서 감시할 Souce명을 지정합니다.
L og 속성 : Windwos event중 감시할 event 타입을 지정합니다.
(Application, system ,secutiry등 지정가능)
6.2.1. includes : 해당하는 문자열이 존재할경우 데이터를 전송합니다. (정규식 입력)
6.2.2. excludes : 해당하는 문자열이 존재할경우 데이터를 전송하지 않습니다. (정규식 입력)
6.3. makeClass : 5.3. makeClass 와동일합니다.
6.4. server : 5.4. server 와 동일합니다.
7. use 속성 : 해당하는 생존신호 발생을 사용할지 지정합니다.
interval 속성 : EMS 서버로 보낼 EMS Agent의 생존신호간격을 미리초 단위로 입력합니다.
(Default : 60000 )
n ame 속성 : 이름을 지정합니다.
7.1. className : 생존신호를 생성하기 위한 class 명을 입력합니다.
7.2. makeClass : 5.3. makeClass 와동일합니다.
7.3. server : 5.4. server 와 동일합니다.
# Specifies debug level
# 0 - debug is not created
# 1 - critical information
# 2 - error information
# 3 - warnings (default)
# 4 - for debugging (produces lots of information)