다음을 통해 공유

PowerShell을 통해 Azure 로컬 버전 23H2 업데이트

  • 아티클

적용 대상: Azure Local, 버전 23H2

이 문서에서는 PowerShell을 통해 Azure 로컬에 솔루션 업데이트를 적용하는 방법을 설명합니다.

이 문서의 절차는 오케스트레이터(수명 주기 관리자)가 설치된 최신 버전의 Azure Local을 실행하는 단일 노드 및 다중 노드 시스템에 모두 적용됩니다. Azure Local 버전 23H2의 새 배포를 통해 시스템을 만든 경우 오케스트레이터는 배포의 일부로 자동으로 설치됩니다.

Important

여기에 설명된 절차는 한 버전의 Azure Local 버전 23H2에서 다른 상위 버전으로 업데이트하는 경우에만 적용됩니다. 이전 버전의 업데이트에 대한 자세한 내용은 Azure Local 버전 22H2용 업데이트 클러스터를 참조하세요.

오케스트레이터가 설치되지 않은 이전 버전의 Azure Local으로 만든 시스템에 솔루션 업데이트를 적용하는 방법에 대한 자세한 내용은 Azure Local 버전 22H2 업데이트를 참조하세요.

솔루션 업데이트 정보

Azure 로컬 솔루션 업데이트는 플랫폼, 서비스 및 솔루션 확장 업데이트로 구성됩니다. 이러한 각 유형의 업데이트에 대한 자세한 내용은 Azure Local 버전 23H2에 대한 업데이트 정보를 참조하세요.

솔루션 업데이트를 적용할 때 수행하는 개략적인 단계는 다음과 같습니다.

  1. 모든 필수 구성 요소가 완료되었는지 확인합니다.
  2. 시스템에서 실행되는 소프트웨어 버전을 식별합니다.
  3. 원격 PowerShell을 통해 Azure 로컬 인스턴스에 연결합니다.
  4. 사용 가능한 업데이트를 검색하고 시스템에 적용할 수 있는 업데이트를 필터링합니다.
  5. 업데이트를 다운로드하고, 시스템의 업데이트 준비 상태를 평가하고, 준비가 되면 시스템에 업데이트를 설치합니다. 업데이트 진행률을 추적합니다. 필요한 경우 자세한 진행률을 모니터링할 수도 있습니다.
  6. 설치된 업데이트의 버전을 확인합니다.

업데이트를 설치하는 데 걸리는 시간은 다음 요인에 따라 달라질 수 있습니다.

  • 업데이트 내용입니다.
  • 시스템에 로드합니다.
  • 시스템의 컴퓨터 수입니다.
  • 사용되는 하드웨어의 유형입니다.
  • 솔루션 작성기 확장이 사용됩니다.

일반적인 단일 또는 다중 노드 시스템에 대한 대략적인 예상 시간은 다음 표에 요약되어 있습니다.

시스템/시간 상태 검사 시간
hh:mm:ss		 업데이트를 설치하는 시간
hh:mm:ss
단일 노드 0:01:44 1:25:42
4노드 0:01:58 3:53:09

필수 조건

시작하기 전에 다음 사항을 확인합니다.

  • 2310 이상을 실행하는 Azure Local 버전 23H2 시스템에 액세스할 수 있습니다. 시스템을 Azure에 등록해야 합니다.
  • Azure Local에 연결할 수 있는 클라이언트에 액세스할 수 있습니다. 이 클라이언트는 PowerShell 5.0 이상을 실행해야 합니다.
  • 네트워크를 통해 솔루션 업데이트 패키지에 액세스할 수 있습니다. 이러한 업데이트를 시스템의 컴퓨터에 테스트용으로 로드하거나 복사합니다.

Azure 로컬에 연결

클라이언트에서 다음 단계에 따라 Azure Local의 컴퓨터 중 하나에 연결합니다.

  1. 시스템에 연결하는 데 사용하는 클라이언트에서 관리자 권한으로 PowerShell을 실행합니다.

  2. Azure Local의 컴퓨터에 대한 원격 PowerShell 세션을 엽니다. 다음 명령을 실행하고 메시지가 표시되면 컴퓨터의 자격 증명을 제공합니다.

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

    참고 항목

    배포 사용자 계정 자격 증명을 사용하여 로그인해야 합니다. Active Directory를 준비할 때 만들고 Azure Local을 배포하는 동안 사용한 계정입니다.

    다음은 출력 예제입니다.

    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 Local 버전 23H2, 소프트웨어 버전 2310을 사용하여 시스템을 배포했는지 확인합니다.

  1. 배포 사용자 계정을 사용하여 컴퓨터에 연결되어 있는지 확인합니다. 다음 명령을 실행합니다.

    whoami

  2. Azure Local 버전 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단계: 업데이트 검색

다음 두 가지 방법 중 하나로 업데이트를 검색할 수 있습니다.

  • 온라인 업데이트 검색 - 시스템에 인터넷 연결이 양수인 경우 권장되는 옵션입니다. 솔루션 업데이트는 온라인 업데이트 카탈로그를 통해 검색됩니다.
  • 테스트용 로드 및 업데이트 검색 - 온라인에서 업데이트를 검색하는 대안이며, 불안정하거나 느린 인터넷 연결이 있는 시나리오 또는 하드웨어 공급업체에서 제공하는 솔루션 확장 업데이트를 사용하는 경우에 사용해야 합니다. 이러한 경우 솔루션 업데이트를 중앙 위치에 다운로드합니다. 그런 다음 Azure 로컬에 업데이트를 테스트용으로 로드하고 로컬로 업데이트를 검색합니다.

온라인 카탈로그를 사용하여 솔루션 업데이트를 검색하는 것이 좋습니다 . 다음 단계에 따라 온라인으로 솔루션 업데이트를 검색합니다.

  1. 배포 사용자 계정을 사용하여 Azure 로컬의 컴퓨터에 연결합니다.

  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 로컬의 컴퓨터에 연결합니다.

  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. 업데이트 서비스를 사용하여 업데이트 패키지를 수동으로 검색합니다. 다음 명령을 실행합니다.

    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

    • 시스템이 준비되면 업데이트가 설치됩니다. 이 단계에서 는 업데이트 상태가 완료된 설치의 백분율로 Installing 표시되고 UpdateStateProperties 표시됩니다.

      Important

      설치하는 동안 컴퓨터가 다시 부팅되어 업데이트를 모니터링하기 위해 원격 PowerShell 세션을 다시 설정해야 할 수 있습니다. 단일 컴퓨터를 업데이트하는 경우 Azure 로컬에 가동 중지 시간이 발생합니다.

      업데이트가 설치되는 동안의 샘플 출력은 다음과 같습니다.

      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 Local 버전 22H2 를 업데이트하는 방법에 대해 자세히 알아봅니다.