제니퍼 뷰 서버 설치 및 구성

제니퍼 뷰 서버란?

뷰 서버는 데이터 서버에 접속하여 모니터링하고자 하는 데이터를 화면에 표시하는 역할을 수행하는 서버이다. 복수개의 데이터 서버에 있는 도메인을 선택하여 모니터링 할 수 있다.

뷰 서버에서 데이터를 요청하고 표시하는 모든 기본 단위는 도메인(Domain)이다.

제니퍼5 패키지를 다운로드 받아서 압축을 해제하면 server.view 디렉토리가 생성이된다. 해당 폴더가 제니퍼 뷰 서버이다

제니퍼 뷰 서버 사양

제니퍼 뷰 서버는 기본적으로 데이터 서버와 같은 시스템에 설치하는 것을 권장하므로 제니퍼 데이터 서버 사양과 동일하다.

제니퍼 뷰 서버 디렉토리 구성

제니퍼 뷰 서버의 디렉토리 구성은 아래와 같다.

제니퍼 뷰 서버의 디렉토리 구성

디렉토리명

설명

bin

실행파일들을 포함하고 있는 디렉토리

conf

설정파일들을 포함하고 있는 디렉토리

lib

뷰 서버 구동을 위한 라이브러리

webapp

뷰 서버의 애플리케이션들을 포함한 디렉토리

db_data

기본값으로 설정한 경우 최초 실행 후 생기는 저장 디렉토리

logs

최초 실행 후 생기는 로그 디렉토리

Linux 시스템에서 제니퍼 뷰 서버의 기동 및 중지

제니퍼 뷰 서버 설정

제니퍼 뷰 서버 환경설정

유닉스 환경에서의 뷰 서버 환경설정은 ${JENNIFER_VIEW_SERVER_HOME}/bin/jennifer_view.sh 파일로 제니퍼 뷰서버를 기동하는데 필요한 설정을 가지고 있다. 여기서는 JAVA_HOME, 뷰 서버 홈, 뷰 서버의 설정파일, 뷰 서버 JVM 옵션등을 설정할 수 있다. 아래의 환경변수 값으로 설치되는 환경에 맞게 설정한다.

${JENNIFER_VIEW_SERVER_HOME}/bin/jennifer_view.sh

환경변수

JAVA_HOME

/usr/lib/jvm/java-8-openjdk-amd64

JENNIFER_VIEW_SERVER_HOME

/home/jennifer/jennifer5/server.view

JENNIFER_VIEW_SERVER_CONF

${JENNIFER_VIEW_SERVER_HOME}/conf/server_view.conf

JENNIFER_VIEW_SERVER_LOG_CONF

${JENNIFER_VIEW_SERVER_HOME}/conf/logback.xml

JENNIFER_PLATFORM

java / php / net

JENNIFER_PLATFORM 옵션은 자바, 닷넷, PHP의 모니터링 환경이 부분적으로 상이하기 때문에 플랫폼에 적합하게 보기위해 설정할 수 있는 값이다.

# ----------------------------------------------------------------------
# ----- Customizable Variables -----------------------------------------
# ----------------------------------------------------------------------
JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
JENNIFER_VIEW_SERVER_HOME=$(dirname $(cd "$(dirname "$0")" && pwd))
JENNIFER_VIEW_SERVER_CONF=${JENNIFER_VIEW_SERVER_HOME}/conf/server_view.conf # Must be absolute path.
JENNIFER_VIEW_SERVER_LOG_CONF=${JENNIFER_VIEW_SERVER_HOME}/conf/logback.xml # Must be absolute path.

뷰서버에서 사용하는 자바는 반드시 64비트 jdk 1.8 을 사용한다. (open jdk 1.8도 지원한다.)

뷰 서버의 옵션 설정

제니퍼 뷰 서버를 관리하는데 필요한 기본을 설정하는 파일이다. 기본적으로 뷰 서버의 홈 디렉토리 conf/server_view.conf 에 존재하고 있으며 환경설정 파일에서 위치와 파일명을 변경할 수 있다. 아래는 server_view.conf 에 대한 기본적인 설정에 대한 설명이다.

