製品移行

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. 単一システムの移行

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

Ensure there are no pending updates or patches. Check the System Status on the client system’s Details Overview page, and install all offered updates or patches. If your client system is not up to date, product migration may fail.
ターゲット製品のすべてのチャンネルが完全に同期されていることを確認してください。 Web UIで同期ステータスを確認するには、管理 セットアップウィザード 製品ページに移動します。
万一に備えて、作業システムのバックアップを用意してください。製品の移行にはロールバック機能はありません。移行プロシージャが始まると、ロールバックできません。

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

システム 概要ページからクライアントを選択します。
クライアントのシステム詳細ページから、ソフトウェア 製品移行タブに移動します。
ターゲットの移行パスを選択し、チャンネルの選択をクリックします。
From the Product Migration - Channels page select the correct base channel, including Mandatory Child Channels and any additional Optional Child Channels.
OPTIONAL: Check Allow Vendor Change to allow packages that have changed vendors to be installed. If this occurs, a notification is shown with details before the migration is started.

To migrate openSUSE Leap to SUSE Linux Enterprise Server, you must check the Allow Vendor Change option.
チャンネルを正しく設定したら移行のスケジュールをクリックします。

3. 製品の大量移行

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

The spacecmd commandline tool provides a system_scheduleproductmigration sub command, which can be used to schedule a migration for a large number of clients to the next minor version.

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

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

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

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

実行可能な移行ターゲットをリストし、移行するシステムIDをメモします。
```
spacecmd api -- system.listMigrationTargets -A 1000010001
```
For each system ID, call listMigrationTarget and check that the desired target product is available.
- If the system ID has an available target, call 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で、システム システムグループに移動し、グループの作成をクリックします。
Name the group mpm-target-sles15sp3.
- Only systems subscribed to the same base channel should be added to the created group. In the example, only systems subscribed to SLE-Product-SLES15-SP2-Pool for x86_64 should be added to the group.
  
  グループへのクライアントの追加の詳細については、システムグループを参照してください。

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

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

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

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

The string is the identifier for the MIGRATIONTARGET of the other command.

The spacecmd sub-commands system_scheduleproductmigration and system_listmigrationtargets are looping over all systems that are part of the group.

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

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

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

The syntax for the system_scheduleproductmigration command is as follows:

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

For this example to upgrade all systems in the group mpm-target-sles15sp3 from SLES 12 SP2 to SLES 15 SP, enter on the command line:

spacecmd -- system_scheduleproductmigration group:mpm-target-sles15sp3 \
    sle-product-sles15-sp3-pool-x86_64 "[190,203,195,1242]" -d

3.2.1. 必須の構文の説明

To see syntax usage and options for system_scheduleproductmigration, run:

spacecmd system_scheduleproductmigration help

<SYSTEM>

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

group:mpm-target-sles15sp3

<BASE_CHANNEL_LABEL>

This is the label for the target base channel. In this case, the system is being upgraded to SLES 15 SP3, and the label is sle-product-sles15-sp3-pool-x86_64.

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

spacecmd softwarechannel_listbasechannels

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

<MIGRATION_TARGET>

To identify this value for systems in the group group:mpm-target-sles15sp3, run:

spacecmd -- system_listmigrationtargets group:mpm-target-sles15sp3

The MIGRATION_TARGET parameter must be passed in the following format; note necessary shell quotation to prevent sideeffects with brackets:

"[190,203,195,1242]"

オプション

-s START_TIME
-d pass this flag, if you want to do a dry run (it is recommended to run a dry run before the actual migration)
-c CHILD_CHANNELS (comma-separated child channels labels with no spaces)

In this case we included the -d option, which can be removed after a successful dry run.

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

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

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

If all is well, the -d option can be removed from the command to run the real migration. After the migration is complete, you can reboot the system from the SUSE Multi-Linux Manager Web UI.