PowerShell を使用して Azure Stack HCI バージョン 23H2 を更新する

  • [アーティクル]

適用対象: Azure Stack HCI バージョン 23H2

この記事では、PowerShell を使用して Azure Stack HCI クラスターにソリューションの更新プログラムを適用する方法について説明します。

この記事の手順は、オーケストレーター (ライフサイクル マネージャー) がインストールされた最新バージョンを実行している単一サーバークラスターとマルチサーバー クラスターの両方に適用されます。 クラスターが Azure Stack HCI バージョン 23H2 の新しいデプロイを使用して作成された場合、オーケストレーターはデプロイの一部として自動的にインストールされました。

重要

ここで説明する手順は、あるバージョンの Azure Stack HCI バージョン 23H2 から別の上位バージョンに更新する場合にのみ適用されます。 以前のバージョンの更新プログラムについては、「Azure Stack HCI バージョン 22H2 のクラスターを更新する」を参照してください。

オーケストレーターがインストールされていない古いバージョンの Azure Stack HCI で作成されたクラスターにソリューション更新プログラムを適用する方法については、「Update Azure Stack HCI clusters, version 22H2」を参照してください。

ソリューションの更新プログラムについて

Azure Stack HCI ソリューションの更新プログラムは、プラットフォーム、サービス、およびソリューション拡張機能の更新プログラムで構成できます。 これらの種類の更新プログラムの詳細については、「Azure Stack HCI バージョン 23H2 の更新プログラムについて」を参照してください。

ソリューションの更新プログラムを適用する場合、実行する手順の概要を次に示します。

  1. すべての前提条件が完了していることを確認します。
  2. クラスターで実行されているソフトウェアのバージョンを特定します。
  3. リモート PowerShell を使用して Azure Stack HCI クラスターに接続します。
  4. 使用可能な更新プログラムを検出し、クラスターに適用できる更新プログラムをフィルター処理します。
  5. 更新プログラムをダウンロードし、クラスターの更新準備状況を評価し、準備ができたら、クラスターに更新プログラムをインストールします。 更新プログラムの進行状況を追跡します。 必要に応じて、詳細な進行状況を監視することもできます。
  6. インストールされている更新プログラムのバージョンを確認します。

更新プログラムのインストールにかかる時間は、次の要因によって異なる場合があります。

  • 更新プログラムの内容。
  • クラスターに読み込みます。
  • クラスター内のサーバーの数。
  • 使用するハードウェアの種類。
  • ソリューション ビルダー拡張機能が使用されています。

一般的な単一サーバーと 4 サーバー クラスターの概算時間の見積もりを次の表にまとめます。

クラスター/時間 正常性チェックの時間
hh:mm:ss		 更新プログラムをインストールする時間
hh:mm:ss
単一サーバー 0:01:44 1:25:42
4 サーバー クラスター 0:01:58 3:53:09

前提条件

開始する前に次の点を確認します。

  • 2310 以上を実行している Azure Stack HCI バージョン 23H2 クラスターにアクセスできます。 クラスターは Azure に登録する必要があります。
  • Azure Stack HCI クラスターに接続できるクライアントにアクセスできます。 このクライアントは PowerShell 5.0 以降を実行している必要があります。
  • ネットワーク経由でソリューション更新プログラム パッケージにアクセスできます。 これらの更新プログラムをクラスターのサーバーにサイドロードまたはコピーします。

Azure Stack HCI クラスターに接続する

クライアントで次の手順に従って、Azure Stack HCI クラスターのいずれかのサーバーに接続します。

  1. クラスターへの接続に使用しているクライアントで、管理者として PowerShell を実行します。

  2. Azure Stack HCI クラスター上のサーバーへのリモート PowerShell セッションを開きます。 次のコマンドを実行し、メッセージが表示されたらサーバーの資格情報を入力します。

    $cred = Get-Credential
Enter-PSSession -ComputerName "<Computer IP>" -Credential $cred

    Note

    デプロイ ユーザー アカウントの資格情報を使用してサインインする必要があります。これは、Active Directory の準備時に作成し、Azure Stack HCI システムのデプロイ時に使用したアカウントです。

    出力例を次に示します。

    PS C:\Users\Administrator> $cred = Get-Credential
 
