<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>3.5.3. Microsoft IIS — Bugzilla 5.0.4 documentation</title> <link rel="stylesheet" href="../_static/bugzilla.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '5.0.4', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true, SOURCELINK_SUFFIX: '.txt' }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <link rel="shortcut icon" href="../_static/favicon.ico"/> <link rel="search" title="Search" href="../search.html" /> <link rel="next" title="3.6. Database Server" href="db_server.html" /> <link rel="prev" title="3.5.2. Apache on Windows" href="apache-windows.html" /> </head> <body> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="db_server.html" title="3.6. Database Server" accesskey="N">next</a></li> <li class="right" > <a href="apache-windows.html" title="3.5.2. Apache on Windows" accesskey="P">previous</a> |</li> <li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li> <li class="nav-item nav-item-1"><a href="index.html" >3. Installation and Maintenance Guide</a> »</li> <li class="nav-item nav-item-2"><a href="web_server.html" accesskey="U">3.5. Web Server</a> »</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body" role="main"> <div class="section" id="microsoft-iis"> <span id="iis"></span><h1>3.5.3. Microsoft IIS<a class="headerlink" href="#microsoft-iis" title="Permalink to this headline">¶</a></h1> <p>Bugzilla works with IIS as a normal CGI application. These instructions assume that you are using Windows 7 or Windows 10. Procedures for other versions are probably similar.</p> <p>Begin by starting Internet Information Services (IIS) Manager. <span class="guilabel">Start</span> --> <span class="guilabel">Administrators Tools</span> --> <span class="guilabel">Internet Information Services (IIS) Manager</span>. Or run the command:</p> <p><strong class="command">inetmgr</strong></p> <div class="section" id="create-a-new-application"> <h2>3.5.3.1. Create a New Application<a class="headerlink" href="#create-a-new-application" title="Permalink to this headline">¶</a></h2> <p>Expand your <span class="guilabel">Server</span> until the <span class="guilabel">Default Web Site</span> shows its children.</p> <p>Right-click <span class="guilabel">Default Web Site</span> and select <span class="guilabel">Add Application</span> from the menu.</p> <p>Unde <span class="guilabel">Alias</span>, enter the alias for the website. This is the path below the domain where you want Bugzilla to appear.</p> <p>Under <span class="guilabel">Physical Path</span>, enter the path to Bugzilla, <code class="file docutils literal"><span class="pre">C:\Bugzilla</span></code>.</p> <p>When finished, click <span class="guilabel">OK</span>.</p> </div> <div class="section" id="configure-the-default-document"> <h2>3.5.3.2. Configure the Default Document<a class="headerlink" href="#configure-the-default-document" title="Permalink to this headline">¶</a></h2> <p>Click on the Application that you just created. Double-click on <span class="guilabel">Default Document</span>, and click <span class="guilabel">Add</span> underneath the Actions menu.</p> <p>Under <span class="guilabel">Name</span>, enter <code class="docutils literal"><span class="pre">index.cgi</span></code>.</p> <p>All other default documents can be removed for this application.</p> <div class="admonition warning"> <p class="first admonition-title">Warning</p> <p class="last">Do not delete the default document from the <span class="guilabel">Default Website</span>.</p> </div> </div> <div class="section" id="add-handler-mappings"> <h2>3.5.3.3. Add Handler Mappings<a class="headerlink" href="#add-handler-mappings" title="Permalink to this headline">¶</a></h2> <p>Ensure that you are at the Default Website. Under <span class="guilabel">IIS</span>, double-click <span class="guilabel">Handler Mappings</span>. Under <span class="guilabel">Actions</span>, click <span class="guilabel">Add Script Map</span>. You need to do this twice.</p> <p>For the first one, set the following values (replacing paths if necessary):</p> <ul class="simple"> <li><span class="guilabel">Request Path</span>: <code class="docutils literal"><span class="pre">*.pl</span></code></li> <li><span class="guilabel">Executable</span>: <code class="docutils literal"><span class="pre">C:\Perl\bin\perl.exe</span> <span class="pre">"%s"</span> <span class="pre">%s</span></code></li> <li><span class="guilabel">Name</span>: <code class="docutils literal"><span class="pre">Perl</span> <span class="pre">Script</span> <span class="pre">Map</span></code></li> </ul> <p>At the prompt select <span class="guilabel">Yes</span>.</p> <div class="admonition note"> <p class="first admonition-title">Note</p> <p class="last">The ActiveState Perl installer may have already created an entry for .pl files that is limited to <code class="docutils literal"><span class="pre">GET,HEAD,POST</span></code>. If so, this mapping should be removed, as Bugzilla's .pl files are not designed to be run via a web server.</p> </div> <p>For the second one, set the following values (replacing paths if necessary):</p> <ul class="simple"> <li><span class="guilabel">Request Path</span>: <code class="docutils literal"><span class="pre">*.cgi</span></code></li> <li><span class="guilabel">Executable</span>: <code class="docutils literal"><span class="pre">C:\Perl\bin\perl.exe</span> <span class="pre">"%s"</span> <span class="pre">%s</span></code></li> <li><span class="guilabel">Name</span>: <code class="docutils literal"><span class="pre">CGI</span> <span class="pre">Script</span> <span class="pre">Map</span></code></li> </ul> <p>At the prompt select <span class="guilabel">Yes</span>.</p> </div> <div class="section" id="bugzilla-application"> <h2>3.5.3.4. Bugzilla Application<a class="headerlink" href="#bugzilla-application" title="Permalink to this headline">¶</a></h2> <p>Ensure that you are at the Bugzilla Application. Under <span class="guilabel">IIS</span>, double-click <span class="guilabel">Handler Mappings</span>. Under <span class="guilabel">Actions</span>, click <span class="guilabel">Add Script Map</span>.</p> <p>Set the following values (replacing paths if necessary):</p> <ul class="simple"> <li><span class="guilabel">Request Path</span>: <code class="docutils literal"><span class="pre">*.cgi</span></code></li> <li><span class="guilabel">Executable</span>: <code class="docutils literal"><span class="pre">C:\Perl\bin\perl.exe</span> <span class="pre">-x"C:\Bugzilla"</span> <span class="pre">-wT</span> <span class="pre">"%s"</span> <span class="pre">%s</span></code></li> <li><span class="guilabel">Name</span>: <code class="docutils literal"><span class="pre">Bugzilla</span></code></li> </ul> <p>At the prompt select <span class="guilabel">Yes</span>.</p> <p>Now it's time to restart the IIS server to take these changes into account. From the top-level menu, which contains the name of your machine, click <span class="guilabel">Restart</span> under <span class="guilabel">Manage Server</span>. Or run the command:</p> <p><strong class="command">iisreset</strong></p> </div> <div class="section" id="enable-rewrite-rules-for-rest"> <h2>3.5.3.5. Enable Rewrite Rules for REST<a class="headerlink" href="#enable-rewrite-rules-for-rest" title="Permalink to this headline">¶</a></h2> <p>REST URLs are usually of the form <a class="reference external" href="http://.../bugzilla/rest/version">http://.../bugzilla/rest/version</a> instead of <a class="reference external" href="http://.../bugzilla/rest.cgi/version">http://.../bugzilla/rest.cgi/version</a>. To let IIS redirect rest/ URLs to rest.cgi, you need to download and install the <a class="reference external" href="http://www.iis.net/downloads/microsoft/url-rewrite">URL Rewrite extension for IIS</a>. Direct download links are available at the bottom of the page for both x86 and x64 Windows.</p> <p>Once installed, you open the IIS Manager again and go to your Bugzilla Application. From here, double-click <span class="guilabel">URL Rewrite</span>. Then click <span class="guilabel">Add Rule(s)</span> under the <span class="guilabel">Actions</span> menu and click <span class="guilabel">Blank rule</span> in the <span class="guilabel">Inbound rules</span> section.</p> <p>Fill the fields as follows. Other fields do not need to be edited.</p> <ul class="simple"> <li><span class="guilabel">Name</span>: <code class="docutils literal"><span class="pre">REST</span></code></li> <li><span class="guilabel">Pattern</span>: <code class="docutils literal"><span class="pre">^rest/(.*)$</span></code></li> <li><span class="guilabel">Rewrite URL</span>: <code class="docutils literal"><span class="pre">rest.cgi/{R:1}</span></code></li> </ul> <p>There is no need to restart IIS. Changes take effect immediately.</p> </div> <div class="section" id="common-problems"> <h2>3.5.3.6. Common Problems<a class="headerlink" href="#common-problems" title="Permalink to this headline">¶</a></h2> <dl class="docutils"> <dt>Bugzilla runs but it's not possible to log in</dt> <dd><p class="first">You've probably configured IIS to use ActiveState's ISAPI DLL -- in other words you're using PerlEx, or the executable IIS is configured to use is <code class="file docutils literal"><span class="pre">PerlS.dll</span></code> or <code class="file docutils literal"><span class="pre">Perl30.dll</span></code>.</p> <p class="last">Reconfigure IIS to use <code class="file docutils literal"><span class="pre">perl.exe</span></code>.</p> </dd> <dt>IIS returns HTTP 502 errors</dt> <dd>You probably forgot the <code class="docutils literal"><span class="pre">-T</span></code> argument to <code class="file docutils literal"><span class="pre">perl</span></code> when configuring the executable in IIS.</dd> </dl> <hr class="docutils" /> <p>This documentation undoubtedly has bugs; if you find some, please file them <a class="reference external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation">here</a>.</p> </div> </div> </div> </div> </div> <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> <div class="sphinxsidebarwrapper"> <p class="logo"><a href="../index.html"> <img class="logo" src="../_static/bugzilla.png" alt="Logo"/> </a></p> <h3><a href="../index.html">Table Of Contents</a></h3> <ul> <li><a class="reference internal" href="#">3.5.3. Microsoft IIS</a><ul> <li><a class="reference internal" href="#create-a-new-application">3.5.3.1. Create a New Application</a></li> <li><a class="reference internal" href="#configure-the-default-document">3.5.3.2. Configure the Default Document</a></li> <li><a class="reference internal" href="#add-handler-mappings">3.5.3.3. Add Handler Mappings</a></li> <li><a class="reference internal" href="#bugzilla-application">3.5.3.4. Bugzilla Application</a></li> <li><a class="reference internal" href="#enable-rewrite-rules-for-rest">3.5.3.5. Enable Rewrite Rules for REST</a></li> <li><a class="reference internal" href="#common-problems">3.5.3.6. Common Problems</a></li> </ul> </li> </ul> <h4>Previous topic</h4> <p class="topless"><a href="apache-windows.html" title="previous chapter">3.5.2. Apache on Windows</a></p> <h4>Next topic</h4> <p class="topless"><a href="db_server.html" title="next chapter">3.6. Database Server</a></p> <div id="searchbox" style="display: none" role="search"> <h3>Quick search</h3> <form class="search" action="../search.html" method="get"> <div><input type="text" name="q" /></div> <div><input type="submit" value="Go" /></div> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="db_server.html" title="3.6. Database Server" >next</a></li> <li class="right" > <a href="apache-windows.html" title="3.5.2. Apache on Windows" >previous</a> |</li> <li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li> <li class="nav-item nav-item-1"><a href="index.html" >3. Installation and Maintenance Guide</a> »</li> <li class="nav-item nav-item-2"><a href="web_server.html" >3.5. Web Server</a> »</li> </ul> </div> <div class="footer" role="contentinfo"> Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6. </div> </body> </html>