Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

smigdeploy.exe를 Windows Server 2016에서 실행할 때 .NET Framework 미설치 오류 발생

예를 들어, 다음과 같은 환경으로 업그레이드를 할 때,

기존 서버: Windows Server 2016 (IP: 192.168.100.5)
신규 서버: Windows Server 2019 (IP: 192.168.100.6)

기존 문서들을 참조하는 경우,

Install, Use, and Remove Windows Server Migration Tools
; https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/jj134202(v=ws.11)

신규 서버(2019) 측에서 smigdeploy.exe를 실행해 다음과 같은 식으로 기존 서버에 배포하라는 글이 나옵니다.

// 신규 서버에서 실행

PS C:\Windows\system32> cd .\ServerMigrationTools
PS C:\windows\system32\ServerMigrationTools> ./smigdeploy.exe /package /architecture amd64 /os WS16 /path \\192.168.100.5\c$\mig
SmigDeploy.exe is checking for prerequisites.
--------------------------------------------------------------------------------
SmigDeploy.exe is copying Windows Server Migration Tools files to \\192.168.100.5\c$\mig\SMT_ws16_amd64.
--------------------------------------------------------------------------------

위에서 /architecture는 32비트인 경우 x86, 64비트인 경우 amd64를 주면 됩니다. 문제는 "/os"에 줄 수 있는 인자인데요, 문서에 보면 2003 ~ 2012까지 만을 대상으로만 설명하고 있습니다.

WS03 (Windows Server 2003)
WS08 (Windows Server 2008)
WS12 (Windows Server 2012)

그러니까, 2016에 대한 식별자가 없는 건데요, 왠지 네이밍 룰에 따라 "Windows Server 2016"이니까 "WS16"이 맞을 것 같아 저렇게 인자를 줬던 것입니다. 어쨌든 저렇게 실행하면 "기존 서버"의 c:\mig\SMT_ws16_amd64 경로에 smigdeploy.exe를 이용해 여러 가지 파일들이 위치하게 됩니다. 이후, 문서에서는 "기존 서버"에서 그 "smigdeploy.exe"를 실행하라고 하는데, 실제로 실행해 보면 다음과 같은 식의 오류가 발생합니다.

C:\mig\SMT_ws16_amd64> SmigDeploy.exe
SmigDeploy.exe is checking for prerequisites.

--------------------------------------------------------------------------------

Error: You cannot run Windows Server Migration Tools because a required version of .NET Framework is not installed on the server. Install .NET Framework 2.0 or a newer release of .NET Framework on the migration source server, and install .NET Framework 4.0 or a newer release of .NET Framework on Windows Server 2012 and newer releases of the Windows Server operating system, and then run this command again.


오류 메시지에 따라, Windows 2008 이하의 머신이라면 .NET Framework 2.0/3.0/3.5 버전이 설치되어야 하고, 2012 이상의 머신에서는 .NET 4.0을 필요로 한다고 하므로 제 경우에는 2016이었기 때문에 당연히 .NET 4.0 이상만 설치되어 있으면 되는 것입니다.

하지만, 그 서버에는 분명히 (.NET 3.5와 함께) .NET 4.0 이상이 설치되어 있는데 그런 오류가 발생하니 더 이상 진행할 수가 없습니다.




다행히 SmigDeploy.exe는 .NET 응용 프로그램이기 때문에 .NET Reflector 등으로 소스 코드를 볼 수 있습니다. 우선, 소스 코드에 앞서 dnSpy.exe로 모듈 정보를 보면 이상하게 해당 응용 프로그램은 .NET 2.0을 대상으로 빌드된 것으로 나옵니다.

// C:\mig\SMT_ws16_amd64\SmigDeploy.exe
// SmigDeploy.exe

// Global type: <Module>
// Entry point: Microsoft.Windows.ServerManager.Migration.SmigDeploy.Application.Main
// Architecture: AnyCPU (64-bit preferred)
// Runtime: .NET Framework 2.0
// Timestamp: 5B9C7D46 (9/15/2018 3:32:22 AM)

