Common issues caused by changing request filtering settings on the Workspaces virtual directories in IIS

Version 7

    Introduction

    Modifying the Request filtering settings in IIS can cause undesirable behavior in Workspaces and does not necessarily display any errors to the user although you may see some errors if you turn on browser debugging.

    This document explains the known symptoms you will see in workspaces and how to resolve them.

     

    Changing any settings detailed in this article will recycle IIS

    Cannot sign out of a Workspaces session (with Workspaces configured for explicit or Token only Authentication)

    When a user clicks the arrow to expand the user and selects 'Sign Out' nothing happens.  This issue can be caused by the Delete verb being denied under request filtering on the BridgeIT or BridgeIT frameworks virtual directory in IIS.  Open IIS Manager, double click on the BridgeIT virtual directory and then double click on 'Request Filtering'.  Select the 'HTTP Verbs' tab and ensure you are not explicitly denying the DELETE verb.  If you are you will need to allow it, if you are not explicitly denying the DELETE verb, Click the 'Edit Feature Settings...' action and make sure the 'Allow unlisted verbs' is checked.  Repeat for the Framework virtual directory that BridgeIT is configured to use in ConfigurationCenter.

     

    Dashboards do not render all gadgets correctly and show as loading continuously until the page is refreshed.

    When opening dashboards in Workspaces the dashboard only partially loads it's gadgets or some gadgets don't render correctly.

     

     

     

    This issue can be caused by the following:

    • Incorrect feature settings under request filtering on the BridgeIT or BridgeIT Frameworks virtual directory in IIS.
    • The PUT verb is denied on the HTTP Verbs tab under request filtering on the BridgeIT or BridgeIT Frameworks virtual directory in IIS.
    Check the Request Filtering Feature Settings

    Open IIS Manager, double click on the BridgeIT virtual directory and then double click on 'Request Filtering'.  Click the 'Edit Feature Settings' action and check the following request limits are set as below (used the same request limits for the Framework virtual directory that BridgeIT is configured to use in ConfigurationCenter:

     

    Maximum URL length (Bytes) = 4096

    Maximum query string (Bytes) = 2048

     

    Check the PUT verb is not denied.

    Double click on the BridgeIT virtual directory and then double click on 'Request Filtering'.  Select the 'HTTP Verbs' tab and ensure you are not explicitly denying the PUT verb.  If you are you will need to allow it, if you are not explicitly denying the PUT verb, Click the 'Edit Feature Settings...' action and make sure the 'Allow unlisted verbs' is checked.  Repeat for the Framework virtual directory that BridgeIT is configured to use in ConfigurationCenter.

     

    After increasing the values above and ensuring the PUT verb is not denied the dashboard should render correctly:

     

     

    Cannot save changes to dashboards in Workspaces

    This issue can be caused by the following:

    1. The PUT verb is denied on the HTTP Verbs tab under request filtering on the BridgeIT virtual directory in IIS.
    2. The PUT verb is denied on the HTTP Verbs tab under request filtering on the BridgeIT Framework virtual directory in IIS.

     

    In 1. the Dashboard Designer does not display an error but shows the dashboard attempting to save but never finishing:

     

     

    In 2. the Dashboard Designer shows an error:

     

     

    When a user clicks the 'Save Dashboard' button the page looks like it is saving but never finishes or an error is displayed.  This issue can be caused by the PUT verb being denied under request filtering on the BridgeIT or BridgeIT frameworks virtual directory in IIS.  Open IIS Manager, double click on the BridgeIT virtual directory and then double click on 'Request Filtering'.  Select the 'HTTP Verbs' tab and ensure you are not explicitly denying the PUT verb.  If you are you will need to allow it, if you are not explicitly denying the PUT verb, Click the 'Edit Feature Settings...' action and make sure the 'Allow unlisted verbs' is checked.  Repeat for the Framework virtual directory that BridgeIT is configured to use in ConfigurationCenter.