RHEVM シェルガイド

1. root ユーザーとしてクライアントマシンにログインします。
2. コンテンツ配信ネットワークにシステムを登録します。プロンプトが表示されたら、カスタマーポータルのユーザー名とパスワードを入力します。

   # subscription-manager register

3. Red Hat Virtualization のサブスクリプションプールを見つけ、プール ID をメモします。

   # subscription-manager list --available

4. 前の手順で確認したプール識別子を使用して、Red Hat Virtualization のエンタイトルメントをシステムに割り当てます。

   # subscription-manager attach --pool=pool_id

5. 必要なリポジトリーを有効にします。

   # subscription-manager repos --enable=rhel-7-server-rhv-4.1-rpms
   

6. CLI パッケージおよび依存関係をインストールします。

   # yum install ovirt-engine-cli
   

手順1.1 証明書の取得

1. 方法 1: コマンドラインツールを使用して、Manager から証明書をダウンロードします。コマンドラインツールの例には、cURL と Wget などがあります。これらはいずれも複数のプラットフォームで利用できます。
   1. cURL を使用している場合：

      $ curl -o rhvm.cer http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA

   2. Wget を使用している場合は、以下を行います。

      $ wget -O rhvm.cer http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA

2. 方法 2: Web ブラウザーを使用して、にある証明書に移動します。

   http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA

   選択したブラウザーに応じて、証明書はブラウザーのキーストアにダウンロードまたはインポートします。
   1. ブラウザーが証明書をダウンロードする場合 は、ファイルを rhvm.cer として保存します。
      ブラウザーが証明書をインポートする場合： ブラウザーの認証オプションからエクスポートし、rhvm.cer として保存します。
3. 方法 3 - Manager にログインし、トラストストアから証明書をエクスポートし、クライアントマシンにコピーします。
   1. Manager に root ユーザーとしてログインします。
   2. Java keytool 管理ユーティリティーを使用して、トラストストアから証明書をエクスポートします。

      $ keytool -exportcert -keystore /etc/pki/ovirt-engine/.truststore -alias cacert -storepass mypass -file rhvm.cer

      これにより、rhvm.cer という名前の証明書ファイルが作成されます。
   3. scp コマンドを使用して、証明書をクライアントマシンにコピーします。

      $ scp rhvm.cer [username]@[client-machine]:[directory]

手順1.2 クライアントへの証明書のインポート

• クライアントへの証明書のインポートは、クライアント自体が証明書を保存し、解釈する方法に依存します。本ガイドでは、証明書のインポート例を紹介します。Network Security Services (NSS)または Java KeyStore (JKS)を使用しないクライアントについては、証明書のインポートに関する詳細は、クライアントのドキュメントを参照してください。

手順2.1 クイックスタートの例

1. CLI シェルをロードし、Red Hat Virtualization Manager に接続します。

   # ovirt-shell -c --url https://[rhevm-host]/ovirt-engine/api --username [user]@[domain] --ca-file certificate/authority/path/name

2. 環境内の全データセンターを一覧表示します。この例では、Default データセンターを使用します。

   [RHEVM shell (connected)]# list datacenters 
   
   id         : 5e3b55d8-c585-11e1-a7df-001a4a400e0d
   name       : Default
   description: The default Data Center
   

3. すべてのホストクラスターを一覧表示し、関連するクラスター ID またはクラスター名を書き留めます。これは、ホストの追加および仮想マシンの作成時に必要になります。この例では、Default クラスターを使用して Red Hat Virtualization 環境のリソースをグループ化します。

   [RHEVM shell (connected)]# list clusters
   
   id         : 99408929-82cf-4dc7-a532-9d998063fa95
   name       : Default
   description: The default server cluster
   

4. すべての CPU プロファイルを一覧表示し、関連する CPU プロファイル ID をメモします。これは、仮想マシンの作成時に必要になります。この例では、Default CPU プロファイルを使用します。

   [RHEVM shell (connected)]# list cpuprofiles 
   
   id         : 0000001a-001a-001a-001a-00000000035e
   name       : Default
   

5. show-all オプションを使用してすべての論理ネットワークを一覧表示し、環境内の論理ネットワークの詳細を表示します。Red Hat Virtualization Manager は、管理トラフィック用に ovirtmgmt と呼ばれるデフォルトの論理ネットワークを作成します。この例では、Default データセンターで ovirtmgmt 論理ネットワークを使用します。

   [RHEVM shell (connected)]# list networks --show-all
   
   id            : 00000000-0000-0000-0000-000000000009
   name          : ovirtmgmt
   description   : Management Network
   data_center-id: 5e3b55d8-c585-11e1-a7df-001a4a400e0d
   mtu           : 0
   required      : True
   status-state  : operational
   stp           : False
   usages-usage  : VM
   
   

   data_center- id の値は、Default データセンターの ID と一致することに注意してください。
6. 新しいハイパーバイザーとして、Red Hat Enterprise Linux ホストを仮想化環境に追加します。ホストは自動的にアクティベートされます。

   [RHEVM shell (connected)]# add host --name MyHost --address host.example.com --cluster-name Default --root_password p@55w0rd!

