製品移行
1. 概要
Product migration lets you upgrade SLE-based client systems to a newer supported product version directly from the Web UI. This includes upgrading to a later Service Pack (SP) within the same major version, for example SUSE Linux Enterprise Server 15 SP5 to SUSE Linux Enterprise Server 15 SP6, as well as the major version upgrade from SUSE Linux Enterprise Server 15 SP7 to SUSE Linux Enterprise Server 16.0.
You can also use it to upgrade clients such as Red Hat Enterprise Linux or CentOS to SUSE Liberty Linux.
|
製品移行では、クライアント上で有効化され、移行される必要のあるすべてのリポジトリが有効である必要があります。有効でない場合、移行は中止されます。 |
SUSE Multi-Linux Manager supports the following migration paths using the product migration feature:
| Migration path | Example |
|---|---|
Service Pack (SP) upgrade within the same major version |
SUSE Linux Enterprise Server 15 SP5 to SUSE Linux Enterprise Server 15 SP6 |
openSUSE Leap to a later minor version |
openSUSE Leap 15.5 to openSUSE Leap 15.6 |
openSUSE Leap to the corresponding SUSE Linux Enterprise Server SP |
openSUSE Leap 15.6 to SUSE Linux Enterprise Server 15 SP6 |
SUSE Linux Enterprise Server to the corresponding SUSE Linux Enterprise Server for SAP Applications SP |
SUSE Linux Enterprise Server 15 SP5 to SUSE Linux Enterprise Server for SAP Applications 15 SP5 |
Major version upgrade to SUSE Linux Enterprise Server 16.0 |
SUSE Linux Enterprise Server 15 SP7 to SUSE Linux Enterprise Server 16.0 |
Red Hat Enterprise Linux or CentOS to SUSE Liberty Linux |
Red Hat Enterprise Linux to SUSE Liberty Linux |
|
You cannot use product migration to migrate from SUSE Linux Enterprise Server 12 to SUSE Linux Enterprise Server 15. To upgrade from SUSE Linux Enterprise Server 12 to SUSE Linux Enterprise Server 15, see メジャーバージョンのアップグレード. |
1.1. Major version upgrade to SUSE Linux Enterprise Server 16.0
The following applies specifically to the major version upgrade from SUSE Linux Enterprise Server 15 SP7 to SUSE Linux Enterprise Server 16.0.
|
The migration to SUSE Linux Enterprise Server 16.0 happens in two steps:
-
The migration action performs the actual product migration on the client.
-
Once the migration action has finished, whether it passed or failed, the system is rebooted automatically. After the reboot, when the Salt minion connects to the SUSE Multi-Linux Manager Server again, the verification step starts automatically.
To perform this upgrade, use the standard product migration procedures described in this page: the 単一システムの移行 procedure for a single client, or the 製品の大量移行 procedure for many clients at once.
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を参照してください。
|
2. 単一システムの移行
製品の移行を開始する前に:
-
Ensure there are no pending updates or patches. Check the
System Statuson the client system’s 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 - Channelspage select the correct base channel, includingMandatory Child Channelsand any additionalOptional Child Channels.OPTIONAL: Check
Allow Vendor Changeto 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 Changeoption.チャンネルを正しく設定したら移行のスケジュールをクリックします。
3. 製品の大量移行
If you want to migrate a large number of clients to the next SP version, you can use SUSE Multi-Linux Manager API calls or System Set Manager (SSM).
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. Perform a Product Mass Migration using System Set Manager (SSM)
Add the systems you want to migrate to the System Set Manager (SSM) as described in システムグループ.
In the SUSE Multi-Linux Manager Web UI, navigate to .
Navigate to the
Product Migrationtab.Choose a target product and then click Select Channels.
On the next page, click Schedule Migration.
If you want, click Dry Run to do a dry run first, and if everything is correct, click Migrate to start the migration.
3.2. Perform a Product Mass Migration using API calls
|
製品の大量移行操作は危険です。 プロセスは徹底的にテストする必要があります。 少なくとも、最初に予行演習を行ってください。 システムを意図せずにアップグレードしないように注意してください。 |
実行可能な移行ターゲットをリストし、移行するシステムIDをメモします。
spacecmd api -- system.listMigrationTargets -A 1000010001For each system ID, call
listMigrationTargetand 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.3. 例: 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_64should be added to the group.グループへのクライアントの追加の詳細については、システムグループを参照してください。
次のコマンドを実行して、グループ内のすべてのシステムのターゲットを取得します。
spacecmd -- system_listmigrationtargets group:mpm-target-sles15sp3コマンドは「ID」の文字列を出力します。
すべての システムについて報告されるターゲットのみを選択してください。
The string is the identifier for the
MIGRATIONTARGETof the other command.
The
spacecmdsub-commandssystem_scheduleproductmigrationandsystem_listmigrationtargetsare looping over all systems that are part of the group.グループに100台のシステムがある場合は、100個のスケジュールされたアクションが表示されます。
グループ内のすべてのシステムは同じ移行ターゲットをサポートする必要があります。
The syntax for the
system_scheduleproductmigrationcommand 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-sles15sp3from 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.3.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_TARGETparameter must be passed in the following format; note necessary shell quotation to prevent sideeffects with brackets:"[190,203,195,1242]"
- オプション
-
-
-sSTART_TIME -
-dpass this flag, if you want to do a dry run (it is recommended to run a dry run before the actual migration) -
-cCHILD_CHANNELS (comma-separated child channels labels with no spaces)In this case we included the
-doption, 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.