PowerShell을 통해 Azure 로컬 버전 23H2 업데이트
적용 대상: Azure Local, 버전 23H2
이 문서에서는 PowerShell을 통해 Azure 로컬에 솔루션 업데이트를 적용하는 방법을 설명합니다.
이 문서의 절차는 오케스트레이터(수명 주기 관리자)가 설치된 최신 버전의 Azure Local을 실행하는 단일 노드 및 다중 노드 시스템에 모두 적용됩니다. Azure Local 버전 23H2의 새 배포를 통해 시스템을 만든 경우 오케스트레이터는 배포의 일부로 자동으로 설치됩니다.
Important
여기에 설명된 절차는 한 버전의 Azure Local 버전 23H2에서 다른 상위 버전으로 업데이트하는 경우에만 적용됩니다. 이전 버전의 업데이트에 대한 자세한 내용은 Azure Local 버전 22H2용 업데이트 클러스터를 참조하세요.
솔루션 업데이트 정보
Azure 로컬 솔루션 업데이트는 플랫폼, 서비스 및 솔루션 확장 업데이트로 구성됩니다. 이러한 각 유형의 업데이트에 대한 자세한 내용은 Azure Local 버전 23H2에 대한 업데이트 정보를 참조하세요.
솔루션 업데이트를 적용할 때 수행하는 개략적인 단계는 다음과 같습니다.
- 모든 필수 구성 요소가 완료되었는지 확인합니다.
- 원격 PowerShell을 통해 Azure 로컬 인스턴스에 연결합니다.
- 현재 설치된 소프트웨어 버전을 확인하고 클러스터가 정상 상태인지 확인합니다.
- 사용 가능한 업데이트를 검색하고 시스템에 적용할 수 있는 업데이트를 필터링합니다.
- (권장) 업데이트를 미리 다운로드하고 시스템의 업데이트 준비 상태를 평가합니다.
- 업데이트를 설치하고 업데이트 진행률을 추적합니다. 필요에 따라 자세한 진행률을 모니터링합니다.
- 설치된 업데이트의 버전을 확인합니다.
업데이트를 설치하는 데 걸리는 시간은 다음 요인에 따라 달라집니다.
- 업데이트 내용입니다.
- 시스템에 로드합니다.
- 시스템의 컴퓨터 수입니다.
- 사용되는 하드웨어 유형입니다.
- 솔루션 확장이 사용됩니다.
일반적인 단일 또는 다중 노드 시스템에 대한 대략적인 예상 시간은 다음 표에 요약되어 있습니다.
| 시스템/시간 | 상태 검사 시간 hh:mm:ss |
업데이트를 설치하는 시간 hh:mm:ss |
|---|---|---|
| 단일 노드 | ~ 03:00 | ~ 01:30 |
| 4노드 | ~ 05:00 | ~ 04:00 |
Important
타사 도구를 사용하여 업데이트를 설치하는 것은 지원되지 않습니다.
필수 조건
시작하기 전에 다음 사항을 확인합니다.
- 2311 이상을 실행하는 23H2 버전의 Azure Local 시스템에 액세스할 수 있습니다. 시스템을 Azure에 등록해야 합니다.
- Azure Local에 연결할 수 있는 클라이언트에 액세스할 수 있습니다.
- 네트워크를 통해 솔루션 업데이트에 액세스할 수 있습니다.
Azure 로컬에 연결
클라이언트에서 다음 단계에 따라 Azure Local의 컴퓨터 중 하나에 연결합니다.
시스템에 연결하는 데 사용하는 클라이언트에서 관리자 권한으로 PowerShell을 실행합니다.
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, 소프트웨어 버전 2311 이상을 실행하고 있는지 확인합니다.
배포 사용자 계정을 사용하여 컴퓨터에 연결되어 있는지 확인합니다. 다음 명령을 실행합니다.
whoami시스템이 Azure Local 버전 23H2를 실행 중인지 확인하려면 시스템의 컴퓨터 중 하나에서 다음 명령을 실행합니다.
Get-SolutionUpdateEnvironment예제 출력을 보려면 이 섹션을 확장합니다.
PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment ResourceId : redmond SbeFamily : GenA HardwareModel : Contoso680 LastChecked : 10/2/2024 12:38:21 PM PackageVersions : {Solution: 10.2408.0.29, Services: 10.2408.0.29, Platform: 1.0.0.0, SBE: 4.1.2409.1} CurrentVersion : 10.2408.0.29 CurrentSbeVersion : 4.1.2409.1 LastUpdated : State : UpdateAvailable HealthState : Success HealthCheckResult : {Storage Subsystem Summary, Storage Pool Summary, Storage Services Physical Disks Summary, Storage Services Physical Disks Summary...} HealthCheckDate : 10/2/2024 10:46:44 AM AdditionalData :시스템에서
CurrentVersion를 확인하십시오. 현재 버전은 시스템이 실행 중인 솔루션 버전을 반영합니다.시스템의
HealthState을 검토하고 시스템이 양호한 상태인지 확인합니다. HealthState가Failure,Error, 또는Warning이라면, 계속하기 전에 문제 해결의 준비 상태 검사를 참조하세요.
2단계: 업데이트 검색
다음 단계에 따라 시스템에 사용 가능한 업데이트를 검색합니다.
배포 사용자 계정을 사용하여 Azure 로컬의 컴퓨터에 연결합니다.
Ready업데이트의 세부 정보를 검토하여Get-SolutionUpdate을(를) 사용해 설치하십시오.Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType예제 출력을 보려면 이 섹션을 확장합니다.
다음은 출력 예제입니다.
PS C:\Users\lcmuser> Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType DisplayName : 2024.10 Cumulative Update ResourceId : redmond/Solution10.2408.2.7 Version : 10.2408.2.7 State : Ready PackageType : Solution DisplayName : SBE_Contoso_GenA_4.1.2410.5 ResourceId : redmond/SBE4.1.2410.5 Version : 4.1.2410.5 State : AdditionalContentRequired PackageType : SBE전체
Solution업데이트(솔루션 작성기 확장도 포함할 수 있음) 및 독립 실행형SBE업데이트에 대한 항목을 포함하여 하나 이상의 옵션이 나열됩니다.예상되는 업데이트가 나열되지 않으면 명령에서 필터를 제거하여
non-ready상태로 나열되었는지 확인합니다.Get-SolutionUpdate | FL DisplayName, Description, ResourceId, State, PackageType업데이트 상태에 대한 자세한 내용은 업데이트 단계 및을 참조하세요.
설치하려는 업데이트를 선택하고 해당
ResourceId을 기록해 둡니다. 업데이트 세부 정보를 검토하여 설치할 원하는 업데이트를 선택했는지 확인합니다.$Update = Get-SolutionUpdate –Id <ResourceId> $Update예제 출력을 보려면 이 섹션을 확장합니다.
다음은 출력 예제입니다.
PS C:\Users\lcmuser> $Update = Get-SolutionUpdate –Id redmond/Solution10.2408.2.7 PS C:\Users\lcmuser> $Update ResourceId : redmond/Solution10.2408.2.7 InstalledDate : Description : State : Ready KbLink : https://zcusa.951200.xyz/en-us/azure-stack/hci/ MinVersionRequired : 10.2408.0.0 MinSbeVersionRequired : 2.0.0.0 PackagePath : C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\Updates\Packages\Solution10.2408 .2.2 PackageSizeInMb : 1278 DisplayName : 2024.10 Cumulative Update Version : 10.2408.2.7 SbeVersion : 4.1.2410.5 Publisher : Microsoft ReleaseLink : https://zcusa.951200.xyz/en-us/azure-stack/hci/ AvailabilityType : Online PackageType : Solution Prerequisites : {} UpdateStateProperties : The update requires additional content distributed by the OEM. AdditionalProperties : {SBEReleaseLink, SBENotifyMessage, SBEFamily, SBEPublisher...} ComponentVersions : {Services: 10.2408.2.7, Platform: 10.2408.2.7, SBE: 4.1.2410.5} RebootRequired : Unknown HealthState : Unknown HealthCheckResult : HealthCheckDate : 1/1/0001 12:00:00 AM BillOfMaterials : {PlatformUpdate, ServicesUpdate}참고 항목
아직 예약되거나 준비되지 않은 업데이트의 경우
HealthState가Unknown인 것이 정상입니다.필요에 따라 업데이트 패키지 구성 요소의 버전을 검토합니다.
$Update = Get-SolutionUpdate -Id <ResourceID> $Update.ComponentVersions예제 출력을 보려면 이 섹션을 확장합니다.
다음은 출력 예제입니다.
PS C:\Users\lcmuser> $Update = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 PS C:\Users\lcmuser> $Update.ComponentVersions PackageType Version LastUpdated ----------- ------- ----------- Services 10.2408.2.7 Platform 10.2408.2.7 SBE 4.1.2410.5 PS C:\Users\lcmuser>
이제 업데이트를 다운로드하고 설치할 수 있습니다.
3단계: 업데이트 가져오기 및 다시 검색
이 단계는 선택 사항입니다. 다음 시나리오 중 하나에서 업데이트를 가져와야 할 수 있습니다.
설치하려는 업데이트가
AdditionalContentRequired상태를 보고합니다.AdditionalContentRequired상태에서 업데이트를 예약하려면 몇 가지 추가 콘텐츠가 필요할 수 있습니다. 이 상태 및 솔루션 확장 업데이트에 대한 자세한 내용은 Azure Local 버전 23H2솔루션 확장 업데이트를 참조하세요. 지원에서 발생하는 문제를 해결하기 위해 프라이빗 릴리스를 제공하므로 설치하려는 업데이트가 나열되지 않습니다.
업데이트는
Ready나열되지만 시스템에 네트워크 연결이 제한되어 있으므로 솔루션 확장 업데이트의 온라인 다운로드 단계를 피하려고 합니다.
다음 단계에 따라 솔루션 업데이트를 가져오고 검색합니다.
배포 사용자 계정을 사용하여 Azure 로컬의 컴퓨터에 연결합니다.
네트워크 공유로 이동하여 사용하는 업데이트 패키지를 가져옵니다. 가져오는 업데이트 패키지에 다음 파일이 포함되어 있는지 확인합니다.
- SolutionUpdate.xml
- SolutionUpdate.zip
- AS_Update_10.2408.2.7.zip
솔루션 작성기 확장이 업데이트 패키지의 일부인 경우 다음 파일도 표시됩니다.
- SBE_Contoso_GenA_4.1.2410.5.xml
- SBE_Contoso_GenA_4.1.2410.5.zip
- SBE_Discovery_Contoso.xml
Azure 로컬 인스턴스에서 액세스할 수 있는 위치로 가져오려는 파일을 다운로드합니다. 솔루션 확장을 가져오는 경우 항상 다음 명명 패턴과 일치하는 세 개의 파일을 다운로드합니다.
파일 이름 패턴 본보기 묘사 SBE_Discovery_<제조업체>.xml SBE_Discovery_Contoso.xml 업데이트 검색을 가능하게 하는 솔루션 확장 발견 매니페스트입니다. SBE_<제조사>_<패밀리>_<버전>.xml SBE_Contoso_GenA_4.1.2410.5.xml 솔루션 확장 인벤토리 및 서명된 소프트웨어 청구서가 있는 파일 SBE_<Manufacturer>_<Family>_<버전>.zip SBE_Contoso_GenA_4.1.2410.5.zip 솔루션 확장 페이로드가 있는 파일 시스템의 인프라 볼륨에서 다음 위치에 업데이트 서비스에서 검색할 폴더를 만듭니다.
New-Item C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import -ItemType Directory이전 단계에서 만든 폴더에 업데이트 파일을 복사합니다.
업데이트 서비스를 사용하여 업데이트 패키지를 수동으로 검색합니다. 다음 명령을 실행합니다.
Add-SolutionUpdate -SourceFolder C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import업데이트 서비스가 업데이트 패키지를 검색하고 준비 및 설치를 시작할 수 있는지 확인합니다.
Get-SolutionUpdate명령을 반복하여 업데이트를 다시 검색합니다.
4단계: (권장) 사전 다운로드 및 업데이트 준비 확인
업데이트를 다운로드하고 일련의 검사를 수행하여 설치를 시작하지 않고 클러스터의 업데이트 준비 상태를 확인할 수 있습니다.
설치를 시작하지 않고 업데이트를 다운로드하려면 다음 명령을 실행합니다.
Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly예제 출력을 보려면 이 섹션을 확장합니다.
다음은 출력 예제입니다.
PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate –PrepareOnly redmond/SBE4.1.2410.9/<GUID>업데이트 진행률을 추적하려면 업데이트 상태를 모니터링합니다. 다음 명령을 실행합니다.
Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState업데이트가 시작되면 다음 작업이 수행됩니다.
- 업데이트 다운로드가 시작됩니다. 다운로드 패키지의 크기와 네트워크 대역폭에 따라 다운로드에 몇 분 정도 걸릴 수 있습니다.
예제 출력을 보려면 이 섹션을 확장합니다.
업데이트가 다운로드되는 경우의 예제 출력은 다음과 같습니다.
PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | ft Version,State,HealthState Version State HealthState ------- ----- --------------------- 10.2408.2.7 Downloading InProgress패키지가 다운로드되면 준비 검사를 수행하여 시스템의 업데이트 준비 상태를 평가합니다. 준비 검사에 대한 자세한 내용은 업데이트 단계를 참조 하세요. 이 단계에서 는 업데이트 상태가 .로
HealthChecking표시됩니다.예제 출력을 보려면 이 섹션을 확장합니다.
PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState Version State HealthState ------- ----- --------------------- 10.2408.2.7 HealthChecking InProgress준비 검사가 완료되면 시스템에서 업데이트를 설치할 준비가 된 것입니다. 업데이트의
State이(가)ReadyToInstall로 표시됩니다. 업데이트에서State이(가)HealthCheckFailed으로 표시될 경우, 계속 진행하기 전에 문제 해결 준비 상태 검사를 참조하십시오.
5단계: 업데이트 시작
설치하는 동안 시스템 컴퓨터가 다시 부팅되어 업데이트를 모니터링하기 위해 원격 PowerShell 세션을 다시 설정해야 할 수 있습니다. 단일 컴퓨터를 업데이트하는 경우 Azure 로컬에서 가동 중지 시간이 발생합니다.
단일 업데이트를 선택하고 Start-SolutionUpdate에 전달하여 업데이트를 시작합니다.
$InstanceId = Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate
참고 항목
4단계를 건너뛰고 Start-SolutionUpdate -PrepareOnly에 유사한 호출을 하지 않은 경우, 먼저 Start-SolutionUpdate을 호출하여 업데이트를 다운로드한 후, 클러스터의 업데이트 준비 상태를 점검하는 검사를 수행합니다. 이것은 업데이트 설치를 시작하기 전에 이루어집니다.
예제 출력을 보려면 이 섹션을 확장합니다.
PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate
그러면 업데이트를 설치하는 프로세스가 시작됩니다.
팁
나중에 Azure 로컬솔루션 업데이트 문제를
6단계: 업데이트 진행률 추적
업데이트가 시작된 후 Azure Portal에서 클러스터 업데이트 진행률을 추적하는 것이 좋습니다. 포털은 상태 보고 중단의 영향을 받지 않으므로 PowerShell을 통해 업데이트가 시작된 경우에도 업데이트 진행 상황을 추적하는 데 유용한 옵션입니다.
팁
- PowerShell을 통해 모니터링하는 경우 세션의 연결이 일찍 끊어지는 것을 방지하기 위해 PowerShell 세션을 클러스터의 마지막 서버에 연결하는 것이 좋습니다. 시스템이 다시 부팅되면서 세션이 끊어지므로 이미 업데이트된 서버에서 모니터링으로 전환하면 연결 끊김 빈도를 최소화할 수 있습니다.
- 컴퓨터를 다시 부팅한 후 PowerShell 세션에 다시 연결할 필요가 없도록 Azure Portal에서 클러스터 업데이트 진행률을 추적하는 것이 좋습니다.
PowerShell을 사용하여 업데이트 진행률을 추적하려면 다음 단계를 수행합니다.
업데이트 진행률을 추적하려면 업데이트 상태를 모니터링합니다. 다음 명령을 실행합니다.
Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState업데이트는 업데이트 검토 단계에서 설명한 대로 여러 상태를 통해 진행됩니다.
위의 명령을 사용하여 다음 예제에서는
State및UpdateStateProperties속성을 사용하여 해당 단계를 진행하면서 업데이트를 모니터링하는 방법을 보여 줍니다.다운로드 상태
Start-SolutionUpdate호출된 직후 업데이트 다운로드가 시작됩니다. 다운로드 패키지의 크기와 네트워크 대역폭에 따라 다운로드에 몇 분 정도 걸릴 수 있습니다.예제 출력을 보려면 이 섹션을 확장합니다.
업데이트가 다운로드되는 경우의 예제 출력은 다음과 같습니다.
PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,UpdateStateProperties,HealthState Version State HealthState ------- ----- ------------ 10.2408.2.7 Downloading Unknown준비 상태
업데이트가 다운로드되면 업데이트를 준비해야 합니다. 준비 상태에서 업데이트 파일 해시가 확인되고 업데이트 파일을 준비하고 스테이징하기 위해 파일이 추출됩니다.
예제 출력을 보려면 이 섹션을 확장합니다.
업데이트가 다운로드되는 경우의 예제 출력은 다음과 같습니다.
PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState Version State HealthState ------- ----- ----------- 10.2408.2.7 Preparing Unknown상태 점검 중
업데이트가 준비되면 준비 검사를 수행하여 클러스터의 업데이트 준비 상태를 평가합니다. 준비 검사에 대한 자세한 내용은 업데이트 단계를 참조 하세요.
이 단계에서 업데이트의
State은HealthChecking로 표시됩니다. 업데이트에서State이(가)HealthCheckFailed으로 표시될 경우, 계속 진행하기 전에 문제 해결 준비 상태 검사를 참조하십시오.예제 출력을 보려면 이 섹션을 확장합니다.
다음은 업데이트가 진행 중일 때 출력 예제입니다:
HealthCheckingPS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState Version State HealthState ------- ----- ----------- 10.2408.2.7 HealthChecking Unknown설치 상태 시스템이 준비되면 업데이트가
Installing전환됩니다. 이 단계에서 업데이트의State는Installing로 표시되며,UpdateStateProperties는 완료된 설치의 비율을 표시합니다.예제 출력을 보려면 이 섹션을 확장합니다.
다음은 업데이트가 진행 중일 때 출력 예제입니다:
InstallingPS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState Version State HealthState ------- ----- ----------- 10.2408.2.7 Installing Unknown
설치가 완료되면 상태가 .로 변경됩니다 Installed. 업데이트의 다양한 상태에 대한 자세한 내용은 설치 진행률 및 모니터링을 참조 하세요.
7단계: 업데이트 다시 시작(필요한 경우)
PowerShell을 통해 이전에 실패한 업데이트 실행을 다시 시작하려면 다음 명령을 사용합니다.
Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate
Warning 상태의 업데이트 준비 검사로 인해 이전에 실패한 업데이트를 다시 시작하려면 다음 명령을 사용합니다.
Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate -IgnoreWarnings
다른 업데이트 실행 문제를 해결하려면 업데이트문제 해결을 참조하세요.
8단계: 설치 확인
업데이트가 설치되면 환경의 솔루션 버전 및 운영 체제 버전을 확인합니다.
업데이트가 상태이
Installed면 환경 솔루션 버전을 확인합니다. 다음 명령을 실행합니다.Get-SolutionUpdateEnvironment | ft State, CurrentVersion예제 출력을 보려면 이 섹션을 확장합니다.
PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion State CurrentVersion ----- -------------- AppliedSuccessfully 10.2408.2.7운영 체제 버전을 확인하여 설치한 레시피와 일치하는지 확인합니다. 다음 명령을 실행합니다.
cmd /c ver예제 출력을 보려면 이 섹션을 확장합니다.
샘플 출력은 다음과 같습니다.
PS C:\Users\lcmuser> cmd /c ver Microsoft Windows [Version 10.0.25398.1189] PS C:\Users\lcmuser>