Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Playce RoRo

...

설치

Note

Playce RoRo 실행을 위한 필수 모듈 설치 여부를 확인하시기 바랍니다.

...

설치 파일 다운로드

Info

기본 설치 경로는 ‘/opt/roro’를 사용합니다. 

...

Code Block
languagebash
# roro-the-next.tar.gz 파일을 /opt/RoRo에 설치하는 경우 아래와 같이 압축을 해제합니다.
]$ tar xf roro-the-next.tar.gz -C /opt/roro/

# roro-the-next.zip 파일을 /opt/RoRo에 설치하는 경우 아래와 같이 압축을 해제합니다.
]$ unzip roro-the-next.zip -d /opt/roro/

압축 해제 경로가 ${RoRo_Home} 경로가 됩니다.
Note

참고

tar 또는 unzip 패키지가 설치되지 않은 경우 다음 명령을 실행하여 패키지를 설치합니다.

Code Block
]$ sudo yum install -y tar

]$ sudo yum install -y unzip

디렉토리 구성

Directory

Description

/bin

  • 시작, 종료 및 기타 기능을 하는 스크립트 파일이 위치하는 디렉토리

  • *.sh 파일을 사용

/conf

  • 컨테이너의 기본 구성파일로서 가장 중요한 server.xml 파일과 설정 파일들이 위치하는 디렉토리

/logs

  • 기본 로그 파일이 위치하는 디렉토리

/temp

  • 기능 동작시 필요한 파일들이 위치하는 디렉토리

/webapps

  • Playce RoRo the next 웹 애플리케이션이 위치하는 디렉토리

...

환경 설정

Playce RoRo 환경 설정을 위해 ${RoRo_Home}/bin에 위치하는 /setenv.sh 파일을 수정합니다.

Code Block
languagebash
!/bin/sh
 
#################################################
#                                               #
#        Configuraton for Playce RoRo           #
#                                               #
#################################################

# Working directory for RoRo (Inventory, Assessment, Migration and etc.)
WORKING_DIR=

# Bucket name to save disk images for migration (AWS or GCP)
BUCKET_NAME=

# Bucket region about given bucket name for migration (AWS)
BUCKET_REGION=

if [ e$WORKING_DIR = "e" ] ; then
    echo "[Error] WORKING_DIR must be set."
    exit;
fi

if [ e$BUCKET_NAME = "e" ] ; then
    echo "[Warning] BUCKET_NAME is empty and migration will be failed."
fi

if [ e$BUCKET_REGION = "e" ] ; then
    echo "[Warning] BUCKET_REGION is empty and migration to AWS will be failed."
fi

# 로그파일 경로
JAVA_OPTS="$JAVA_OPTS -DLOG_PATH=$CATALINA_HOME/logs/"
 
# 파일 인코딩
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dfile.client.encoding=UTF-8"

# Derby DB 포트를 변경하고 싶은 경우 "roro.derby.server.port" 파라메타를 수정한다.
# 포트를 변경한 경우 "spring.datasource.url" 파라메타도 함께 변경해야 한다.
# DB 경로를 변경하고 싶은 경우 localhost:1527과 roroDB 사이에 경로를 포함한다. (예. localhost:1527//home/bill/DerbyDb/roroDB)
#JAVA_OPTS="$JAVA_OPTS -Droro.derby.server.port=1527"
#JAVA_OPTS="$JAVA_OPTS -Dspring.datasource.url='jdbc:derby://localhost:1527/roroDB;create=true'"
 
# 추가 설정
JAVA_OPTS="$JAVA_OPTS -Xms2048m -Xmx2048m -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=256m"
JAVA_OPTS="$JAVA_OPTS -XX:+UseG1GC"
JAVA_OPTS="$JAVA_OPTS -XX:+UseLargePagesInMetaspace"
JAVA_OPTS="$JAVA_OPTS -XX:+ExplicitGCInvokesConcurrent"
JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"
JAVA_OPTS="$JAVA_OPTS -XX:ReservedCodeCacheSize=512m"
JAVA_OPTS="$JAVA_OPTS -XX:-UseCodeCacheFlushing"
JAVA_OPTS="$JAVA_OPTS -Djava.security.egd=file:/dev/urandom"

# Cron Expression for connection test (Server & Database)
JAVA_OPTS="$JAVA_OPTS -Droro.connection.test.enabled=true"
JAVA_OPTS="$JAVA_OPTS -Droro.connection.test.cron.expression='0 0/5 * * * ?'"