즉, Windows Server 2019 측의 SmigDeploy가 "\\192.168.100.5\c$\mig\SMT_ws16_amd64" 폴더로 내려준 바이너리가 애당초 .NET 4.0을 대상으로 한 것이 아니었습니다. 게다가 조건을 검사하는 코드의,

private static Application.ExitCode GeneralPrerequisiteCheck()
{
    Application.DisplayWriteLine(Resources.StatusPrereqChecks, new object[0]);
    if (DownLevelHelper.GetPlatform() == Constants.TargetPlatform && Environment.Version.Major < 4)
    {
        Application.DisplayError(Resources.ErrorPrereqNETFramework, new object[0]);
        return Application.ExitCode.PrereqFail;
    }
    // ...[생략]...
}

/*
Resources.ErrorPrereqNETFramework

You cannot run Windows Server Migration Tools because a required version of .NET Framework is not installed on the server. Install .NET Framework 2.0 or a newer release of .NET Framework on the migration source server, and install .NET Framework 4.0 or a newer release of .NET Framework on Windows Server 2012 and newer releases of the Windows Server operating system, and then run this command again.
*/

DownLevelHelper.GetPlatform() == Constants.TargetPlatform에서 TargetPlatform 값을 보면,
using System;

namespace Microsoft.Windows.ServerManager.Migration.SmigDeploy
{
    // Token: 0x02000006 RID: 6
    internal static class Constants
    {
        // Token: 0x0400002A RID: 42
        internal static Platform TargetPlatform = Platform.WS2016;

        // Token: 0x0400002B RID: 43
        internal static Version Win7Version = new Version(6, 1, 6500);

        // Token: 0x0400002C RID: 44
        internal static Version Win8Version = new Version(6, 2);

        // Token: 0x0400002D RID: 45
        internal static Version WS2012R2Version = new Version(6, 3);

        // Token: 0x0400002E RID: 46
        internal static Version WS2016Version = new Version(10, 0);
    }
}

운영체제에 대한 판단은 정확했습니다. 그렇다면 혹시, .NET 2.0 바이너리이지만, 강제로 .NET 4.0 CLR에 태워 실행해 보면 어떻게 될까요? 이를 위해 다음과 같은 내용을 담은 "SmigDeploy.exe.config" 파일을 생성해,

<?xml version="1.0"?>
<configuration>
    <startup>
        <supportedRuntime version="v4.0.30319"/>
        <supportedRuntime version="v2.0.50727"/>
    </startup>
</configuration>

실행했더니 이번에는 오류 메시지가 바뀌었습니다.

C:\mig\SMT_ws16_amd64> SmigDeploy.exe
SmigDeploy.exe is checking for prerequisites.
--------------------------------------------------------------------------------
Error: To run SmigDeploy.exe without parameters to register Windows Server Migration Tools, the computer must be running either Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2, or Windows Server 2008.

Error: The parameters /architecture, /os, and /path must be used with the parameter /package. For more information about the command line syntax, type /help or /?, and then press ENTER.

메시지를 보면, Windows Server 2016이라는 단어가 없습니다. 즉, Windows Server 2019의 SmigDeploy는 어찌 보면 "/os WS16" 옵션을 제대로 인식하지 못한 듯 하고, 어쩌면 가장 기본 환경인 "Windows Server 2003"이라고 판단해 .NET 2.0 용으로 빌드된 SmigDeploy를 내려준 것으로 보입니다.




결론이 좀 허망한데, Windows Server 2016에서는 2019에서 "./smigdeploy.exe /package /architecture amd64 /os WS16 /path \\192.168.100.5\c$\mig"를 이용해 smigdeploy.exe를 실행하기 위한 환경을 내려줄 필요가 없습니다. 왜냐하면 2016부터 이미 자체적으로 smigdeploy를 지원하기 때문에 단순히 이 기능을 추가해 주면 됩니다.

// PowerShell

Add-WindowsFeature Migration