cmdlet Get-Credential at command pipeline position 1
Supply values for the following parameters:
Credential
PS C:\Users\Administrator> Enter-PSSession -ComputerName "100.100.100.10" -Credential $cred 
[100.100.100.10]: PS C:\Users\Administrator\Documents>

手順 1: クラスターのスタンプ のバージョンを特定する

更新プログラムを検出する前に、Azure Stack HCI バージョン 23H2 ソフトウェア バージョン 2310 を使用してクラスターがデプロイされていることを確認します。

  1. デプロイ ユーザー アカウントを使用してクラスター サーバーに接続していることを確認します。 次のコマンドを実行します。

    whoami

  2. Azure Stack HCI バージョン 23H2 を実行してクラスターがデプロイされたことを確認するには、クラスターのいずれかのサーバーで次のコマンドを実行します。

    Get-StampInformation

    出力例を次に示します。

    PS C:\Users\lcmuser> Get-StampInformation
Deployment ID             : b4457f25-6681-4e0e-b197-a7a433d621d6
OemVersion                : 2.1.0.0
PackageHash               :
StampVersion              : 10.2303.0.31
InitialDeployedVersion    : 10.2303.0.26
PS C:\Users\lcmuser>

  3. クラスター上の内容を StampVersion 書き留めしておきます。 スタンプのバージョンには、クラスターが実行されているソリューションのバージョンが反映されます。

手順 2: 更新プログラムを検出する

更新プログラムは、次の 2 つの方法のいずれかで検出できます。

  • オンライン で更新プログラムを検出する - クラスターのインターネット接続が良好な場合に推奨されるオプション。 ソリューションの更新プログラムは、オンライン更新プログラム カタログを介して検出されます。
  • 更新プログラム のサイドロードと検出 - オンラインで更新プログラムを検出する代わりに、信頼性の低い、または低速なインターネット接続のシナリオや、ハードウェア ベンダーによって提供されるソリューション拡張機能の更新プログラムを使用する場合に使用する必要があります。 これらのインスタンスでは、ソリューションの更新プログラムを中央の場所にダウンロードします。 その後、Azure Stack HCI クラスターに更新プログラムをサイドロードし、更新プログラムをローカルで検出します。

オンライン カタログを使用してソリューションの更新プログラムを検出することをお 勧めします 。 ソリューションの更新プログラムをオンラインで検出するには、次の手順に従います。

  1. デプロイ ユーザー アカウントを使用して、Azure Stack HCI クラスター上のサーバーに接続します。

  2. 更新サービスが更新プログラム パッケージを検出することを確認します。

    Get-SolutionUpdate | ft DisplayName, State

  3. 必要に応じて、更新プログラム パッケージ コンポーネントのバージョンを確認します。

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    出力例を次に示します。

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

これで、更新プログラムのダウンロードとインストールに進むことができます。

ソリューションの更新プログラムをサイドロードして検出する

ハードウェアからソリューション拡張機能の更新プログラムを使用している場合は、それらの更新プログラムをサイドロードする必要があります。 次の手順に従って、ソリューションの更新プログラムをサイドロードして検出します。

  1. デプロイ ユーザー アカウントを使用して、Azure Stack HCI クラスター上のサーバーに接続します。

  2. ネットワーク共有に移動し、使用する更新プログラム パッケージを取得します。 サイドロードする更新プログラム パッケージに次のファイルが含まれていることを確認します。

    • SolutionUpdate.xml
    • SolutionUpdate.zip
    • AS_Update_10.2303.4.1.zip

    ソリューション ビルダー拡張機能が更新プログラム パッケージの一部である場合は、次のファイルも表示されます。

    • SBE_Content_4.1.2.3.xml
    • SBE_Content_4.1.2.3.zip
    • SBE_Discovery_Contoso.xml

  3. クラスターのインフラストラクチャ ボリューム内の次の場所に、更新サービスによる検出用のフォルダーを作成します。

    New-Item C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\sideload -ItemType Directory

  4. 前の手順で作成したフォルダーに更新パッケージをコピーします。

  5. Update サービスを使用して更新プログラム パッケージを手動で検出します。 次のコマンドを実行します。

    Add-SolutionUpdate -SourceFolder C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\sideload

  6. 更新サービスが更新プログラム パッケージを検出し、準備とインストールを開始できるかどうかを確認します。

    Get-SolutionUpdate | ft DisplayName, Version, State

    出力例を次に示します。

     PS C:\Users\lcmuser> Get-SolutionUpdate | ft DisplayName, Version, State