${JENNIFER_VIEW_SERVER_HOME}/conf/server_view.conf

설정

기본값

설명

server_port

7900

뷰 서버의 접속 포트로 브라우져에서 연결을 위한 포트이다.

db_path

../db_view

뷰 서버 내부적으로 가지고 사용자/화면/권한등의 정보를 저장한다.

report_path

../report

뷰 서버에서 생성한 리포트롤 저장한다.

server_port = 7900
db_path = ../db_view
report_path = ../report

이 외에 뷰서버 옵션으로 자주 사용할만한 옵션들에 대해서는 주석(#)으로 처리되어 있다.

제니퍼 뷰 서버 기동

  1. 뷰 서버의 bin 디렉토리로 이동한다.

cd /home/jennifer/jennifer5/server.view/bin
  1. bin 디렉토리에서 startup_view.sh 를 실행한다.

#
# ./startup_view.sh
#
  1. 뷰 서버가 정상적으로 기동되었는지 확인한다.

2020-08-31 14:42:04.784 [main] INFO  com.aries.view.config.Configure - Configuration file: /home/jennifer/jennifer5/server.view/conf/server_view.conf
2020-08-31 14:42:04.807 [main] INFO  com.aries.view.Main - JAVA HOME : /usr/lib/jvm/java-8-openjdk-amd64/jre
2020-08-31 14:42:04.808 [main] INFO  com.aries.view.Main - JAVA VERSION : 1.8.0_265
2020-08-31 14:42:04.808 [main] INFO  com.aries.view.Main - View server home: /home/jennifer/jennifer5/server.view
2020-08-31 14:42:04.808 [main] INFO  com.aries.view.Main - PlatForm : java
2020-08-31 14:42:04.849 [main] INFO  com.aries.view.Main - View server version: 5.5.2.4
2020-08-31 14:42:04.849 [main] INFO  com.aries.view.Main - System property: user.timezone=Asia/Seoul, locale=en_US, file.encoding=UTF-8
2020-08-31 14:42:04.849 [main] INFO  com.aries.view.Main - Locale detail: user.language=en , user.region=null , user.country=US , user.variant=null
2020-08-31 14:42:04.907 [main] INFO  com.aries.view.Main - War Path : /home/jennifer/jennifer5/server.view/war/jennifer.server.view-5.5.2.4.war
2020-08-31 14:42:04.910 [main] INFO  com.aries.view.Main - Temp Path : /home/jennifer/jennifer5/server.view/temp/5.5.2.4-7900



....


2020-08-31 14:55:52.810 [main] INFO  o.e.j.server.handler.ContextHandler - Started o.e.j.w.WebAppContext@6fe7aac8{Aries View Server,/,file:///home/jennifer/jennifer5/server.view/temp/5.5.2.4-7900/webapp/,AVAILABLE}{/home/jennifer/jennifer5/server.view/war/jennifer.server.view-5.5.2.4.war}
2020-08-31 14:55:52.821 [main] INFO  o.e.jetty.server.AbstractConnector - Started ServerConnector@345965f2{HTTP/1.1,[http/1.1]}{0.0.0.0:7900}
2020-08-31 14:55:52.821 [main] INFO  org.eclipse.jetty.server.Server - Started @6937ms
2020-08-31 14:55:52.821 [main] INFO  com.aries.view.Main - view server startup. address=0.0.0.0, port=7900

제니퍼 뷰 서버 중지

  1. 뷰 서버의 bin 디렉토리로 이동한다.

cd /home/jennifer/jennifer5/server.view/bin
  1. bin디렉토리에서 shutdown_view.sh 를 실행한다.

#
# ./shutdown_view.sh
#
  1. 뷰 서버가 정상적으로 중지되면 아래의 로그와 같이 보여진다.

2020-08-31 15:50:47.229 [pool-1-thread-1] INFO  com.aries.view.util.ShutdownCheck - Request Delete db.shutdown. Path = /home/jennifer/jennifer5/server.view/bin/../db_view/db.shutdown
2020-08-31 15:50:47.229 [pool-1-thread-1] INFO  com.aries.view.Main - shutdown(int status) - [0]

윈도우 시스템에서 제니퍼 뷰 서버의 기동 및 중지

위의 Linux 시스템에서의 뷰서버 기동과 중지와 동일하다.

제니퍼 뷰 서버를 윈도우 서비스로 등록하기

  1. 관리자 권한의 cmd.exe 창을 띄운다.

  2. server.view\bin 디렉토리에서 reg_service.bat 를 실행한다.

등록되는 서비스 이름의 기본값은 "jennifer_view"이고, 이 값을 바꾸고 싶다면 reg_service.bat를 실행하기 전 동일한 폴더에 다음의 INI 파일을 생성해야 한다.

* 32비트의 경우
  jenniferview32.ini

* 64비트의 경우
  jenniferview64.ini

다음은 기본값과 동일한 INI 파일의 내용을 보여준다.

[default]
serviceName=jennifer_view
servicePath=jennifer_view.bat

serviceName 값을 바꾸고 reg_service.bat 파일을 실행하면 서비스 관리자에 보여지는 제니퍼 뷰 서버의 이름이 바뀐다.

reg_service.bat으로 윈도우 서비스 등록 시 기본적으로 전역 환경 변수 PATH에 JAVA HOME 경로가 등록되어 있는지 검사해서 없으면 오류 메시지와 함께 등록에 실패한다. 만약 환경 변수 검사를 건너뛰고 싶다면 "reg_service.bat -nc"와 같이 명령행에 "-nc" 옵션을 주어 실행하면 된다.

화면 접속

크롬으로 제니퍼 뷰 서버로 접속한다. 기본 접속 url port는 7900이다.

뷰서버 최초 실행시

뷰서버의 최고관리자를 생성한다.

최고 관리자를 생성하면 아래와 같이 login화면이 보인다.

로그인화면

최고 관리자에서 생성한 ID로 로그인 하면 아래와 같이 초기화면이 보여진다.

제니퍼 초기화면

데이터 서버의 포트를 5000번 이외의 포트로 사용하고 있는 경우에는 데이터 서버가 연결되지 않아서 아래와 같이 "도메인 설정 정보가 없습니다" 라는 화면이 나온다.

도메인 설정 정보가 없습니다.

"도메인 설정 정보가 없습니다" 라는 메시지가 나올 경우에는 어떤 데이터 서버의 도메인을 연결할지를 결정하여 해당 데이터서버의 도메인을 수동으로 등록한다.

도메인을 등록하기 위해서는 관리화면의 도메인관리 메뉴에서 등록한다.

초기 도메인 추가하기

뷰서버에서 도메인서버를 등록하면 뷰서버 로그에 아래와 같은 메세지가 출력된다.

2020-09-01 16:18:21.802 [NETWORK_IO_EXECUTOR] INFO  c.a.v.c.n.DataServerConnectingThread - Data server session is created. domainId=1000, connection=Local:192.168.0.31:41704-Remote:192.168.0.31:5000

뷰서버에서 도메인 서버를 등록하면 데이터 서버 로그에 아래와 같은 메세지가 출력된다.

2020-09-01 16:18:21.799 KST [:ME:CommandMultiplexer] INFO  c.a.d.n.ViewServerSessionCreationHandler - View server session is created. domainId=1000, connection=Local:192.168.0.31:5000-Remote:192.168.0.31:41704

인스턴스 자동 추가 버튼을 클릭하면 자동으로 인스턴스가 등록된다.

제니퍼 데이터, 뷰 서버 업그레이드

  1. 업그레이드할 버전의 파일을 다운로드 받는다.

  2. 제니퍼 설정화면에서 제니퍼 서버업그레이드 메뉴로 들어가서 다운로드 받은 파일을 선택한다.

serverUpgrade