Various Documentation

Hosting Through IIS Instead of the Integrated Web Server

  • Last Modified: 2019-12-09

When you install any of our products using the installer, you're presented with two application hosting options: Integrated Web Server or IIS Web Application.

The question of which to choose comes down to simplicity or robustness, except for load-balanced or High Availability installations of ProGet which require IIS. The Integrated Web Server is easy to install (and obviously doesn't require IIS installed), while an IIS Web Application offers a whole lot more advanced hosting features and configurations (but of course requires IIS).

If you've started with the Integrated Web Server and would like to upgrade your hosting to an IIS Web Application, all it takes is a few easy steps.

1. Change Configuration

The service looks in configuration to determine whether the integrated web server should be started.

BuildMaster, Otter, and ProGet v5.1.0+

The integrated web server's configuration is stored in a configuration file.

  1. On the server, navigate to the Service root directory (by default, C:\Program Files\ProGet\Service, C:\Program Files\BuildMaster\Service or C:\Program Files\Otter\Service)
  2. Open App_appSettings.config in any text editor
  3. Change the value of the key named IntegratedWebServer.Enabled to False
  4. Save the file

ProGet Prior to v5.1.0

Before ProGet v5.1.0, the integrated web server's configuration was stored in the database.

  1. Sign in to ProGet with an account that has administrative privileges
  2. Click the Admin link (top right corner of the navigation
  3. Click on Advanced Settings under the System Settings options
  4. Change the UseIntegratedWebServer key to False

2. Uninstall IWS Service

This step is only necessary for BuildMaster & Otter, skip to section 3 for ProGet.

  1. Open a Command Prompt with administrative privileges
  2. Navigate to the service directory (default C:\BuildMaster\Service or C:\Otter\Service)
  3. Stop the IWS Service by typing net stop inedobmwebsrv for BuildMaster & net stop inedootterwebsrv for Otter
  4. Uninstall the IWS Service by typing bmservice UninstallWebServer for BuildMaster & otterservice UninstallWebServer for Otter

3. Create IIS Web Application

  1. Open the IIS Manager
  2. Create a new Application Pool named BuildMasterAppPool, ProGetAppPool, or OtterAppPool with the following minimum configuration:
  • .NET CLR Version - 4.0
  • Managed Pipeline Mode - Integrated is recommended, but Classic will also work

Example PowerShell command to create an app pool for ProGet:

&"C:\Windows\System32\inetsrv\appcmd.exe" add apppool /name:ProGet /managedRuntimeVersion:v4.0 /managedPipelineMode:Integrated /processModel.identityType:SpecificUser /processModel.userName:ProGetServiceUser@domain /processModel.password:<account-password>

Additional instructions for creating application pools can be found here: Create an Application Pool in IIS 7.x

Create a new Website (virtual directories are not supported) named BuildMaster, ProGet, or Otter with the following minimum configuration:

  • Physical Path - the path on disk where the web application files are located (by default C:\Program Files\[ProductName]\Web)
  • Application Pool - the application pool to use (by default [ProductName]AppPool)
  • Binding - the combination of IP address(es) and port(s) used to access the product over the network

Note that any of these values can be edited once they are created, for example, to add SSL certificates, update the port that ProGet is listening on, etc.

Example PowerShell command to create a ProGet site:

&"C:\Windows\System32\inetsrv\appcmd.exe" add site /name:ProGet /physicalPath:"C:\Program Files\ProGet\Web" /bindings:"http/*:80:" /applicationDefaults.applicationPool:ProGet

You may adjust other IIS site settings as desired.

Your product will now be hosted through IIS. The products aren't very particular about how they are hosted as long as the prerequisite roles & features are installed, so virtually any of the settings within the IIS Application or Application Pool can be changed to suit your needs.

Is this documentation incorrect or incomplete? Help us by contributing!

This documentation is licensed under CC-BY-SA-4.0 and stored in GitHub.

Generated from commit d08a87ca on master