기타 스크립트 사용

ProSync Manager에서 제공되는 스크립트 사용법에 대해 설명한다.

1. ProSync Manager 시작/종료

prosyncmanager 스크립트는 ProSync Manager의 시작,종료와 상태,버전확인의 기능을 사용 할 수 있다.

주의

prosyncmanager.properties가 위치한 디렉토리 경로로 PRSMGR_HOME 환경변수가 설정되어 있어야 한다.

export PRSMGR_HOME={PROSYNCMANAGER_INSTALLATION_PATH}
export PATH=$PATH:$JAVA_HOME/bin:$PRSMGR_HOME:$CATALINA_HOME/bin

사용법

사용 방법은 다음과 같다.

$ prosyncmanager [COMMAND] [OPTION]

COMMAND	설명
help	필요한 pre-requisite 및 command와 사용 예시를 출력한다.
start	ProSyncManager를 시작한다. with-docker OPTION 추가 시, install 스크립트를 통해 repoDB를 설치한 경우 해당 컨테이너를 시작한다.
stop	ProSyncManager를 종료한다. with-docker OPTION 추가 시, install 스크립트를 통해 repoDB를 설치한 경우 해당 컨테이너를 종료한다.
status	ProSyncManager의 backend/frontend 서버와 repoDB 상태를 조회한다.
version	ProSyncManager의 backend/frontend 서버의 버전을 조회한다.

사용 예시

help

prosyncmanager help를 통해 스크립트의 사용법을 알 수 있다

$ ./prosyncmanager help
###############################
  pre-requisite:
   1. PRSMGR_HOME
    ex) export PRSMGR_HOME=`pwd`
   2. intall.cfg
    will use repoDB_dockername for starting docker container
###############################
  commands:
   help - show commands
    prosyncmanager help
   start - start prosyncmanager
    prosyncmanager start [with-docker]
   stop - stop prosyncmanager
    prosyncmanager stop [with-docker]
   status - check BE/FE/RepoDB status
    prosyncmanager status
   version - get BE/FE version
    prosyncmanager version
###############################

start

ProSync Manager를 시작한다.

with-docker OPTION 추가 시, install 스크립트를 통해 repoDB를 설치한 경우 해당 컨테이너를 시작한다.

