インストールガイド

手順2.2 katello-installer の初回実行時のカスタムサーバー証明書の設定

• Red Hat Satellite Server で以下のコマンドを実行します。

  katello-installer --certs-server-cert ~/path/to/server.crt\
                    --certs-server-cert-req ~/path/to/server.crt.req\
                    --certs-server-key ~/path/to/server.crt.key\
                    --certs-server-ca-cert ~/path/to/cacert.crt
  

  ここで、

  • certs-server-cert は、証明書の認証局によって署名 (または自己署名) された証明書へのパスです。
  • certs-server-cert-req は、証明書を作成するために使用された証明書署名要求ファイルへのパスです。
  • certs-server-key は、証明書に署名するために使用される秘密鍵です。
  • certs-server-ca-cert ~/path/to/cacert.crt は、このシステム上の CA 証明書へのパスです。

手順2.3 katello-installer 実行後のカスタムサーバー証明書の設定

1. katello-installer の初回実行では、サーバーとクライアントの証明書にデフォルト CA を使用します。カスタム証明書の展開を強制するには、--certs-update-server パラメーターと --certs-update-server-ca パラメーターを設定して CA 証明書を更新します。

   katello-installer --certs-server-cert ~/path/to/server.crt\ --certs-server-cert-req ~/path/to/server.crt.req\ --certs-server-key ~/path/to/server.crt.req\ --certs-server-ca-cert ~/path/to/cacert.crt\ --certs-update-server --certs-update-server-ca
   

   これにより、katello-ca-consumer パッケージとサーバー CA 証明書が再生成されます。
2. サーバー CA の変更後に、新たなバージョンの consumer-ca-consumer パッケージをクライアントシステムにインストールします。

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

手順3.1 組織の作成

1. 右上にある 管理 → 組織 メニューをクリックします。
2. 新規組織 ボタンをクリックします。
3. 名前 フィールドに新しい組織の名前を入力します。
4. ラベル フィールドに新しい組織のラベルを入力します。
5. 詳細 フィールドに新しい組織の詳細を入力します。
6. 送信 ボタンをクリックします。
7. 新しい組織に割り当てるホストを選択します。
   • 組織のないすべてのホストを新しい組織に割り当てるには、すべてを割り当て ボタンをクリックします。
   • 組織のないホストを手動で選択し、割り当てるには、手動割り当て ボタンをクリックします。
   • ホストの割り当てをスキップするには、編集に進む ボタンをクリックします。

手順3.2 組織の編集

1. 右上にある 管理 → 組織 メニューをクリックします。
2. 編集する組織の名前をクリックします。
3. 左側の一覧から編集するリソースを選択します。
4. 必要な項目の名前をクリックし、それらを 選択された項目 の一覧に追加します。
5. 送信 ボタンをクリックします。

手順3.3 組織の削除

1. 右上にある 管理 → 組織 メニューをクリックします。
2. 削除する組織の名前の右側にあるドロップダウンメニューから、削除 を選択します。
3. 警告ボックスが表示されます。

   組織名 を削除しますか?

4. OK ボタンをクリックします。

手順4.11 Red Hat CDN のコンテンツを同期し、エクスポートするためのホストの設定:

1. Red Hat サブスクリプションマネージャーを使って、同期ホストを RHN に登録します。
2. システムに割り当てるのに適した Red Hat Satellite 製品を見つけるため、利用可能なすべてのサブスクリプションを一覧表示します。

   # subscription-manager list --available --all

   このコマンドにより、以下のような出力が表示されます。

   +-------------------------------------------+
       Available Subscriptions
   +-------------------------------------------+
   
   
   ProductName:        Red Hat Satellite
   ProductId:          SKU123456
   PoolId:             e1730d1f4eaa448397bfd30c8c7f3d334bd8b
   Quantity:           10
   Multi-Entitlement:  No
   Expires:            08/20/2013
   MachineType:        physical
   

   注記

   SKU とプール ID は、お使いのシステムのバージョンと製品タイプに対応する Red Hat Satellite の製品タイプによって異なります。
3. 次のコマンドを使ってプールをサブスクライブします。

   # subscription-manager subscribe --pool=Red_Hat_Satellite_Pool_Id
   # subscription-manager subscribe --pool=Red_Hat_Enterprise_Linux_Pool_Id
   # subscription-manager subscribe --pool=Red_Hat_Enterprise_Linux_Software_Collections_Pool_Id
   

