마이그레이션 계획 만들기

로컬 머신에서 소스 머신의 파일 시스템 사본을 만든 후에는 마이그레이션 계획을 준비하기 위해 파일 시스템을 분석해야 합니다. 그런 후 마이그레이션 계획을 사용해서 마이그레이션 아티팩트를 생성할 수 있습니다.

이 페이지에서는 여러 다른 워크로드의 마이그레이션 계획을 준비하는 데 필요한 단계에 대해 설명합니다

Linux VM 컨테이너의 마이그레이션 계획 만들기

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p linux-vm-container \
  -o ANALYSIS_OUTPUT_PATH \
  [ -r skip_size_checks=SKIP_SIZE_CHECKS  ] \
  [ -r big_files_threshold_mb=SIZE_IN_MB ]

다음을 바꿉니다.

  • PATH_TO_COPIED_FILESYSTEM: 복사된 파일 시스템 디렉터리의 경로입니다.
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로
  • SKIP_SIZE_CHECKS: 선택적 매개변수입니다. 기본적으로 false로 설정되며 Migrate to Containers CLI는 이미지 레이어의 크기가 15GB를 초과하지 않는지 확인합니다. 이미지 레이어의 총 크기가 15GB를 초과하면 아티팩트 생성이 실패하고 Migrate to Containers CLI에 오류 메시지가 표시됩니다. 이 크기 확인을 건너뛰려면 매개변수를 true로 설정합니다.
  • SIZE_IN_MB: 선택적 매개변수입니다. 특정 크기를 초과하는 파일을 확인하려면 파일 크기 기준(MB)을 지정합니다. Migrate to Containers CLI에서 지정된 크기 기준을 초과하는 파일을 감지하면 Migrate to Containers CLI는 감지된 파일을 컨테이너 이미지에서 제외하라는 제안과 함께 생성된 마이그레이션 계획에 주석을 추가합니다.

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

Tomcat 워크로드의 마이그레이션 계획 만들기

Tomcat 앱 구성요소의 경우 이 프로세스에는 catalina-homecatalina-base 경로가 입력으로 필요합니다.

이러한 값을 검색하려면 실행 중인 Tomcat 서버 프로세스를 확인합니다.

ps aux | grep catalina

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p tomcat-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r catalina-home=PATH_TO_CATALINA_HOME \
  -r catalina-base=PATH_TO_CATALINA_BASE \
  -r java-version=JAVA_VERSION

다음을 바꿉니다.

  • PATH_TO_COPIED_FILESYSTEM: 복사된 파일 시스템 디렉터리의 경로입니다.
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로입니다.
  • PATH_TO_CATALINA_HOME: Tomcat 설치의 루트 경로입니다.
  • PATH_TO_CATALINA_BASE: 마이그레이션하려는 Tomcat 인스턴스의 런타임 구성에 대한 루트 경로입니다. 베이스가 여러 개이면 콜론으로 구분해야 합니다.
  • JAVA_VERSION: 컨테이너의 Java 버전(X.Y 형식)입니다. 기본 Java 버전은 11.0입니다.

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

WebSphere 워크로드의 마이그레이션 계획 만들기

(선택사항) binaryAppScanner.jar 설정

WebSphere 기존 워크로드를 마이그레이션하거나 다른 Java 환경 간에 마이그레이션을 수행하려면 binaryAppScanner.jar를 설정하면 됩니다. Migrate to Containers CLI는 binaryAppScanner.jar 사용을 자동화하여 새 WebSphere 구성을 생성하고 Java 런타임 현대화를 용이하게 합니다.

binaryAppScanner.jar 설정하기:

  1. IBM 지원에서 설치 프로그램 파일 binaryAppScannerInstaller.jar를 다운로드합니다. 다운로드 중에 라이선스 계약에 동의해야 합니다.

  2. binaryAppScanner.jar 파일의 압축을 풀고 라이선스 계약에 동의합니다.

    java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose INSTALL_LOCATION
    

    다음을 바꿉니다.

    • INSTALL_LOCATION: 추출할 대상 디렉터리. 예를 들어 /tmp를 대상 디렉터리로 지정하면 설치가 완료된 후 binaryAppScanner.jar/tmp/wamt/binaryAppScanner.jar에 제공됩니다.

