17.3. 이미지 업로더 도구

⁠17.3.1. 이미지 업로더 도구

참고

내보내기 스토리지 도메인은 사용되지 않습니다. 스토리지 데이터 도메인을 데이터 센터에서 분리한 후 같은 환경이나 다른 환경의 데이터 센터로 가져오기할 수 있습니다. 그 후에 가상 머신, 플로팅 가상 디스크 이미지, 그리고 템플릿을 가져오기한 스토리지 도메인에서 연결된 데이터 센터로 업로드할 수 있습니다. 스토리지 도메인을 가져오기하는 방법에 대한 자세한 내용은 7.6절. “기존 스토리지 도메인 가져오기”에서 참조하십시오.
engine-image-uploader 명령을 사용하여 내보내기할 스토리지 도메인을 나열하고 가상 머신 이미지를 OVF 또는 OVA 형식으로 내보내기 스토리지 도메인에 업로드하여 Red Hat Virtualization Manager에서 자동으로 인식할 수 있습니다.
OVA는 OVF 파일의 tar 아카이브(archive)입니다.

참고

이미지 업로더는 Red Hat Virtualization에 의해 생성된 gzip으로 압축된 OVF 또는 OVA 파일만 지원합니다.
OVF에는 다음과 같은 형식의 이미지와 마스터 디렉토리가 들어 있습니다: 
|-- images
|   |-- [Image Group UUID]
|        |--- [Image UUID (this is the disk image)]
|        |--- [Image UUID (this is the disk image)].meta
|-- master
|   |---vms
|       |--- [UUID]
|             |--- [UUID].ovf

⁠17.3.2. engine-image-uploader 명령 구문

이미지 업로더 명령의 기본 구문은 다음과 같습니다: 
engine-image-uploader [options] list
engine-image-uploader [options] upload [file].[file]...[file]
이미지 업로더 명령은 list 및 upload 두 동작을 지원합니다.
  • list 동작은 이미지를 업로드할 수 있는 내보내기 스토리지 도메인을 나열합니다.
  • upload 동작은 지정된 내보내기 스토리지 도메인에 이미지를 업로드합니다.
이미지 업로더 명령을 사용하는 경우 위의 동작 중 하나를 지정해야 합니다. 또한 upload 동작을 사용하려면 최소 하나의 로컬 파일을 지정해야 합니다.
engine-image-uploader 명령을 자세히 지정하기 위한 여러 매개 변수가 있습니다. 이러한 매개 변수의 기본값은 /etc/ovirt-engine/imageuploader.conf 파일에서 설정할 수 있습니다.

일반 옵션

-h, --help
이미지 업로더 명령을 사용하는 방법에 대한 정보를 표시합니다.
--conf-file=[PATH]
명령을 사용할 설정 파일로 [PATH]를 설정합니다. 기본값은 etc/ovirt-engine/imageuploader.conf입니다.
--log-file=[PATH]
로그 출력 결과를 작성하기 위해 명령이 사용할 특정 파일 이름으로 [PATH]를 설정합니다. 기본값은 /var/log/ovirt-engine/ovirt-image-uploader/ovirt-image-uploader-[date].log입니다.
--cert-file=[PATH]
engine을 검증하기 위한 인증서로 [PATH]를 설정합니다. 기본값은 /etc/pki/ovirt-engine/ca.pem입니다.
--insecure
engine 검증을 시도하지 않도록 지정합니다.
--quiet
콘솔 출력을 최소로 감소시키는 자동 모드 (quiet mode)를 설정합니다.
-v, --verbose
보다 자세한 콘솔 출력을 표시하는 상세 표시 모드 (verbose mode)를 설정합니다.
-f, --force
강제 모드 (Force mode)는 업로드된 소스 파일이 내보내기 도메인에 있는 기존 파일과 동일한 파일 이름일 경우에 사용해야 합니다. 이 옵션은 기존 파일을 강제로 덮어쓰기합니다.

Red Hat Virtualization Manager 옵션

-u [USER], --user=[USER]
명령 실행에 사용할 사용자 인증을 지정합니다. [USER]은/는 [username]@[domain] 형식으로 지정합니다. 사용자는 지정된 도메인에 존재해야 하며 Red Hat Virtualization Manager가 알고 있어야 합니다.
-r [FQDN], --engine=[FQDN]
이미지가 업로드될 Red Hat Virtualization Manager의 IP 주소 또는 정규화된 도메인 이름을 지정합니다. 이미지 업로더는 Red Hat Virtualization Manager가 설치된 시스템과 동일한 컴퓨터에서 실행되는 것을 전제로 합니다. 기본값은 localhost:443입니다.

