설치 및 실행

1 Playce RoRo the next 설치
- 1.1 RoRo 설치 파일 다운로드
- 1.2 압축 해제
2 디렉토리 구성
3 Playce RoRo the next 환경 설정
4 실행 방법
5 패스워드 정책/수정 가이드

Playce RoRo the next 설치

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

사용환경 페이지

RoRo 설치 파일 다운로드

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

Playce RoRo the next 설치 파일은 tar.gz, zip 파일 형식으로 제공되며, 설치 대상 서버에 업로드한 후 설치 홈 디렉토리 '${RoRo_Home}'에 압축을 해제합니다

Playce RoRo 설치 파일은 제품 홈페이지에서 다운로드 받을 수 있습니다.

압축 해제

다운로드 받은 RoRo 설치 파일을 특정 경로에 설치하기 위해 다음 명령을 사용합니다.

# 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} 경로가 됩니다.

참고

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

]$ sudo yum install -y tar

]$ sudo yum install -y unzip

디렉토리 구성

Directory	Description

Directory	Description
/bin	시작, 종료 및 기타 기능을 하는 스크립트 파일이 위치하는 디렉토리 *.sh 파일을 사용
/conf	컨테이너의 기본 구성파일로서 가장 중요한 server.xml 파일과 설정 파일들이 위치하는 디렉토리
/logs	기본 로그 파일이 위치하는 디렉토리
/temp	기능 동작시 필요한 파일들이 위치하는 디렉토리
/webapps	Playce RoRo the next 웹 애플리케이션이 위치하는 디렉토리

Playce RoRo the next 환경 설정

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

!/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"

# 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"

실행 방법

RoRo를 실행하기 위해서는 Java Development Kit 11 이상이 설치되어야 합니다.

java -version 명령을 실행하여 java 명령을 찾을 수 없거나 버전이 낮은 경우 다음과 같이 java 패키지를 설치하고 설정합니다. (JRE 설치 시 일부 기능에 제한이 생길 수 있어 JDK 설치를 추천합니다.)

설치

]$ sudo yum install -y java-11-openjdk-devel

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

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

${RoRo_Home}/bin 디렉토리로 접속합니다.
시스템에 따라 startup.sh 를 실행합니다.
브라우저에서 http://$IP:$PORT 를 접속하여 아래의 화면을 확인합니다.

User ID, Password를 입력하고 [Sign in] 버튼을 클릭합니다. (초기 접속 정보 : admin / admin )
로그인에 성공하면 [Dashboard (Home)] 메뉴로 이동합니다.

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

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

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

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

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

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

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