PozoAppCommonUpdatedCode/FIX-IIS-HANDLERS-MANUAL.md

IIS Handlers Section Unlock - Manual Guide

Problem

Error: "This configuration section cannot be used at this path. This happens when the section is locked at a parent level."

Solution 1: Using Script (Easiest)

Run UNLOCK-IIS-HANDLERS.bat as Administrator

Solution 2: Manual Unlock via IIS Manager

Step 1: Open IIS Manager

• Windows + R → inetmgr → Enter

Step 2: Unlock Handlers Section

1. Select Server (root level - your computer name at top)
2. Double-click "Feature Delegation" (in Management section)
3. Find "Handler Mappings" in the list
4. Right-click → "Read/Write" (or click "Read/Write" in Actions pane)
5. Confirm if prompted

Step 3: Restart IIS

• Command Prompt (Admin): iisreset
• Or restart Application Pool in IIS Manager

Step 4: Test

• Browser: http://localhost

Solution 3: Using PowerShell (Advanced)

# Run as Administrator
Import-Module WebAdministration
Set-WebConfigurationProperty -PSPath "MACHINE/WEBROOT/APPHOST" -Filter "system.webServer/handlers" -Name "overrideMode" -Value "Allow"
iisreset

Solution 4: Edit applicationHost.config (Advanced)

1. Open: C:\Windows\System32\inetsrv\config\applicationHost.config
2. Find: <section name="handlers" overrideModeDefault="Deny" />
3. Change to: <section name="handlers" overrideModeDefault="Allow" />
4. Save and restart IIS

Verify iisnode Installation

Check if iisnode is installed:

• Look for: C:\Program Files\iisnode\
• Or check IIS Modules: IIS Manager → Server → Modules → Look for "iisnode"

If not installed:

• Download: https://github.com/Azure/iisnode/releases
• Install and restart IIS

After Unlocking

1. Restart IIS: iisreset
2. Test website: http://localhost
3. Check logs if errors: dist\iisnode\ folder