<!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>
