알림 설정 및 확인
이 장에서는 시스템이나 관제서버와 관련하여 사용자가 지정한 조건에 맞게 알람이 발생하도록 환경을 설정하고, 발생한 알람들을 조회하거나 해결하는 방법에 대해서 설명합니다.
알림 설정
관제서버는 이메일, SMS, 팝업 등 다양한 방법으로 이벤트 및 장애 발생시 사용자에게 알림을 제공합니다.
- 이메일 알림: 이메일로 알림을 받으려면, 고객사의 SMTP 서버가 존재해야 합니다.
- SMS 알림: SMS 발송을 받으려면, 아래의 두가지 방법으로 구성이 가능합니다.
- 고객사의 SMS 발송 서버와 연동
- 맨텍의 SMS 발송 서버로 연결 (이 경우 고객사에서 외부로 접근이 가능하도록 설정 필요)
- 팝업(XMPP) 알림: 팝업 알림은 XMPP를 사용하는 메신저를 통해 알림을 제공 (별도의 XMPP를 지원하는 메신저 서버가 필요)
<그림> 사용자 알림
이메일 알림 설정
이 절에서는 다음 그림과 같이 알림을 이메일을 통해 받을수 있도록 설정하는 작업을 설명합니다.
<그림> 이메일 알림
관제서버에서 제공하는 이벤트 및 장애 상황을 이메일을 통해 확인 하려면, 다음 설정을 수정합니다.
먼저 “/gampkgs/data/config/email-config.properties” 파일을 열어서 아래의 SMTP 설정을 사용자 환경에 맞게 수정하십시오.
# rabbit wind.rabbit.server.host=127.0.0.1 wind.rabbit.server.port=5673 wind.rabbit.server.username=mccs wind.rabbit.server.password=password # Characterset system.charset=UTF-8 # SMTP smtp.host=smtp_host smtp.port=25 smtp.userid=sender_userid smtp.password=sender_password smtp.from=sender_email@mail.server # JAVAMAIIL mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory mail.smtp.auth=true mail.smtp.starttls.enable=true mail.smtp.debug=false # Email Template mail.template= /gampkgs/data/config/email-template.html
SMTP 설정의 각 항목들의 의미는 다음과 같습니다.
항목 설명 smtp.host= SMTP 서버 주소를 입력 smtp.port= SMTP 포트 번호를 입력 smtp.userid= 이메일 알림 발송자의 아이디를 입력 smtp.password= 이메일 알림 발송자의 암호를 입력 smtp.from= 이메일 알림 발송자의 이메일주소를 입력 이메일 템플릿에서 관제서버 웹 콘솔로 바로 접속하기 위해 서 Email Template 설정의 /gampkgs/data/config/email-template.html 템플릿 파일을 열어서 <GAM_HOMENAME> 항목을 설치한 관제서버의 아이피 주소(또는 관제서버의 FQDN)로 변경하십시오.
외부 네트워크를 사용할 경우
외부에서 이 알림 이메일을 확인할 경우, 이메일이 올바르게 열리지 않는 경우가 발생할 수 있습니다. 이런 경우에는 외부에서 접근가능한 공인 아이피 주소를 입력하시면 됩니다.
SMS 알림 설정
이 절에서는 SMS로 알림을 받을 수 있도록 설정하는 작업 방법을 설명합니다.
SMS 알림을 발송하려면 “/gampkgs/data/config/sms-config.properties” 파일을 열어서 아래 설정을 사용자 환경에 맞게 수정하십시오.
# rabbit wind.rabbit.server.host=127.0.0.1 wind.rabbit.server.port=5673 wind.rabbit.server.username=mccs wind.rabbit.server.password=password # SMS JDBC jdbc.driverClassName=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://xxx.xxx.xxx.xxx/db_name?useUnicode=true&characterEncoding=UTF8&jdbcCompliantTruncation=false&useOldUTF8Behavior=true jdbc.username=db_userid jdbc.password=db_userpassword # SMS sms.from=xx-xxxx-xxxx sms.query=insert into SMS_TBL(send_date, receiver, sender, message) values (now(), ?, ?, ?)
MCCS Enterprise의 SMS 알림은 데이터베이스의 특정 테이블에 값을 입력해 두면 발송하는 방식입니다. 위 설정에서 SMS 알림 발송과 관련하여 정보를 수정할 때 확인해야 할 항목들은 다음과 같습니다.
항목 | 설명 |
---|---|
jdbc.driverClassName= | 데이터베이스 드라이버를 입력 |
jdbc.url= | 사용하는 데이터베이스 IP 와 이름을 입력 |
jdbc.username= | 데이터베이스 접속 계정을 입력 |
jdbc.password= | 데이터베이스 접속 계정 암호를 입력 |
sms.from= | 문자 발송자의 전화번호를 입력 |
sms.query= | SMS 알림 발송을 위해 특정 테이블에 입력하는 쿼리문이며, 다음과 같은 3가지의 매개변수(“?”)를 순차적으로 전달 ? : 받는 사람 ? : 보내는 사람 ? : 발송 내용 |
<표> SMS 알림 발송과 관련하여 수정할 속성값 목록
팝업 알림 설정(XMPP)
MCCS Enterprise에서는 XMPP 프로토콜을 지원하는 메신저 서버와의 연동을 통해 클라이언트 PC에서 팝업으로 알림을 받을수 있습니다.
이 절에서는 오픈소스인 Openfire XMPP서버를 예제로 Openfire설치와 연동을 위한 관제서버의 설정 방법에 대해 설명합니다.
Openfire 서버 설치
- Openfire를 사용하려면 관리콘솔(9090) 포트와 클라이언트 통신(5222) 포트를 오픈해야 합니다. Openfire는 Docker 이미지로 제공합니다.
다음 명령어를 사용하여 Openfire 컨테이너를 실행하십시오.
gunzip openfire.tar.gz docker load -i openfire.tar docker run --privileged -d -h openfire --name openfire -p 9090:9090 -p 5222:5222 --volume /srv/docker/openfire:/var/lib/openfire --restart=always openfire:latest
- Openfire 기본설정을 진행합니다. http://<Openfire Host>:9090으로 접속하면 설정화면이 나타납니다.
- 언어를 고르는 화면에서 "English"를 선택하십시오.
- 그런 다음 기본 설정 값을 유지하도록 합니다.
- 다음에 나타난 화면에서 "Embedded Database"를 선택하십시오.
- 이어서 나타난 설정에서 "Default"를 선택하십시오.
- 비밀번호를 설정하십시오.
관리자 비밀번호를 입력한 후에 [Continue] 버튼을 클릭하십시오.
주의!
비밀번호를 입력하고 있는 과정에서 키보드의 [Enter] 키를 누르면, 관리자 콘솔 화면에 로그인할 수 없는 경우가 발생합니다.
관리자 콘솔에 접속하고, 설정한 관리자 아이디와 비밀번호를 사용하여 로그인하십시오.
http://<Openfire Host>:9090
- 다음으로는 XMPP 클라이언트인 Spark를 설치합니다. 먼저 계정을 생성해야 하는데, 계정을 생성하는 방법은 Spark를 사용하는 방법과 Openfire 콘솔을 사용하는 방법 두 가지입니다. 이 매뉴얼에서는 Spark를 사용하는 방법부터 설명하고 Openfire 콘솔을 사용하는 방법을 설명합니다. Spark로 생성하려면 순서23과 24를 참고하시고, Openfire로 생성하려면 순서 25부터 참고하십시오.
- Spark를 통해 계정을 생성하려면, Spark의 "계정 생성"을 클릭하십시오.
- 계정을 생성하기 위해 필요한 사항들을 입력하십시오.
"사용자명(U):" 항목에는 관제 서버에서 사용하는 아이디를 입력하고, "서버(S):" 항목에는 Openfire 호스트를 입력합니다. - Openfire 콘솔을 통해 계정을 생성하려면, “http://<Openfire Host>:9090”으로 접속한 다음 "Users/Groups"를 클릭하십시오.
- 좌측에 서브 메뉴가 나타나면 "Create New User"를 클릭하십시오.
- 관련사항들을 입력한 후에 [Create User] 버튼을 클릭하여 계정을 생성하십시오.
이때 "Username:" 항목에는 관제 서버에서 사용하는 아이디를 입력하십시오. 이제 계정 생성을 완료하였습니다. - 생성한 계정으로 로그인하십시오.
- "서버(S)" 항목에는 Openfire 서버 주소를 입력하십시오.이제 로그인을 완료하였습니다.
- 관제 서버에서 알림을 수신하는 경우, 메시지 팝업창이 화면 가장 상단에 나타나도록 설정합니다. "File"을 선택하여 환경 설정을 클릭하십시오.
- 나타난 화면에서, "알림" 탭을 선택한 후 "팝업으로 보기"와 "윈도우를 앞으로 보내기" 항목을 활성화하십시오. 그런 다음에 [적용] 버튼을 클릭하십시오.
XMPP 설정
XMPP 설정을 위해 “/gampkgs/data/config/xmpp-config.properties” 파일을 열어서 다음 예제를 참고하여 사용자의 경우에 맞게 수정하십시오.
# rabbit wind.rabbit.server.host=127.0.0.1 wind.rabbit.server.port=5673 wind.rabbit.server.username=mccs wind.rabbit.server.password=password wind.xmpp.server.host=xxx.xxx.xxx.xxx wind.xmpp.server.port=5222 wind.xmpp.server.servicename=openfire wind.xmpp.server.username=user_name wind.xmpp.server.password=user_password
위 설정에서 팝업 알림 발송과 관련하여 정보를 수정할 때 확인해야 할 항목들은 다음과 같습니다.
항목 | 설명 |
---|---|
wind.xmpp.server.host= | XMPP 발송 서버 IP 주소를 입력 |
wind.xmpp.server.port= | XMPP 발송 서버 포트를 입력 |
wind.xmpp.server.servicename= | XMPP 서비스이름을 입력 |
wind.xmpp.server.username= | XMPP 사용자 이름을 입력 |
wind.xmpp.server.password= | XMPP 발송자 암호를 입력 |
<표 11> 팝업(XMPP) 알림과 관련하여 수정할 속성값 목록
알림 조회 및 해결
<그림 76> 알림 메인메뉴 화면
- 유형: 설정한 트리거에 따라 심각한 정도나 상태를 나타내는 항목, "해결" 유형의 경우, 담당자가 해결 처리한 알림이라는 의미
- 필터: 알림이 많을 경우, 트리거 플러그인의 종류에 따라 선택해서 선택한 유형에 속하는 알림을 골라 볼 수 있도록 하는 필터, 복수로 선택할 수 있음.
- 미해결 알림: 해결하지 않은 알림들을 모두 볼 때 선택하는 항목, 그 외에는 최근의 알림들을 다양하게 선택할 수 있음.
- 검색 기간: 특정 기간 동안 발생한 알림들로 골라서 볼 때 사용하는 항목으로, 기간을 선택한 후 [조회] 버튼을 클릭
- 해결: 특정 알림을 해결 처리할 때 사용하는 버튼
알림 해결하기
이미 확인한 사항에 대한 알림을 처리하려면, 다음 그림과 같이 해당 알림의 체크박스를 선택하고 [해결] 버튼을 클릭하십시오.