KBA-01651: Preparing an IIS Server

Question

Is there an easy way to prepare an IIS server for sfPMS?

Answer

We require Windows 2012 R2 or later.  We strongly recommend Windows 2016 or Windows 2019.

Using PowerShell

  1. Download the Role Deployment XML from the NewInstall resources folder, save the file in c:\spitfire\IIS-RoleDeployment.xml
  2. Open PowerShell as an Administrator
  3. Type (or paste) the following command to run the Install-WindowsFeature
    Install-WindowsFeature -ConfigurationFilePath c:\spitfire\IIS-RoleDeployment.xml
  4. Repeat for IIS-RoleDeployment-WebSockets.xml

Add Server Role: WebSocket Protocol

Manual Check List

  1. Install Chrome
  2. Download the Role Deployment and ICTool Setup from the NewInstall resources folder
  3. Follow the Using Powershell steps above to apply the roles
  4. Run the ICTool Setup – you need Site and User Keys
  5. Run INETMGR and
    1. Create one or more application pools for the sfPMS application(s).  Typically, don’t mix production and test sites in one pool.  Name the pools something like SpitfireProductionPool and SpitfireTestPool.  See below for recommended advanced settings.
    2. (optionally) add a website (Spitfire) mapped to c:\program files (x86)\Spitfire\websiteroot
    3. (optional) SSL certificate?
    4. Add (one or more) web applications mapped to c:\program files (x86)\Spitfire\webapproot\vr-xxxx and bind to hostname and (optionally) a local port
  6. If migrating from an older server
    1. Copy site configuration data from c:\program files (x86)\Spitfire\cfgFiles and c:\program files (x86)\Spitfire\InstallBase\data\SERVERNAME 
      1. SiteConfig.XML
      2. Site signing key
      3. License (likely needs to be replaced if not a farm)
      4. Optional: Logo image (may be in web application root\images)
    2. Use NotePad++ to edit the configuration XML
      1. Replace the old SQL server name with the new SQL name
      2. Replace the old IIS server name with the new server name
      3. If the IIS Site number has changed, find IISSiteName and update it
  7. Open ICTool (use File | Open to open the configuration file copied from a prior server)
    1. On the Servers tab, update the ATC server name
    2. For new installs, see the installation guide – setup SQL data, etc)
    3. On the sfPMS Members tab,
      1. update the server name and verify the VSPD path folders exist
      2. click in the web application column and lookup the IIS Web Application.
      3. consider if the hostname is changing
    4. On the ATC tab,
      1. verify the local HTTP path and local IP addresses
      2. install ATC
      3. install the service
      4. Create a firewall exemption for 14491 and 14492
      5. IMPORTANT: if you are preparing the new server and the old server is running, disable ATC on the new server for now!
  8. Obtain a license for the new server and place it into the InstallBase\data\SERVERNAME folder
  9. In Windows SERVICES.MSC
    1. set the ASPNET_STATE service to auto-start (and start the service)
    2. set the Spitfire ATC service to DELAYED start, with auto-recovery.
      1. Use “Local System Account” on the “Login As” tab.  If you use AD credentials, use a domain-limited account, but also add the account to the local administrators group on this IIS server.  If you use an AD user without local admin, the service will not automatically restart overnight, nor can it apply updates for the web application.
  10.  Publish the site
  11. Open the site

IIS Application Pool Advanced Settings

  • Enable 32-bit applications: With Windows Server 2012  and later, we recommend false (which is the default).
  • Idle Time-out Minutes: We recommend a value between 30 and 50 (default is 20).
  • Shutdown Time Limit: We recommend a value between 99 and your PDS RAM cache time (often 123).
  • Specific Times: We recommend something between 1 and 3 AM. You should specify at least one time during off-hours; otherwise your application pool will recycle daily at whatever time IIS decides. The UI seems to support seconds, but you must use 00 for seconds (minutes are okay).
  • Virtual Memory Limit: Should be zero

 

 


KBA-01651; Last updated: August 12, 2020 at 19:37 pm  Setup IIS