Prosedur Penyiapan Satu Kali untuk Sampel Windows Communication Foundation

  • Artikel

Sebagian besar sampel Windows Communication Foundation (WCF) dihosting di Layanan Informasi Internet (IIS) dan dijalankan dari direktori virtual umum. Prosedur penyiapan satu kali ini membuat folder pada disk; ini juga menambahkan direktori virtual ke IIS bernama ServiceModelSamples.

Direktori virtual ServiceModelSamples digunakan untuk membangun dan menjalankan semua sampel yang menggunakan layanan yang dihosting IIS. Ini adalah satu-satunya direktori virtual yang diperlukan untuk menjalankan sampel. Membangun sampel akan menggantikan layanan yang disebarkan sebelumnya di direktori virtual ini; hanya sampel yang baru dibuat yang akan disebarkan dan tersedia di direktori virtual ini.

Catatan

  • Anda harus menjalankan semua perintah di bawah akun administrator lokal. Jika Anda menggunakan Windows 7, Windows Vista, atau Windows Server 2008 R2, Anda juga harus menjalankan perintah dengan hak istimewa yang ditingkatkan. Untuk melakukannya, klik kanan ikon perintah, lalu klik Jalankan sebagai administrator.
  • Semua perintah dalam artikel ini harus dijalankan dalam perintah yang memiliki pengaturan jalur yang sesuai. Cara termudah untuk memastikan hal ini adalah dengan menggunakan Perintah Pengembang untuk Visual Studio.

Prosedur penyiapan satu kali untuk sampel WCF

  1. Pastikan ASP.NET siap. Untuk informasi selengkapnya tentang cara menyiapkan ASP.NET, lihat Instruksi Hosting Layanan Informasi Internet.

  2. Pastikan .NET Framework 4+ dipasang. Cari direktori berikut untuk v4.0 (atau yang lebih baru): \Windows\Microsoft.NET\Framework

  3. Pastikan Anda telah memasang Visual Studio 2012 atau yang lebih baru, atau sistem operasi Anda adalah Windows Server 2008 SP2 atau yang lebih baru.

  4. Jalankan perintah berikut. Untuk informasi selengkapnya tentang mengapa perintah ini harus dijalankan, lihat Kegagalan Layanan yang Dihosting IIS.

    Peringatan

    Jika IIS dipasang ulang, perintah berikut perlu dijalankan lagi.

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

    Peringatan

    Menjalankan aspnet_regiis –i –enable perintah akan membuat Kumpulan Aplikasi Default berjalan menggunakan .NET Framework 4, yang dapat menyebabkan masalah ketidaksesuaian untuk aplikasi lain di komputer yang sama.

  5. Ikuti Instruksi Firewall untuk mengaktifkan port yang digunakan oleh sampel.

  6. Jalankan file batch Setupvroot.bat. Dilakukan langkah-langkah berikut:

    • Direktori virtual dibuat di IIS dengan nama ServiceModelSamples.

    • Direktori disk baru dibuat dengan nama %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples dan %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Jika Anda lebih suka menyiapkan direktori ini secara manual, lihat Instruksi Penyiapan Direktori Virtual. Untuk mengembalikan semua perubahan yang dilakukan dalam langkah ini, jalankan cleanupvroot.bat setelah Anda selesai menggunakan sampel.

    Catatan

    Prosedur ini harus dilakukan hanya sekali pada komputer, kecuali Anda menjalankan cleanupvroot.bat.

  7. Anda harus memberikan izin untuk mengubah %SystemDrive%\inetpub\wwwroot ke akun tempat Anda membangun sampel dan pengguna Layanan Jaringan. Saat membangun, beberapa sampel yang dihosting Web mungkin mencoba menyalin biner yang dikompilasi ke lokasi yang disebutkan sebelumnya, dan jika Anda belum mengatur izin yang sesuai, build akan rusak. Atau, Anda dapat membiarkan izin apa adanya dan menjalankan perintah SDK atau Visual Studio Command Prompt (2012) sebagai Administrator, atau membangun sampel di Visual Studio 2012, juga berjalan sebagai Administrator.

    Catatan

    Jika langkah ini tidak selesai, semua sampel yang dihosting IIS akan gagal saat dibangun. Pastikan Anda mengatur izin dengan benar, atau jalankan perintah SDK dan Visual Studio Command Prompt sebagai Administrator.

  8. Buat direktori C:\logs di komputer karena beberapa sampel mungkin mengharapkannya. Pastikan bahwa akun yang sesuai memiliki akses tulis yang diberikan ke folder ini. Untuk Windows 7, Windows Vista, dan Windows Server 2008 R2, akun ini adalah Layanan Jaringan. Untuk Windows Server 2008, akunnya adalah NT Authority\Network Service. Untuk Windows XP dan Windows Server 2003, akunnya adalah ASPNET.

  9. Jalankan file Setupcerttool.bat. Skrip ini mengerjakan tugas-tugas berikut:

    • Membangun alat FindPrivateKey.

    • Membuat direktori yang disebut %ProgramFiles%\ServiceModelSampleTools.

    • Menyalin alat FindPrivateKey baru ke direktori ini.

    Alat ini diperlukan oleh sampel yang menggunakan sertifikat dan dihosting di IIS.

    Catatan

    Untuk tujuan keamanan, ingatlah untuk menghapus definisi dan izin direktori virtual yang diberikan dalam langkah-langkah penyiapan di atas dengan menjalankan file batch bernama cleanupvroot.bat setelah Anda selesai dengan sampel.

  10. Sampel yang dihost sendiri (tidak dihosting di IIS) memerlukan izin untuk mendaftarkan alamat HTTP di komputer untuk mendengarkan. Izin untuk reservasi namespace HTTP berasal dari akun pengguna yang digunakan untuk menjalankan sampel. Secara default, akun administrator memiliki izin untuk mendaftarkan alamat HTTP apa pun. Akun non-administrator harus diberikan izin untuk namespace HTTP yang digunakan oleh sampel. Untuk informasi selengkapnya tentang cara mengonfigurasi reservasi namespace, lihat Mengonfigurasi HTTP dan HTTPS.

  11. Beberapa sampel memerlukan Message Queuing. Lihat Menginstal Message Queuing (MSMQ) untuk instruksi penginstalan.

    Catatan

    Pastikan Anda memulai layanan MSMQ sebelum menjalankan sampel apa pun yang memerlukan Message Queuing.

  12. Beberapa sampel memerlukan sertifikat. Lihat Instruksi Penginstalan Sertifikat Server Layanan Informasi Internet (IIS).