필요한 부분 설치하기

Owned by Copy Page Tree
2018/05/31
6 min read

이 절에서는 필수적이지 않으나 다음과 같이 필요한 부분을 따로 설치하는 작업을 제공합니다. 필요에 맞게 해당하는 부분을 참고하여 작업하십시오.

서버 제어 에이전트 직접 설치하기

DRM 기능을 사용하려면 서버 제어 에이전트를 설치해야 합니다. 제품 내에서 자동으로 설치할 수 있지만, 수동으로 설치해야 할 경우에는 이 절의 내용을 참고하여 작업하십시오.

설치 사전 조건

서버 제어 에이전트를 설치하기 위해서는 jre 6 이상의 버전의 자바(Java)가 설치되어 있어야 합니다. 서버 제어 에이전트를 설치하기 전에, 설치한 자바를 확인하려면 다음 순서대로 작업하십시오.

  1. “JAVA_HOME”을 찾으십시오.
    “JAVA_HOME” 환경 변수가 세팅 됐는지 여부와 “JAVA_HOME” 폴더 아래에 “bin/java”라는 실행파일이 있는지 체크하십시오.
  2. 위 조건을 만족한다면, “JAVA_HOME” 아래의 “bin/java”로 서버 제어 에이전트를 실행하십시오.
  3. 명령어 “java”를 실행할 수 있는지 확인하십시오.
    “java”를 실행할 수 있다면, “type -p java”나 “which java”라는 명령어로 자바 실행 파일의 위치를 확인하고, 이 “java”로 서버 제어 에이전트를 실행하십시오.
  4. 그런 다음, “/usr/bin/java” 파일이 있는지 체크하십시오.
    “/usr/bin/java”는 자바를 설치하면 실행 파일이 있는 기본 위치입니다. 이 파일의 실행 권한이 있다면, 이 자바를 사용하여 서버 제어 에이전트를 실행하십시오.


운영체제에 따라 다르게 설치하기: 리눅스 또는 유닉스

리눅스나 유닉스에서 설치하려면 다음 순서대로 작업하십시오.

  1. 다음 명령어를 활용하여 서버 제어 에이전트를 설치할 폴더를 만드십시오.

    mkdir /opt/gam_agent

  2. 폴더를 작성한 후 “MDRM agent tar” 설치할 운영체제가 있는 곳으로 복사하십시오.

  3. 파일을 1번에 만들어 놓은 폴더로 압축을 푸십시오. 이 방법은 운영체제에 따라 다릅니다.
    리눅스 사용자는 다음 명령어를 사용하십시오.

    tar xvf gam_agent.tar -C /opt/gam_agent

    유닉스에서는 압축 파일을 해당 폴더로 옮긴 후 압축을 풀어야 합니다. 다음 명령어를 사용하십시오.

    mv gam_agent.tar /opt/gam_agent
cd /opt/gam_agent
tar xvf gam_agent.tar

  4. 설치 스크립트를 실행하십시오. 다음은 예시입니다.

    /opt/gam_agent/install.sh /opt/gam_agent 20080 false

    “install.sh” 파일이 받는 변수는 다음과 같이 세 개입니다.
    • 첫번째 변수: MDRM agent home 경로(위 예시에서는 “/opt/gam_agent”)
    • 두번째 변수: MDRM agent web port(위 예제에서는 “20080”)
    • 세번째 변수: https 사용 여부로, “true”나 “false” 입력(값이 “true”일 때는 https 설정 필요)

  5. 관제서버에서 “서버가져오기”를 하십시오.

리눅스나 유닉스에서의 로그 파일 위치

리눅스나 유닉스에서, 로그 파일은 경우에 따라 다음과 같이 만들어집니다.

  • “/var/log” 폴더에 대한 접속 권한이 있는 경우: “/var/log” 폴더 아래에 “gam_agent.log”로 생성됨

    /var/log/gam_agent.log

  • “/var/log” 폴더에 대한 접속 권한이 없는 경우: “/tmp” 폴더 아래에 “gam_agent.log”로 생성됨

    /tmp/gam_agent.log

리눅스나 유닉스에서의 pid 파일 위치

