プロキシの移行

1. 要件と考慮事項

SUSE Manager 4.3プロキシをSUSE Multi-Linux Manager 5.1に移行するには、SL Micro 6.1またはSUSE Linux Enterprise Server 15 SP7、および`mgrpxy`がインストールされた新しいマシンが必要です。

SUSE Manager 4.3から5.1へのインプレース移行は、選択したホストオペレーティングシステムがSL Micro 6.1またはSUSE Linux Enterprise Server 15 SP7のいずれであっても、ホストオペレーティングシステムの再インストールが必要です。

SUSE Manager 4.3から5.1に移行する前に、従来のプロキシを含む既存の従来のクライアントをSaltに移行する必要があります。従来のSUSE Multi-Linux Manager 4.3クライアントをSaltクライアントに移行する方法についての詳細は、 https://documentation.suse.com/suma/4.3/en/suse-manager/client-configuration/contact-methods-migrate-traditional.html.を参照してください。

従来の接続プロトコルは、SUSE Multi-Linux Manager 5.0以降ではサポートされなくなりました。

SUSE Manager 4.3プロキシをSUSE Multi-Linux Manager 5.1に移行する前に、まずSUSE Manager 4.3サーバーを移行する必要があります。詳細はSUSE Multi-Linux Manager コンテナ化された環境へのサーバ移行を参照してください。

2. 概要

SUSE Multi-Linux Manager 5.1では、プロキシを展開するための2つの異なる方法があります：

Podman上でコンテナ化して実行
k3sへのコンテナ化された{productname}プロキシのインストール

SUSE Multi-Linux Manager 5.1では、RPMベースのサポートが削除され、podmanまたはk3sで実行されるコンテナ化されたバージョンのみがサポートされています。 Podmanで実行されるコンテナ化されたプロキシの管理は、`mgrpxy`ツールを使用して行います。

3. 既存のSUSE Multi-Linux Manager Proxyデータをバックアップします。

SUSE Multi-Linux Manager for Retail 5.1.2には、両方の種類のSUSE Multi-Linux Manager Proxyバリアントのための自動バックアップ移行手順が含まれています。この手順は、必要なすべてのデータを収集し、それをSUSE Multi-Linux Managerサーバーにアップロードします。SUSE Multi-Linux Manager Retail Branch Serverのために、このツールはSaltboot関連のエンティティを作成し、移行します。詳細はMigrating from SUSE Multi-Linux Manager Retail Branch Server 4.3を参照してください。

SUSE Multi-Linux Manager Proxy 4.3の移行を開始する方法は複数あります：

API呼び出し

`$proxyid`をブランチプロキシのサーバID、またはカンマで区切られた複数のサーバIDに置き換えます。
```
mgrctl api login +
mgrctl api post proxy/backupConfiguration '{\"sids\":[$proxyid]}'
```
Salt コール

以下のコマンドの`$proxy`をブランチプロキシのミニオンIDに置き換えるか、複数のブランチプロキシを対象とする場合は`-L proxyminionid1,proxyminionid2,…`に置き換えます。
```
salt $proxy proxy.backup
```

特にカスタム変更がある場合は、プロキシの手動バックアップも実行することをお勧めします。

SUSE Multi-Linux Manager Proxyはバックアップステップ後も以前と同様に動作し続けますが、潜在的な不整合を防ぐために、バックアップステップの実行後できるだけ早くサーバホストを移行してください。

4. 新しいSUSE Multi-Linux Manager Proxyをデプロイします。

既存のホストをAutoYaSTを使用してSUSE Linux Enterprise Server 15 SP7にアップグレードするか、SL Micro 6.1の新規インストールを行うことができます。

4.1. AutoYaSTを使用してSUSE Linux Enterprise Server 15 SP7にアップグレードします。

AutoYASTプロファイルを作成して使用し、プロキシホストを移行または再インストールします。

4.1.1. SUSE Linux Enterprise Server 15 SP7に基づいて自動インストールのディストリビューションを準備します。

SUSE Linux Enterprise Server 15 SP7インストールISOをサーバホストにダウンロードまたは取得します。
インストールファイルをコンテナにコピーするには`mgradm distribution copy $path_to_the_iso`を使用します。
自動インストールディストリビューションを登録します。詳細は自動インストール可能なディストリビューションを参照してください。

4.1.2. インストールメディアへのアクセス

詳細については、自動インストールプロファイルを参照してください。

以前に作成したディストリビューションに基づいて自動インストールプロファイルを作成します。プロファイルとして https://github.com/SUSE/manager-build-profiles/blob/master/AutoYaST/SUSE-Multi-Linux-Manager/SUSE%20Multi-Linux%20Manager%20Proxy/MLM_Proxy-51-SLES-Install.xmlで提供されたプロファイルを使用します。

プロファイルを作成したら、`Variables`タブに切り替えて必要な変数を入力します。

org='organization_id'
distrotree='autoinstallation_distribution_label_from_previous_step'
channel_prefix='clm_channel_prefix' またはSCCチャネル用に空白
registration_key='activation_key_for_post_upgrade'

`Autoinstallation File`タブでは、追加の確認用に、レンダリングされた完全なプロファイルを参照できます。

4.1.3. プロキシの自動インストールのプロビジョニング

以前のステップで作成したプロファイルを使用して、古いSUSE Multi-Linux Manager Proxy 4.3における自動インストールをスケジュールします。

