Dela via

Engångsinstallationsprocedur för Windows Communication Foundation-exempel

  • Artikel

De flesta WCF-exempel (Windows Communication Foundation) finns i IIS (Internet Information Services) och körs från en gemensam virtuell katalog. Den här engångsinställningsproceduren skapar en mapp på disken. den lägger också till en virtuell katalog i IIS med namnet ServiceModelSamples.

Den virtuella katalogen ServiceModelSamples används för att skapa och köra alla exempel som använder en IIS-värdbaserad tjänst. Det här är den enda virtuella katalogen som krävs för att köra exemplen. Om du skapar ett exempel ersätts alla tidigare distribuerade tjänster i den här virtuella katalogen. endast det senast byggda exemplet distribueras och är tillgängligt i den här virtuella katalogen.

Kommentar

  • Du måste köra alla kommandon under ett lokalt administratörskonto. Om du använder Windows 7, Windows Vista eller Windows Server 2008 R2 måste du också köra kommandotolken med utökade privilegier. Det gör du genom att högerklicka på kommandotolkens ikon och sedan klicka på Kör som administratör.
  • Alla kommandon i den här artikeln måste köras i en kommandotolk som har rätt sökvägsinställningar. Det enklaste sättet att se till att detta är genom att använda kommandotolken för utvecklare för Visual Studio.

Engångskonfigurationsprocedur för WCF-exempel

  1. Kontrollera att ASP.NET har konfigurerats. Mer information om hur du konfigurerar ASP.NET finns i Värdinstruktioner för Internet Information Service.

  2. Kontrollera att .NET Framework 4+ är installerat. Sök i följande katalog efter v4.0 (eller senare): \Windows\Microsoft.NET\Framework

  3. Kontrollera att Visual Studio 2012 eller senare är installerat, eller att operativsystemet är Windows Server 2008 SP2 eller senare.

  4. Kör följande kommandon. Mer information om varför dessa kommandon måste köras finns i IIS Hosted Service Fails (IIS Hosted Service Fails).

    Varning

    Om IIS installeras om måste följande kommandon köras igen.

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

    Varning

    Om du kör kommandot aspnet_regiis –i –enable körs standardapppoolen med .NET Framework 4, vilket kan orsaka inkompatibilitetsproblem för andra program på samma dator.

  5. Följ brandväggsanvisningarna för att aktivera portarna som används av exemplen.

  6. Kör batchfilen Setupvroot.bat. Följande steg utförs:

    • En virtuell katalog skapas i IIS med namnet ServiceModelSamples.

    • Nya diskkataloger skapas med namnet %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples och %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Om du föredrar att konfigurera dessa kataloger manuellt kan du läsa installationsanvisningar för Virtuell katalog. Om du vill återställa alla ändringar som gjorts i det här steget kör du cleanupvroot.bat när du har slutfört med hjälp av exemplen.

    Kommentar

    Den här proceduren får bara utföras en gång på en dator, såvida du inte kör cleanupvroot.bat.

  7. Du måste bevilja behörighet att ändra för %SystemDrive%\inetpub\wwwroot till kontot där du skapar exemplen och nätverkstjänstanvändaren. När du skapar kan vissa webbaserade exempel försöka kopiera de kompilerade binärfilerna till den tidigare nämnda platsen, och om du inte har angett rätt behörigheter kommer bygget att brytas. Du kan också lämna behörigheterna som de är och köra SDK-kommandotolken eller Visual Studio-kommandotolken (2012) som administratör, eller skapa exemplen i Visual Studio 2012 och även köra som administratör.

    Kommentar

    Om det här steget inte har slutförts misslyckas alla IIS-värdbaserade exempel när du skapar. Se till att du anger behörigheterna korrekt eller kör både SDK-kommandotolken och Visual Studio-kommandotolken som administratör.

  8. Skapa en C:\logs-katalog på datorn eftersom vissa exempel kanske förväntar sig det. Kontrollera att rätt konto har skrivåtkomst som beviljats till den här mappen. För Windows 7, Windows Vista och Windows Server 2008 R2 är det här kontot Nätverkstjänst. För Windows Server 2008 är kontot NT Authority\Network Service. För Windows XP och Windows Server 2003 är kontot ASPNET.

  9. Kör filen Setupcerttool.bat. Det här skriptet utför följande uppgifter:

    • Skapar verktyget FindPrivateKey.

    • Skapar en katalog med namnet %ProgramFiles%\ServiceModelSampleTools.

    • Kopierar det nya Verktyget FindPrivateKey till den här katalogen.

    Det här verktyget krävs av exempel som använder certifikat och som finns i IIS.

    Kommentar

    I säkerhetssyfte bör du komma ihåg att ta bort den virtuella katalogdefinitionen och behörigheterna som beviljats i installationsstegen ovan genom att köra batchfilen med namnet cleanupvroot.bat när du är klar med exemplen.

  10. Exempel som är lokalt installerade (som inte finns i IIS) kräver behörighet att registrera HTTP-adresser på datorn för att lyssna. Behörigheten för en HTTP-namnområdesreservation kommer från det användarkonto som används för att köra exemplet. Som standard har administratörskonton behörighet att registrera alla HTTP-adresser. Konton som inte är administratörskonton måste beviljas behörighet för DE HTTP-namnområden som används av exemplen. Mer information om hur du konfigurerar namnområdesreservationer finns i Konfigurera HTTP och HTTPS.

  11. Vissa exempel kräver Meddelandeköer. Installationsinstruktioner finns i Installera Message Queuing (MSMQ).

    Kommentar

    Se till att du startar MSMQ-tjänsten innan du kör några exempel som kräver Message Queuing.

  12. Vissa exempel kräver certifikat. Se Installationsinstruktioner för IIS-servercertifikat (Internet Information Services).