마이그레이션 계획 만들기
로컬 머신에서 소스 머신의 파일 시스템 사본을 만든 후에는 마이그레이션 계획을 준비하기 위해 파일 시스템을 분석해야 합니다. 그런 후 마이그레이션 계획을 사용해서 마이그레이션 아티팩트를 생성할 수 있습니다.
이 페이지에서는 여러 다른 워크로드의 마이그레이션 계획을 준비하는 데 필요한 단계에 대해 설명합니다
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-home
및 catalina-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
설정하기:
IBM 지원에서 설치 프로그램 파일
binaryAppScannerInstaller.jar
를 다운로드합니다. 다운로드 중에 라이선스 계약에 동의해야 합니다.binaryAppScanner.jar
파일의 압축을 풀고 라이선스 계약을 수락합니다.java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose INSTALL_LOCATION
다음을 바꿉니다.
- INSTALL_LOCATION: 추출할 대상 디렉터리.
예를 들어
/tmp
를 대상 디렉터리로 지정하면 설치가 완료된 후binaryAppScanner.jar
이/tmp/wamt/binaryAppScanner.jar
에 제공됩니다.
- INSTALL_LOCATION: 추출할 대상 디렉터리.
예를 들어
분석 수행
분석을 수행하려면 다음 명령어를 실행합니다.
./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
를 설정하려면 다음 단계를 따르세요.
IBM 지원에서 설치 프로그램 파일
binaryAppScannerInstaller.jar
를 다운로드합니다. 다운로드 중에 라이선스 계약에 동의해야 합니다.다음 명령어를 실행하여
binaryAppScanner.jar
파일을 추출하고 라이선스 계약에 동의합니다.java -jar binaryAppScannerInstaller.jar --acceptLicense --verbose
추출할 대상 디렉터리를 지정합니다. 예를 들어
/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
이 포함된 지정된 출력 경로에 새 디렉터리가 생성됩니다.
다음 단계
- 다음에 대한 마이그레이션 계획을 맞춤설정하는 방법을 알아봅니다.