移行するブランチサーバーの`System`ビューにあるWeb UIインターフェースの`Provisioning`タブを使用します
または、API呼び出し`system/provisionSystem`を使用して移行をスケジュールします。例として、SUSE Multi-Linux Managerホストから次のスニペットを実行してください：
```
mgrctl api login
mgrctl api post system/provisionSystem '{\"sid\":$proxyid,\"profileName\":\"$profileName\"}'
```

4.2. SL Micro 6.1を再インストールします。

SL Micro 6.1はホストに新規インストールが必要です。

ホストの再インストールを進める前に、既存の4.3プロキシのバックアップを実施してください。詳細については、既存のSUSE Multi-Linux Manager Proxyデータをバックアップします。を参照してください。

4.3. SL Micro 6.1ホストを準備します。

4.3.1. インストールメディアのダウンロード

プロシージャ:インストールメディアのダウンロード

https://www.suse.com/download/sle-micro/,にあるSL Micro 6.1インストールメディアを見つけて、適切なメディアファイルをダウンロードします。

インストール用にダウンロードした`.iso`イメージを含むDVDまたはUSB フラッシュドライブを準備します。

4.3.2. SL Micro 6.1をインストールします。

マシン（仮想または物理）の準備に関する詳細は、SL Microデプロイメントガイドを参照してください。

プロシージャ:SL Micro 6.1をインストール中です。

SLE Micro 6.1のインストールイメージを含むDVDまたはUSBフラッシュドライブ（USBディスクまたはキー）を挿入します。

システムをブートまたは再起動します。

矢印キーを使用して`Installation`を選択します。

キーボードと言語を調整します。

`checkbox`をクリックして、ライセンス契約を受け入れます。

`Next`をクリックして続行します。

プロキシの登録SL Micro 6.1エンタイトルメントはSUSE Multi-Linux Managerエンタイトルメント内に含まれているため、別途登録コードは必要ありません。

継続するには次へをクリックしてください。

`NTP Configuration`ページで、Nextをクリックします。

`Authentication for the System`ページで、ルートユーザのパスワードを入力します。次へをクリックします。

`Installation Settings`ページで、Installをクリックします。

これでSL Micro 6.1とSUSE Multi-Linux Manager 5.1の拡張機能のインストールが完了しました。

4.3.3. システムの更新

プロシージャ:システムの更新

*ルート*としてログインします。
transactional-updateを実行します。
transactional-update
再起動します。

SL Microはデフォルトで自動的に更新されるように設計されており、更新を適用した後に再起動します。しかし、この動作はSUSE Multi-Linux Manager環境では望ましくありません。サーバーで自動更新を防ぐために、SUSE Multi-Linux Managerは起動プロセス中にトランザクション更新タイマーを無効にします。

SL Microのデフォルトの動作を使用したい場合は、次のコマンドを実行してタイマーを有効にします。

systemctl enable --now transactional-update.timer

4.3.4. プロキシを登録してデプロイします。

プロシージャ:プロキシの登録とデプロイ

ホストの準備が整ったら、新しいSL Micro 6.1システムをSUSE Multi-Linux Managerサーバーにクライアントとして登録します。元の4.3プロキシと同じミニオンIDを使用することをお勧めします。詳細については、クライアントの登録を参照してください。

SUSE Multi-Linux Managerサーバーで、新しいプロキシサーバーのプロキシ設定を生成します。詳細については、installation-and-upgrade:container-deployment/mlm/proxy-deployment-mlm.adoc#generate-proxy-configを参照してください。
設定をSL Micro 6.1ホストに転送し、プロキシをインストールします：
mgrpxy install podman config.tar.gz
プロキシを起動します：
mgrpxy start
プロキシが稼働すると、SUSE Multi-Linux Managerサーバーは次の`Hardware Refresh`ステップ中にバックアップされた設定を自動的にデプロイします。

5. プロキシコンテナを検証する

移行が完了しsaltが初めて起動されると、バックアップされたプロキシ設定が`Hardware refresh`ステップ中に自動的にデプロイされます。

すべてのオンボーディングステップが完了したら、必要なプロキシ機能を検証します。

6. TFTPファイルの同期

コンテナ化されたプロキシは、tftpsyncメカニズムを使用してtftprootファイルを転送しません。代わりに、これらのファイルは透過的にダウンロードされ、必要に応じてキャッシュされます。

`cobbler sync`の実行中の誤検知エラーを防ぐため、移行された4.3プロキシをtftpsyncメカニズムから削除する必要があります。

以前にTFTPファイルを受信するように4.3プロキシを設定していた場合は、以下の設定オプションのいずれかが必要です。

コンテナ内のシェルに移動するには、コンテナホストで次のコマンドを実行します。

mgrctl term

SUSE Multi-Linux Manager 5.1サーバーコンテナ内で、残りの4.3プロキシのリストを引数として`configure-tftpsync.sh`を実行してください。 4.3プロキシが残っていない場合は、引数なしで`configure-tftpsync.sh`を実行してください。

SUSE Multi-Linux Manager 5.1サーバーコンテナ内で、`/etc/cobbler/settings.yaml`ファイルの`proxies`設定から該当するプロキシを手動で削除してください。 4.3プロキシが残っていない場合は、`proxies`リストを完全に手動で削除してください。