PozoAppCommonUpdatedCode/IIS-DEPLOYMENT-GUIDE.md

IIS Server-ல் Node.js App Host செய்வது - Step by Step Guide

Prerequisites (முன் தேவைகள்)

1. Node.js Installation

   • Node.js 18.x அல்லது அதற்கு மேல் install செய்ய வேண்டும்
   • Download: https://nodejs.org/
   • Installation பிறகு, Command Prompt-ல் node --version run செய்து verify செய்யவும்

2. iisnode Module Installation

   • Download: https://github.com/Azure/iisnode/releases
   • Latest version-ஐ download செய்து install செய்யவும்
   • Install பிறகு IIS-ஐ restart செய்யவும்

3. IIS Features Enable செய்யவும்

   • Windows Features-ல் இவை enable செய்யவும்:
     • Internet Information Services (IIS)
     • IIS Management Console
     • URL Rewrite Module (https://www.iis.net/downloads/microsoft/url-rewrite)
     • Application Request Routing (ARR) - Optional

Step 1: Project Build செய்யவும்

# Project root directory-ல்
npm install
npm run build

Step 2: IIS-ல் Website Create செய்யவும்

Method 1: IIS Manager-ல் Manual Setup

1. IIS Manager open செய்யவும்
2. Connections pane-ல் server name-ஐ right-click செய்து Add Website select செய்யவும்
3. Fill செய்யவும்:
   • Site name: PozoApp (அல்லது உங்கள் விருப்பத்திற்கு)
   • Application pool: New application pool create செய்யவும்
   • Physical path: D:\2025\Pozo Dev\PozoDev Updated OptimandSEO\Nov 7\dist
   • Binding:
     • Type: http
     • IP address: All Unassigned (அல்லது specific IP)
     • Port: 80 (அல்லது வேறு port)
     • Host name: (optional) pozo.app அல்லது www.pozo.app
4. OK click செய்யவும்

Method 2: PowerShell-ல் Script

# Run as Administrator
Import-Module WebAdministration

$siteName = "PozoApp"
$physicalPath = "D:\2025\Pozo Dev\PozoDev Updated OptimandSEO\Nov 7\dist"
$port = 80

# Create Application Pool
New-WebAppPool -Name $siteName
Set-ItemProperty IIS:\AppPools\$siteName -Name managedRuntimeVersion -Value ""

# Create Website
New-Website -Name $siteName -PhysicalPath $physicalPath -Port $port -ApplicationPool $siteName

Step 3: Application Pool Configuration

1. IIS Manager-ல் Application Pools select செய்யவும்
2. உங்கள் application pool-ஐ select செய்யவும்
3. Advanced Settings open செய்யவும்
4. இவை set செய்யவும்:
   • .NET CLR Version: No Managed Code
   • Enable 32-Bit Applications: False (64-bit Node.js-க்கு)
   • Start Mode: AlwaysRunning (optional, auto-start-க்கு)
   • Idle Timeout: 0 (idle-ல stop ஆகாமல்)

Step 4: Environment Variables Setup (Optional)

Application Pool-க்கு environment variables set செய்யலாம்:

# Run as Administrator
$appPoolName = "PozoApp"
$env = Get-ItemProperty "IIS:\AppPools\$appPoolName" -Name environmentVariables
$env.Add("NODE_ENV", "production")
$env.Add("PORT", "process.env.PORT")
$env.Add("API_URL", "https://api.pozo.app")
$env.Add("PRODUCTION_URL", "https://www.pozo.app")
Set-ItemProperty "IIS:\AppPools\$appPoolName" -Name environmentVariables -Value $env

Step 5: Permissions Setup

dist folder-க்கு IIS application pool identity-க்கு permissions கொடுக்கவும்:

# Run as Administrator
$folderPath = "D:\2025\Pozo Dev\PozoDev Updated OptimandSEO\Nov 7\dist"
$appPoolName = "PozoApp"
$identity = "IIS AppPool\$appPoolName"

# Full control permissions
icacls $folderPath /grant "${identity}:(OI)(CI)F" /T

Step 6: Verify web.config

dist folder-ல் web.config file உள்ளதா check செய்யவும். இது already configure செய்யப்பட்டிருக்கும்.

Step 7: Test the Application

1. IIS Manager-ல் website-ஐ Start செய்யவும்
2. Browser-ல் open செய்யவும்:
   • http://localhost (port 80-க்கு)
   • அல்லது http://localhost:PORT (custom port-க்கு)

Troubleshooting (பிரச்சனைகள் தீர்த்தல்)

Error: "iisnode module not found"

• iisnode install செய்யப்பட்டதா verify செய்யவும்
• IIS-ஐ restart செய்யவும்

Error: "Cannot find module"

• dist folder-ல் node_modules folder உள்ளதா check செய்யவும்
• Project root-ல் npm install run செய்யவும்
• dist folder-க்கு node_modules copy செய்யவும்:

  xcopy /E /I /Y "node_modules" "dist\node_modules"
  

Error: "Port already in use"

• IIS-ல் binding-ஐ check செய்யவும்
• வேறு port use செய்யவும்

Error: "500 Internal Server Error"

• IIS logs check செய்யவும்: C:\inetpub\logs\LogFiles\
• iisnode logs check செய்யவும்: dist\iisnode\ folder
• Application Pool-ல் Advanced Settings → Process Model → Identity-ஐ check செய்யவும்

Static Files Load ஆகாமல்

• web.config-ல் static content rules சரியாக configure செய்யப்பட்டதா check செய்யவும்
• IIS-ல் Static Content feature enable செய்யப்பட்டதா verify செய்யவும்

ES Modules Error

• Node.js version 18+ install செய்யப்பட்டதா verify செய்யவும்
• package.json-ல் "type": "module" உள்ளதா check செய்யவும்

Logs Check செய்யவும்

1. IIS Logs: C:\inetpub\logs\LogFiles\W3SVC[SiteID]\
2. iisnode Logs: dist\iisnode\ folder
3. Application Logs: Event Viewer → Windows Logs → Application

Production Deployment Tips

1. HTTPS Setup: SSL certificate install செய்து HTTPS enable செய்யவும்
2. Firewall: Port 80/443 open செய்யவும்
3. Domain: DNS-ல் domain point செய்யவும்
4. Monitoring: Application performance monitor செய்யவும்
5. Backup: Regular backup எடுக்கவும்

Quick Commands

# Website start
Start-Website -Name "PozoApp"

# Website stop
Stop-Website -Name "PozoApp"

# Application Pool restart
Restart-WebAppPool -Name "PozoApp"

# Check website status
Get-Website -Name "PozoApp"

# View application pool status
Get-WebAppPoolState -Name "PozoApp"

Support

பிரச்சனைகள் இருந்தால்:

1. IIS logs check செய்யவும்
2. iisnode logs check செய்யவும்
3. Node.js version verify செய்யவும்
4. Permissions verify செய்யவும்