10.5. Registration

手順10.2 ホストを登録するための設定:

1. Satellite Server または Capsule Server の完全修飾ドメイン名(FQDN)をメモしておきます（例： server.example.com ）。
2. ホストでターミナルを開き、root でログインします。
3. ホストを登録する Satellite Server または Capsule Server からコンシューマー RPM をインストールします。コンシューマー RPM は、ホストのコンテンツソースのロケーションを更新し、ホストが Red Hat Satellite に指定したコンテンツソースからコンテンツをダウンロードできるようにします。

   # rpm -Uvh http://server.example.com/pub/katello-ca-consumer-latest.noarch.rpm

   重要
   実行中の Docker デーモンが再起動します。
   注記
   katello-ca-consumer-hostname-1.0-1.noarch.rpm は、サーバーのホスト名を含む、利用可能な追加の katello-ca-consumer RPM です。katello-ca-consumer-latest.noarch.rpm rpm は常に最新のバージョンを反映します。どちらを使用しても達成できる目的は同じです。

手順10.3 ホストを登録する方法:

1. ホストでターミナルを開き、root でログインします。
2. Red Hat Subscription Manager (RHSM) に関連するすべての以前のホストデータを消去します。

   # subscription-manager clean
   

3. RHSM を使用してホストを登録します。

   # subscription-manager register --org your_org_name --activationkey your_activation_key

   例10.1 登録後のコマンド出力:

   # subscription-manager register --org MyOrg --activationkey TestKey-1
   The system has been registered with id: 62edc0f8-855b-4184-b1b8-72a9dc793b96
   

手順10.5 Satellite Tools リポジトリーが有効にされていることを確認するには、以下を実行します。

1. Satellite Web UI を開き、コンテンツRed Hat リポジトリー に移動して、RPM タブをクリックします。
2. Red Hat Enterprise Linux Server 項目を見つけ、展開します。
3. Red Hat Satellite Tools 6.2 (RHEL VERSION Server 用) (RPM) 項目を見つけ、展開します。
   Red Hat Satellite Tools 6.2 の項目が表示されていない場合は、カスタマーポータルから取得したサブスクリプションマニフェストにその項目が含まれないことが原因として考えられます。この問題を修正するには、カスタマーポータルにログインし、これらのリポジトリーを追加し、サブスクリプションマニフェストをダウンロードして、Satellite にインポートします。
4. リポジトリーの名前の横にある Enabled チェックボックスが選択されていることを確認します。選択されていない場合は、選択します。

手順10.6 Katello エージェントをインストールする方法:

1. ホストで、satellite-tools リポジトリーが有効になっていることを確認します。自動アタッチが有効なアクティベーションキーを使用してホストを登録した場合、リポジトリーはすでに自動的に有効になっています。

   # yum repolist enabled | grep -i satellite-tools

   satellite-tools が有効になっていない場合は、以下のコマンドで有効にします。

   # subscription-manager repos --enable=rhel-version-server-satellite-tools-6.2-rpms

2. 以下のコマンドを使用して katello-agent RPM パッケージをインストールします。

   # yum install katello-agent

3. goferd サービスが実行していることを確認します。
   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

     # service goferd start

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

     # systemctl start goferd

手順10.7 Satellite Tools リポジトリーが有効にされていることを確認するには、以下を実行します。

1. Satellite Web UI を開き、コンテンツRed Hat リポジトリー に移動して、RPM タブをクリックします。
2. Red Hat Enterprise Linux Server 項目を見つけ、展開します。
3. Red Hat Satellite Tools 6.2 (RHEL VERSION Server 用) (RPM) 項目を見つけ、展開します。
   Red Hat Satellite Tools 6.2 の項目が表示されていない場合は、カスタマーポータルから取得したサブスクリプションマニフェストにその項目が含まれないことが原因として考えられます。この問題を修正するには、カスタマーポータルにログインし、これらのリポジトリーを追加し、サブスクリプションマニフェストをダウンロードして、Satellite にインポートします。
4. リポジトリーの名前の横にある Enabled チェックボックスが選択されていることを確認します。選択されていない場合は、選択します。

手順10.8 Puppet エージェントをインストールし、有効にする方法:

1. ホストでターミナルコンソールを開き、root ユーザーとしてログインします。
2. 以下のコマンドを使用して、satellite-tools リポジトリーが有効になっていることを確認します。

   # yum repolist enabled | grep -i satellite-tools

   satellite-tools が有効になっていない場合は、以下のコマンドで有効にします。

   # subscription-manager repos --enable=rhel-version-server-satellite-tools-6.2-rpms

3. 以下のコマンドを使用して Puppet エージェントの RPM パッケージをインストールします。

   # yum install puppet
   

4. 起動時に開始する Puppet エージェントを設定します。
   • Red Hat Enterprise Linux 6 の場合:

     # chkconfig puppet on

   • Red Hat Enterprise Linux 7 の場合

     # systemctl enable puppet

手順10.9 Puppet エージェントを設定する方法:

