Red Hat Enterprise Virtualization への Red Hat CloudForms のインストール

Red Hat CloudForms 4.1

Red Hat Enterprise Linux OpenStack Platform 環境に Red Hat CloudForms アプライアンスをインストール/設定する方法

Red Hat CloudForms Documentation Team

概要

本ガイドは、Red Hat Enterprise Virtualization 環境への Red Hat CloudForms のインストールおよび設定方法を説明します。

1. Red Hat CloudForms のインストール

Red Hat CloudForms は、わずかな手順でインストールでき、すぐに設定の準備が整います。Red Hat カスタマーポータルから Red Hat CloudForms を仮想マシンのイメージテンプレートとしてダウンロードした後に、インストールプロセスでは、サポートされる仮想化またはクラウドプロバイダーにアプライアンスをアップロードするステップを実行します。

重要

Red Hat CloudForms アプライアンスのインストール後には、Red Hat CloudForms のデータベースの設定が必要になります。「Red Hat CloudForms のデータベースの設定」を参照してください。

1.1. Red Hat CloudForms アプライアンスの取得

  1. access.redhat.com に移動して、顧客アカウントの情報を使用して Red Hat カスタマーポータルにログインします。
  2. メニューバーで ダウンロード をクリックします。
  3. A-Z をクリックして、製品のダウンロードをアルファベット順に並べ替えます。
  4. Red Hat CloudForms → 最新版のダウンロード をクリックして、製品ダウンロードページにアクセスします。
  5. インストーラーとイメージの一覧から、CFME Red Hat Virtual Appliance のダウンロードリンクを選択します。

1.2. Red Hat Enterprise Virtualization Manager へのアプライアンスのアップロード

Red Hat CloudForms Management Engine アプライアンスファイルを Red Hat Enterprise Virtualization Manager システムにアップロードするには、以下のような要件があります。

  • /tmp があるローカルパーティションと export ドメインの両方においてストレージ領域 44 GB (OVF アーカイブは、ローカルの /tmp ディレクトリー内で拡張されるため)。

  • engine-image-uploader を含む rhevm-image-uploader パッケージをローカルマシンにインストールします。 

    # yum install rhevm-image-uploader

    engine-image-uploader スクリプトを使用する場合は -v (詳細ロギング) を使用してアップロードの進捗を確認することを推奨します。

  • インフラストラクチャーによっては、アップロードに約 90 分程度割り当てるようにしてください。
  • OVF がアップロードされ、テンプレートとしてインポートされたら、テンプレート自体にネットワークアダプターを追加します。

1.3. イメージアップローダーツールの使用

engine-image-uploader コマンドは、エクスポートストレージドメインを一覧表示し、エクスポートドメインに仮想マシンイメージを OVF 形式でアップロードして、Red Hat Enterprise Virtualization Manager で自動認識させることができます。

注記

イメージアップローダーは、Red Hat Enterprise Virtualization によって作成された gzip 圧縮済みの 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

イメージアップローダーコマンドの基本構文は以下の形式です。 

engine-image-uploader [options] listengine-image-uploader [options] upload [file].[file]...[file]

イメージアップローダーのコマンドは、list と upload の 2 つのアクションをサポートしています。

  • list アクションは、イメージをアップロードすることができるエクスポートストレージドメインを一覧表示します。
  • upload アクションは、指定したエクスポートストレージドメインにイメージをアップロードします。

engine-image-uploader のコマンドを使用する際には、上記のアクションのいずれかを指定する必要があります。また、upload アクションを使用するには、ローカルファイルを少なくとも 1 つ指定する必要があります。

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 です。
-i, --insecure
engine の検証を試行しないように指定します。
--quiet
コンソールの出力を最小限に抑える Quiet モードに設定します。
--verbose
より詳しいコンソール出力を表示する詳細モードに設定します。
-f, --force
engine の検証を試行しないように指定します。

強制モードは、アップロードされるソースファイルが、アップロード先のエクスポートドメインの既存ファイルと同じ名前の場合に使用する必要があります。このオプションは、既存のファイルを強制的に上書きします。

Red Hat Enterprise Virtualization Manager オプション

-u [USER], --user=[USER]
コマンドの実行に使用する認証情報のユーザーを指定します。[USER] は、[username]@[domain] の形式で指定してください。指定するユーザーは、指定したドメインに存在し、かつ Red Hat Enterprise Virtualization Manager が認識している必要があります。
-r [FQDN], --engine=[FQDN]
イメージをアップロード元となる Red Hat Enterprise Virtualization Manager の IP アドレスまたは完全修飾ドメイン名を指定します。イメージアップローダーは、Red Hat Enterprise Virtualization Manager がインストールされているのと同じマシンから実行されることを前提としています。デフォルト値は localhost:443 です。

