Windows Communication Foundation 샘플의 일회 설치 절차
대부분의 WCF(Windows Communication Foundation) 샘플은 IIS(인터넷 정보 서비스)에서 호스팅되고 공용 가상 디렉터리에서 실행됩니다. 이 일회 설치 절차에서는 디스크에 폴더를 만들고 IIS에 ServiceModelSamples라는 가상 디렉터리를 추가합니다.
ServiceModelSamples 가상 디렉터리는 IIS에서 호스팅되는 서비스를 사용하는 모든 샘플을 빌드 및 실행하는 데 사용됩니다. 이 디렉터리는 샘플을 실행하는 데 필요한 유일한 가상 디렉터리입니다. 샘플을 빌드하면 이 가상 디렉터리에서 이전에 배포된 서비스가 대체되고 가장 최근에 빌드된 샘플만 배포되어 이 가상 디렉터리에서 사용할 수 있게 됩니다.
.gif "ms751527.note(ko-kr,VS.100).gif") 참고: |
|---|
| 모든 명령을 로컬 관리자 계정으로 실행해야 합니다. Windows 7, Windows Vista 또는 Windows Server 2008 R2를 사용하는 경우에는 높은 권한으로 명령 프롬프트를 실행해야 합니다. 이렇게 하려면 명령 프롬프트 아이콘을 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 클릭합니다. 이 항목의 모든 명령은 경로 설정이 적절한 명령 프롬프트에서 실행해야 합니다. 이를 위한 가장 쉬운 방법은 Visual Studio 명령 프롬프트를 사용하는 것입니다. 이 프롬프트를 열려면 시작을 클릭하고 모든 프로그램을 선택한 다음 아래로 스크롤하여 Visual Studio 2010에서 Visual Studio 도구를 선택합니다. 그런 다음 Visual Studio 명령 프롬프트(2010)를 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 클릭합니다. Visual Studio Express Edition 중 하나가 설치되어 있어 이 명령 프롬프트를 사용할 수 없는 경우에는 시스템 경로에 "C:\Windows\Microsoft.Net\Framework\v4.0"을 추가해야 합니다. |
WCF 샘플의 일회 설치 절차
ASP.NET이 설치되어 있는지 확인합니다. ASP.NET을 설치하는 방법에 대한 자세한 내용은 인터넷 정보 서비스 호스팅 지침을 참조하십시오.
.NET Framework 버전 4이 설치되어 있는지 확인합니다. \Windows\Microsoft.NET\Framework 디렉터리에서 v4.0(또는 이후 버전)을 검색합니다.
Visual Studio 2010이 설치되어 있지 않고 운영 체제가 Windows Server 2008 SP2 이상이 아닌 경우 핫픽스 251798을 설치합니다.
다음 명령을 실행합니다. 이러한 명령을 실행해야 하는 이유에 대한 자세한 내용은 IIS Hosted Service Fails를 참조하십시오.
.gif "ms751527.Warning(ko-kr,VS.100).gif")
주의:IIS가 다시 설치된 경우 다음 명령을 다시 실행해야 합니다. "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r 주의:aspnet_regiis –i –enable 명령을 실행하면 .NET Framework 4을 사용하여 기본 응용 프로그램 풀이 실행됩니다. 이 경우 동일한 컴퓨터의 다른 응용 프로그램에 비호환 문제가 발생할 수 있습니다. 방화벽 지침에 따라 샘플에서 사용하는 포트를 활성화합니다.
<InstallDrive>:\WF_WCF_Samples 기본 디렉터리를 확인합니다. 샘플이 이전에 설치된 경우 이 디렉터리가 기본 디렉터리입니다.
샘플이 설치되어 있지 않은 경우에는 Visual C# 또는 Visual Basic에 대한 샘플 다운로드 위치에서 샘플을 설치합니다.
샘플을 설치한 후 <InstallDrive>:**\WF_WCF_Samples\WCF\Setup\**으로 이동합니다.
Setupvroot.bat 배치 파일을 실행합니다. 다음 단계가 수행됩니다.
IIS에 ServiceModelSamples라는 가상 디렉터리가 만들어집니다.
%SystemDrive%\Inetpub\wwwroot\ServiceModelSamples and %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin이라는 새 디스크 디렉터리가 만들어집니다.
이러한 디렉터리를 수동으로 설정하려면 가상 디렉터리 설치 지침을 참조하십시오. 이 단계에서 수행한 모든 변경 작업을 되돌리려면 샘플 사용을 마친 후 cleanupvroot.bat를 실행합니다.
참고:cleanupvroot.bat가 실행되지 않은 경우 이 절차는 한 컴퓨터에서 한 번만 수행해야 합니다. 샘플을 빌드 중인 계정과 Network Service 사용자에 %SystemDrive%\inetpub\wwwroot에 대한 수정 권한을 부여해야 합니다. 빌드하는 동안 일부 웹 호스팅 샘플은 컴파일된 이진 파일을 앞에서 설명한 위치에 복사하려고 시도하므로 적절한 사용 권한이 설정되지 않은 경우 빌드가 중지됩니다. 또는 사용 권한을 그대로 유지하고 SDK 명령 프롬프트 또는 Visual Studio 명령 프롬프트(2010)를 관리자 권한으로 실행하거나, 관리자 권한으로 실행되는 Visual Studio 2010에서 샘플을 빌드할 수도 있습니다.
참고:이 단계를 완료하지 않으면 IIS에서 호스팅되는 모든 샘플이 빌드 중에 실패합니다. 사용 권한을 올바르게 설정했는지 확인하거나 SDK 명령 프롬프트와 Visual Studio 명령 프롬프트(2010)를 관리자 권한으로 실행하십시오. 컴퓨터에 C:\logs 디렉터리를 만듭니다. 일부 샘플에 이 디렉터리가 필요할 수 있습니다. 적절한 계정에 이 폴더에 대한 쓰기 권한을 부여해야 합니다. 이 계정은 Windows 7, Windows Vista 및 Windows Server 2008 R2의 경우 Network Service이고, Windows Server 2008의 경우 NT Authority\Network Service이며, Windows XP 및 Windows Server 2003의 경우에는 ASPNET입니다.
Setupcerttool.bat 파일을 실행합니다. 이 파일은 <InstallPath>\WF_WCF_Samples\WCF\Setup\ 폴더에 있습니다. 이 스크립트는 다음 작업을 수행합니다.
FindPrivateKey 도구를 빌드합니다.
%ProgramFiles%\ServiceModelSampleTools라는 디렉터리를 만듭니다.
이 디렉터리에 새 FindPrivateKey 도구를 복사합니다.
이 도구는 인증서를 사용하고 IIS에서 호스팅되는 샘플에 필요합니다.
참고:보안을 위해 샘플 사용이 끝나면 Cleanupvroot.bat라는 배치 파일을 실행하여 설치 단계에서 부여된 가상 디렉터리 정의와 사용 권한을 제거해야 합니다. IIS에서 호스팅되지 않고 자체 호스팅되는 샘플의 경우 수신 대기를 위해 컴퓨터에서 HTTP 주소를 등록할 수 있는 권한이 필요합니다. HTTP 네임스페이스 예약을 위한 사용 권한은 샘플을 실행하는 데 사용되는 사용자 계정에서 제공됩니다. 기본적으로 관리자 계정에는 모든 HTTP 주소를 등록할 수 있는 사용 권한이 있습니다. 관리자 이외의 계정에는 샘플에 사용되는 HTTP 네임스페이스에 대한 권한을 부여해야 합니다. 네임스페이스 예약을 구성하는 방법에 대한 자세한 내용은 HTTP 및 HTTPS 구성을 참조하십시오.
일부 샘플에는 메시지 큐가 필요합니다. 설치 방법을 보려면 메시지 큐(MSMQ) 설치를 참조하십시오.
참고:메시지 큐가 필요한 샘플을 실행하려면 먼저 MSMQ 서비스를 시작해야 합니다. 일부 샘플에는 인증서가 필요합니다. IIS(인터넷 정보 서비스) 서버 인증서 설치 지침을 참조하십시오.