따라서, 저 명령어를 실행 후 "Server Manager"의 "Tools" / "Windows Server Migration Tools" / "Windows Server Migration Tools"를 실행하는 것이 바로 위의 본문에서 .NET 오류가 발생해 문제가 되었던 "C:\mig\SMT_ws16_amd64\SmigDeploy.exe"의 실행과 동일한 역할을 합니다. (어쩐지... "Install, Use, and Remove Windows Server Migration Tools" 문서에 대응하는 Windows Server 2016을 위한 문서가 검색이 안된 데에는 다 이유가 있었습니다. ^^;)




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 3/9/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13843정성태12/13/20244391오류 유형: 938. Docker container 내에서 빌드 시 error MSB3021: Unable to copy file "..." to "...". Access to the path '...' is denied.
13842정성태12/12/20244534디버깅 기술: 205. Windbg - KPCR, KPRCB
13841정성태12/11/20244866오류 유형: 937. error MSB4044: The "ValidateValidArchitecture" task was not given a value for the required parameter "RemoteTarget"
13840정성태12/11/20244439오류 유형: 936. msbuild - Your project file doesn't list 'win' as a "RuntimeIdentifier"
13839정성태12/11/20244877오류 유형: 936. msbuild - error CS1617: Invalid option '12.0' for /langversion. Use '/langversion:?' to list supported values.
13838정성태12/4/20244604오류 유형: 935. Windbg - Breakpoint 0's offset expression evaluation failed.
13837정성태12/3/20245073디버깅 기술: 204. Windbg - 윈도우 핸들 테이블 (3) - Windows 10 이상인 경우
13836정성태12/3/20244625디버깅 기술: 203. Windbg - x64 가상 주소를 물리 주소로 변환 (페이지 크기가 2MB인 경우)
13835정성태12/2/20245071오류 유형: 934. Azure - rm: cannot remove '...': Directory not empty
13834정성태11/29/20245301Windows: 275. C# - CUI 애플리케이션과 Console 윈도우 (Windows 10 미만의 Classic Console 모드인 경우) [1]파일 다운로드1
13833정성태11/29/20244979개발 환경 구성: 737. Azure Web App에서 Scale-out으로 늘어난 리눅스 인스턴스에 SSH 접속하는 방법
13832정성태11/27/20244913Windows: 274. Windows 7부터 도입한 conhost.exe
13831정성태11/27/20244382Linux: 111. eBPF - BPF_MAP_TYPE_PERF_EVENT_ARRAY, BPF_MAP_TYPE_RINGBUF에 대한 다양한 용어들
13830정성태11/25/20245198개발 환경 구성: 736. 파이썬 웹 앱을 Azure App Service에 배포하기
13829정성태11/25/20245169스크립트: 67. 파이썬 - Windows 버전에서 함께 설치되는 py.exe
13828정성태11/25/20244450개발 환경 구성: 735. Azure - 압축 파일을 이용한 web app 배포 시 디렉터리 구분이 안 되는 문제파일 다운로드1
13827정성태11/25/20245105Windows: 273. Windows 환경의 파일 압축 방법 (tar, Compress-Archive)
13826정성태11/21/20245337닷넷: 2313. C# - (비밀번호 등의) Console로부터 입력받을 때 문자열 출력 숨기기(echo 끄기)파일 다운로드1
13825정성태11/21/20245672Linux: 110. eBPF / bpf2go - BPF_RINGBUF_OUTPUT / BPF_MAP_TYPE_RINGBUF 사용법
13824정성태11/20/20244751Linux: 109. eBPF / bpf2go - BPF_PERF_OUTPUT / BPF_MAP_TYPE_PERF_EVENT_ARRAY 사용법
13823정성태11/20/20245304개발 환경 구성: 734. Ubuntu에 docker, kubernetes (k3s) 설치
13822정성태11/20/20245169개발 환경 구성: 733. Windbg - VirtualBox VM의 커널 디버거 연결 시 COM 포트가 없는 경우
13821정성태11/18/20245094Linux: 108. Linux와 Windows의 프로세스/스레드 ID 관리 방식
13820정성태11/18/20245250VS.NET IDE: 195. Visual C++ - C# 프로젝트처럼 CopyToOutputDirectory 항목을 추가하는 방법
13819정성태11/15/20244490Linux: 107. eBPF - libbpf CO-RE의 CONFIG_DEBUG_INFO_BTF 빌드 여부에 대한 의존성
13818정성태11/15/20245297Windows: 272. Windows 11 24H2 - sudo 추가
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...