第4章 Managing Subscriptions

Red Hat Satellite 6 では、Red Hat のコンテンツ配信ネットワーク (CDN) からコンテンツをインポートします。Satellite 6 では、対応のリポジトリーからコンテンツの検索、アクセス、ダウンロードを行うサブスクリプションマニフェストが必要です。サブスクリプションマニフェストには、Satellite Server の組織ごとにサブスクリプション割り当てを含める必要があります。サブスクリプション情報はすべて、Red Hat カスタマーポータルのアカウントで確認できます。

Before you can complete the tasks in this chapter, you must create a Subscription Manifest in the Customer Portal.

カスタマーポータルでサブスクリプションマニフェストを作成、管理、エクスポートするには、『Red Hat Subscription Management の使用』ガイドの「マニフェストの使用」を参照してください。

Use this chapter to import a Subscription Manifest and manage the manifest within the Satellite web UI.

Subscription Allocations and Organizations

複数のサブスクリプション割り当てがある場合は、複数の組織を管理できます。Satellite 6 では、Satellite Server で設定した組織ごとに 1 つの割り当てが必要です。この利点は、各組織が独立したサブスクリプションを保持するため、複数の組織をそれぞれ独自の Red Hat アカウントでサポートできることです。

Future-Dated subscriptions

You can use future-dated subscriptions in a subscription allocation. When you add future-dated subscriptions to content hosts before the expiry date of the existing subscriptions, you can have uninterrupted access to repositories.

現在のサブスクリプションの有効期限前に、コンテンツホストに未来の日付のサブスクリプションを手動でアタッチします。自動アタッチ機能は別の目的で設計されており、機能しない可能性があるので、この機能に依存しないでください。詳細は、「Attaching Subscriptions to Content Hosts」を参照してください。

4.1. Importing a Subscription Manifest into Satellite Server

Use the following procedure to import a Subscription Manifest into Satellite Server.

Prerequisite

サブスクリプションマニフェストファイルがカスタマーポータルからエクスポートされていること。詳細は、『Red Hat Subscription Management の使用』ガイドの「マニフェストの使用」を参照してください。

Procedure

To import a Subscription Manifest, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. In the Red Hat Subscriptions window, click Manage Manifest.
  4. マニフェストの管理ウィンドウで、参照をクリックします。
  5. サブスクリプションマニフェストファイルが保存されている場所に移動して、表示 をクリックします。管理マニフェストウィンドウが自動的に終了しない場合は、終了 をクリックして Red Hat サブスクリプションウィンドウに戻ります。

For CLI Users

  1. Copy the Subscription Manifest file to Satellite Server:

    [user@client ~]$ scp ~/manifest_file.zip root@satellite.example.com:~/.
  2. Connect to Satellite Server as the root user, and then import the Subscription Manifest file:

    [root@satellite ~]# hammer subscription upload \
    --file ~/manifest_file.zip \
    --organization "organization_name"

リポジトリーを有効化して、Red Hat コンテンツをインポートできるようになります。詳細は、5章Importing Red Hat Content を参照してください。

4.2. Locating a Subscription in the Satellite Web UI

When you import a Subscription Manifest into Satellite Server, the subscriptions from your manifest are listed in the Red Hat Subscriptions window. If you have a high volume of subscriptions, you can filter the results to find a specific subscription.

Prerequisite

サブスクリプションマニフェストファイルは、Satellite Server にインポートしておく必要があります。詳細は、「Importing a Subscription Manifest into Satellite Server」を参照してください。

Procedure

To locate a subscription, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. Red Hat サブスクリプションウィンドウで、検索 フィールドをクリックし、検索条件の一覧を表示して検索クエリーをビルドします。
  4. Select search criteria to display further options.
  5. When you have built your search query, click the search icon.

たとえば、検索 フィールドにカーソルを置き、expires (期限切れ) を選択して、スペースキーを押すと、別のリストが表示され、>< または = 文字を選択できます。> を選択してスペースキーを押すと、自動オプションの別のリストが表示されます。独自の条件を入力することも可能です。

4.3. Adding Subscriptions to Subscription Allocations in the Satellite Web UI

以下の手順を使用して、Satellite Web UI でサブスクリプション割り当てにサブスクリプションを追加します。

Prerequisite

サブスクリプションマニフェストファイルは、Satellite Server にインポートしておく必要があります。詳細は、「Importing a Subscription Manifest into Satellite Server」を参照してください。

Procedure

To add subscriptions to a subscription allocation, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. In the Red Hat Subscriptions window, click Add Subscriptions.
  4. 追加するサブスクリプションの各行で、Quantity to Allocate (割り当てる数量) 列に数量を入力します。
  5. Click Submit.

4.4. Removing Subscriptions from Subscription Allocations in the Satellite Web UI

以下の手順を使用して、Satellite Web UI でサブスクリプション割り当てからサブスクリプションを削除します。

