製品移行

Table of Contents

1. 単一システムの移行
2. 製品の大量移行
- 2.1. 製品の大量移行の実行
- 2.2. 例: SLES 15 SP2からSLES 15 SP3
  - 2.2.1. 必須の構文の説明

製品を移行すると、SLEベースのクライアントシステムをサービスパック(SP)レベルから最新版にアップグレードできます。たとえば、SUSE Linux Enterprise Server 15 SP1をSUSE Linux Enterprise Server 15 SP2に移行できます。

製品の移行は、同じメジャーバージョン内でアップグレードするためのものです。 SUSE Linux Enterprise Server 12からSUSE Linux Enterprise Server 15への移行には、製品の移行は使用できません。メジャーアップグレードの詳細については、クライアント - メジャーバージョンのアップグレードを参照してください。

openSUSE Leapを新しいマイナーバージョンまたは対応するSUSE Linux Enterprise Server SPレベルに移行することもできます。次に例を示します。

openSUSE Leap 15.1から15.2、または
openSUSE Leap 15.1からSUSE Linux Enterprise Server 15 SP1、または
openSUSE Leap 15.5からSUSE Linux Enterprise Server 15 SP5

SUSE Linux Enterprise Server 12以降では、SUSE Customer Centerがサービスパックを提供している場合、SUSEはサービスパックのスキップをサポートしています。たとえば、SUSE Linux Enterprise Server 15からSP2にアップグレードできます。SP1はインストールされません。

サポートされているSUSE Linux Enterprise Serverアップグレードパスについては、https://documentation.suse.com/sles/15-SP4/html/SLES-all/cha-upgrade-paths.html#sec-upgrade-paths-supportedを参照してください。

移行中、SUSE Managerは、インストール前に必要なライセンス(EULA)を自動的に受け入れます。

1. 単一システムの移行

製品の移行を開始する前に:

保留中の更新やパッチがないことを確認してください。クライアントシステムの詳細概要ページの［システムステータス ］を確認し、提供されているすべての更新またはパッチをインストールします。クライアントシステムが最新でない場合、製品移行が失敗する可能性があります。
ターゲット製品のすべてのチャンネルが完全に同期されていることを確認してください。 Web UIで同期ステータスを確認するには、管理 セットアップウィザード 製品ページに移動します。
万一に備えて、作業システムのバックアップを用意してください。製品の移行にはロールバック機能はありません。移行プロシージャが始まると、ロールバックできません。

プロシージャ: 単一システムの移行の実行

システム 概要ページからクライアントを選択します。
クライアントのシステム詳細ページから、ソフトウェア 製品移行タブに移動します。
ターゲットの移行パスを選択し、チャンネルの選択をクリックします。
［製品移行 - チャンネル］ページから、正しいベースチャンネルを選択し、必須の子チャンネルおよび追加のオプション子チャンネルを含めます。
オプション: ［ベンダー変更を許可する］にチェックを付け、ベンダを変更したパッケージをインストールできるようにします。チェックを付けると、移行の開始前に詳細を示す通知が表示されます。

openSUSE LeapをSUSE Linux Enterprise Serverに移行するには、［ベンダー変更を許可する］オプションにチェックを付ける必要があります。
チャンネルを正しく設定したら移行のスケジュールをクリックします。

2. 製品の大量移行

多数のクライアントを次のSPバージョンに移行する場合、SUSE Manager APIコールを使用できます。

spacecmdコマンドラインツールは、system_scheduleproductmigrationサブコマンドを提供します。このコマンドを使用して、多数のクライアントの次のマイナーバージョンへの移行をスケジュールできます。

2.1. 製品の大量移行の実行

製品の大量移行操作は危険です。プロセスは徹底的にテストする必要があります。少なくとも、最初に予行演習を行ってください。

システムを意図せずにアップグレードしないように注意してください。

プロシージャ: 製品の大量移行の実行

実行可能な移行ターゲットをリストし、移行するシステムIDをメモします。
```
spacecmd api -- system.listMigrationTargets -A 1000010001
```
それぞれのシステムIDに対して、listMigrationTargetを呼び出し、目的の製品が使用可能であることを確認します。
- システムIDに使用可能なターゲットがある場合は、system.scheduleProductMigrationを呼び出します。
- 目的のターゲットを使用できない場合、そのシステムをスキップします。

次のテンプレートを環境に合わせます。

target = '[....]'
basechannel = 'channel-label'
 system_ids = [1, 2, 3]

