Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

신규 패치 또는 버그로 인한 패치는 아래 가이드라인을 통해 3.5.0 버전의 경우는 Playce RoRo v3.5.0 & Playce RoRo for Java App v1.0.0 통합패키지로 인해, 신규 설치가 아닌 경우 아래 가이드에 따라 진행합니다.

Info

설치 경로 및 구성 파일은 다를 수 있으니 반드시 패치 전 위치를 확인 및 백업 후, 패치 작업을 진행합니다.

3.5.0 버전부터 RoRo_Home 변경되었습니다. (기존 ‘~/playce-roro’ 에서 ‘~/playce/playce-roro’ 로 변경)

Code Block
languagebash
#### 본 패치 가이드는 간단한 예시를 기준으로 작성되었습니다.

### Step1 실행 중인 Playce-RoRo를 중지합니다.
]$ cd /opt/serversrorosrv/playce-roro/bin
]$ sh kill.sh
Code Block
languagebash
### Step2 RoRo가 중지된 것을 확인 후, AS-IS Playce RoRo 백업 작업을 진행합니다.
]$ ps -ef | grep roro # roro 프로세스 확인
]$ mv /opt/serversrorosrv/playce-roro /opt/serversrorosrv/playce-roro-{version}-backup
Code Block
languagebash
### Step3 신규 패치할 Playce RoRo를 RoRo 3.5.0를 다운로드 받고 copy 혹은 설치 경로에 위치 시킵니다.
### 신규 다운로드 경로는 신규 릴리즈 시 홈페이지(https://www.play-ce.io/resource.html#playce-roro) (size : 675MB)
### 또는 운영 담당자를 통해 전달 받으실 수 있습니다.

]$ cp playce-roro-ext-3.5.0.tar.gz /opt/servers/downloads
]$ cd /opt/serversrorosrv
]$ tar xf /downloads/playce-roro-ext-3.5.0.tar.gz -C /opt/rorosrv

### 3.5.0 버전부터 RoRo_Home 변경되었습니다.
### 기존 ‘~/playce-roro’ 에서 ‘~/playce/playce-roro’ 로 변경
Code Block
languagebash
### Step4 기존 구성파일을구성파일 복사합니다적용합니다.
### 구성기존 정보의버전에서 변경패치 필요진행 시 setenv.sh 파일의파일을 구성그대로 정보를복사하면 변경합니다안됩니다. 
### 버전이 변경됨에 따라 기존 구성화일의 (1)~(3) 하기사항 및 "JAVA_OPTS 변경사항" 확인하여 반영
### 신규 setenv.sh 파일과 비교하여 파일의수정해야 내용이하며, 수정될jdbc url에 있으니log4jdbc는 비교 작업이이상 선행되어야사용되지 합니다않습니다.

]$ cdcat /opt/serversrorosrv/playce-roro-{version}-backup/bin/setenv.sh  <<<<< 기존 버전
]$ cpvi /opt/serversrorosrv/playce/playce-roro-{version}-backup/bin/setenv.sh             <<<<< 신규 3.5.0 버전 

### (1) Working directory for RoRo (Inventory, Assessment, Migration and etc.)
### (2) DB Connection URL (log4jdbc 삭제, db name 확인 (roro (O), rorodb (x))
### (3) DB Username/Password 
Code Block
languagebash
### Step5-1 roro DB 변경사항이 있는 경우 변경 사항을 적용합니다.
### 3.4.1-to-3.5.0 에서는 DB 변경사항은 없습니다.
### 3.4.0 이하 버전에 3.5.0 패치인 경우는, 기존 버전부터 현재 버전까지 해당하는 sql 파일을 실행합니다.
]$ cd /opt/rorosrv/serversplayce/playce-roro/db_patch
]$ mysql -u roro -p roro < 3.3.2.3-3.23.43.sql
]$ mysql -u roro -p roro < 3.23.43-3.34.0.sql

### Step5-2 추가 DB 생성 등 변경 사항을 적용합니다. (oauthdb, migratordb)
### DB 서버와 RoRo 설치 서버가 동일 호스트인 경우 아래와 같이 localhost에서의 접근을 추가한다.

]$ mysql -u root -p
--- oauthdb
CREATE DATABASE oauthdb CHARACTER SET utf8 COLLATE utf8_bin;
GRANT ALL PRIVILEGES ON oauthdb.* TO playce@'%' IDENTIFIED BY 'playce';
GRANT ALL PRIVILEGES ON oauthdb.* TO playce@'localhost' IDENTIFIED BY 'playce'; 
FLUSH PRIVILEGES;

