第2章 Satellite Server のインストール
本章では、Red Hat Satellite Server のインストール、初期設定、マニフェストの作成およびインストール、および追加設定の実行について説明します。
Red Hat Satellite 6.4 はデフォルトでは Puppet 5 を使用します。Puppet モジュールが Puppet 5 をサポートすることを確認して、更新します。Puppet モジュールが Puppet 5 をサポートするように更新する方法は、Satellite 6.4 の『Red Hat Satellite のアップグレードおよびアップデート』ガイドの「Puppet のアップグレード」セクションを参照してください。
Red Hat Satellite 6.3 で Puppet 4 をサポートする Puppet モジュールにアップグレードが確認していることを確認します。Puppet モジュールを Puppet 4 にアップグレードする情報は、Satellite 6.3 の『Red Hat Satellite のアップグレードおよびアップデート』ガイドの「Puppet のアップグレード」のセクションを参照してください。
Satellite Server は、以下の 2 つのインストール方法があります。
オンラインインストール
Satellite Server のインストールに必要なパッケージは、Red Hat Content Delivery Network (CDN) から直接取得できます。CDN を使用すると、システムは常に最新のアップデートを受信できます。
オフラインインストール
外部のコンピューターを使用してパッケージの ISO イメージをダウンロードして、それを Satellite Server のインストール先のシステムにコピーする必要があります。非接続環境が必要な場合にのみ、ISO イメージを使用してください。ISO イメージには最新のアップデートが含まれていない場合があります。
Satellite Server をそれ自体に登録することはできません。
2.1. 切断されたネットワークからのダウンロードおよびインストール リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Satellite Server のホストがオフライン環境にある場合は、ISO イメージを使用して Satellite Server をインストールできます。ISO イメージには最新のアップデート、バグフィックス、および機能が含まれないことがあるため、この方法はこの環境以外では推奨されません。
ベースシステムが Red Hat CDN から更新されなかった場合、パッケージの依存関係エラーが発生することがあります。必要なパッケージの最新バージョンは手動でダウンロードしてインストールしてください。詳細は「パッケージの手動ダウンロード」 を参照してください。
作業を開始する前に
-
インストールで使用されたリポジトリーのコピーは
/opt/ディレクトリーに格納されます。このファイルシステムとディレクトリーのために最低 3GB の領域を確保してください。
2.1.1. バイナリー DVD イメージのダウンロード リンクのコピーリンクがクリップボードにコピーされました!
- Red Hat カスタマーポータル に移動し、ログインします。
- ダウンロード をクリックします。
- Red Hat Enterprise Linux を選択します。
製品とバージョンがご使用の環境に適切であることを確認します。
- Product Variant (製品のバリアント) は Red Hat Enterprise Linux Server に設定されます。
- Version (バージョン) は、ベースシステムとして使用する予定の製品の最新マイナーバージョンに設定されます。
- Architecture (アーキテクチャー) が 64 ビットバージョンに設定されている
- Product Software (製品ソフトウェア) タブで、最新の Red Hat Enterprise Linux Server バージョン向けのバイナリー DVD イメージをダウンロードします。
- DOWNLOADS (ダウンロード) をクリックし、Red Hat Satellite を選択します。
製品とバージョンがご使用の環境に適切であることを確認します。
- Product Variant (製品のバリアント) が Red Hat Satellite に設定されている
- Version (バージョン) は、ベースシステムとして使用する予定の製品の最新マイナーバージョンに設定されます。
- Architecture (アーキテクチャー) が 64 ビットバージョンに設定されている
- Product Software (製品ソフトウェア) タブで、最新の Red Hat Satellite バージョン向けのバイナリー DVD イメージをダウンロードします。
ISO ファイルを Satellite ベースシステムの
/var/tmpまたは他のアクセス可能なストレージデバイスにコピーします。# scp localfile username@hostname:remotefile
2.1.2. オフラインリポジトリーでベースシステムの設定 リンクのコピーリンクがクリップボードにコピーされました!
ベースシステムのバージョンに対応する ISO ファイルのマウントポイントとして使用するディレクトリーを作成します。
# mkdir /media/rhel7-serverRed Hat Enterprise Linux の ISO イメージをマウントポイントにマウントします。
# mount -o loop rhel7-Server-DVD.iso /media/rhel7-serverISO ファイルのリポジトリーデータファイルをコピーします。
# cp /media/rhel7-server/media.repo /etc/yum.repos.d/rhel7-server.repoリポジトリーデータファイルを編集し、
baseurlディレクティブを追加します。baseurl=file:///media/rhel7-server/リポジトリーが設定されたことを確認します。
# yum repolistベースシステムのバージョンに対応する ISO ファイルのマウントポイントとして使用するディレクトリーを作成します。
# mkdir /media/sat6Red Hat Satellite Server の ISO イメージをマウントポイントにマウントします。
# mount -o loop sat6-DVD.iso /media/sat6
2.1.3. オフラインリポジトリーからのインストール リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Enterprise Linux Server と Red Hat Satellite の ISO イメージがマウントされていることを確認します。
# findmnt -t iso9660Red Hat GPG キーをインポートします。
# rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-releaseバイナリー DVD イメージを使用してベースシステムを最新の状態にします。
# yum updateSatellite ISO がマウントされたディレクトリーに移動します。
# cd /media/sat6/マウントされたディレクトリーでインストールスクリプトを実行します。
# ./install_packages This script will install the foreman packages on the current machine. - Ensuring we are in an expected directory. - Copying installation files. - Creating a Repository File - Creating RHSCL Repository File - Checking to see if Foreman is already installed. - Importing the gpg key. - Foreman is not yet installed, installing it. - Installation repository will remain configured for future package installs. - Installation media can now be safely unmounted. Install is complete. Please run satellite-installer --scenario satellite.パッケージが見つからない、または古いためにスクリプトが失敗する場合は、これらをダウンロードして個別にインストールする必要があります。手順は「パッケージの手動ダウンロード」を参照してください。
インストール済みパッケージが必要なものよりも新しいためにスクリプトが失敗する場合は、
yum distribution-synchronizationを実行してインストール済みパッケージを Red Hat Enterprise Linux ISO からのバージョンにダウングレードしてから、インストールスクリプトを再度実行します。リポジトリーのソースが Red Hat Enterprise Linux ISO 以外のものに設定されている場合にのみ、これが発生します。このようなリポジトリーの使用はサポート対象外になります。
2.1.4. パッケージの手動ダウンロード リンクのコピーリンクがクリップボードにコピーされました!
パッケージを手動でダウンロードする必要がある場合は、以下の手順を実行します。
- Red Hat カスタマーポータル に移動し、ログインします。
- ダウンロード をクリックします。
- Red Hat Satellite を選択します。
製品とバージョンがご使用の環境に適切であることを確認します。
- Product Variant (製品のバリアント) が Red Hat Satellite に設定されている
- Version (バージョン) は、ベースシステムとして使用する製品の最新マイナーバージョンに設定されます。
- Architecture (アーキテクチャー) が 64 ビットバージョンに設定されている
- Packages (パッケージ) タブで、Search (検索) ボックスに必要なパッケージの名前を入力します。
- 必要なパッケージの横にある Download Latest (最新版のダウンロード) をクリックします。
2.2. 初期設定の実行 リンクのコピーリンクがクリップボードにコピーされました!
本セクションでは、Red Hat Satellite Server インストール時のホストオペレーティングシステムの初期設定について説明します。時間の同期、sos パッケージのインストール、インストールオプションの指定などが含まれます。
作業を進める前に、使用している環境に適切なマニフェストまたはパッケージを確認します。マニフェストついての詳細は『Red Hat Satellite コンテンツ管理ガイド』の 「サブスクリプションの管理」 を参照してください。
2.2.1. 時間の同期 リンクのコピーリンクがクリップボードにコピーされました!
時刻の誤差を最小化するには、ホストオペレーティングシステムで時刻シンクロナイザーを起動し、有効にする必要があります。システムの時刻が正しくないと、証明書の検証に失敗することがあります。
NTP ベースの時刻シンクロナイザーは chronyd と ntpd の 2 種類利用できます。chronyd 実装は、特に、頻繁に一時停止するシステムと、ネットワークから断続的に切断されるシステムに推奨されます。ntpd 実装は、chronyd でまだサポートされていないプロトコルまたはドライバーに対するサポートが必要な場合にのみ使用してください。
ntpd と chronyd の違いについては、『システム管理者のガイド』の「ntpd と chronyd の違い」を参照してください。
chronyd を使用した時間の同期
chronyd をインストールします。
# yum install chronychronyd サービスを起動して、有効にします。
# systemctl start chronyd # systemctl enable chronyd
2.2.2. ホストオペレーティングシステムへの SOS パッケージのインストール リンクのコピーリンクがクリップボードにコピーされました!
ホストオペレーティングシステムには sos パッケージをインストールする必要があります。sos パッケージを使用すると、Red Hat Enterprise Linux システムから設定と診断情報を収集できます。また、Red Hat テクニカルサポートでサービスリクエストを開く際に必要な初期システム分析を提供することもできます。sos の使用の詳細は、カスタマーポータルのナレッジベース「Red Hat Enterprise Linux 4.6 以降における sosreport の役割と取得方法」を参照してください。
sos パッケージをインストールします。
# yum install sos
2.2.3. インストールオプションの指定 リンクのコピーリンクがクリップボードにコピーされました!
Satellite Server は satellite-installer インストールスクリプトを使用してインストールし、初期設定の一部として自動または手動で Satellite を設定します。
以下のいずれかの設定方法を選択します。
自動設定: この方法は、インストールスクリプトの実行時に応答ファイルを使用して設定プロセスを自動化することで実行します。応答ファイルとは、コマンドやスクリプトによって読み込まれるパラメーター一覧が含まれているファイルです。デフォルトの Satellite 応答ファイルは、
/etc/foreman-installer/scenarios.d/satellite-answers.yamlです。使用する応答ファイルは、/etc/foreman-installer/scenarios.d/satellite.yaml設定ファイル内のanswer_fileディレクティブで設定します。応答ファイルを使用したインストールスクリプトによる初期設定の実行法は「応答ファイルを使用した初期設定の自動実行」を参照してください。
手動設定: 1 つ以上のコマンドオプションが含まれるインストールスクリプトを実行します。コマンドオプションは、対応するデフォルトの初期設定オプションを上書きし、Satellite 応答ファイルに記録されます。必要なオプションを設定するために、スクリプトは何回でも実行することができます。
コマンドラインオプションのあるインストールスクリプトによる初期設定の実行法は「手動による初期設定」を参照してください。
Satellite インストーラーの実行時に使用するオプションによっては、設定が完了するのに数分かかることがあります。管理者は、応答ファイルを見ることで、両方の方法でこれまでに使用されたオプションを確認できます。
2.2.3.1. 手動による初期設定 リンクのコピーリンクがクリップボードにコピーされました!
初期設定では、組織、場所、ユーザー名、およびパスワードが作成されます。初期設定後に、必要に応じて追加の組織と場所を作成できます。初期設定では、MongoDB および PostgreSQL データベースも同じサーバーにインストールします。デプロイメントによっては、外部のデータベースを使用する方がパフォーマンスが向上する可能性があります。
インストールプロセスの完了には、数十分かかることがあります。システムにリモートで接続する場合は、リモートシステムから切断された場合にインストールの進捗を確認できるよう、通信セッションの一時中断または再接続を許可できる screen などのユーティリティーの使用を検討してください。Red Hat ナレッジベースの記事「How to use the screen command」には screen のインストールについて記載されています。詳細はscreen の man ページを参照してください。インストールコマンドを実行しているシェルへの接続が切断された場合は、/var/log/foreman-installer/satellite.log のログを参照してプロセスが正常に完了したかどうかを確認します。
Satellite Server の手動設定
satellite-installer --scenario satellite --help コマンドを使用して利用可能なオプションとすべてのデフォルト値を表示します。値を指定しない場合は、デフォルト値が使用されます。
--foreman-initial-organization オプションには、意味のある値を指定することが推奨されます。たとえば会社名を指定できます。値に一致する内部ラベルが作成されますが、このラベルは後で変更できません。値を指定しない場合は、ラベルが Default_Organization の Default Organization という名前の組織が作成されます。組織名は変更できますが、ラベルは変更できません。
デフォルトでは、インストーラーが設定するすべての設定ファイルが Puppet によって管理されます。satellite-installer を実行すると、Puppet が管理するファイルに手動で加えられた変更が初期値で上書きされます。Satellite Server は、デフォルトでは、サービスとして実行している Puppet エージェントを使用してインストールされます。必要に応じて、--puppet-runmode=none オプションを使用して、Satellite Server で Puppet エージェントを無効にできます。
DNS ファイルと DHCP ファイルを手動で管理する場合には、--foreman-proxy-dns-managed=false オプションと --foreman-proxy-dhcp-managed=false オプションを使用して、各サービスに関連するファイルが Puppet で管理されないようにします。他のサービスにカスタム設定を適用する方法は「付録A Red Hat Satellite へのカスタム設定の適用」を参照してください。
Satellite で外部データベースを使用する場合には、satellite installer ツールを実行する前に、外部データベースを設定して参照する必要があります。詳しい情報は、『オンラインネットワークからの Satellite Server のインストール』の「Satellite での外部データベースの使用」を参照してください。
# satellite-installer --scenario satellite \
--foreman-initial-organization "initial_organization_name" \
--foreman-initial-location "initial_location_name" \
--foreman-admin-username admin_user_name \
--foreman-admin-password admin_password \
--foreman-proxy-dns-managed=false \
--foreman-proxy-dhcp-managed=false
このスクリプトは、進捗を表示し、/var/log/foreman-installer/satellite.log にログを記録します。
切断環境でインストールしている場合は、ISO イメージをアンマウントします。
# umount /media/sat6
# umount /media/rhel7-server
2.2.3.2. 応答ファイルを使用した初期設定の自動実行 リンクのコピーリンクがクリップボードにコピーされました!
応答ファイルを使用すると、カスタマイズされたオプションでインストールを自動化できます。最初の応答ファイルには、部分的に情報が入力されます。応答ファイルには、satellite-installer の初回実行後に、インストール用の標準パラメーター値が入力されます。「手動による初期設定」 の記載通りに Satellite Server を既にインストールしている場合は、この方法を使用する必要ありません。ただし、この方法を使用していつでも Satellite Server の設定に変更を加えることはできます。
ネットワークの変更の場合は、可能な限り、IP アドレスの代わりに FQDN を使用する必要があります。
応答ファイルを使用した Satellite Server の自動設定
デフォルトの応答ファイル
/etc/foreman-installer/scenarios.d/satellite-answers.yamlをローカルファイルシステムの場所にコピーします。# cp /etc/foreman-installer/scenarios.d/satellite-answers.yaml \ /etc/foreman-installer/scenarios.d/my-answer-file.yaml-
設定可能なすべてのオプションを表示するには、
satellite-installer --scenario satellite --helpコマンドを実行します。 - 応答ファイルのコピーを開き、ご使用の環境に適した値を編集し、ファイルを保存します。
/etc/foreman-installer/scenarios.d/satellite.yamlファイルを開き、カスタム応答ファイルを参照する応答ファイルエントリーを編集します。:answer_file: /etc/foreman-installer/scenarios.d/my-answer-file.yamlsatellite-installerスクリプトを実行します。# satellite-installer --scenario satellite切断環境でインストールしている場合は、ISO イメージをアンマウントします。
# umount /media/sat6 # umount /media/rhel7-server
2.2.4. カスタマーポータルでサブスクリプションの割り当ての作成 リンクのコピーリンクがクリップボードにコピーされました!
サブスクリプション情報は、Red Hat カスタマーポータルでアクセスできます。そこでサブスクリプション割り当てを使用して、Red Hat Satellite Server などのオンプレミス管理アプリケーションで使用するサブスクリプションを割り当てることができます。
- ブラウザーで カスタマーポータル (https://access.redhat.com/) を開き、Red Hat アカウントでログインします。
- カスタマーポータルの左上にある サブスクリプション に移動します。
- サブスクリプション割り当て に移動します。
- 新規サブスクリプションの割り当てを作成 をクリックします。
- 名前 フィールドに名前を入力します。
- タイプ の一覧から、お使いの Satellite Server に一致するタイプとバージョンを選択します。
- 作成 をクリックします。
2.2.5. 割り当てへのサブスクリプションの追加 リンクのコピーリンクがクリップボードにコピーされました!
以下の手順では、サブスクリプションを割り当てに追加する方法を説明します。
- サブスクリプション割り当て に移動します。
- 変更するサブスクリプションの名前を選択します。
- サブスクリプション タブをクリックします。
- サブスクリプションの追加 をクリックします。
- Red Hat 製品サブスクリプションの一覧が表示されます。各製品に対するエンタイトルメントの数量 を入力します。
- 送信 をクリックして割り当てを完了します。
割り当てにサブスクリプションを追加したら、マニフェストファイルをエクスポートします。
2.2.6. カスタマーポータルからのサブスクリプションマニフェストのエクスポート リンクのコピーリンクがクリップボードにコピーされました!
1 つ以上のサブスクリプションがあるサブスクリプション割り当てを表示し、以下のいずれかからマニフェストをエクスポートできます。
- サブスクリプション セクションの 詳細 タブから マニフェストのエクスポート ボタンをクリックします。
- サブスクリプション タブから マニフェストのエクスポート ボタンをクリックします。
マニフェストをエクスポートすると、カスタマーポータルにより、選択したサブスクリプション証明書がエンコードされ、.zip アーカイブが作成されます。作成した .zip アーカイブはサブスクリプションのマニフェストで、Satellite Server にアップロードできます。
2.2.6.1. Satellite Server へのサブスクリプションマニフェストのインポート リンクのコピーリンクがクリップボードにコピーされました!
マニフェストは、Red Hat Satellite 6 の Web UI と CLI の両方でインポートできます。
Web UI をご利用の場合
- コンテキストが、使用する組織に設定されていることを確認します。
- コンテンツ > Red Hat サブスクリプション に移動します。
- マニフェストの管理 をクリックして、組織のマニフェストページを表示します。
- ファイルの選択 をクリックしてサブスクリプションマニフェストを選択し、アップロード をクリックします。
CLI をご利用の場合
Red Hat Satellite 6 CLI を使用するには、Satellite Server にマニフェストが必要になります。ローカルクライアントシステムで、マニフェストを Satellite Server にコピーします。
[user@client ~]$ scp ~/manifest_file.zip root@satellite.example.com:~/.
次に、以下のコマンドを使用してインポートします。
[root@satellite ~]# hammer subscription upload \
--file ~/manifest_file.zip \
--organization "organization_name"
数分後に、CLI により、マニフェストのインポートに成功したことが報告されます。
上記の手順を完了すると、リポジトリーを有効にして Red Hat コンテンツをインポートできるようになります。これは、後に続くいくつかの手順での前提条件になります。詳細は、『Red Hat Satellite コンテンツ管理ガイド』の「Red Hat コンテンツのインポート」を参照してください。