製品移行

1. 概要

製品移行により、SLEベースのクライアントシステムをサービスパック（SP）レベルから後のレベルにアップグレードすることができます。例えば、SUSE Linux Enterprise Server 15 SP5をSUSE Linux Enterprise Server 15 SP6に移行できます。 Red Hat Enterprise LinuxやCentOSなどのクライアントをSUSE Liberty Linuxにアップグレードすることもできます。

製品移行では、クライアント上で有効化され、移行される必要のあるすべてのリポジトリが有効である必要があります。有効でない場合、移行は中止されます。

SUSE Multi-Linux Managerは、以下の移行パスをサポートしています：

1.1. 同じメジャーバージョン内での移行

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

1.2. openSUSE Leapから以降のマイナーバージョンまたは対応するSUSE Linux Enterprise Server SPへの移行

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

openSUSE Leap 15.5から15.6
openSUSE Leap 15.6からSUSE Linux Enterprise Server 15 SP6

1.3. SUSE Linux Enterprise Serverから対応するSUSE Linux Enterprise Server for SAP Applications SPへの移行

SUSE Linux Enterprise Serverを対応するSUSE Linux Enterprise Server for SAP Applications SPレベルに移行することもできます。次に例を示します：

SUSE Linux Enterprise Server 15 SP5からSUSE Linux Enterprise Server for SAP Applications 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/en-us/sles/15-SP6/html/SLES-all/cha-upgrade-paths.html#sec-upgrade-paths-supportedを参照してください。

すべての推奨される拡張機能は、移行時に自動的に有効になります。
移行中、SUSE Multi-Linux Managerは、インストール前に必要なライセンス（EULA）を自動的に受け入れます。

2. 単一システムの移行

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

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

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

システム 概要ページから、クライアントを選択します。
クライアントのシステム詳細ページから、ソフトウェア 製品移行タブに移動します。
ターゲットの移行パスを選択し、チャンネルの選択をクリックします。
`Product Migration - Channels`ページから、`Mandatory Child Channels`および追加の`Optional Child Channels`を含む正しいベースチャンネルを選択します。
オプション:ベンダーが変更されたパッケージをインストールできるようにするには、`Allow Vendor Change`にチェックを入れてください。これが発生した場合、移行が開始される前に詳細を含む通知が表示されます。

openSUSE LeapをSUSE Linux Enterprise Serverに移行するには、`Allow Vendor Change`オプションにチェックを入れる必要があります。
チャンネルが正しく設定されたら、移行のスケジュールをクリックします。

3. 製品の大量移行

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

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

3.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

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

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

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

SUSE Multi-Linux Manager Web UIで、システム システムグループに移動し、グループの作成をクリックします。
グループに`mpm-target-sles15sp3`という名前を付けます。
- 同じベースチャネルに登録されているシステムのみが作成されたグループに追加されるべきです。この例では、`SLE-Product-SLES15-SP2-Pool for x86_64`に登録されているシステムのみをグループに追加する必要があります。
  
  クライアントをグループに追加する方法についての詳細は、システムグループを参照してください。

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

次のコマンドを実行して、グループ内のすべてのシステムのターゲットを取得します。
```
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
```

3.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 CHILD_CHANNELS (子チャンネル) (カンマ区切りで子チャンネルのラベルを指定する。空白は使用しないこと)

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

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

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

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

すべて問題がなければ、コマンドから`-d`オプションを削除して、実際の移行を実行できます。移行が完了したら、システムをSUSE Multi-Linux Manager Web UIから再起動できます。