Frequently Asked Question

How do I configure IIS for PlatoAtlas?
Last Updated 4 years ago

APPLICABLE AUDIENCE: PLATO Intranet Applications, United Kingdom and Australasia.

General Information
PlatoAtlas serves pages via Internet Information Server (IIS) whose security settings, features and defaults can change over time. Use this article to ensure that required IIS features are enabled.

V10 and Later:

Open Windows Powershell using Run as Administrator, then

CD (path to unzipped PlatoV10 archive)
Set-ExecutionPolicy Bypass -Scope Process
install-iis-features.ps1

This will confirm/enable requires IIS features.


Prior to V10:

Manual IIS Feature Installation
On Windows Clients the IIS configuration features are under Turn Windows Features On and Off from the Start Menu (Programs and Features). The screenshot in this article is for a Windows Client. On Windows Server, open Server Manager and Add the Web Server Role then follow the Wizard interface to add components. If IIS is already installed, right click on the Web Server Role and click on Add/Remove Role Services.

Required IIS features are highlighted in yellow in the screenshot below. Without these features, PlatoAtlas may not work at all. The most important settings are:

  • IIS Metabase and IIS 6 Configuration compatibility
  • ASP.NET and .NET Extensibility
  • ISAPI Extensions Support if you use the ISAPI module (classic mode)
  • Basic and Windows Authentication.
image

Automated IIS Feature Installation

In recent versions of Windows you can use Powershell to automate IIS Features installation using Commandlet calls.

The following script will correctly configure a base version of IIS. Note that in some OS and setups, a Powershell Execution Policy bypass may need to be run before this script. The bypass command is commented in the script.

# This script installs IIS and the features required to run asp.net applications

# * Make sure you run this script from an Admin Prompt!
# * Make sure Powershell Execution Policy is bypassed to run these scripts:
# * YOU MAY HAVE TO RUN THIS COMMAND PRIOR TO RUNNING THIS SCRIPT!
Set-ExecutionPolicy Bypass -Scope Process

Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebServerRole
Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebServer
Enable-WindowsOptionalFeature -Online -FeatureName IIS-CommonHttpFeatures
Enable-WindowsOptionalFeature -Online -FeatureName IIS-HttpErrors
Enable-WindowsOptionalFeature -Online -FeatureName IIS-HttpRedirect
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ApplicationDevelopment
Enable-WindowsOptionalFeature -Online -FeatureName IIS-NetFxExtensibility45
Enable-WindowsOptionalFeature -Online -FeatureName IIS-HealthAndDiagnostics
Enable-WindowsOptionalFeature -Online -FeatureName IIS-HttpLogging
Enable-WindowsOptionalFeature -Online -FeatureName IIS-LoggingLibraries
Enable-WindowsOptionalFeature -Online -FeatureName IIS-RequestMonitor
Enable-WindowsOptionalFeature -Online -FeatureName IIS-HttpTracing
Enable-WindowsOptionalFeature -Online -FeatureName IIS-Security
Enable-WindowsOptionalFeature -Online -FeatureName IIS-RequestFiltering
Enable-WindowsOptionalFeature -Online -FeatureName IIS-Performance
Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebServerManagementTools
Enable-WindowsOptionalFeature -Online -FeatureName IIS-IIS6ManagementCompatibility
Enable-WindowsOptionalFeature -Online -FeatureName IIS-Metabase
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ManagementConsole
Enable-WindowsOptionalFeature -Online -FeatureName IIS-BasicAuthentication
Enable-WindowsOptionalFeature -Online -FeatureName IIS-WindowsAuthentication
Enable-WindowsOptionalFeature -Online -FeatureName IIS-StaticContent
Enable-WindowsOptionalFeature -Online -FeatureName IIS-DefaultDocument
Enable-WindowsOptionalFeature -Online -FeatureName IIS-WebSockets
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ApplicationInit
Enable-WindowsOptionalFeature -Online -FeatureName IIS-NetFxExtensibility45
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ASPNET45
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ISAPIExtensions
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ISAPIFilter
Enable-WindowsOptionalFeature -Online -FeatureName IIS-HttpCompressionStatic

Copy and paste the above into a POSH script file (e.g. PlatoAtlasSetupIIS.ps1) and then:

  • Open a PowerShell command prompt using Run as Administrator
  • Run the script.

Please Wait!

Please wait... it will take a second!