$ ./prosyncmanager start
Using CATALINA_BASE:   /path/to/prsmgr_home/installation/apache-tomcat
Using CATALINA_HOME:   /path/to/prsmgr_home/installation/apache-tomcat
Using CATALINA_TMPDIR: /path/to/prsmgr_home/installation/apache-tomcat/temp
Using JRE_HOME:        /usr/lib/jvm/jdk1.8.0_311
Using CLASSPATH:       /path/to/prsmgr_home/installation/apache-tomcat/conf:/path/to/prsmgr_home/installation/apache-tomcat/lib/*:/path/to/prsmgr_home/installation/apache-tomcat/bin/bootstrap.jar:/path/to/prsmgr_home/installation/apache-tomcat/bin/tomcat-juli.jar
Using CATALINA_OPTS:
Using CATALINA_PID:    /path/to/prsmgr_home/installation/apache-tomcat/temp/tomcat.pid
Tomcat started.
prosyncmanager started

stop

ProSyncManager를 종료한다.

with-docker OPTION 추가 시, install 스크립트를 통해 repoDB를 설치한 경우 해당 컨테이너를 종료한다.

$ ./prosyncmanager stop
Using CATALINA_BASE:   /path/to/prsmgr_home/installation/apache-tomcat
Using CATALINA_HOME:   /path/to/prsmgr_home/installation/apache-tomcat
Using CATALINA_TMPDIR: /path/to/prsmgr_home/installation/apache-tomcat/temp
Using JRE_HOME:        /usr/lib/jvm/jdk1.8.0_311
Using CLASSPATH:       /path/to/prsmgr_home/installation/apache-tomcat/conf:/path/to/prsmgr_home/installation/apache-tomcat/lib/*:/path/to/prsmgr_home/installation/apache-tomcat/bin/bootstrap.jar:/path/to/prsmgr_home/installation/apache-tomcat/bin/tomcat-juli.jar
Using CATALINA_OPTS:
Using CATALINA_PID:    /path/to/prsmgr_home/installation/apache-tomcat/temp/tomcat.pid
Tomcat stopped.
prosyncmanager stopped

status

ProSyncManager의 backend/frontend 서버와 repoDB 상태를 조회한다.

$ ./prosyncmanager status
server ... not ok
prsmgr_web ... not ok
repoDB ... ok

version

ProSyncManager의 backend/frontend 서버의 버전을 조회한다.

$ ./prosyncmanager version
server ... {
  "commit": "9da481d5",
  "tag": "v4.2",
  "mergeRequest": "!60",
  "buildTime": "2025-04-28T03:12:23Z"
}
prsmgr_web ... {
  "commit": "2a8e0f5",
  "tag": "4.1",
  "mergeRequest": "!14",
  "buildTime": "2025-04-28T03:12:30Z"
}

---

2. 비밀번호 초기화

ProSyncManager가 제공하는 ResetPassword.sh를 사용하여 특정 계정의 비밀번호를 초기화 할 수 있다.

해당 툴은 java 8을 환경으로 수행해야 한다.

주의

호스트 머신의 superuser/관리자 권한이 있는 사용자만 비밀번호 초기화 툴을 사용하여 일반 계정 및 관리자 계정의 비밀번호를 초기화 할 수 있다.

사용법

사용 방법은 다음과 같다.

$ ./ResetPassword.sh --dbuser [dbuser] --dbpassword [dbpassword] --dbname [dbname] --host [host] --port [port] --target [target]

다음은 각 파라미터에 대한 설명이다.

파라미터	설명
dbuser	repoDB의 dbuser로, 설치 시 사용한 install.cfg의 REPODB_USERNAME 값이다.
dbpassword	repoDB 접속에 필요한 password로, 설치 시 사용한 install.cfg의 REPODB_PASSWORD 값이다.
dbname	repoDB의 dbname로, 설치 시 사용한 install.cfg의 REPODB_DBNAME 값이다.
host	접속할 repoDB의 ip로, 설치 시 사용한 install.cfg의 REPODB_IP 값이다.
port	접속할 repoDB의 port로, 설치 시 사용한 install.cfg의 REPODB_PORT 값이다.
target	초기화 하고자 하는 user의 ID이다

사용 예시('admin' 이름의 유저 비밀번호 초기화)

$ sudo ./ResetPassword.sh --dbuser repo_user --dbpassword password --dbname prosyncmanager --host 192.1.3.112 --port 13852 --target admin
Running command: java -jar /home/mujin_gwak/develop/prsmanager/prosyncmanager/installation/repodb/Resetter.jar --dbuser "repo_user" --dbpassword "password" --dbname "prosyncmanager" --host "192.1.3.112" --port "13852" --target "admin"
This app is running on Unix
Password updated successfully!
Reset completed, new password is set for admin.
Password: 17]x;Vi1aMI,
Please change the password after login.

주의

초기화 된 비밀번호는 한 번만 제공되므로 비밀번호 초기화 후 새로운 비밀번호로 변경하는 것을 권장한다.

---

3. repo DB 유저 및 비밀번호 변경

REPO DB의 유저 및 비밀번호 변경 과정에 대해 기술한다.

3.1. ProSync Manager 종료

종료 관련 명령어는 ProSync Manager 시작/종료 를 참고한다.

3.2. 비밀번호 변경 명령어

REPO DB에 접속하여 비밀번호 변경 alter 구문을 수행해야 한다.

아래의 명령어를 통해 접속이 가능하며, 명령어 입력 시 나오는 비밀번호 란에는 install.cfg에 설정되어있던 REPODB_PASSWORD 의 값을 입력한다.

docker exec -it {REPODB_DOCKERNAME} psql -U {REPODB_USERNAME} {REPODB_DBNAME}
Password for user repo_user: {REPODB_PASSWORD}

비밀번호 변경 SQL은 아래와 같다. {REPODB_PASSWORD} 에 새로운 비밀번호를 기입하면 된다.

alter user {REPODB_USERNAME} with password '{REPODB_PASSWORD}'

3.3. prosyncmanager.properties 파일 수정

prosyncmanager.properties 파일에는 ProSyncManager가 사용할 REPO DB의 유저, 비밀번호 정보가 기입되어있다. 해당 정보를 변경한 비밀번호에 맞게 수정해야 한다.

# $PRSMGR_HOME/prosyncmanager.properties
...
# REPO DB
REPODB_USERNAME={REPODB_USERNAME}
REPODB_PASSWORD={REPODB_PASSWORD} # 이 곳에 변경된 비밀번호 기입
REPODB_IP={REPODB_IP}
REPODB_PORT={REPODB_PORT}
REPODB_DBNAME={REPODB_DBNAME}
...

3.4. ProSync Manager 시작

기동 관련 명령어는 ProSyncManager 시작/종료 를 참고한다.