注記

Manifests must not be deleted. If you delete the manifest from the Red Hat Customer Portal or in the Satellite web UI, all of the entitlements for all of your content hosts will be removed.

Prerequisite

サブスクリプションマニフェストファイルは、Satellite Server にインポートしておく必要があります。詳細は、「Importing a Subscription Manifest into Satellite Server」を参照してください。

Procedure

To remove subscriptions, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. On the row of each subscription you want to remove, select the corresponding check box.
  4. 削除をクリックして、削除を確定します。

4.5. Updating and Refreshing Subscription Manifests

Every time that you change a subscription allocation, you must refresh the manifest to reflect these changes. For example, you must refresh the manifest if you take any of the following actions:

  • Renewing a subscription
  • Adjusting subscription quantities
  • Purchasing additional subscriptions

You can refresh the manifest directly in the Satellite web UI. Alternatively, you can import an updated manifest that contains the changes.

Procedure

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. Navigate to Content > Subscriptions.
  3. In the Red Hat Subscriptions window, click Manage Manifest.
  4. マニフェストの管理ウィンドウで、更新をクリックします。

4.6. Attaching Subscriptions to Content Hosts

Using activation keys is the main method to attach subscriptions to content hosts during the provisioning process. However, an activation key cannot update an existing host. If you need to attach new or additional subscriptions, such as future-dated subscriptions, to one host, use the following procedure.

複数ホストの更新に関する詳細情報は、「Bulk Updating Content Hosts' Subscriptions」 を参照してください。

アクティベーションキーに関する詳細情報は、10章Managing Activation Keys を参照してください。

Smart Management Subscriptions

Satellite 6 では、管理するすべての Red Hat Enterprise Linux ホストの Red Hat Enterprise Linux Smart Management サブスクリプションを保持する必要があります。

However, you are not required to attach Smart Management subscriptions to each content host. Smart Management subscriptions cannot attach automatically to content hosts in Satellite because they are not associated with any product certificates. Adding a Smart Management subscription to a content host does not provide any content or repository access. If you want, you can add a Smart Management subscription to a manifest for your own recording or tracking purposes.

Prerequisite

Satellite Server にサブスクリプションマニフェストファイルをインポートしておくこと。

Procedure

To attach subscriptions to content hosts, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. ホスト > コンテンツホストに移動します。
  3. On the row of each content host whose subscription you want to change, select the corresponding check box.
  4. From the Select Action list, select Manage Subscriptions.
  5. 任意で、検索フィールドにキーと値を入力し、表示するサブスクリプションを絞り込みます。
  6. 追加または削除するサブスクリプションの左側にあるチェックボックスを選択し、必要に応じて 選択した項目を追加 または 選択した項目を削除 をクリックします。
  7. 完了をクリックして変更を保存します。

For CLI Users

  1. root ユーザーとして Satellite Server に接続してから、利用可能なサブスクリプションを表示します。

    # hammer subscription list \
    --organization-id 1
  2. Attach a subscription to the host:

    # hammer host subscription attach \
    --host host_name \
    --subscription-id subscription_id

4.7. Bulk Updating Content Hosts' Subscriptions

以下の手順を使用して、インストール後に複数のコンテンツホストを同時に変更します。Satellite Web UI およびフィルター機能を使用して変更するコンテンツホストを選択するか、Hammer CLI ツールの CSV ファイルエクスポート機能を使用して、CSV ファイルで設定を編集し、変更内容をアップロードします。

Procedure

To update multiple content hosts, complete the following steps:

  1. In the Satellite web UI, ensure the context is set to the organization you want to use.
  2. ホスト > コンテンツホストに移動します。
  3. On the row of each content host whose subscription you want to change, select the corresponding check box.
  4. From the Select Action list, select Manage Subscriptions.
  5. 任意で、検索フィールドにキーと値を入力し、表示するサブスクリプションを絞り込みます。
  6. 追加または削除するサブスクリプションの左側にあるチェックボックスを選択し、選択した項目を追加または選択した項目を削除をクリックします。
  7. 完了をクリックして変更を保存します。

For CLI Users

  1. Export the current state of content hosts to a CSV file.

    # hammer --server https://satellite.example.com csv content-hosts --export --file content_hosts.csv
  2. Make a backup of the file:

    # cp content_hosts.csv content_hosts.csv.backup
  3. CSV ファイルで必要な値を変更します。CSV ファイルの文字列を変更するには、以下のように、エディター、CSV プラグイン、または sed を使用できます。

    # sed -i "s/1|RH1234|Red Hat Enterprise Linux Server/1|RH5678|Red Hat Enterprise Linux Server/g" content_hosts.csv
  4. Confirm only the required changes were made. For example:

    # diff content_hosts.csv content_hosts.csv.backup
  5. Upload the changed file to Satellite Server:

    # hammer --server https://satellite.example.com csv content-hosts --file content_hosts.csv