DisplayName                 Version      State
-----------                 -------      -----
2023.03 Feature Update 10.2303.0.31 Ready

 PS C:\Users\lcmuser>

  7. 必要に応じて、更新プログラム パッケージ コンポーネントのバージョンを確認します。 次のコマンドを実行します。

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    出力例を次に示します。

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

手順 3: ダウンロード、準備状況の確認、更新プログラムのインストール

更新プログラムをダウンロードし、一連のチェックを実行してクラスターの更新の準備状況を確認し、更新プログラムのインストールを開始できます。

  1. インストールを開始せずに更新プログラムをダウンロードするか、更新プログラムをダウンロードしてインストールする必要があります。

    • 更新プログラムをダウンロードしてインストールするには、次のコマンドを実行します。

      Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate

    • インストールを開始せずに更新プログラムのみをダウンロードするには、フラグStart-SolutionUpdateを-PrepareOnly使用します。

  2. 更新の進行状況を追跡するには、更新の状態を監視します。 次のコマンドを実行します。

    Get-SolutionUpdate | ft Version,State,UpdateStateProperties,HealthState

    更新が開始されると、次のアクションが発生します。

    • 更新プログラムのダウンロードが開始されます。 ダウンロード パッケージのサイズとネットワーク帯域幅によっては、ダウンロードに数分かかる場合があります。

      更新プログラムのダウンロード時の出力例を次に示します。

        PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 Downloading                        InProgress

    • パッケージがダウンロードされると、準備チェックが実行され、クラスターの更新の準備状況が評価されます。 準備チェックの詳細については、「更新フェーズ」を参照してください。 このフェーズでは、 更新プログラムの状態 は次のように HealthChecking表示されます。

      PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 HealthChecking                        InProgress

    • システムの準備ができたら、更新プログラムがインストールされます。 このフェーズでは、更新プログラムの状態が表示され、UpdateStateProperties完了したインストールの割合が表示Installingされます。

      重要

      インストール中にクラスター サーバーが再起動する場合があり、更新プログラムを監視するためにリモート PowerShell セッションを再度確立する必要がある場合があります。 1 つのサーバーを更新すると、Azure Stack HCI でダウンタイムが発生します。

      更新プログラムのインストール中の出力例を次に示します。

      PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 6% complete.              Success


PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 25% complete.             Success

PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 40% complete.             Success

PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 89% complete.             Success

インストールが完了すると、状態Installedは . 更新プログラムのさまざまな状態の詳細については、「インストールの進行状況と監視」を参照してください。

手順 4: インストールを確認する

更新プログラムがインストールされたら、ソリューションのバージョンの環境とオペレーティング システムのバージョンを確認します。

  1. 更新プログラムの状態が Installed 完了したら、環境ソリューションのバージョンを確認します。 次のコマンドを実行します。

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion

    出力例を次に示します。

    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2303.0.31

  2. インストールしたレシピと一致することを確認するには、オペレーティング システムのバージョンを確認します。 次のコマンドを実行します。

    cmd /c ver

    出力例を次に示します。

    PS C:\Users\lcmuser> cmd /c ver

Microsoft Windows [Version 10.0.20349.1547]
PS C:\Users\lcmuser>

更新プログラムのトラブルシューティング

PowerShell を使用して以前に失敗した更新プログラムの実行を再開するには、次のコマンドを使用します。

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate

更新プログラムの正常性チェックが警告状態であるために以前に失敗した更新を再開するには、次のコマンドを使用します。

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate -IgnoreWarnings

その他の更新プログラムの実行に関する問題のトラブルシューティングについては、「更新プログラムのトラブルシューティング」を参照してください。

次のステップ

オーケストレーターが インストールされていないときに Azure Stack HCI クラスターバージョン 22H2 を更新する方法について説明します。