분석 수행

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r websphere-profile=WEBSPHERE_PROFILE \
  -r websphere-home=WEBSPHERE_HOME \
  -r websphere-java-home=WEBSPHERE_JAVA_HOME \
  -r target-profile=TARGET_PROFILE \
  -r target-version=TARGET_VERSION \
  -r target-edition=TARGET_EDITION \
  -r target-se=TARGET_SE \
  -r target-ee=TARGET_EE \
  -r target-vendor=TARGET_VENDOR \
  -r target-base-image=TARGET_BASE_IMAGE \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

다음을 바꿉니다.

  • PATH_TO_COPIED_FILESYSTEM: 복사된 파일 시스템 디렉터리의 경로
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로
  • WEBSPHERE_PROFILE: 선택적 매개변수. 소스 VM에 사용되는 WebSphere 프로필을 지정합니다. 형식은 [Liberty|traditional]입니다.
  • WEBSPHERE_HOME: 선택적 매개변수. 소스 VM의 애플리케이션 서버 설치 경로를 지정합니다.
  • WEBSPHERE_JAVA_HOME: 선택적 매개변수. 소스 VM의 Java 설치 경로를 지정합니다.
  • TARGET_PROFILE: 선택적 매개변수. 대상 컨테이너에서 사용할 WebSphere 프로필을 지정합니다. 형식은 [Liberty|traditional]입니다. 기본값은 소스 프로필입니다.
  • TARGET_VERSION: 선택적 매개변수. 대상 컨테이너에서 사용할 WebSphere 버전을 지정합니다. 기본값은 소스 버전입니다.
  • TARGET_EDITION: 선택적 매개변수. 대상 컨테이너에서 사용할 WebSphere 버전을 지정합니다. 형식은 [Base|Core|Open|ND]입니다. 기본값은 원본 버전입니다.
  • TARGET_SE: 선택적 매개변수. 대상 컨테이너에서 사용할 Java SE 버전을 지정합니다. 형식은 [SE8|SE11|SE17]입니다. 기본값은 소스 Java SE입니다.
  • TARGET_EE: 선택적 매개변수. 대상 컨테이너에서 사용할 Java EE 또는 자카르타 EE 버전을 지정합니다. 형식은 [EE7|EE8|EE9|EE10]입니다. 기본값은 소스 Java EE 또는 자카르타 EE입니다.
  • TARGET_VENDOR: 선택적 매개변수. 대상 컨테이너에서 사용할 Java 공급업체를 지정합니다. 형식은 [IBM Corporation|Oracle Corporation]입니다. 기본값은 소스 Java 공급업체입니다.
  • TARGET_BASE_IMAGE: 선택적 매개변수. 대상 컨테이너에 사용할 기본 이미지를 지정합니다.
  • PATH_TO_BINARYAPPSCANNER: 선택적 매개변수. 로컬 머신에서 binaryAppScanner.jar 파일의 경로를 지정합니다.

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

WebSphere 기존 워크로드의 마이그레이션 계획 만들기

binaryAppScanner.jar 설정

binaryAppScanner.jar 파일의 최신 버전을 다운로드합니다.

binaryAppScanner.jar 파일을 이미 설치했으면 현재 버전을 확인합니다.

java -jar binaryAppScanner.jar --version

그런 후 파일을 다운로드하기 위해 Migration Toolkit for Application Binaries를 클릭할 때 나타나는 IBM 라이선스에 표시된 버전과 현재 버전을 비교합니다. 버전이 다르면 binaryAppScanner.jar 파일의 최신 버전을 다운로드합니다.

Migrate to Containers CLI는 IBM WebSphere Application Server Migration Toolkit for Application Binaries의 일부로 제공되는 binaryAppScanner.jar 사용을 자동화하여 소스 VM에서 WebSphere Application Server 애플리케이션에 대한 구성 정보 및 파일을 추출합니다.

마이그레이션을 수행하려면 먼저 라이선스 계약을 수락하고 IBM WebSphere Application Server Migration Toolkit for Application Binaries를 다운로드하고 binaryAppScanner.jar 파일을 추출해야 합니다.