7. NFS 共有を作成、アタッチ、およびアクティブ化することで、NFS 共有をデータストレージドメインとして追加します。NFS データストレージドメインは、データセンターに接続されたエクスポートされた NFS 共有です。仮想マシン用のストレージを提供します。storage-address および storage-path を、NFS サーバーの正しい値に置き換えてください。
   1. データストレージドメインを作成します。

      [RHEVM shell (connected)]# add storagedomain --host-name MyHost --type data --storage-type nfs --storage_format v3 --storage-address x.x.x.x --storage-path /exports/data --name DataStorage

   2. 作成したストレージドメインが利用可能であることを確認します。作成プロセスには数分かかる場合があります。status-state が アタッチされていない になったら、次のステップに進むことができます。

      [RHEVM shell (connected)]# show storagedomain DataStorage
      id             : xxxx
      name           : DataStorage
      master         : False
      status-state   : unattached
      ...
      

   3. データストレージドメインをデータセンターに接続します。ストレージドメインは自動的にアクティブ化されます。

      [RHEVM shell (connected)] # add storagedomain --datacenter-identifier Default --name DataStorage

      注記
      ストレージドメインがアクティブ化されていない場合は、以下のコマンドを使用して手動でアクティブ化します。

      [RHEVM shell (connected)]# action storagedomain DataStorage --datacenter-identifier Default activate
      

8. NFS 共有を作成し、アタッチし、アクティベートして、ISO ストレージドメインとして NFS 共有を追加します。NFS ISO ストレージドメインは、データセンターに接続されたエクスポートされた NFS 共有です。DVD/CD-ROM ISO および仮想フロッピーディスク(VFD)イメージファイル用のストレージを提供します。storage-address および storage-path を、NFS サーバーの正しい値に置き換えてください。
   1. ISO ストレージドメインを作成します。

      [RHEVM shell (connected)]# add storagedomain --host-name MyHost --type iso --storage-type nfs --storage_format v3 --storage-address x.x.x.x --storage-path /exports/iso --name ISOStorage

   2. 作成したストレージドメインが利用可能であることを確認します。作成プロセスには時間がかかる場合があります。status-state が アタッチされていない になったら、次のステップに進むことができます。

      [RHEVM shell (connected)]# show storagedomain --name ISOStorage
      id             : xxxx
      name           : ISOStorage
      master         : False
      status-state   : unattached
      ...
      

   3. ISO ストレージドメインをデータセンターに接続します。ストレージドメインは自動的にアクティブ化されます。

      [RHEVM shell (connected)] # add storagedomain --datacenter-identifier Default --name ISOStorage

9. 新しい仮想マシンを作成します。

   [RHEVM shell (connected)]# add vm --name MyVM --cluster-name Default --template-name Blank --memory 536870912 --os-boot boot.dev=hd --cpu_profile-id 0000001a-001a-001a-001a-00000000035e

10. add nic コマンドを使用して、新しいネットワークインターフェイスを追加します。vm-identifier オプションを追加して、インターフェイスを MyVM のサブリソースとして、および ovirtmgmt ネットワークに接続するための network-name オプションを追加します。

    [RHEVM shell (connected)]# add nic --vm-identifier MyVM --name nic1 --network-name ovirtmgmt --bootable true
    

11. add disk コマンドを使用して、新しい仮想ハードディスクを追加します。vm-identifier オプションを追加して、ディスクを MyVM のサブリソースとしてアタッチします。

    [RHEVM shell (connected)]# add disk --vm-identifier MyVM --provisioned_size 8589934592 --interface virtio --format cow --storage_domains-storage_domain storage_domain.name=DataStorage

12. Manager で、仮想マシンで使用する ISO Storage ドメインに ISO イメージをアップロードします。Red Hat Virtualization Manager は、正しいユーザーパーミッションでイメージが正しいディレクトリーパスにアップロードされるように ISO アップローダーツールを提供します。

    # engine-iso-uploader --iso-domain=ISOStorage upload rhel-server-6.6-x86_64-dvd.iso
    Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):

13. CLI シェルで、list files コマンドを使用して、ストレージドメインで利用可能な ISO ファイルを一覧表示します。

    [RHEVM shell (connected)]# list files --storagedomain-identifier ISOStorage

14. インストールメディア用の仮想 CD-ROM ドライブを追加します。vm-identifier オプションを追加して、CD-ROM を MyVM のサブリソースとしてアタッチします。

    [RHEVM shell (connected)]# add cdrom --vm-identifier MyVM --file-id rhel-server-6.6-x86_64-dvd.iso

15. 仮想マシンを起動します。仮想環境が完了し、仮想マシンには正常に動作させるのに必要なすべてのコンポーネントが含まれます。

    [RHEVM shell (connected)]# action vm MyVM start --vm-os-boot boot.dev=cdrom
    

    vm-os-boot オプションの使用に注意してください。これにより、この最初の起動セッションでブートデバイスが cdrom に変更されます。インストール後に、仮想マシンは再起動し、ブートデバイスを hd に戻します。
16. 特定の イベントタイプを表示するには、追加の クエリー オプションと共に list イベント を使用します。仮想マシンの start アクションは、events コレクションに複数のエントリーを追加します。

    [RHEVM shell (connected)]# list events --query "type=153"
    
    id         : 105
    description: MyVM was started by admin (Host: MyHost).
    

    type=153 クエリーは、 ユーザーが仮想マシンを起動するイベントを参照します。
17. show event コマンドを使用して、イベントの包括的な情報を表示します。このコマンドを使用して、タイプ、名前、および ID でイベントを表示でき ます。

    [RHEVM shell (connected)]# show event '60'
    
    id            : 60
    description   : New Tag foo was created by admin@internal.
    code          : 432
    correlation_id: 3e4d4350
    custom_id     : -1
    flood_rate    : 30
    origin        : oVirt
    severity      : normal
    time          : 2013-07-03 10:57:43.257000+03:00
    user-id       : fdfc627c-d875-11e0-90f0-83df133b58cc
    

18. console コマンドを使用して仮想マシンにアクセスします。

    [RHEVM shell (connected)]# console MyVM

    重要
    クライアントマシンに、仮想マシンの ディスプレイタイプ と一致するコンソールアプリケーションがインストールされていることを確認します。利用可能なプロトコルには、SPICE （デフォルト）および VNC が含まれます。