How to Setup Microsoft IIS with Board 12 Web Server

Board Support
Board Support Employee
5 Likes Photogenic
edited January 12 in Support Articles


Functionality

Board 12 Web Server includes its own HTTP Server, but for multiple reasons, you might want to publish Board under IIS. Publishing Board under IIS may be convenient in these cases:

  • Need to use a certificate and publish the site through HTTPS
  • Need to publish the same Board Engine through multiple sites with different configurations
  • Allow your local IT to maintain and support the website on a platform they feel confident with.
  • Schedule regular recycles, etc.

How to do it

Prerequisites

  1. Install Microsoft IIS Server Role.
  2. Check and enable "ASP.NET 4.6" and "WebSocket Protocol" Role services under Application Development category.
    Please note that if you need to use Windows Authentication, you must also enable it now. You can find it under the Security options
  3. If you install IIS server after .NET Framework 4, run this command according to your installation path and version:
    %windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
  4. The article below assumes that the Board main engine is installed on the same server you’re configuring IIS.

IIS Configuration

If you need to publish Board under IIS, please follow the steps:

  1. Unzip and install the standard BOARD Web Server application BoardVersion_Setup_Web_HTML5_Server
  2. Create the Board site under IIS.
  3. Your IIS folder structure should look like this:
  4. Uninstall the Board WebApi Engine from the Windows Programs and Features.
  5. Give full rights to IIS_IUSRS on the IIS site folder that you created (right-click C:\inetpub\wwwroot\BWEB12\--> Properties --> Security)
  6. On the IIS Manager, create a new website, point it to the BWED12 folder location and add a binding to external name/address of the server as shown
    In the example above, your website will be accessible publicly on http://testsa-company.board.com
  7. In the Application Pool of the IIS Board Website, open the Advanced Settings, and set the Load User Profile to True
  8. Edit C:\inetpub\wwwroot\BWEB12\App_data\config\mailer.config so it looks as shown:
    Note that a new folder C:\inetpub\wwwroot\BWEB12\App_Data\broadcasting\log was created to store the broadcasting logs.
  9. Edit C:\inetpub\wwwroot\BWEB12\bin\Board.mailer.Service.exe.Config so it looks as shown:
  10. Finally you must re-configure the Mailer service. To do that please reboot the server if necessary and then run the following commands from an elevated command line prompt (ie run “cmd” as an administrator):

    "C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil.exe" “C:\inetpub\wwwroot\BWEB12\Bin\Board.Mailer.Service.exe"

    sc config BoardMailerService start=auto
    sc start BoardMailerService

Notes

  • If your Board version is earlier that Board 10.5, please proceed with the Snapshotter (ie Create a Report) configuration as described in this article:
  • You may schedule a periodic IIS Recycle of the site (a daily recycle is recommended): Recycling Settings for an Application Pool | Microsoft Docs
  • If you want to enable the Windows Authentication (for on-premise customers only) you need to enable the windows authentication option in the Authentication section of the IIS site configurations

  • In order to achieve optimal configuration under IIS, make sure to set the "compilation debug" parameter to false. The parameter is available in the web.config configuration file.