A Windows Communication Foundation-minták egyszeri beállítási eljárása

A Windows Communication Foundation (WCF) mintáinak többsége az Internet Information Servicesben (IIS) található, és egy közös virtuális könyvtárból fut. Ez az egyszeri beállítási eljárás létrehoz egy mappát a lemezen; Emellett hozzáad egy virtuális könyvtárat az IIS-hez ServiceModelSamples néven.

A ServiceModelSamples virtuális könyvtár az IIS által üzemeltetett szolgáltatást használó összes minta létrehozásához és futtatásához használható. Ez az egyetlen virtuális könyvtár, amely a minták futtatásához szükséges. A minta létrehozása lecseréli a virtuális címtárban korábban üzembe helyezett összes szolgáltatást; Ebben a virtuális könyvtárban csak a legutóbb létrehozott minta lesz üzembe helyezve és elérhető.

Feljegyzés

• Az összes parancsot helyi rendszergazdai fiókban kell futtatnia. Ha Windows 7, Windows Vista vagy Windows Server 2008 R2 rendszert használ, a parancssort emelt szintű jogosultságokkal is futtatnia kell. Ehhez kattintson a jobb gombbal a parancssor ikonra, majd kattintson a Futtatás rendszergazdaként parancsra.
• A cikkben szereplő összes parancsot a megfelelő elérésiút-beállításokkal rendelkező parancssorban kell futtatni. Ennek legegyszerűbb módja a Visual Studio fejlesztői parancssorának használata.

WcF-minták egyszeri beállítási eljárása

1. Győződjön meg arról, hogy a ASP.NET be van állítva. A ASP.NET beállításával kapcsolatos további információkért tekintse meg az Internet Information Service üzemeltetési utasításait.

2. Győződjön meg arról, hogy a .NET-keretrendszer 4+ telepítve van. Keressen rá a következő könyvtárban a 4.0-s (vagy újabb) verzióra: \Windows\Microsoft.NET\Framework

3. Győződjön meg arról, hogy telepítve van a Visual Studio 2012 vagy újabb verziója, vagy az operációs rendszere Windows Server 2008 SP2 vagy újabb.

4. Futtassa az alábbi parancsokat. További információ arról, hogy miért kell futtatni ezeket a parancsokat: IIS Hosted Service Fails.

   Figyelmeztetés

   Az IIS újratelepítése esetén a következő parancsokat újra kell futtatni.

   "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable
   "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r
   

   Figyelmeztetés

   A parancs aspnet_regiis –i –enable futtatásával az alapértelmezett alkalmazáskészlet a .NET-keretrendszer 4 használatával lesz futtatva, ami kompatibilitási problémákat okozhat az ugyanazon a számítógépen található más alkalmazásoknál.

5. Kövesse a tűzfal utasításait a minták által használt portok engedélyezéséhez.

6. Futtassa a Setupvroot.bat kötegfájlt. A következő lépéseket hajtja végre:

   • Egy serviceModelSamples nevű IIS-ben létrejön egy virtuális könyvtár.

   • Az új lemezkönyvtárak a következő néven jönnek létre: %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples és %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

   Ha inkább manuálisan szeretné beállítani ezeket a könyvtárakat, tekintse meg a virtuális címtár telepítési utasításait. Az ebben a lépésben végzett módosítások visszaállításához futtassa a cleanupvroot.bat a minták használatának befejezése után.

   Feljegyzés

   Ezt az eljárást csak egyszer kell végrehajtani egy számítógépen, hacsak nem futtatja cleanupvroot.bat.

7. Engedélyt kell adnia a %SystemDrive%\inetpub\wwwroot módosítására ahhoz a fiókhoz, amely alatt a mintákat és a hálózati szolgáltatás felhasználót készíti. Az összeállítás során előfordulhat, hogy egyes webes minták megpróbálják a lefordított bináris fájlokat a korábban említett helyre másolni, és ha nem állította be a megfelelő engedélyeket, a build megszakad. Másik lehetőségként hagyja meg az engedélyeket, és futtassa az SDK-parancssort vagy a Visual Studio parancssort (2012) Rendszergazda istratorként, vagy létrehozhatja a mintákat a Visual Studio 2012-ben, és Rendszergazda istratorként is futtatható.

   Feljegyzés

   Ha ez a lépés nem fejeződik be, az összes IIS által üzemeltetett minta sikertelen lesz az összeállítás során. Győződjön meg arról, hogy helyesen állította be az engedélyeket, vagy futtassa az SDK parancssort és a Visual Studio parancssort Rendszergazda istratorként.

8. Hozzon létre egy C:\logs könyvtárat a számítógépen, mert előfordulhat, hogy egyes minták azt várják. Győződjön meg arról, hogy a megfelelő fiók rendelkezik írási hozzáféréssel ehhez a mappához. Windows 7, Windows Vista és Windows Server 2008 R2 esetén ez a fiók hálózati szolgáltatás. Windows Server 2008 esetén a fiók az NT Authority\Network Service. Windows XP és Windows Server 2003 esetén a fiók ASPNET.

9. Futtassa a Setupcerttool.bat fájlt. Ez a szkript a következő feladatokat hajtja végre:

   • Létrehozza a FindPrivateKey eszközt.

   • Létrehoz egy %ProgramFiles%\ServiceModelSampleTools nevű könyvtárat.

   • Másolja az új FindPrivateKey eszközt ebbe a könyvtárba.

   Ezt az eszközt tanúsítványokat használó és IIS-ben üzemeltetett minták igénylik.

   Feljegyzés

   Biztonsági okokból ne felejtse el eltávolítani a fenti beállítási lépésekben megadott virtuális könyvtárdefiníciót és engedélyeket a cleanupvroot.bat nevű kötegfájl futtatásával, miután befejezte a mintákat.

10. A saját üzemeltetésű (nem az IIS-ben üzemeltetett) mintákhoz engedélyezni kell a HTTP-címek regisztrálását a számítógépen a figyeléshez. A HTTP-névtér-foglalás engedélyét a minta futtatásához használt felhasználói fiók adja meg. Alapértelmezés szerint a rendszergazdai fiókok rendelkeznek engedéllyel a HTTP-címek regisztrálásához. A nem rendszergazdai fiókoknak engedélyt kell adni a minták által használt HTTP-névterekhez. A névtérfoglalások konfigurálásáról további információt a HTTP és a HTTPS konfigurálása című témakörben talál.

11. Egyes mintákhoz Üzenetsor-kezelés szükséges. A telepítési utasításokat a Message Queuing (MSMQ) telepítése című témakörben találja.

    Feljegyzés

    A Message Queuinget igénylő minták futtatása előtt győződjön meg arról, hogy elindítja az MSMQ szolgáltatást.

12. Egyes mintákhoz tanúsítványok szükségesek. Lásd az Internet Information Services (IIS) kiszolgálói tanúsítvány telepítési utasításait.