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)
13527정성태1/14/20241959오류 유형: 892. Visual Studio - Failed to launch debug adapter. Additional information may be available in the output window.
13526정성태1/14/20242048닷넷: 2201. C# - Facebook 연동 / 사용자 탈퇴 처리 방법
13525정성태1/13/20242018오류 유형: 891. Visual Studio - Web Application을 실행하지 못하는 IISExpress
13524정성태1/12/20242066오류 유형: 890. 한국투자증권 KIS Developers OpenAPI - GW라우팅 중 오류가 발생했습니다.
13523정성태1/12/20241888오류 유형: 889. Visual Studio - error : A project with that name is already opened in the solution.
13522정성태1/11/20242028닷넷: 2200. C# - HttpClient.PostAsJsonAsync 호출 시 "Transfer-Encoding: chunked" 대신 "Content-Length" 헤더 처리
13521정성태1/11/20242109닷넷: 2199. C# - 한국투자증권 KIS Developers OpenAPI의 WebSocket Ping, Pong 처리
13520정성태1/10/20241858오류 유형: 888. C# - Unable to resolve service for type 'Microsoft.Extensions.ObjectPool.ObjectPool`....'
13519정성태1/10/20241937닷넷: 2198. C# - Reflection을 이용한 ClientWebSocket의 Ping 호출파일 다운로드1
13518정성태1/9/20242174닷넷: 2197. C# - ClientWebSocket의 Ping, Pong 처리
13517정성태1/8/20242016스크립트: 63. Python - 공개 패키지를 이용한 위성 이미지 생성 (pystac_client, odc.stac)
13516정성태1/7/20242103닷넷: 2196. IIS - AppPool의 "Disable Overlapped Recycle" 옵션의 부작용
13515정성태1/6/20242374닷넷: 2195. async 메서드 내에서 C# 7의 discard 구문 활용 사례 [1]
13514정성태1/5/20242065개발 환경 구성: 702. IIS - AppPool의 "Disable Overlapped Recycle" 옵션
13513정성태1/5/20242004닷넷: 2194. C# - WebActivatorEx / System.Web의 PreApplicationStartMethod 특성
13512정성태1/4/20241979개발 환경 구성: 701. IIS - w3wp.exe 프로세스의 ASP.NET 런타임을 항상 Warmup 모드로 유지하는 preload Enabled 설정
13511정성태1/4/20241995닷넷: 2193. C# - ASP.NET Web Application + OpenAPI(Swashbuckle) 스펙 제공
13510정성태1/3/20241937닷넷: 2192. C# - 특정 실행 파일이 있는지 확인하는 방법 (Linux)
13509정성태1/3/20241966오류 유형: 887. .NET Core 2 이하의 프로젝트에서 System.Runtime.CompilerServices.Unsafe doesn't support netcoreapp2.0.
13508정성태1/3/20242013오류 유형: 886. ORA-28000: the account is locked
13507정성태1/2/20242697닷넷: 2191. C# - IPGlobalProperties를 이용해 netstat처럼 사용 중인 Socket 목록 구하는 방법파일 다운로드1
13506정성태12/29/20232189닷넷: 2190. C# - 닷넷 코어/5+에서 달라지는 System.Text.Encoding 지원
13505정성태12/27/20232704닷넷: 2189. C# - WebSocket 클라이언트를 닷넷으로 구현하는 예제 (System.Net.WebSockets)파일 다운로드1
13504정성태12/27/20232321닷넷: 2188. C# - ASP.NET Core SignalR로 구현하는 채팅 서비스 예제파일 다운로드1
13503정성태12/27/20232190Linux: 67. WSL 환경 + mlocate(locate) 도구의 /mnt 디렉터리 검색 문제
13502정성태12/26/20232290닷넷: 2187. C# - 다른 프로세스의 환경변수 읽는 예제파일 다운로드1
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...