내보내기 스토리지 도메인 옵션

다음 옵션은 이미지를 업로드할 내보내기 도메인을 지정합니다. 이러한 옵션은 동시에 함께 사용할 수 없습니다. -e 또는 -n 옵션 중 하나를 사용해야 합니다.
-e [EXPORT_DOMAIN], --export-domain=[EXPORT_DOMAIN]
스토리지 도메인 EXPORT_DOMAIN을 업로드할 대상으로 설정합니다.
-n [NFSSERVER], --nfs-server=[NFSSERVER]
NFS path [NFSSERVER]을/를 업로드할 대상으로 설정합니다.

가져오기 옵션

다음 옵션을 사용하여 이미지를 내보내기 도메인에 업로드할 때 포함된 업로드할 이미지 속성을 사용자 정의할 수 있습니다.
-i, --ovf-id
이미지의 UUID가 업데이트되지 않도록 지정합니다. 기본값으로 명령은 업로드된 이미지의 새 UUID를 생성합니다. 이는 업로드된 이미지와 환경에 이미 존재하는 이미지 사이에서 ID충돌이 발생하지 않게 합니다.
-d, --disk-instance-id
이미지에 있는 각 디스크의 인스턴스 ID 이름이 변경되지 않도록 지정합니다. 기본값으로 명령은 업로드된 이미지에 있는 디스크의 새 UUID를 생성합니다. 이는 업로드된 이미지에 있는 디스크와 환경에 이미 존재하는 디스크 간의 충돌이 발생하지 않게 합니다.
-m, --mac-address
이미지의 네트워크 구성 요소가 해당 이미지에서 제거되지 않도록 지정합니다. 기본값으로 명령은 업로드된 이미지에서 네트워크 인터페이스 카드를 제거하여 환경에 이미 존재하는 다른 가상 머신의 네트워크 카드와 충돌하지 않게 합니다. 이 옵션을 사용하지 않은 경우 관리 포털을 사용하여 네트워크 인터페이스 카드를 새로 가져오기한 이미지에 추가하여 Manager가 MAC 주소 충돌이 발생하지 않게 할 수 있습니다.
-N [NEW_IMAGE_NAME], --name=[NEW_IMAGE_NAME]
업로드될 이미지의 새 이름을 지정합니다.

⁠17.3.3. 이미지 업로더와 호환하는 OVF 아카이브 만들기

개요
engine-image-uploader 도구를 사용하여 업로드할 수 있는 파일을 만들 수 있습니다.
⁠

절차 17.2. 이미지 업로더와 호환하는 OVF 아카이브 만들기

  1. Manager를 사용하여 빈 내보내기 도메인을 생성합니다. 빈 내보내기 도메인을 통해 어떤 디렉토리에 가상 머신이 들어 있는지를 쉽게 확인할 수 있습니다.
  2. 생성한 비어있는 내보내기 도메인에 가상 머신을 내보냅니다.
  3. 내보내기 도메인으로 사용되는 스토리지 서버에 로그인하여 NFS 공유의 root를 찾아 마운트 지점 아래의 서브 디렉토리로 변경합니다. 새 내보내기 도메인으로 시작했으므로 내보내기된 디렉토리 아래에는 하나의 디렉토리만 있습니다. 이에는 images/ 및 master/ 디렉토리가 포함되어 있습니다.
  4. tar -zcvf my.ovf images/ master/ 명령을 실행하여 tar/gzip OVF 아카이브를 생성합니다.
  5. 만든 OVF 파일 (예에서는 my.ovf로 부름)을 전달 받으면 누구나 engine-image-uploader 명령을 사용하여 Red Hat Virtualization Manager로 가져오기할 수 있습니다.
결과
배포할 수 있는 압축된 OVF 이미지 파일이 생성되었습니다. 이 파일을 받으면 누구나 engine-image-uploader 명령을 사용하여 이미지를 Red Hat Virtualization 환경에 업로드할 수 있습니다.

⁠17.3.4. 기본적인 engine-image-uploader 사용 예

다음은 내보내기 스토리지 도메인을 나열하기 위해 engine 업로더 명령을 사용하는 방법의 예입니다:
⁠

예 17.1. 이미지 업로더를 사용하여 내보내기 스토리지 도메인 목록 보기

# engine-image-uploader list
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):
Export Storage Domain Name | Datacenter  | Export Domain Status
myexportdom               | Myowndc 　  | active
다음은 OVF (Open Virtualization Format) 파일을 업로드하는 방법의 예입니다:
⁠

예 17.2. 이미지 업로더를 사용하여 파일 업로드

# engine-image-uploader -e myexportdom upload myrhel6.ovf
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):