# Cron Expression for Server Assessment Task
JAVA_OPTS="$JAVA_OPTS -Droro.server.assessment.cron.expression='0 0 0 * * ?'"

# Assessment 쓰레드 풀 사이즈 설정
JAVA_OPTS="$JAVA_OPTS -Droro.assessment.threadpool.size=5"

# Server Assessment 스크립트 명령어 동작 대기 시간 (Seconds)
JAVA_OPTS="$JAVA_OPTS -Droro.server.assessment.wait-time=0"

# Server Assessment 스크립트 명령어 재수행 제한 값
JAVA_OPTS="$JAVA_OPTS -Droro.server.assessment.re-try-limit=1"

# Migration 쓰레드 풀 사이즈 설정
JAVA_OPTS="$JAVA_OPTS -Droro.migration.threadpool.size=1"
# Migration 타겟 클라우드 버킷 이름 설정
JAVA_OPTS="$JAVA_OPTS -Droro.migration.bucket.name=$BUCKET_NAME"
# Migration 타겟 클라우드 디폴트 리전 설정
JAVA_OPTS="$JAVA_OPTS -Droro.migration.bucket.region==$BUCKET_REGION" 
# Migration 종료 시 버킷 삭제 설정
JAVA_OPTS="$JAVA_OPTS -Droro.migration.bucket.remove=true" 

# RoRo 작업 경로 설정
JAVA_OPTS="$JAVA_OPTS -Droro.working.dir.path=$WORKING_DIR" 

...

  • 설정 (~/.bash_profile 파일에 JAVA_HOME 및 PATH 환경변수를 다음과 같이 설정합니다.)

Code Block
# ~/.bash_profile을 수정합니다

vi ~/.bash_profile
.중략...

# JDK 설치 경로는 버전 및 시스템에 따라 다를 수 있습니다.  export
JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.9.11-3.el8_3.x86_64
# 기존 PATH에 $JAVA_HOME/bin이 포함될 수 있도록 아래와 같이 추가합니다.

export JAVA_HOME=/usr/lib/jvm/java-11
PATH=$JAVA_HOME/bin:$PATH
...중략:$HOME/bin

...

설치 및 설정이 완료 될 경우 아래와 같이 서비스 화면 연결에 대한 확인을 진행합니다.

  1. ${RoRo_Home}/bin 디렉토리로 접속합니다.

  2. 시스템에 따라 startup.sh 를 실행합니다.

  3. 브라우저에서 http://$IP:$PORT 를 접속하여 아래의 화면을 확인합니다.

...

  1. Image Added

...

  1. 사용자 ID,

...

  1. 비밀번호를 입력하고 [

...

  1. 로그인] 버튼을 클릭합니다. (초기 접속 정보 : admin / admin )

  2. 로그인에 성공하면 [

...

  1. 대시보드] 메뉴로 이동합니다.

Info

비밀번호의 보안을 위해 제품에 설정된 비밀번호를 반드시 변경하시기 바랍니다.

Note

시스템에 firewall가 시스템의 방화벽이 active 상태로 브라우저 접속이 불가능한 경우 다음 명령어를 실행하여 8080 포트의 접속을 허용한다.

Code Block
]$ sudo firewall-cmd --add-port=8080/tcp --permanent

]$ sudo firewall-cmd --add-port=8080/tcp

패스워드 정책/수정 가이드

로그인 성공 이후 패스워드를 변경할 수 있습니다. 서비스 화면 진입 후, 우측 “RoRo Admin”을 클릭합니다.

이후 아래와 같은 Change Password창이 팝업됩니다. 입력 시, Playce RoRo의 패스워드 정책을 따라 입력합니다.

Playce RoRo의 패스워드 정책은 아래와 같습니다.

최소 8자 이상/16자 이하로 구성되어야 합니다

영문/숫자/기호만 사용 가능합니다. 아래는 문자/숫자/기호의 범위 입니다

영문(a-z, A-Z), 숫자(0-9),기호(! @ # $ % ^ & * ( ) _ + - = [ ] |')

...

가이드에 따라 현재 사용 중 인 패스워드와 새롭게 변경 할 패스워드, 새롭게 변경 할 패스워드를 다시 한번 더 입력 후 Save합니다.

이후 로그아웃하고 변경된 패스워드로 다시 로그인합니다.

서버 패스워드를 화면이 아닌 서버 내부에서 파일을 수정할 경우 아래와 같이 진행합니다.

Info

수정 이후에는 서버를 반드시 재 시작 해주어야 합니다.

...