Versions Compared

Old Version 46

changes.mady.by.user 전수현 (Deactivated)

Saved on

compared with

New Version 47

changes.mady.by.user 전수현 (Deactivated)

Saved on

Key

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

Playce RoRo the next 설치

Note

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

RoRo 설치 파일 다운로드

Info

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

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

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

압축 해제

다운로드 받은 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 패키지가 설치되지 않은 경우 다음 명령을 실행하여 패키지를 설치합니다.

]$ 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 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"

# 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 설치를 추천합니다.)

  • 설치

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

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

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

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

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

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

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

  1. User ID, Password를 입력하고 [Sign in] 버튼을 클릭합니다. (초기 접속 정보 : admin / admin )

  2. 로그인에 성공하면 [Dashboard (Home)] 메뉴로 이동합니다.

Note

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

]$ 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

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

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

# setenv.sh 파일을 실행합니다.

# 실행한 파일 맨 아래 다음과 같이파라미터를 입력합니다.
JAVA_OPTS="$JAVA_OPTS -Droro.admin.password.reset=변경할 비밀번호

# 이후 서버를 재시작합니다.
sh kill.sh, sh startup.sh