리눅스나 유닉스에서, pid 파일은 경우에 따라 다음과 같이 만들어집니다.

  • "/var/run" 폴더의 접속 권한이 있는 경우: "/var/run/gam_agent" 폴더 아래에 "gam_agent.pid"로 생성됨

    /var/run/gam_agent/gam_agent.pid

  • "/var/run" 폴더의 접속 권한이 없는 경우: "/tmp/gam_agent" 폴더 아래에 "gam_agent.pid"로 생성됨

    /tmp/gam_agent/gam_agent.pid

리눅스에서의 설정 파일 위치

설정 파일은 설치 파일 아래의 “application.properties” 파일입니다.

리눅스에서의 경로는 다음과 같습니다.

/opt/gam_agent/application.properties


운영체제에 따라 다르게 설치하기: 윈도우

윈도우에서 설치하려면 다음 순서대로 작업하십시오.

  1. 가장 먼저 “MDRM agent zip” 파일을 설치할 운영체제가 있는 곳으로 복사하십시오.

  2. 서버 제어 에이전트를 설치할 위치에 압축을 푸십시오.
    예제는 다음과 같습니다.

    c:\Program Files\gam_agent

  3. 설치 스크립트 실행하십시오. 예시는 다음과 같습니다.

    install.bat 20080 false

    install.bat는 아래와 같은 두개 변수를 받습니다.
    • 첫번째 변수: MDRM agent web port(위 예제에서는 “20080”)
    • 두번째 변수: https 사용 여부로, “true”나 “false” 입력(값이 “true”일 때는 https 설정 필요)

  4. 관제서버에서 "서버가져오기"를 하십시오.

설정 파일 위치

설정 파일은 설치 파일 아래의 “application.properties” 파일입니다.

윈도우에서의 경로는 다음과 같습니다.

c:\Program Files\gam_agent\application.properties

알림 처리와 리포트, 공유 기능

관제서버는 이메일, SMS, 팝업 등 다양한 방법으로 이벤트를 사용자에게 알립니다. 알림을 받으려면 다음 부분을 알아 두시면 좋습니다.

  • 이메일 알림: 이메일로 알림을 받으려면, 고객사의 SMTP 서버가 존재해야 함
  • SMS 알림: SMS 발송을 받으려면, 다음 상황들 중 하나가 필요
    • 고객사의 SMS 발송 서버와 연동시키기
    • 맨텍의 SMS 발송 서버를 통해야 함: 이 경우, 고객사에서 외부로 접근이 가능하도록 설정 필요
  • 팝업(XMPP) 알림: 팝업 알림은 XMPP를 통해 가능(별도의 XMPP 서버가 필요)

<그림 8> 사용자 알림


이메일 설정

이 절에서는 다음 그림과 같은 알림 이메일을 발송시키도록 설정하는 작업 방법을 설명합니다.

<그림 9> 이메일 알림

이벤트가 발생했을 때 이메일로 알림을 받아 보시려면, 다음 순서대로 작업하십시오.

  1. 먼저 “/gampkgs/data/config/email-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
# 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=이메일 알림 발송자의 이메일주소를 입력

  2. 템플릿에 포함되어있는 이미지나 MDRM 웹 콘솔 바로가기 URL을 변경하려면 “mail.template=” 항목에 올바른 경로를 입력하십시오.

  3. 그런 다음 /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(), ?, ?, ?)


MDRM의 SMS 알림은 데이터베이스의 특정 테이블에 값을 입력해 두면 발송하는 방식입니다. 위 설정에서 SMS 알림 발송과 관련하여 정보를 수정할 때 확인해야 할 항목들은 다음과 같습니다.

항목설명
jdbc.driverClassName=데이터베이스 드라이버를 입력
jdbc.url=사용하는 데이터베이스 IP 와 이름을 입력
jdbc.username=데이터베이스 접속 계정을 입력
jdbc.password=데이터베이스 접속 계정 암호를 입력
sms.from=문자 발송자의 전화번호를 입력
sms.query=SMS 알림 발송을 위해 특정 테이블에 입력하는 쿼리문이며,
다음과 같은 3가지의 매개변수(“?”)를 순차적으로 전달
? : 받는 사람
? : 보내는 사람
? : 발송 내용
<표 10> SMS 알림 발송과 관련하여 수정할 속성값 목록