1. /etc/puppet/puppet.conf ファイルでサーバーおよび環境設定を指定して、Puppet エージェントを設定します。

   # vi /etc/puppet/puppet.conf
   

   [main]
       # The Puppet log directory.
       # The default value is '$vardir/log'.
       logdir = /var/log/puppet
   
       # Where Puppet PID files are kept.
       # The default value is '$vardir/run'.
       rundir = /var/run/puppet
   
       # Where SSL certificates are kept.
       # The default value is '$confdir/ssl'.
       ssldir = /var/lib/puppet/ssl
   
   ...
   
   [agent]
       # The file in which puppetd stores a list of the classes
       # associated with the retrieved configuratiion.  Can be loaded in
       # the separate ``puppet`` executable using the ``--loadclasses``
       # option.
       # The default value is '$confdir/classes.txt'.
       classfile = $vardir/classes.txt
       pluginsync = true
       report = true
       ignoreschedules = true
       daemon = false
       ca_server = satellite.example.com
       server = satellite.example.com
       environment = KT_Example_Org_Library_RHEL6Server_3
   
       # Where puppetd caches the local configuration.  An
       # extension indicating the cache format is added automatically.
       # The default value is '$confdir/localconfig'.
       localconfig = $vardir/localconfig
   
   ...
   

   重要
   ホストの所属先の Puppet 環境名に environment パラメーターを設定します。Puppet 環境は、ホストまたはホストグループに関連付けることができる Puppet モジュールのコレクションです。

   • ホストの Puppet 環境を見つけるには、Hosts All Hosts に移動し、ホストテーブルの Environment コラムを検査します。
   • Puppet 環境をホストに割り当てるには、Hosts All Hosts に移動し、選択したホストの横にある Edit をクリックします。
   • Satellite Server で有効な Puppet 環境を表示するには、環境 設定 ます。Satellite Server の /etc/puppet/environments/ ディレクトリーを確認して、Puppet 環境に関連付けられている Puppet モジュールとマニフェストを確認することもできます。

   詳細は Red Hat Satellite Puppet ガイド を参照してください。
2. ホスト上で Puppet エージェントを実行します。

   # puppet agent -t --server satellite.example.com

3. Satellite Server Web UI を使って Puppet クライアントの SSL 証明書に署名します。
   1. Web UI から Satellite Server にログインします。
   2. インフラストラクチャー Capsule を 選択 し ます。
   3. 必要な Capsule の右側にあるドロップダウンメニューから Certificates を選択します。
   4. 必要なホストの右側にある Sign をクリックします。
   5. puppet agent コマンドを再度入力します。

      # puppet agent -t --server satellite.example.com

手順10.10 ホストへのブートストラップのインストール

1. 正しいディレクトリーにいることを確認します。たとえば、/root に変更するには、次のコマンドを実行します。

   # cd

2. スクリプトをダウンロードします。

   # wget http://satellite6.example.com/pub/bootstrap.py

   これにより、スクリプトが現行ディレクトリーにインストールされます。
3. スクリプトを実行可能にします。

   # chmod +x bootstrap.py

4. スクリプトが実行できることを確認するには、以下のように使用ステートメントを表示します。

   # ./bootstrap.py -h

5. 移行プロセスが完了したら、スクリプトを削除できます。

   # cd
   # rm bootstrap.py

手順10.11 ブートストラップスクリプトの実行

前提条件

1. ご使用の環境に適した値を使用して、以下のようにブートストラップコマンドを出力します。
   --server オプションの場合は、Satellite Server または Capsule Server の FQDN 名を指定します。for-- location,--organization, and-- hostgroup オプションは、オプションへの引数として、ラベルではなく引用符で囲まれた名前を使用します。詳細なユースケースは 「詳細なブートストラップスクリプトの設定」 を参照してください。

   # bootstrap.py --login=admin \
   --server satellite6.example.com \
   --location="Example Location" \
   --organization="Example Organization" \
   --hostgroup="Example Host Group" \
   --activationkey=activation_key

   スクリプトは、the- login オプションで入力した Satellite ユーザー名に対応するパスワードの入力を求めるプロンプトを出します。
2. スクリプトが実行され、進捗の通知が標準出力( stdout )に送信されます。証明書の承認を求めるプロンプトが表示されるのを確認します。以下に例を示します。

   [NOTIFICATION], [2016-04-26 10:16:00], [Visit the UI and approve this certificate via Infrastructure->Capsules]
   [NOTIFICATION], [2016-04-26 10:16:00], [if auto-signing is disabled]
   [RUNNING], [2016-04-26 10:16:00], [/usr/bin/puppet agent --test --noop --tags no_such_tag --waitforcert 10]

   ホストは、管理者が Puppet 証明書を承認するまで無期限に待機します。
   1. Web UI で、Infrastructure Capsules に移動します。
   2. 指定した FQDN- server オプションに対応する Capsule 名の右側にある 証明書 を選択します。
   3. アクション コラムで、署名 を選択して、ホストの Puppet 証明書を承認します。
   4. ホストに戻り、残りのブートストラップ処理が完了するのを確認します。
3. Web UI で Hosts All hosts に移動し、そのホストが適切なホストグループに接続していることを確認します。