エクスポートストレージドメインオプション

以下のオプションは、イメージのアップロード先となるエクスポートドメインを指定します。これらのオプションは、同時に使用することはできません。-e または -n のいずれかを使用する必要があります。

-e [EXPORT_DOMAIN], --export-domain=[EXPORT_DOMAIN]
ストレージドメイン EXPORT_DOMAIN には、アップロード先を指定します。
-n [NFSSERVER], --nfs-server=[NFSSERVER]
NFS パス [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]
アップロードされるイメージの新しい名前を指定します。

1.3.1. イメージアップローダーを使用したアプライアンスのアップロード

以下の手順では、Image Uploader Tool を使用して、Red Hat CloudForms Management Engine アプライアンスをアップロードします。

  1. Red Hat CloudForms アプライアンスが含まれるディレクトリーに移動します。

  2. 以下のコマンドを実行します。 

    # engine-image-uploader -N `newimagename` -e `myexportdomain` -v -m upload cfme-rhevm-5.3-15.x86_64.rhevm.ova

    newimagename はイメージに選択した名前に、myexportdomain は選択した export ストレージドメインに置き換えます。

  3. プロンプトが表示されたら、Red Hat Enterprise Virtualization Manager のデフォルトの管理ユーザーパスワードを入力します。 

    Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort): **********
    重要

    Red Hat Enterprise Virtualization Manager には、選択した export ストレージドメインへの管理者権限があることを確認します。

Red Hat Enterprise Virtualization Manager に Red Hat CloudForms Management Engine アプライアンスファイルをアップロードするには、約 90 分かかります。

1.4. アプライアンスの手動アップロード

以下の手順では、Image Uploader Tool を利用できない場合や、ツールでのアップロードに失敗した場合に、手動でのアップロードの方法を説明します。

  1. エクスポートストレージドメイン がマウントされた Red Hat Enterprise Virtualization の ホスト にログインします。
  2. エクスポートストレージドメイン のディレクトリーに移動します。
  3. Red Hat CloudForms アプライアンスの OVF アーカイブをこのディレクトリーにコピーします。

  4. tar コマンドを使用して OVF ファイルを展開します。 

    $ tar xvf cfme-rhevm-5.3-15.x86_64.rhevm.ova

  5. 以下のパーミッションを設定します。 

    chown -R 36:36 images/
chown -R 36:36 master/

1.5. Red Hat CloudForms の実行

エクスポートストレージドメインへアプライアンスをアップロードした後に、テンプレートとしてインポートして仮想マシンを作成します。以下の手順はガイドとして使用してください。

  1. エクスポートストレージドメインからアプライアンスイメージをテンプレートとして、Red Hat Enterprise Virtualization データストレージドメインにインポートします。イメージのアップロード時に指定した newimagename を使用して、テンプレートとしてインポートするイメージを検索します。インポートが完了したら、テンプレートにネットワークインターフェース (NIC) があるかを確認します。テンプレートに NIC が含まれていない場合には作成します。
  2. Red Hat CloudForms アプライアンスをベースとして使用して新規仮想マシンを作成します。方法は、『Red Hat Enterprise Virtualization 管理ガイド』を参照してください。
  3. アプライアンスと同じマシンにデータベースをホストする場合には、データベースディスクを追加します。
  4. 新規作成した Red Hat CloudForms アプライアンスの仮想マシンを起動します。

Red Hat Enterprise Virtualization 環境に、実行中の Red Hat CloudForms アプライアンスが設定されました。

2. Red Hat CloudForms の設定

Red Hat CloudForms アプライアンスは、ご使用の環境に即座に統合されるように設定されていますが、この設定は変更ができます。

注記

Red Hat CloudForms アプライアンスは、最小限の設定オプションを備えるように設計されています。

2.1. 設定の変更

以下の手順では、Red Hat CloudForms アプライアンスの設定を変更する方法を説明します。

  1. アプライアンスを起動してから、ユーザー名 root、デフォルトパスワード smartvm でログインしてます。これにより、root ユーザーの bash プロンプトが表示されます。
  2. appliance_console コマンドを入力すると、Red Hat CloudForms アプライアンスのサマリー画面が表示されます。
  3. Enter を押して手動で設定します。
  4. 変更する項目の番号を押して、Enter を入力します。選択したオプションが表示されます。
  5. プロンプトにしたがって、変更を行います。
  6. 必要に応じて、Enter を押して設定を確定します。
注記

5 分間操作が行われないと、Red Hat CloudForms アプライアンスのコンソールから自動的にログアウトされます。

2.2. Advanced Configuration (詳細設定) の設定