--- migratordb
CREATE DATABASE migratordb CHARACTER SET utf8 COLLATE utf8_bin;
GRANT ALL PRIVILEGES ON migratordb.* TO playce@'%' IDENTIFIED BY 'playce';
GRANT ALL PRIVILEGES ON migratordb.* TO playce@'localhost' IDENTIFIED BY 'playce';
FLUSH PRIVILEGES;

### 참고 : 추가 DB 생성 여부 확인
]$ mysql -uplayce -pplayce oauthdb
...(중략)
MariaDB [oauthdb]>

]$ mysql -uplayce -pplayce migratordb
...(중략)
MariaDB [migratordb]>
Code Block
languagebash
### Step6 신규 Playce RoRo를 RoRo 3.5.0 통합 패키지를 실행합니다.
]$ cd /opt/serversrorosrv/playce-roro/bin
]$ sh startupstart-all.sh
Code Block
languagebash
### Step7 실행 로그 확인 및 페이지 접속을 해서 정상적으로 실행되는지 확인합니다.
### Web Console (ex.Chrome) 에서 {ip address}:{port} 로 페이지 접속
]$ cd /opt/serversrorosrv/playce/playce-roro/bin
]$ sh tail.sh       # 로그 모니터링 or
]$ tail -f /opt/rorosrv/serversplayce/playce-roro/logs/catalina.out     # 로그 모니터링

패치가 완료되서 Playce RoRo 서버에 접속하여 정상적으로 구동되는지 확인하고 하단의 그림과 같이 로그인 화면의 Playce RoRo Version 정보가 패치된 버전인지 확인하도록 합니다.

...

  • 참고 1. 통합 패키지 구동/정지

Code Block
--- 통합 패키지 구동/정지
]$ sh /opt/rorosrv/playce/bin/start-all.sh
]$ sh /opt/rorosrv/playce/bin/stop-all.sh
  • 참고 2. 통합 패키지 설치 이후 구동 확인

Code Block
### 8080~8083 4개의 port open 확인
]$ netstat -tnlp | grep 808
tcp        0      0 0.0.0.0:8080            0.0.0.0:*               LISTEN      6059/java
tcp        0      0 0.0.0.0:8081            0.0.0.0:*               LISTEN      6076/java
tcp        0      0 0.0.0.0:8082            0.0.0.0:*               LISTEN      6095/java
tcp        0      0 0.0.0.0:8083            0.0.0.0:*               LISTEN      6129/java
  • 참고 3. 통합 패키지 구동 후 roro 단독 구동/정지는 동일 (단, 통합 패키지 프로세스가 구동되지 않으면 roro 로그인 불가)

Code Block
--- start
]$ sh /opt/rorosrv/playce/playce-roro/bin/startup.sh

--- stop
]$ sh /opt/rorosrv/playce/playce-roro/bin/kill.sh

--- monitoring
]$ sh /opt/rorosrv/playce/playce-roro/bin/tail.sh
  • 참고 4. 신규 3.5.0 버전에서 추가된 환경 변수 setenv.sh

Code Block
# Set JAVA_HOME when default java version is not JDK 11
#JAVA_HOME=/usr/lib/jvm/java-11

# add for 3.5.0
# Port offset for HTTP
PORT_OFFSET=2

# Additional config
(...중략...)
JAVA_OPTS="$JAVA_OPTS -Dhttp.port=$(expr 8080 + $PORT_OFFSET)"
JAVA_OPTS="$JAVA_OPTS -Dajp.port=$(expr 8009 + $PORT_OFFSET)"
JAVA_OPTS="$JAVA_OPTS -Dssl.port=$(expr 8443 + $PORT_OFFSET)"
JAVA_OPTS="$JAVA_OPTS -Dshutdown.port=$(expr 8005 + $PORT_OFFSET)""

# Use BouncyCastleProvider as first (Use when DH key size is not multiple of 64)
#JAVA_OPTS="$JAVA_OPTS -Dssh.use.bouncy.castle=true"

# SSH Connection Timeout (seconds)
JAVA_OPTS="$JAVA_OPTS -Dssh.connect.timeout=10"
  • 초기화면 변경

...