4. すべての既存リポジトリーを無効にします。

   # subscription-manager repos --disable "*"
   

5. Red Hat Satellite および Red Hat Enterprise Linux ならびに Red Hat Software Collections リポジトリーを有効にします。Red Hat Enterprise Linux リポジトリーがお使いの特定のバージョンと一致していることを確認してください。

   # subscription-manager repos --enable rhel-6-server-rpms \
   --enable rhel-server-rhscl-6-rpms \
   --enable rhel-6-server-satellite-6.0-rpms
   

6. katello-utils と関連する RPM をインストールします。

   # yum install python-qpid-qmf python-qpid  qpid-cpp-server-store katello-utils
   

   katello-utils には、インポート用のリポジトリーをセットアップするために必要な katello-disconnected ユーティリティーが含まれます。qpid 関連のパッケージは pulp 設定に必要です。
7. /etc/pulp/server.conf ファイルの oauth_secret エントリーに 32 文字の英数字から成る秘密の文字列を生成します。

   # tr -dc "[:alnum:]" < /dev/urandom | head -c 32 
   randomly_generated_value

8. /etc/pulp/server.conf で、[oauth] エントリーのコメントを解除し、直前の手順でランダムに生成された値を oauth_secret 値として追加します。

   [oauth]
   enabled: true
   oauth_key: katello
   oauth_secret: randomly_generated_value

9. /etc/qpid/qpidd.conf で認証を無効にします。

   # Configuration file for qpidd. Entries are of the form: 
   #   name=value 
   #
   # (Note: no spaces on either side of '=').
   # Run "qpidd --help" or see "man qpidd" for more details.
   
   auth=no
   

   すべての着信接続は、Satellite のデフォルトのレルムを使用して認証されます。
10. --oauth-secret オプションとして生成された先の値を使用して、katello-disconnected から Pulp への接続を設定します。

    # katello-disconnected setup --oauth-key=katello --oauth-secret=randomly_generated_value

    これにより、設定値が ~/.katello-disconnected に配置されます。
11. 同期サーバーで Pulp を設定します。

    sudo service qpidd start
    sudo chkconfig qpidd on
    sudo service mongod start
    sleep 10
    sudo chkconfig mongod on
    sudo -u apache pulp-manage-db
    sudo service httpd restart
    sudo chkconfig pulp_workers on
    sudo service pulp_workers start
    sudo chkconfig pulp_celerybeat on
    sudo service pulp_celerybeat start
    sudo chkconfig pulp_resource_manager on
    sudo service pulp_resource_manager start
    

12. マニフェストをインポートします。

    # katello-disconnected import -m ./manifest.zip
    

    マニフェストをインポートすることにより、選択したサブスクリプションに基づいて利用できる同期対象のリポジトリーの一覧がセットアップされます。

1. すべてのリポジトリーを無効にします。

   # katello-disconnected disable --all
   

   katello-disconnected は、デフォルトですべてのリポジトリーを有効にします。
2. マニフェストのすべての利用可能なリポジトリーを一覧表示し、同期するリポジトリーを選択します。

   # katello-disconnected list --disabled
   rhel-5-server-debug-rpms-5Server-i386
   rhel-5-server-debug-rpms-5Server-ia64
   rhel-5-server-debug-rpms-5Server-x86_64
   rhel-5-server-debug-rpms-5_7-i386
   rhel-5-server-debug-rpms-5_7-ia64
   rhel-5-server-debug-rpms-5_7-x86_64
   rhel-5-server-debug-rpms-5_8-i386
   rhel-5-server-debug-rpms-5_8-ia64
   rhel-5-server-debug-rpms-5_8-x86_64
   rhel-5-server-debug-rpms-5_9-i386
   rhel-5-server-debug-rpms-5_9-ia64
   rhel-5-server-debug-rpms-5_9-x86_64
   rhel-5-server-isos-5Server-i386
   

3. 同期用に選択したリポジトリーを有効にします。

   # katello-disconnected enable -r rhel-6-server-sam-rpms-6_4-x86_64
   

4. リポジトリーを作成し、それらを Pulp にプッシュして同期を許可します。

   # katello-disconnected configure
   

   注記

   katello-disconnected の設定オプションは、同期前にマニフェストを読み込み、Pulp リポジトリーを作成し、スクリプトを生成します。これは、リポジトリーを有効/無効にするたびに毎回実行する必要があります。
