TEXT   31
Bugzilla works with IIS as a normal CGI application
Guest on 19th March 2023 11:23:23 AM


  1. Microsoft IIS
  2. *************
  3.  
  4. Bugzilla works with IIS as a normal CGI application. These
  5. instructions assume that you are using Windows 7 or Windows 10.
  6. Procedures for other versions are probably similar.
  7.  
  8. Begin by starting Internet Information Services (IIS) Manager. Start
  9. --> Administrators Tools --> Internet Information Services (IIS)
  10. Manager. Or run the command:
  11.  
  12. **inetmgr**
  13.  
  14.  
  15. Create a New Application
  16. ========================
  17.  
  18. Expand your Server until the Default Web Site shows its children.
  19.  
  20. Right-click Default Web Site and select Add Application from the menu.
  21.  
  22. Unde Alias, enter the alias for the website. This is the path below
  23. the domain where you want Bugzilla to appear.
  24.  
  25. Under Physical Path, enter the path to Bugzilla, "C:\Bugzilla".
  26.  
  27. When finished, click OK.
  28.  
  29.  
  30. Configure the Default Document
  31. ==============================
  32.  
  33. Click on the Application that you just created. Double-click on
  34. Default Document, and click Add underneath the Actions menu.
  35.  
  36. Under Name, enter "index.cgi".
  37.  
  38. All other default documents can be removed for this application.
  39.  
  40. Warning: Do not delete the default document from the Default
  41.   Website.
  42.  
  43.  
  44. Add Handler Mappings
  45. ====================
  46.  
  47. Ensure that you are at the Default Website. Under IIS, double-click
  48. Handler Mappings. Under Actions, click Add Script Map. You need to do
  49. this twice.
  50.  
  51. For the first one, set the following values (replacing paths if
  52. necessary):
  53.  
  54. * Request Path: "*.pl"
  55.  
  56. * Executable: "C:\Perl\bin\perl.exe "%s" %s"
  57.  
  58. * Name: "Perl Script Map"
  59.  
  60. At the prompt select Yes.
  61.  
  62. Note: The ActiveState Perl installer may have already created an
  63.   entry for .pl files that is limited to "GET,HEAD,POST". If so, this
  64.   mapping should be removed, as Bugzilla's .pl files are not designed
  65.   to be run via a web server.
  66.  
  67. For the second one, set the following values (replacing paths if
  68. necessary):
  69.  
  70. * Request Path: "*.cgi"
  71.  
  72. * Executable: "C:\Perl\bin\perl.exe "%s" %s"
  73.  
  74. * Name: "CGI Script Map"
  75.  
  76. At the prompt select Yes.
  77.  
  78.  
  79. Bugzilla Application
  80. ====================
  81.  
  82. Ensure that you are at the Bugzilla Application. Under IIS, double-
  83. click Handler Mappings. Under Actions, click Add Script Map.
  84.  
  85. Set the following values (replacing paths if necessary):
  86.  
  87. * Request Path: "*.cgi"
  88.  
  89. * Executable: "C:\Perl\bin\perl.exe -x"C:\Bugzilla" -wT "%s" %s"
  90.  
  91. * Name: "Bugzilla"
  92.  
  93. At the prompt select Yes.
  94.  
  95. Now it's time to restart the IIS server to take these changes into
  96. account. From the top-level menu, which contains the name of your
  97. machine, click Restart under Manage Server. Or run the command:
  98.  
  99. **iisreset**
  100.  
  101.  
  102. Enable Rewrite Rules for REST
  103. =============================
  104.  
  105. REST URLs are usually of the form http://.../bugzilla/rest/version
  106. instead of http://.../bugzilla/rest.cgi/version. To let IIS redirect
  107. rest/ URLs to rest.cgi, you need to download and install the URL
  108. Rewrite extension for IIS. Direct download links are available at the
  109. bottom of the page for both x86 and x64 Windows.
  110.  
  111. Once installed, you open the IIS Manager again and go to your Bugzilla
  112. Application. From here, double-click URL Rewrite. Then click Add
  113. Rule(s) under the Actions menu and click Blank rule in the Inbound
  114. rules section.
  115.  
  116. Fill the fields as follows. Other fields do not need to be edited.
  117.  
  118. * Name: "REST"
  119.  
  120. * Pattern: "^rest/(.*)$"
  121.  
  122. * Rewrite URL: "rest.cgi/{R:1}"
  123.  
  124. There is no need to restart IIS. Changes take effect immediately.
  125.  
  126.  
  127. Common Problems
  128. ===============
  129.  
  130. Bugzilla runs but it's not possible to log in
  131.    You've probably configured IIS to use ActiveState's ISAPI DLL -- in
  132.    other words you're using PerlEx, or the executable IIS is
  133.    configured to use is "PerlS.dll" or "Perl30.dll".
  134.  
  135.    Reconfigure IIS to use "perl.exe".
  136.  
  137. IIS returns HTTP 502 errors
  138.    You probably forgot the "-T" argument to "perl" when configuring
  139.    the executable in IIS.
  140.  
  141. ======================================================================
  142.  
  143. This documentation undoubtedly has bugs; if you find some, please file
  144. them here.
Raw Paste

Login or Register to edit or fork this paste. It's free.