17.6. ISO 업로더 도구

17.6.1. ISO 업로더 도구

ISO 업로더는 ISO 이미지를 ISO 스토리지 도메인에 업로드하기 위한 도구입니다. 이는 Red Hat Virtualization Manager의 일부로 설치됩니다.
ISO 업로더 명령은 engine-iso-uploader입니다. root 사용자로 로그인하고 Red Hat Virtualization 환경의 관리자 인증 정보를 입력하여 이러한 명령을 사용합니다. engine-iso-uploader -h 명령은 engine-iso-uploader 명령의 모든 사용 가능한 옵션 목록을 포함하여 사용 방법을 표시합니다.

17.6.2. engine-iso-uploader 명령 구문

ISO 업로더 명령의 기본 구문은 다음과 같습니다:
engine-iso-uploader [options] list
engine-iso-uploader [options] upload [file].[file]...[file]
ISO 업로더 명령은 listupload의 두 가지 동작을 지원합니다.
  • list 동작은 ISO 파일을 업로드할 수 있는 ISO 스토리지 도메인을 나열합니다. Red Hat Virtualization Manager는 설치 프로세스 도중 Manager가 설치된 시스템에 이러한 목록을 생성합니다.
  • upload 동작은 특정 ISO 스토리지 도메인에 공백으로 구분된 단일 ISO 파일 또는 여러 ISO 파일을 업로드합니다. 기본값으로 NFS가 사용되지만 SSH 또한 사용할 수 있습니다.
ISO 업로더 명령을 사용하는 경우 위의 동작 중 하나를 지정해야 합니다. 또한 upload 동작을 사용하려면 최소 하나의 로컬 파일을 지정해야 합니다.
engine-iso-uploader명령을 상세 지정하기 위한 여러 매개 변수가 있습니다.

일반 옵션

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

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입니다.

ISO 스토리지 도메인 옵션

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

연결 옵션

ISO 업로더는 파일을 업로드하기 위해 기본값으로 NFS를 사용합니다. 이러한 옵션은 SSH 파일 전송을 지정합니다.
--ssh-user=[USER]
업로드에 사용할 SSH 사용자 이름으로 [USER]를 설정합니다. 기본값은 root입니다.
--ssh-port=[PORT]
SSH에 연결 시 사용할 포트로 [PORT]를 설정합니다.
-k [KEYFILE], --key-file=[KEYFILE]
SSH 인증에 사용할 공개키로 [KEYFILE]을 설정합니다. 키가 설정되어 있지 않을 경우 --ssh-user=[USER]로 지정된 사용자의 암호를 입력해야 합니다.

17.6.3. NFS 서버 지정

예 17.5. NFS 서버에 업로드

# engine-iso-uploader --nfs-server=storage.demo.redhat.com:/iso/path upload RHEL6.0.iso

17.6.4. 기본 ISO 업로더 사용

다음은 ISO 업로더와 list 매개 변수의 예입니다. 첫 번째 명령은 사용 가능한 ISO 스토리지 도메인을 나열하며 명령에 사용자가 지정되어 있지 않기 때문에 admin@internal 사용자가 사용됩니다. 두 번째 명령은 NFS 를 통해 지정된 ISO 도메인에 ISO 파일을 업로드합니다.

예 17.6. 도메인 목록 및 이미지 업로드

# engine-iso-uploader list
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):
ISO Storage Domain Name   | Datacenter          | ISO Domain Status
ISODomain                 | Default             | active
# engine-iso-uploader --iso-domain=[ISODomain] upload [RHEL6.iso]
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):

17.6.5. ISO 스토리지 도메인에 VirtIO 및 게스트 도구 이미지 파일 업로드

다음 예에서는 ISODomainvirtio-win.iso, virtio-win_x86.vfd, virtio-win_amd64.vfd, rhev-tools-setup.iso 이미지 파일을 업로드하는 명령을 보여줍니다.

예 17.7. VirtIO 및 게스트 도구 이미지 파일 업로드

# engine-iso-uploader --iso-domain=[ISODomain] upload /usr/share/virtio-win/virtio-win.iso /usr/share/virtio-win/virtio-win_x86.vfd /usr/share/virtio-win/virtio-win_amd64.vfd /usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso

17.6.6. VirtIO 및 게스트 도구 이미지 파일

Windows 가상 머신 용 VirtIO 드라이버가 들어 있는 virtio-win ISO 및 VFD (Virtual Floppy Drive) 이미지와 Windows 가상 머신용 Red Hat Virtualization 게스트 도구가 들어 있는 rhev-tools-setup ISO가 도메인 설치 및 설정 시 ISO 스토리지 도메인에 복사됩니다.
이러한 이미지 파일은 가상 머신에 설치할 수 있는 소프트웨어를 제공하여 성능 및 유용성을 향상시킵니다. 가장 최근의 virtio-winrhev-tools-setup 파일은 Red Hat Virtualization Manager의 파일 시스템에 있는 다음과 같은 심볼릭 링크를 통해 액세스할 수 있습니다:
  • /usr/share/virtio-win/virtio-win.iso
  • /usr/share/virtio-win/virtio-win_x86.vfd
  • /usr/share/virtio-win/virtio-win_amd64.vfd
  • /usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso
이러한 이미지 파일은 설치 프로세스에 의해 로컬로 생성되지 않은 ISO 스토리지 도메인에 수동으로 업로드해야 합니다. engine-iso-uploader 명령을 사용하여 이러한 이미지를 ISO 스토리지 도메인에 업로드합니다. 업로드한 후 이미지 파일은 가상 머신에 연결하여 사용할 수 있습니다.