60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
|
# 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)
|
||
|
|
|
||
|
|
```powershell
|
||
|
|
# 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
|
||
|
|
|