session = auth.login(user, pass)
for system in system_ids
  if system.listMigrationTargets(session, system).ident == target
    system.scheduleProductMigration(session, system, target, basechannel, [], False, <now>)
  else
    print "Cannot migrate to requested target -- skipping system"
  endif
endfor

2.2. 例: SLES 15 SP2からSLES 15 SP3

この例では、大量移行を容易にするためにグループが一時的に作成されます。

プロシージャ: 製品の大量移行グループの作成

SUSE ManagerのWeb UIで、システム システムグループに移動し、グループの作成をクリックします。
グループにmpm-target-sles15sp3という名前を付けます。
- 同じベースチャンネルにサブスクライブしているシステムのみを、作成したグループに追加する必要があります。この例では、SLE-Product-SLES15-SP2-Pool for x86_64にサブスクライブされているシステムのみをグループに追加する必要があります。
  
  グループへのクライアントの追加の詳細については、client-configuration:system-groups.adoc#_add_clients_to_groupsを参照してください。

プロシージャ: グループへのシステムの追加

次のコマンドを実行して、グループ内のすべてのシステムのターゲットを取得します。
```
spacecmd -- system_listmigrationtargets group:mpm-target-sles15sp3
```

コマンドは「ID」の文字列を出力します。

すべての システムについて報告されるターゲットのみを選択してください。

文字列は、他のコマンドのMIGRATIONTARGETの識別子です。

spacecmdサブコマンドsystem_scheduleproductmigrationとsystem_listmigrationtargetsは、グループの一部であるすべてのシステムをループしています。

グループに100台のシステムがある場合は、100個のスケジュールされたアクションが表示されます。

グループ内のすべてのシステムは同じ移行ターゲットをサポートする必要があります。

プロシージャ: 大量移行コマンドの実行

system_scheduleproductmigrationコマンドの構文は次のとおりです。

spacecmd -- system_scheduleproductmigration <SYSTEM> <BASE_CHANNEL_LABEL> \
    <MIGRATION_TARGET> [options]

この例では、グループmpm-target-sles15sp3内のすべてのシステムをSLES 12 SP2からSLES 15 SPにアップグレードするには、コマンドラインで次のように入力します。
```
spacecmd -- system_scheduleproductmigration group:mpm-target-sles15sp3 \
    sle-product-sles15-sp3-pool-x86_64 "[190,203,195,1242]" -d
```

2.2.1. 必須の構文の説明

system_scheduleproductmigrationの構文の使用方法とオプションを表示するには、次のコマンドを実行します。

spacecmd system_scheduleproductmigration help

<SYSTEM>

この例では、作成したグループを使用して、そのグループからすべてのシステムを選択します。

group:mpm-target-sles15sp3

<BASE_CHANNEL_LABEL>

これは、ターゲットベースチャンネルのラベルです。この場合、システムはSLES 15 SP3にアップグレードされており、ラベルはsle-product-sles15-sp3-pool-x86_64です。

現在ミラーリングされているすべてのベースチャンネルのリストを表示するには、次のコマンドを実行します。

spacecmd softwarechannel_listbasechannels.

現在のベースチャンネルで使用可能なターゲットでない限り、チャンネルにアップグレードできないことに注意してください。

<MIGRATION_TARGET>

グループgroup:mpm-target-sles15sp3内のシステムのこの値を特定するには、次のコマンドを実行します。

spacecmd -- system_listmigrationtargets group:mpm-target-sles15sp3

MIGRATION_TARGETパラメータは、次の形式で渡す必要があります。角括弧の副次作用を防ぐために、シェルの引用符が必要であることに注意してください。

"[190,203,195,1242]"

オプション

-s START_TIME
-d 予行演習モード(実際には処理を行わない) (実際の移行の前に予行演習を行うことを推奨)
-c (子チャンネル) (カンマ区切りで子チャンネルのラベルを指定する。空白は使用しないこと)

この場合、-dオプションが含まれています。このオプションは予行演習が成功した後に削除できます。

成功した場合、スケジュールされたシステムごとのコマンド出力は次のようになります。

Scheduling Product migration for system mpm-sles152-1
Scheduled action ID: 66

グループ内の特定のシステムのWeb UIで、アクション (この場合は予行演習)を追跡することもできます。クライアントのシステム詳細ページから、イベント 履歴に移動します。予行演習中に障害が発生した場合は、システムを調査する必要があります。

すべて問題がなければ、コマンドから-dオプションを削除して、実際の移行を実行できます。

移行が完了したら、SUSE Manager Web UIからシステムを再起動できます。