Mengubah file konfigurasi Reporting Services (RSreportserver.config)

  • Artikel

Reporting Services menyimpan pengaturan aplikasi dalam sekumpulan file konfigurasi. Penyiapan membuat file konfigurasi untuk setiap instans server laporan yang Anda instal. Dalam setiap file, nilai diatur selama penginstalan atau saat Anda menggunakan alat dan aplikasi untuk mengonfigurasi server untuk operasi. Dalam beberapa kasus, Anda harus mengubah file secara langsung untuk menambahkan atau mengonfigurasi pengaturan tingkat lanjut. Pengaturan konfigurasi ditentukan sebagai elemen atau atribut XML. Jika Anda memahami FILE XML dan konfigurasi, Anda dapat menggunakan editor teks atau kode untuk mengubah pengaturan yang dapat didefinisikan pengguna.

Beberapa pengaturan konfigurasi hanya dapat diatur melalui alat. Pengaturan yang berisi nilai terenkripsi harus dimodifikasi melalui alat Konfigurasi Layanan Pelaporan, program Penyiapan, atau rsconfig utilitas baris perintah. Anda harus menjadi anggota grup Administrator lokal untuk menjalankan alat ini.'

Penting

Berhati-hatilah saat memodifikasi file konfigurasi. Jika Anda mengubah pengaturan yang dicadangkan untuk penggunaan internal, Anda mungkin menonaktifkan penginstalan Anda. Umumnya, mengubah pengaturan konfigurasi tidak disarankan kecuali Anda mencoba menyelesaikan masalah tertentu. Untuk informasi selengkapnya tentang pengaturan mana yang aman untuk diubah, lihat file konfigurasi RsReportServer.config atau file konfigurasi RSReportDesigner. Untuk informasi selengkapnya tentang file konfigurasi, lihat dokumentasi produk Microsoft .NET Framework.

Dalam artikel ini:

Membaca dan menggunakan nilai konfigurasi

Server laporan membaca file konfigurasi saat layanan dimulai dan setiap kali file konfigurasi disimpan. Nilai baru dan yang direvisi berlaku di domain aplikasi baru setelah domain aplikasi saat ini kedaluwarsa. Jika memungkinkan, permintaan yang masih diproses di domain aplikasi saat ini diizinkan untuk diselesaikan. Namun, beberapa pengaturan memerlukan operasi daur ulang domain aplikasi segera. Dalam hal ini, semua permintaan yang sedang dalam proses dimulai ulang di domain aplikasi baru.

Jika server laporan mendeteksi nilai yang tidak valid, server laporan mencatat kesalahan ke log aplikasi Windows dan gagal memulai atau menggunakan nilai default, tergantung pada kesalahan:

  • Jika kesalahan XML salah format, server laporan tidak dimulai. Jika server laporan berjalan saat Anda memperkenalkan kesalahan, server laporan mengabaikan file konfigurasi yang tidak valid. Ini mengabaikan file sampai server laporan dimulai ulang atau domain aplikasi didaur ulang. Setelah kesalahan terdeteksi, server laporan tidak lagi dimulai.

  • Jika kesalahan adalah nilai konfigurasi yang tidak valid, server menggunakan nilai default internal dan mencatat kesalahan ke file log pelacakan. Dalam beberapa kasus di mana nilai default internal tidak tersedia, server mengembalikan rsServerConfigurationError kesalahan jika pengaturan konfigurasi yang tidak valid sangat penting untuk operasi server. Kesalahan tentang pengaturan penting yang hilang atau tidak valid dikembalikan ke aplikasi klien di halaman kesalahan HTML dan dicatat ke log peristiwa.

Semua perubahan file konfigurasi, termasuk perubahan yang berhasil, dicatat dalam file log jejak server laporan. Hanya kesalahan yang dicatat ke log peristiwa aplikasi.

Tentang nilai default

Sebagian besar pengaturan konfigurasi memiliki nilai default yang ditentukan secara internal di server laporan. Server laporan menggunakan nilai-nilai ini jika nilai yang ditentukan pengguna tidak valid atau tidak ditentukan. Jika nilai default harus digunakan karena pengaturan konfigurasi yang tidak valid, kesalahan ditulis ke file log pelacakan.

Menghapus pengaturan konfigurasi

Untuk pengaturan konfigurasi yang memiliki nilai default, menghapus pengaturan dari file konfigurasi tidak berpengaruh. Sebagian besar pengaturan konfigurasi ditentukan dan dikonfigurasi secara internal. Jika Anda menghapus item dari file konfigurasi, salinan internal masih tersedia dan menggunakan nilai default yang ditentukan untuknya.

Mengedit file konfigurasi Reporting Services

  1. Temukan file konfigurasi yang ingin Anda edit:

    • RSReportServer.config terletak di folder berikut:

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer

      Berlaku untuk: Pratinjau Teknis Laporan Power BI Januari 2017 di SQL Server Reporting Services

      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer

    • RSReportServerServices.exe.config terletak di folder berikut:

      Catatan

      Ini tidak tersedia dengan Pratinjau Teknis Laporan Power BI Januari 2017 di SQL Server Reporting Services.

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\bin

    • RSReportDesigner.config terletak di folder berikut:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies

  2. Simpan salinan file jika Anda perlu mengembalikan perubahan Anda.

  3. Buka file asli di Notepad atau editor kode. Jangan gunakan Textpad. Ini mengatur panjang file sebelum file disimpan, menyebabkan kesalahan karakter yang tidak valid ditulis ke file log jejak.

  4. Ketik elemen atau nilai yang ingin Anda tambahkan atau gunakan. Elemen peka huruf besar/kecil. Jika Anda menambahkan elemen, pastikan untuk menggunakan huruf besar dan kecil yang benar. Instruksi khusus untuk mengedit file konfigurasi tersedia jika Anda menyesuaikan ekstensi penyajian, ekstensi autentikasi, atau ekstensi pemrosesan data:

  5. Simpan file.

  6. Periksa file log jejak untuk memverifikasi bahwa kesalahan tidak terjadi. Jika Anda melihat kondisi kesalahan, pengaturan atau nilainya ditentukan dengan tidak benar. Tinjau file konfigurasi RsReportServer.config untuk nilai yang valid untuk pengaturan apa pun yang menyebabkan kesalahan. Untuk informasi selengkapnya tentang cara melihat log jejak, lihat Melaporkan log pelacakan layanan server.

Konten terkait

File konfigurasi RsReportServer.config
File konfigurasi ReportingServicesService
File konfigurasi RSReportDesigner
Menyebarkan ekstensi pemrosesan data
Menyebarkan ekstensi pengiriman
Menyebarkan ekstensi penyajian
File konfigurasi Reporting Services