From 4d6f94f325fde0a41af5df315f27f47c63d6bacc Mon Sep 17 00:00:00 2001 From: Frédéric Buclin Date: Wed, 21 Oct 2015 19:27:59 +0200 Subject: Bug 1200604: The URL Rewrite extension for IIS is needed to use the rest/ shortcut in URLs (instead of rest.cgi/) r=gerv --- docs/en/rst/installing/iis.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) (limited to 'docs') diff --git a/docs/en/rst/installing/iis.rst b/docs/en/rst/installing/iis.rst index 74e198ae0..1670db5f5 100644 --- a/docs/en/rst/installing/iis.rst +++ b/docs/en/rst/installing/iis.rst @@ -91,6 +91,29 @@ From the top-level menu, which contains the name of your machine, click :command:`iisreset` +Enable Rewrite Rules for REST +============================= + +REST URLs are usually of the form http://.../bugzilla/rest/version instead of +http://.../bugzilla/rest.cgi/version. To let IIS redirect rest/ URLs to rest.cgi, +you need to download and install the +`URL Rewrite extension for IIS `_. +Direct download links are available at the bottom of the page for both x86 and +x64 Windows. + +Once installed, you open the IIS Manager again and go to your Bugzilla +Application. From here, double-click :guilabel:`URL Rewrite`. Then click +:guilabel:`Add Rule(s)` under the :guilabel:`Actions` menu and click +:guilabel:`Blank rule` in the :guilabel:`Inbound rules` section. + +Fill the fields as follows. Other fields do not need to be edited. + +* :guilabel:`Name`: ``REST`` +* :guilabel:`Pattern`: ``^rest/(.*)$`` +* :guilabel:`Rewrite URL`: ``rest.cgi/{R:1}`` + +There is no need to restart IIS. Changes take effect immediately. + Common Problems =============== -- cgit v1.2.3-24-g4f1b