ログイン後、アプライアンスの詳細設定にある、以下のメニューアイテムを使用することができます。

  • Set DHCP Network Configuration で、Red Hat CloudForms アプライアンスの IP アドレスとネットワーク設定の取得に DHCP を使用します。アプライアンスは最初、ブリッジネットワークの DHCP クライアントとして設定されます。
  • Red Hat CloudForms アプライアンスに使用する必要のある、固有の IP アドレスおよびネットワーク設定がある場合には、Set Static Network Configuration を使用します。
  • 名前解決が正しく機能しているかをチェックするには、Test Network Configuration を使用します。

  • Red Hat CloudForms アプライアンスのホスト名を指定するには、Set Hostname を使用します。

    重要

    SmartState 分析を正しく機能させるには、Red Hat CloudForms アプライアンスの有効な完全修飾ホスト名が必要です。

  • Red Hat CloudForms のタイムゾーン、日付、時間を設定するには、Set Timezone, Date, and Time を使用します。
  • 以前のバックアップから VMDB データベースを復元するには、Restore Database from Backup を使用します。
  • VMDB レプリケーションのリージョンを作成するには、Setup Database Region を使用します。
  • Configure Database を使用して、VMDB データベースを設定します。インストールして初めて実行した後にアプライアンスのデータベースを設定する場合には、このオプションを使用します。
  • アプライアンスに一時ストレージを追加するには、Extend Temporary Storage を使用します。アプライアンスは、アプライアンスのホストにアタッチされたパーティション前のディスクをフォーマットして、/var/www/miq_tmp にマウントします。そして、アプライアンスはこの位置時ストレージディレクトリーを使用して、特定のイメージのダウンロード機能を実行します。
  • IPA サーバー経由の認証を設定するには、Configure External Authentication (httpd) を使用します。
  • プレーンテキストのパスワードを暗号化するのに使用する暗号化キーを再生成するには、Generate Custom Encryption Key を使用します。
  • Security Content Automation Protocol (SCAP) 規格をアプライアンスに適用するには、Harden Appliance Using SCAP Configuration を使用します。これらの SCAP ルールは /var/www/miq/lib/appliance_console/config/scap_rules.yml ファイルで確認することができます。
  • 全サーバープロセスを停止するには Stop Server Processes を使用します。これは、メンテナンスを行う場合に必要な場合があります。
  • サーバーを起動するには Start Server Processes を使用します。これは、メンテナンスを行なった後に必要な場合があります。
  • Red Hat CloudForms の再起動には、Restart Appliance を使用します。アプライアンスの再起動とログ消去の両方を行うか、アプライアンスの再起動だけを行うことができます。
  • アプライアンスの電源をオフにして、全プロセスを終了するには、Shut Down Appliance を使用します。
  • Red Hat CloudForms アプライアンスのネットワーク概要に戻るには、Summary Information を使用します。
  • Red Hat CloudForms アプライアンスのコンソールを終了するには Quit を使用します。

2.3. Red Hat CloudForms のデータベースの設定

Red Hat CloudForms を使用する前に、データベースオプションを設定します。Red Hat CloudForms のデータベース設定には 2 つのオプションがあります。

  • 内部の PostgreSQL データベースをアプライアンスにインストールするオプション
  • 外部の PostgreSQL データベースを使用するようにアプライアンスを設定するオプション

2.4. 内部データベースの設定

重要

内部データベースのインストール前に、アプライアンスをホストするインフラストラクチャーにディスクを追加します。ディスクの追加方法については、お使いのインフラストラクチャー固有のドキュメントを参照してください。ストレージディスクは通常、仮想マシンの実行中には追加できないため、Red Hat ではアプライアンスの起動前にディスクを追加することを推奨しています。Red Hat CloudForms では、空のディスクへの内部 VMDB のインストールのみをサポートしています。ディスクが空でない場合は、インストールに失敗します。

  1. アプライアンスを起動して、仮想化またはクラウドプロバイダーからターミナルを開きます。
  2. アプライアンスを起動してから、ユーザー名 root、デフォルトパスワード smartvm でログインしてます。これにより、root ユーザーの bash プロンプトが表示されます。
  3. appliance_console コマンドを入力すると、Red Hat CloudForms アプライアンスのサマリー画面が表示されます。
  4. Enter を押して手動で設定を行います。
  5. メニューから 8) Configure Database を選択します。

  6. 暗号化キーを作成するか、取得するようにプロンプトが表示されます。

    • これが最初の Red Hat CloudForms アプライアンスの場合には、1) Create key を選択します。
    • これが最初の Red Hat CloudForms アプライアンスではない場合には、リモートマシンから 2) Fetch key を選択して、最初の Red Hat CloudForms アプライアンスからキーを取得します。複数のリージョンのデプロイメントにある CFME アプライアンスはすべて、同じキーを使用する必要があります。
  7. 1) Internal を選び、データベースの場所を選択します。

  8. 以下のように、データベースのディスクを選択します。 

    1)  /dev/vdb: 20480