binaryAppScanner.jar를 설정하려면 다음 단계를 따르세요.

  1. IBM 지원에서 설치 프로그램 파일 binaryAppScannerInstaller.jar를 다운로드합니다. 다운로드 중에 라이선스 계약에 동의해야 합니다.

  2. 다음 명령어를 실행하여 binaryAppScanner.jar 파일을 추출하고 라이선스 계약에 동의합니다.

    java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose
    
  3. 추출할 대상 디렉터리를 지정합니다. 예를 들어 /tmp를 대상 디렉터리로 지정하면 설치가 완료된 후 binaryAppScanner.jar/tmp/wamt/binaryAppScanner.jar에 제공됩니다.

WAS_HOME 검색

WAS_HOME 환경 변수는 /opt/IBM/WebSphere/AppServer/와 같이 기존 WebSphere Application Server가 설치되는 위치를 지정합니다. Migrate to Containers CLI는 이 값을 사용해서 WebSphere 기존 구성을 올바르게 찾아서 분석합니다.

이 값을 검색하려면 실행 중인 WebSphere Application Server 기존 프로세스를 확인합니다.

ps aux | grep WAS_HOME

분석 실행

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p websphere-traditional-container -o ANALYSIS_OUTPUT_PATH \
  -r was-home=PATH_TO_WAS_HOME \
  --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

다음을 바꿉니다.

  • PATH_TO_COPIED_FILESYSTEM: 복사된 파일 시스템 디렉터리의 경로입니다.
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로
  • PATH_TO_WAS_HOME: WebSphere Application Server 기존 설치의 경로입니다.
  • PATH_TO_BINARYAPPSCANNER: binaryAppScanner.jar 파일의 경로입니다. 예를 들어 /tmp를 대상 디렉터리로 지정하면 binaryAppScanner.jar/tmp/wamt/binaryAppScanner.jar에 제공됩니다.

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

JBoss 워크로드의 마이그레이션 계획 만들기

JBoss 앱 구성요소에서 마이그레이션 계획을 만들려면 JBOSS_HOME 변수가 입력으로 필요합니다.

이 값을 검색하려면 실행 중인 JBoss 서버 프로세스를 확인합니다.

ps aux | grep jboss.home.dir

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p jboss-container \
  -o ANALYSIS_OUTPUT_PATH \
  -r jboss-home=PATH_TO_JBOSS_HOME

다음을 바꿉니다.

  • PATH_TO_COPIED_FILESYSTEM: 복사된 파일 시스템 디렉터리의 경로입니다.
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로입니다.
  • PATH_TO_JBOSS_HOME: JBoss 설치 경로입니다.

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

Apache 워크로드의 마이그레이션 계획 만들기

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p apache-container \
  -o ANALYSIS_OUTPUT_PATH

다음을 바꿉니다.

  • PATH_TO_COPIED_FILESYSTEM: 복사된 파일 시스템 디렉터리의 경로입니다.
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로입니다.

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

WordPress 워크로드의 마이그레이션 계획 만들기

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze \
  -s PATH_TO_COPIED_FILESYSTEM \
  -p wordpress-container \
  -o ANALYSIS_OUTPUT_PATH

다음을 바꿉니다.

  • PATH_TO_COPIED_FILESYSTEM: 복사된 파일 시스템 디렉터리의 경로입니다.
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로입니다.

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

Windows IIS 서비스의 마이그레이션 계획 만들기

분석을 수행하려면 다음 명령어를 실행합니다.

./m2c analyze -s PATH_TO_IMAGE -p windows-iis-container -o ANALYSIS_OUTPUT_PATH

다음을 바꿉니다.

  • PATH_TO_IMAGE: 소스 머신 디스크 이미지의 경로입니다. 여러 -s 플래그를 사용하여 한 번에 디스크 이미지를 두 개 이상 지정할 수 있습니다. 예를 들면 -s PATH_TO_IMAGE_1 -s PATH_TO_IMAGE_2...-s PATH_TO_IMAGE_N입니다.
  • ANALYSIS_OUTPUT_PATH: 분석 출력을 생성할 폴더의 경로

분석이 완료되면 마이그레이션 계획 config.yaml이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.

다음 단계