설치 및 파라미터 설정
ProSync Manager를 설치하는 과정에 대해 설명한다.
1. 설치 파라미터 설정
$PRSMGR_HOME 에서 install.cfg 파일을 열어 ProSync Manager 설치에 필요한 파라미터 값을 설정한다.
이 때 각 파라미터들은 개행으로 구분하며, 파라미터 이름과 값 사이에는 공백없이 등호(=) 하나만을 입력한다.
ROOT_ID=admin
ROOT_PW=admin
SERVER_IP=localhost
SERVER_PORT=8080
REPODB_IP=localhost
REPODB_PORT=13852
REPODB_USERNAME=repo_user
REPODB_PASSWORD=password
REPODB_DBNAME=prosyncmanager
REPODB_DOCKERNAME=prosyncmanager
# set at the same time when mounting the repodb volume
#REPODB_PATH=$PRSMGR_HOME/repodb/data
#REPODB_LOG_PATH=$PRSMGR_HOME/repodb/log
# for repoDB management
REPODB_SUPERUSER_NAME=prsmgr_superuser
REPODB_SUPERUSER_PASSWORD=prsmgr_password
# for repoDB shared buffers(B, kB, MB, GB, TB)
# 0 is the setting that makes it determined based on the value according to the system memory.
REPODB_SHARED_BUFFERS=0
# if you need, enable and type the path to jar
# JDBC_ORACLE=/path/to/ojdbc.jar
# Optional: if the Oracle database uses a character set not included in the JDBC driver, add orai18n jar (e.g., KO16MSWIN949)
# JDBC_ORACLE_I18N=/path/to/orai18n.jar
다음은 각 파라미터에 대한 설명이다.
ROOT_ID
ProSync Manager 의 Root 계정 ID 이다.
admin
ROOT_PW
ProSync Manager의 Root 계정 비밀번호 이다.
admin
SERVER_IP
ProSyncManager의 접속 ip다.
localhost
SERVER_PORT
ProSyncManager의 접속 port다.
8080
REPODB_IP
ProSync Manager repoDB의 접속 ip다.
localhost
REPODB_PORT
ProSync Manager repoDB의 접속 port다.(범위: 0 - 65535)
13852
REPODB_USERNAME
ProSync Manager repoDB의 user name 이다.
repo_user
REPODB_PASSWORD
ProSync Manager repoDB의 REPODB_USERNAME에 대한 비밀번호다.
password
REPODB_DBNAME
ProSync Manager repoDB의 DB이름이다.(범위: 0 - 63Byte)
prosyncmanager
REPODB_DOCKERNAME
ProSync Manager repoDB의 docker 컨테이너 명이다.
prosyncmanager
REPODB_PATH
ProSync Manager repoDB의 데이터가 저장될 경로이다.
지정하지 않는 경우, docker가 관리하는 기본 경로에 저장된다.
$PRSMGR_HOME/repodb/data
REPODB_LOG_PATH
ProSync Manager repoDB의 로그가 저장될 경로이다.
지정하지 않는 경우, docker가 관리하는 기본 경로에 저장된다.
$PRSMGR_HOME/repodb/log
REPODB_SUPERUSER_NAME
ProSync Manager repoDB의 superuser 명이다.
prsmgr_superuser
REPODB_SUPERUSER_PASSWORD
ProSync Manager repoDB의 superuser에 대한 비밀번호이다.
prsmgr_passsword
REPODB_SHARED_BUFFERS
ProSync Manager repoDB 로 사용하는 postgreSQL 에서 최적화를 위해 shared_buffers 를 전체 메모리의 일정 비율로 사용하기 때문에 메모리가 부족한 경우 repoDB 기동이 실패한다. 따라서 사용자가 해당 사이즈를 강제할 수 있도록 하는 파라미터 이며, 0(default) 일 경우 system 의 계산에 따른다.(0, 128kB - ... )
0
JDBC_ORACLE
ProSync Manager에서 사용할 Oracle JDBC의 경로이며, ProSync 구성에 Oracle이 포함 된 경우에 설정해야한다. Oracle이 설치된 일반적인 환경에서$ORACLE_HOME/jdbc/lib/ojdbc.jar에 위치한다.
null
JDBC_ORACLE_I18N
Oracle server의 character set이 Oracle JDBC에 포함되지 않는 경우(e.g., KO16MSWIN949), i18n에 해당되는 jar파일의 경로를 설정해야한다. Oracle이 설치된 일반적인 환경에서$ORACLE_HOME/jlib/orai18n.jar에 위치한다.
null
2. 설치
파라미터 설정 후 install.sh 스크립트를 실행하여 설치를 수행한다.
install.sh 스크립트는 다음과 같이 실행할 수 있다.
. $PRSMGR_HOME/install.sh다음은 설치 중 옵션을 선택하는 절차에 대한 설명이다.
want to clean previously deployed application?
이전에 deploy 된 application 이 존재할 경우 나타나는 절차이며, 기 존재하던 deployed application을 없애고 싶을 경우 y 를 입력한다.
install repoDB?
REPO DB 를 새로이 install 할 건지 묻는 절차이며, 기 존재하던 REPO DB를 새로이 설치하고 싶을 경우 y 를 입력한다.
want remove container?
이미 'prosyncmanager'라는 도커 컨테이너가 존재할 경우 나타나는 절차이 며, 기존재하는 도커 컨테이너를 없애고 싶을 경우 y 를 입력한다.
start server?
서버 설치가 완료되고 서버를 기동할지 물어보는 절차이며, 서버 기동을 원할 경우 y 를 입력한다.
다음은 설치 예시이다.
$ . $PRSMGR_HOME/install.sh
want to clean previously deployed application? (y/n): y
**********************************************************************
* clean webapps directory
**********************************************************************
clean webapps directory complete
install repoDB? (y/n): y
**********************************************************************
* install repoDB
**********************************************************************
there's container whose name is 'prosyncmanager'
want remove container (y/n): y
8288a8287696
8288a8287696
container whose name is 'prosyncmanager' removed
container prosyncmanager created
==============================DOCKER LOG==============================
...
repoDB created
...
============================DOCKER LOG END============================
repoDB restarted
**********************************************************************
* create meta tables
**********************************************************************
meta tables created
**********************************************************************
* create superuser
**********************************************************************
superuser created
**********************************************************************
* restart repoDB
**********************************************************************
repoDB started
**********************************************************************
* repoDB install finished
**********************************************************************
repoDB install complete
**********************************************************************
* Extract Tomcat
**********************************************************************
Applying SERVER_PORT to tomcat server.xml...
Copying WAR files to the webapps directory...
**********************************************************************
* Configure Tomcat
**********************************************************************
PRSMGR_HOME=/path/to/prsmgr_home
CATALINA_BASE=/path/to/prsmgr_home/apache-tomcat
CATALINA_HOME=/path/to/prsmgr_home/apache-tomcat
CATALINA_PID=/path/to/prsmgr_home/apache-tomcat/temp/tomcat.pid
start server? (y/n): y
Starting Tomcat...
Using CATALINA_BASE: /path/to/prsmgr_home/apache-tomcat
Using CATALINA_HOME: /path/to/prsmgr_home/apache-tomcat
Using CATALINA_TMPDIR: /path/to/prsmgr_home/apache-tomcat/temp
Using JRE_HOME: /usr/lib/jvm/jdk1.8.0_311
Using CLASSPATH: /path/to/prsmgr_home/apache-tomcat/conf:/path/to/prsmgr_home/apache-tomcat/lib/*:/path/to/prsmgr_home/apache-tomcat/bin/bootstrap.jar:/path/to/prsmgr_home/apache-tomcat/bin/tomcat-juli.jar
Using CATALINA_OPTS:
Using CATALINA_PID: /path/to/prsmgr_home/apache-tomcat/temp/tomcat.pid
Tomcat started.
prosyncmanager started
**********************************************************************
* Install Done.
* URL : http://localhost:8080/
* ID / PW : admin/admin
**********************************************************************설치 중 오류가 발생할 경우 디버깅이 가능하도록 오류가 발생한 부분 또는 문장과 관련 오류 메시지를 로그 파일에 출력하고 설치를 중단한다. 오류에 대한 자세한 내용은 install.log 파일로 확인 가능하다.
3. 설치 확인
install log 최하단에 확인되는 URL로 접속하여 로그인과 같이 화면이 뜨는지와, install.cfg에 설정한 ID/PW로 로그인 되는지 확인한다.
Last updated