5. リポジトリーを同期します。

   # katello-disconnected sync
   

   同期プロセスをモニターするには watch オプションを使用できます。

   # katello-disconnected watch
   Watching sync... (this may be safely interrupted with Ctrl+C)
   running:
   rhel-6-server-sam-rpms-6_4-x86_64 
   
   running:
   rhel-6-server-sam-rpms-6_4-x86_64 
   ...
   finished:
   rhel-6-server-sam-rpms-6_4-x86_64 
   
   
   Watching finished
   

1. 同期したリポジトリーをエクスポートします。

   # katello-disconnected export -t /var/tmp/export
   

   出力は以下のようになります。

   
   # katello-disconnected export -t /var/tmp/export
   # katello-disconnected watch
   Watching sync... (this may be safely interrupted with Ctrl+C)
   running:
   rhel-6-server-sam-rpms-6_4-x86_64
   
   finished:
   rhel-6-server-sam-rpms-6_4-x86_64
   Watching finished
   Done watching ...
    Copying content to /var/tmp/export
    Archiving contents of /var/tmp/export into 4600M tar archives.
    NOTE: This may take a while.
   tar: Removing leading `/' from member names
   
   Done exporting content, please copy /var/tmp/export/* to your disconnected host
   

   この操作により、以下のファイルが /var/tmp/export に作成されます。

   # ls /var/tmp/export/
   content-export-00 content-export-01 content-export-02 expand_export.sh
   

2. /var/tmp/export から外部メディアにファイルをコピーします。

   注記

   ファイルが外部メディアに対して大きすぎる場合、ファイルを一連の DVD に順番にコピーすることができます。

1. 外部メディアのエクスポートされたコンテンツを、接続されていない Satellite のディレクトリーにコピーします。

   注記

   エクスポートされたコンテンツが複数の異なる外部メディアデバイスにある場合、接続されていない Satellite の 1 つの ディレクトリーにすべてのコンテンツをコピーしてください。
2. エクスポートされたコンテンツと共にコピーされた expand_export.sh スクリプトを実行します。

   # ./expand_export.sh 
   *** Done expanding archives. ***
   

   警告

   接続されていない Satellite には、エクスポートされたコンテンツを展開する前に、展開した場合に必要となる分の空き容量がなければなりません。
   スクリプトにより、アーカイブがディレクトリーに展開されます。
3. 展開したディレクトリーツリーのコンテンツを Satellite Server の /var/www/html に移動し、移動したファイル上で SELinux コンテキストを復元します。

   # mv var/tmp/export/* /var/www/html/
   # cd /var/www/html
   # restorecon -r *
   

   注記

   Satellite は、ファイルを http://localhost/content に持つ独自の CDN として機能するようになります。ただしこれは必須ではなく、Satellite Server に HTTP 経由でアクセスできる限り、同じ切断されたネットワーク内の別のマシンで CDN をホストすることができます。
4. CDN アドレスを Satellite Web インターフェースに追加します。
   1. Satellite Web インターフェースにログインします。
   2. コンテンツ → Red Hat サブスクリプション をクリックしてから マニフェストの管理 をクリックします。
   3. サブスクリプションマニフェスト の情報画面で、Red Hat プロバイダーの詳細 へスクロールします。リポジトリー URL エントリー上で編集アイコンをクリックし、エントリーを CDN のリポジトリー URL に変更します。
   4. 参照 をクリックしてマニフェストファイルを選択します。
   5. アップロード をクリックしてマニフェストをインポートします。
5. ローカル CDN のリポジトリーを有効にします。
   1. コンテンツ → Red Hat リポジトリー をクリックします。
   2. 「コンテンツの同期」セクションで有効にされ、同期されたリポジトリーを有効にします。
6. コンテンツ → 同期の状態 をクリックします。
7. 同期するリポジトリーを選択し、今すぐ同期 をクリックします。

手順5.2 capsule-certs-generate の初回実行時のカスタムサーバー証明書の設定

1. Red Hat Satellite Server で以下のコマンドを実行します。

   capsule-certs-generate --capsule-fqdn "$CAPSULE"\
                          --certs-tar "~/$CAPSULE-certs.tar"\
                          --server-cert ~/path/to/server.crt\
                          --server-cert-req ~/path/to/server.crt.req\
                          --server-key ~/path/to/server.key\
                          --server-ca-cert ~/cacert.crt
   

   ここで、

   • capsule_FQDN は、Satellite Capsule Server の完全修飾ドメイン名 (必須) です。
   • certs-tar は、生成される tar ファイルの名前で、Satellite Capsule インストーラーが使用する証明書が含まれます。
   • server-cert は、証明書の認証局によって署名 (または自己署名) された証明書へのパスです。
   • server-cert-req は、証明書を作成するために使用された証明書署名要求ファイルへのパスです。
   • server-key は、証明書に署名するために使用される秘密鍵です。
   • server-ca-cert ~/path/to/cacert.crt は、このシステム上の CA 証明書へのパスです。
2. 生成される tarball、capsule.example.com-certs.tar を Satellite Server から Satellite Capsule ホストシステムにコピーします。
3. Satellite Capsule Server 上:
   1. Satellite Capsule Server を Satellite Server に登録します。

      # rpm -Uvh http://sat6host.example.redhat.com/pub/katello-ca-consumer-latest.noarch.rpm
      # subscription-manager register --org "ACME_Corporation" --env [environment]/[content_view_name]
      

      注記

      Satellite Capsule Server では Satellite Server からのコンテンツの同期に環境が必要となるため、Satellite Capsule Server を組織に割り当てておく必要があります。環境は組織のみに設定できます。

      Satellite Capsule Server とそれが管理しているホストとの距離の近さを示すためにロケーションを割り当てることは推奨されますが、これはオプションになります。
   2. 必要とされる Satellite Capsule Server のタイプに応じて、以下のオプションのいずれかを選択してください。
      1. オプション 1: Satellite Capsule Server とスマートプロキシー: このオプションでは Satellite Capsule Server をスマートプロキシー機能 (DHCP、DNS、Puppet) と共にインストールします。root ユーザーとして Satellite Capsule Server 上で以下のコマンドを実行します。

           
         # capsule-installer --parent-fqdn          "satellite.example.com"\
                             --register-in-foreman  "true"\
                             --foreman-oauth-key    "xmmQCGYdkoCRcbviGfuPdX7ZiCsdExf
                             --foreman-oauth-secret "w5ZDpyPJ24eSBNo53AFybcnqoDYXgLUA"\
                             --pulp-oauth-secret    "doajBEXqNcANy93ZbciFyysWaiwt6BWU"\
                             --certs-tar            "/root/capsule.example.com-certs.tar"\
                             --puppet               "true"\
                             --puppetca             "true"\
                             --pulp                 "true"
                             --tftp                 "true"
                             --dhcp                 "true"\
                             --dhcp-interface       "virbr1
                            --dns                  "true"\
                            --dns-forwarders       "8.8.8.8"\
                            --dns-forwarders       "8.8.4.4"\
                            --dns-interface        "virbr1"\
                            --dns-zone             "example.com"
         
         

      2. オプション 2 - コンテンツノードとしての Satellite Capsule Server: このオプションでは Satellite Capsule Server を、コンテンツ管理機能および Puppet マスターと共にインストールします。root ユーザーとして、Satellite Capsule Server 上で以下のコマンドを実行します。

         # capsule-installer --parent-fqdn          "sat6.example.com"\
                             --register-in-foreman  "true"\
                             --pulp-oauth-secret    "doajBEXqNcANy93ZbciFyysWaiwt6BWU"\
                             --certs-tar           "~/capsule.example.com-certs.tar"\
                             --puppet               "false"\
                             --puppetca             "false"\
                             --pulp                 "true"
         

      3. オプション 3 - コンテンツノードとしての Satellite Capsule Server とスマートプロキシー: このオプションでは Satellite Capsule Server をすべての機能と共にインストールします。root ユーザーとして Satellite Capsule Server 上で以下のコマンドを実行します。

         # capsule-installer --parent-fqdn          "sat6.example.com"\
                             --register-in-foreman  "true"\
                             --foreman-oauth-key    "xmmQCGYdkoCRcbviGfuPdX7ZiCsdExf
                             --foreman-oauth-secret "w5ZDpyPJ24eSBNo53AFybcnqoDYXgLUA"\
                             --pulp-oauth-secret    "doajBEXqNcANy93ZbciFyysWaiwt6BWU"\
                             --certs-tar            "/root/capsule.example.com-certs.tar"\
                             --puppet               "true"\
                             --puppetca             "true"\
                             --pulp                 "true"
                             --tftp                 "true"
                             --dhcp                 "true"\
                             --dhcp-interface       "virbr1
                            --dns                  "true"\
                            --dns-forwarders       "8.8.8.8"\
                            --dns-forwarders       "8.8.4.4"\
                            --dns-interface        "virbr1"\
                            --dns-zone             "example.com"
         
         

手順5.3 capsule-certs-generate 実行後のカスタムサーバー証明書の設定

1. カスタムサーバー証明書をベースとして新規の証明書を生成します。

   capsule-certs-generate --capsule-fqdn "satcapsule.example.com"\
                          --certs-tar "~/$CAPSULE-certs.tar"\
                          --server-cert ~/path/to/server.crt\
                          --server-cert-req ~/path/to/server.crt.req\
                          --server-key ~/path/to/server.key\
                          --server-ca-cert ~/cacert.crt\
                          --certs-update-server --certs-update-server-ca
   

2. 生成される tarball、capsule.example.com-certs.tar を Satellite Server から Satellite Capsule ホストシステムにコピーします。
3. Satellite Capsule Server で、証明書を更新するために capsule-installer コマンドを再実行します。必要とされる Satellite Capsule Server のタイプに応じて、以下のオプションのいずれかを選択します。
   1. オプション 1: Satellite Capsule Server とスマートプロキシー: このオプションでは Satellite Capsule Server をスマートプロキシー機能 (DHCP、DNS、Puppet) と共にインストールします。root ユーザーとして Satellite Capsule Server 上で以下のコマンドを実行します。

        
      # capsule-installer --parent-fqdn          "satellite.example.com"\
                          --register-in-foreman  "true"\
                          --foreman-oauth-key    "xmmQCGYdkoCRcbviGfuPdX7ZiCsdExf
                          --foreman-oauth-secret "w5ZDpyPJ24eSBNo53AFybcnqoDYXgLUA"\
                          --pulp-oauth-secret    "doajBEXqNcANy93ZbciFyysWaiwt6BWU"\
                          --certs-tar            "/root/capsule.example.com-certs.tar"\
                          --puppet               "true"\
                          --puppetca             "true"\
                          --pulp                 "true"
                          --tftp                 "true"
                          --dhcp                 "true"\
                          --dhcp-interface       "virbr1
                         --dns                  "true"\
                         --dns-forwarders       "8.8.8.8"\
                         --dns-forwarders       "8.8.4.4"\
                         --dns-interface        "virbr1"\
                         --dns-zone             "example.com"
      
      

   2. オプション 2 - コンテンツノードとしての Satellite Capsule Server: このオプションでは Satellite Capsule Server を、コンテンツ管理機能および Puppet マスターと共にインストールします。root ユーザーとして、Satellite Capsule Server 上で以下のコマンドを実行します。

      # capsule-installer --parent-fqdn          "sat6.example.com"\
                          --register-in-foreman  "true"\
                          --pulp-oauth-secret    "doajBEXqNcANy93ZbciFyysWaiwt6BWU"\
                          --certs-tar           "~/capsule.example.com-certs.tar"\
                          --puppet               "false"\
                          --puppetca             "false"\
                          --pulp                 "true"
      

   3. オプション 3 - コンテンツノードとしての Satellite Capsule Server とスマートプロキシー: このオプションでは Satellite Capsule Server をすべての機能と共にインストールします。root ユーザーとして Satellite Capsule Server 上で以下のコマンドを実行します。

      # capsule-installer --parent-fqdn          "sat6.example.com"\
                          --register-in-foreman  "true"\
                          --foreman-oauth-key    "xmmQCGYdkoCRcbviGfuPdX7ZiCsdExf
                          --foreman-oauth-secret "w5ZDpyPJ24eSBNo53AFybcnqoDYXgLUA"\
                          --pulp-oauth-secret    "doajBEXqNcANy93ZbciFyysWaiwt6BWU"\
                          --certs-tar            "/root/capsule.example.com-certs.tar"\
                          --puppet               "true"\
                          --puppetca             "true"\
                          --pulp                 "true"
                          --tftp                 "true"
                          --dhcp                 "true"\
                          --dhcp-interface       "virbr1
                         --dns                  "true"\
                         --dns-forwarders       "8.8.8.8"\
                         --dns-forwarders       "8.8.4.4"\
                         --dns-interface        "virbr1"\
                         --dns-zone             "example.com"