팝업 설정(XMPP)

이 절에서는 알림이 팝업으로 나타나도록 설정하는 작업 방법을 설명합니다.

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) 알림과 관련하여 수정할 속성값 목록

알림 수신을 위해 XMPP 설치하기

관제서버 알림을 수신하려면, XMPP 서버와  그 서버의 클라이언트를 설치하시기를 권장합니다. 다음 순서대로 작업하십시오.

  1. XMPP를 지원하는 Openfire를 사용하려면 관리콘솔(9090) 포트와 클라이언트 통신(5222) 포트를 오픈해야 합니다. Openfire는 Docker 이미지로 제공합니다.

  2. 다음 명령어를 사용하여 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
  3. Openfire 기본설정을 진행합니다. http://<Openfire Host>:9090으로 접속하면 설정화면이 나타납니다.
  4. 언어를 고르는 화면에서 "English"를 선택하십시오.
  5. 그런 다음 기본 설정 값을 유지하도록 합니다.
  6. 다음에 나타난 화면에서 "Embedded Database"를 선택하십시오.
  7. 이어서 나타난 설정에서 "Default"를 선택하십시오.
  8. 비밀번호를 설정하십시오.

  9. 관리자 비밀번호를 입력한 후에 [Continue] 버튼을 클릭하십시오.

    주의!

    비밀번호를 입력하고 ��는 과정에서 키보드의 [Enter] 키를 누르면, 관리자 콘솔 화면에 로그인할 수 없는 경우가 발생합니다.

  10. 관리자 콘솔에 접속하고, 설정한 관리자 아이디와 비밀번호를 사용하여 로그인하십시오.

    http://<Openfire Host>:9090


    관리자 계정으로 로그인이 안 된다면 Openfire 컨테이너를 삭제하고 재설치하셔야 합니다.

  11. 다음으로는 XMPP 클라이언트인 Spark를 설치합니다. 먼저 계정을 생성해야 하는데, 계정을 생성하는 방법은 Spark를 사용하는 방법과 Openfire 콘솔을 사용하는 방법 두 가지입니다. 이 매뉴얼에서는 Spark를 사용하는 방법부터 설명하고 Openfire 콘솔을 사용하는 방법을 설명합니다. Spark로 생성하려면 순서23과 24를 참고하시고, Openfire로 생성하려면 순서 25부터 참고하십시오.
  12. Spark를 통해 계정을 생성하려면, Spark의 "계정 생성"을 클릭하십시오.

  13. 계정을 생성하기 위해 필요한 사항들을 입력하십시오.

    "사용자명(U):" 항목에는 관제 서버에서 사용하는 아이디를 입력하고, "서버(S):" 항목에는 Openfire 호스트를 입력합니다.
  14. Openfire 콘솔을 통해 계정을 생성하려면, “http://<Openfire Host>:9090”으로 접속한 다음 "Users/Groups"를 클릭하십시오.
  15. 좌측에 서브 메뉴가 나타나면 "Create New User"를 클릭하십시오.
  16. 관련사항들을 입력한 후에 [Create User] 버튼을 클릭하여 계정을 생성하십시오.

    이때 "Username:" 항목에는 관제 서버에서 사용하는 아이디를 입력하십시오. 이제 계정 생성을 완료하였습니다.
  17. 생성한 계정으로 로그인하십시오.
  18. "서버(S)" 항목에는 Openfire 서버 주소를 입력하십시오.이제 로그인을 완료하였습니다.
  19. 관제 서버에서 알림을 수신하는 경우, 메시지 팝업창이 화면 가장 상단에 나타나도록 설정합니다. "File"을 선택하여 환경 설정을 클릭하십시오.
  20. 나타난 화면에서, "알림" 탭을 선택한 후 "팝업으로 보기"와 "윈도우를 앞으로 보내기" 항목을 활성화하십시오. 그런 다음에 [적용] 버튼을 클릭하십시오.