Versions Compared

Key

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

...

Note

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

설치 파일 다운로드

...

Info

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

Playce RoRo 설치 파일은 tar.gz 파일 형식으로 제공되며, 설치 대상 서버에 업로드한 후 압축을 해제합니다

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

...

설치 파일 다운로드 위치: https://roro-repository.s3.ap-northeast-2.amazonaws.com/release/playce-roro-ext-3.5.0.tar.gz

...

압축 해제

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

Code Block
languagebash
# playce-roro-ext-

...

{VERSION}.tar.gz

...

Info

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

압축 해제

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

Code Block
languagebash
# playce-roro-ext-{VERSION}.tar.gz 파일을 파일을 /opt 에 설치하는 경우 아래와 같이 압축을 해제합니다. (playce 라는 디렉토리가 자동으로 생성됩니다.)
]$ tar xf playce-roro-ext-{VERSION}.tar.gz -C /opt

하위 playce 경로에는 bin, 디렉토리가 ${Playce_Home} 경로가 되며, ${Playce_Home} 경로에는 bin, modules, playce-roro, playce-migrator 디텍토리가 존재합니다.
존재하며 /opt/playce또한 ${Playce_Home}/playce-roro 디렉토리가 ${RoRo_Home} 경로가 됩니다.

...

Playce RoRo 의 기본 설치 포트와 환경 설정 파일은 다음과 같습니다.

  • Gateway 서버: 8080 포트

  • auth OAuth 서버: 8081 포트

  • Playce RoRo: 8082포트

  • Playce RoRo for Java App: 8083 포트

  • 환경 설정 파일: playce/playce-roro/ ${RoRo_Home}/bin/setenv.sh

Code Block
languagebash
#!/bin/sh

#################################################
#                                               #
#        Configuration for Playce RoRo          #
#                                               #
#################################################

# Set JAVA_HOME when default java version is not JDK 11
#JAVA_HOME=/usr/lib/jvm/java-11
//
설치된# 자바Port 버전이 11이 아닌 경우 JAVA_HOME 디렉토리를 설정을 변경합니다.

# Port offset offset for HTTP
PORT_OFFSET=2

# Working directory for RoRo (Inventory, Assessment, Migration and etc.)
WORKING_DIR=/playce/roro
//
Working dir입니다, 아래는 예시로 roro로 지정되어 있습니다

# DB Connection URL 연결할 데이터데이스 URL을 입력합니다. 아래 예시는 MariaDB 기준으로 작성되었습니다.
# 3.5.0 부터는 jdbc:log4jdbc:mariadb://가 아닌 jdbc:mariadb://를 사용합니다.
DB_URL=jdbc:mariadb://localhost:3306/rorodb

# DB Username (데이터베이스 사용자를 입력합니다.)
DB_USERNAME=playce

# DB Password (데이터베이스 패스워드를 입력합니다.)
DB_PASSWORD=playce

# 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$DB_USERNAME = "e" ] ; then
    echo "[Error] DB_USERNAME must be set."
    exit;
fi

if [ e$DB_PASSWORD = "e" ] ; then
    echo "[Error] DB_PASSWORD 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

# 로그파일 경로(Log file path)
JAVA_OPTS="$JAVA_OPTS -DLOG_PATH=$CATALINA_HOME/logs/"
JAVA_OPTS="$JAVA_OPTS -Dlogging.file.name=$CATALINA_HOME/logs/playce-roro.log"
 
# 파일 인코딩(File encoding)
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dfile.client.encoding=UTF-8"

# 추가 설정(Additional config)
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"
JAVA_OPTS="$JAVA_OPTS -Djava.net.preferIPv4Stack=true"
JAVA_OPTS="$JAVA_OPTS -Djava.security.properties=$CATALINA_HOME/conf/security/java.security"

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

# 사전 환경 분석(prerequisite), 평가 수행(assessment), 마이그레이션(migration) 스케줄러 사용여부를 설정합니다.
JAVA_OPTS="$JAVA_OPTS -Denable.prerequisite.schedule=true"
JAVA_OPTS="$JAVA_OPTS -Denable.assessment.schedule=true"
JAVA_OPTS="$JAVA_OPTS -Denable.migration.schedule=true"

# 서버 모니터링 및 주기적 스캔 주기를 설정합니다.
# 서버 모니터링 및 주기적 스캔 여부는 RoRo Console의 Settings 메뉴에서 제어합니다.
JAVA_OPTS="$JAVA_OPTS -Dscheduler.schedule.monitoring.cron='0 0 0/3 * * ?'"
JAVA_OPTS="$JAVA_OPTS -Dscheduler.schedule.scheduled-scan.cron='0 0 0 * * ?'"

# SSH 실행 결과 첫 라인에 [YOU HAVE NEW MAIL]과 같은 시스템 메시지가 포함되는 경우 해당 라인은 제외시킬 수 있는 키워드를 등록한다.
# 대소문자 구분은 없으며 apple,banana|dog,cat 과 같이 여러 세트의 단어를 입력할 수 있으며 실행 결과 첫 라인에 "apple" & "banana"를 포함하거나 "dog" & "cat"을 포함하는지 체크한다.  
#JAVA_OPTS="$JAVA_OPTS -Dssh.skip.messages=you,have,mail"

# BouncyCastleProvider를 java.security의 첫 번째 인덱스로 추가한다.(DH 키 사이즈가 64의 배수가 아닐 때 사용)
#JAVA_OPTS="$JAVA_OPTS -Dssh.use.bouncy.castle=true"

# SSH Connection Timeout (초)
JAVA_OPTS="$JAVA_OPTS -Dssh.connect.timeout=10"

# 상기 설정한 데이터베이스 정보를 사용하기 위해 설정합니다.
JAVA_OPTS="$JAVA_OPTS -Dspring.datasource.url='$DB_URL'"
JAVA_OPTS="$JAVA_OPTS -Dspring.datasource.username='$DB_USERNAME'"
JAVA_OPTS="$JAVA_OPTS -Dspring.datasource.password='$DB_PASSWORD'"

# RoRo Migration config (마이그레이션 정보를 설정합니다.)
JAVA_OPTS="$JAVA_OPTS -Droro.migration.bucket.name=$BUCKET_NAME"
JAVA_OPTS="$JAVA_OPTS -Droro.migration.bucket.region=$BUCKET_REGION"
JAVA_OPTS="$JAVA_OPTS -Droro.migration.bucket.remove=true"
JAVA_OPTS="$JAVA_OPTS -Droro.migration.include.system.uid=false"

# RoRo working directory
JAVA_OPTS="$JAVA_OPTS -Droro.working.dir-path=$WORKING_DIR"

...

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

vi ~/.bash_profile
...

# JDK 설치 경로는 버전 및 시스템에 따라 다를 수 있습니다. 
# 기존 PATH에 $JAVA_HOME/bin이 포함될 수 있도록 아래와 같이 추가합니다.

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

...
  • ${playce_home}/playce로 이동합니다.

Code Block
cd ${playce_home}/playce
  • bin/start-all.sh를 실행합니다.

Code Block
sh bin/start-all.sh

...

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

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

  2. sh startup.sh 를 실행합니다.

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

Info

${Playce_Home}/bin/start-all.sh 로 모든 서버를 일괄적으로 실행할 수도 있으며, 이때는 ${RoRo_Home|/bin/startup.sh 실행 없이 브라우저 접속이 가능합니다.

Image Modified

  • 로그인할 대상 제품으로 Playce RoRo를 선택합니다.

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

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

...