Choose disk:

    1 を入力して、データベースの場所として /dev/vdb を選択します。

  9. プロンプトが表示されたら、3 桁の一意なリージョン ID を入力して新規リージョンを作成します。

    重要

    新規リージョンを作成すると、選択したデータベースにある既存のデータは破棄されます。

  10. プロンプトが表示されたら、設定を確定します。

Red Hat CloudForms が内部データベースを設定しました。

2.5. 外部データベースの設定

Red Hat CloudForms データベースで使用する postgresql.conf ファイルは、正常に機能するために固有の設定が必要になります。たとえば、テーブル領域の解放、セションタイムアウトの制御、PostgreSQL サーバーログのフォーマットを正しく行い、システムのサポートを向上させる必要があります。このような要件があるため、Red Hat では外部の CloudForms Management Engine データベースには、CloudForms Management Engine アプライアンスで使用される標準ファイルをベースにした postgresql.conf ファイルを使用することを推奨しています。

お使いのシステムに合わせて postgresql.conf の設定を行うようにします。たとえば、shared_buffers の設定は、PostgreSQL インスタンスをホストする外部システムで利用可能な実際のストレージ容量に合わせてカスタマイズします。さらに、PostgreSQL インスタンスに接続する予定のアプライアンスの総数により、max_connections 設定を変更する必要がある場合があります。

postgresql.conf ファイルは、PostgreSQL の単一インスタンスが管理する全データベースの操作を制御するため、Red Hat CloudForms データベースと単一 PostgreSQL インスタンス内にある他のタイプのデータベースを混同しないようにしてください。

注記

Red Hat CloudForms 4.x では PostgreSQL バージョン 9.4 が必要です。

  1. アプライアンスを起動して、仮想化またはクラウドプロバイダーからターミナルコンソールを開きます。
  2. アプライアンスを起動してから、ユーザー名 root、デフォルトパスワード smartvm でログインしてます。これにより、root ユーザーの bash プロンプトが表示されます。
  3. appliance_console コマンドを入力すると、Red Hat CloudForms アプライアンスのサマリー画面が表示されます。
  4. Enter を押して手動で設定を行います。
  5. メニューから 8) Configure Database を選択します。

  6. セキュリティーキーを作成するか、取得するようにプロンプトが表示されます。

    • これが最初の Red Hat CloudForms アプライアンスの場合には、キー作成のオプションを選択します。
    • これが最初の Red Hat CloudForms アプライアンスではない場合には、最初の Red Hat CloudForms アプライアンスからキーを取得するオプションを選択します。複数のリージョンのデプロイメントにある CFME アプライアンスはすべて、同じキーを使用する必要があります。
  7. 2) External を選択して、データベースの場所を指定します。
  8. プロンプトが表示されたら、データベースのホスト名または IP アドレスを入力します。
  9. データベースの名前を入力するか、デフォルト (vmdb_production) を使用するには空のままにしておきます。
  10. データベースのユーザー名を入力するか、デフォルト (root) を使用するには空のままにしておきます。
  11. 選択したデータベースユーザーのパスワードを入力します。
  12. プロンプトが表示されたら、設定を確定します。

Red Hat CloudForms が外部データベースを設定します。

2.6. Red Hat CloudForms のワーカーアプライアンスの設定

ターミナルを使用してワーカーアプライアンスを設定することができます。以下のステップでは、すでにリージョンにデータベースが設定されているアプライアンスに、ワーカーアプライアンスを参加させる方法を説明します。

  1. アプライアンスを起動して、仮想化またはクラウドプロバイダーからターミナルを開きます。
  2. アプライアンスを起動してから、ユーザー名 root、デフォルトパスワード smartvm でログインしてます。これにより、root ユーザーの bash プロンプトが表示されます。
  3. appliance_console コマンドを入力すると、Red Hat CloudForms アプライアンスのサマリー画面が表示されます。
  4. Enter を押して手動で設定を行います。
  5. メニューから 8) Configure Database を選択します。
  6. セキュリティーキーを作成するか、取得するようにプロンプトが表示されます。最初の Red Hat CloudForms アプライアンスからキーを取得するオプションを選択します。複数のリージョンのデプロイメントにある Red Hat CloudForms アプライアンスはすべて、同じキーを使用する必要があります。
  7. 2) External を選択して、データベースの場所を指定します。
  8. プロンプトが表示されたら、データベースのホスト名または IP アドレスを入力します。
  9. データベースの名前を入力するか、デフォルト (vmdb_production) を使用するには空のままにしておきます。
  10. データベースのユーザー名を入力するか、デフォルト (root) を使用するには空のままにしておきます。
  11. 選択したデータベースユーザーのパスワードを入力します。
  12. プロンプトが表示されたら、設定を確定します。