آموزش مدیریت Application Poolهای IIS با PowerShell

مقدمه

در سرورهای ویندوزی که از IIS برای میزبانی سایت‌ها استفاده می‌کنند، یکی از مهم‌ترین بخش‌های مدیریت سرویس‌های وب، مدیریت Application Pool است. Application Pool را می‌توان مانند یک محیط جداگانه در نظر گرفت که برنامه وب در آن اجرا می‌شود. هر Application Pool می‌تواند تنظیمات مخصوص خود را داشته باشد و IIS از آن برای کنترل نحوه اجرای برنامه و Worker Process استفاده می‌کند. تنظیمات مربوط به Application Pool در IIS شامل مواردی مانند وضعیت اجرا، هویت اجرای برنامه، نسخه Runtime، حالت Pipeline، نحوه شروع و تنظیمات Recycling است.

مدیریت Application Pool از طریق محیط گرافیکی IIS Manager بسیار ساده است، اما زمانی که تعداد سایت‌ها زیاد باشد یا مدیر سرور بخواهد یک کار را روی چند Application Pool انجام دهد، PowerShell سرعت و انعطاف بسیار بیشتری دارد. ماژول WebAdministration در PowerShell مجموعه‌ای از دستورات برای مشاهده، ایجاد، حذف، شروع، توقف و Restart کردن Application Pool های IIS در اختیار مدیر سرور قرار می‌دهد.

در این آموزش، مهم‌ترین دستورات PowerShell برای مدیریت Application Pool در IIS را از ساده‌ترین حالت شروع می‌کنیم و به تنظیمات کاربردی‌تر می‌رسیم.

PowerShell و ماژول WebAdministration

برای مدیریت IIS از طریق PowerShell، یکی از روش‌های رایج استفاده از ماژول WebAdministration است. این ماژول دستورات متعددی مانند Get-WebAppPoolState، Start-WebAppPool، Stop-WebAppPool، Restart-WebAppPool، New-WebAppPool و Remove-WebAppPool را فراهم می‌کند.

ابتدا PowerShell را در سرور باز کنید و ماژول WebAdministration را وارد کنید:

Import-Module WebAdministration

پس از آن، مسیر مدیریتی IIS با نام IIS: در PowerShell قابل استفاده خواهد بود و می‌توانید Application Pool ها را مانند سایر Providerهای PowerShell مدیریت کنید. مایکروسافت نیز در مستندات IIS استفاده از IIS:\ و ماژول WebAdministration را برای مدیریت تنظیمات IIS نشان داده است.

مشاهده تمام Application Pool های IIS

برای مشاهده Application Pool های موجود روی سرور، می‌توانید از دستور زیر استفاده کنید:

Get-ChildItem IIS:\AppPools

این دستور فهرست Application Pool های موجود را نمایش می‌دهد. مسیر IIS:\AppPools محل دسترسی به Application Pool های IIS در PowerShell است.

برای مثال، ممکن است Application Pool هایی مانند موارد زیر در سرور وجود داشته باشند:

DefaultAppPool
MyWebsitePool
ShopPool
ApiPool

در یک سرور هاستینگ، داشتن چند Application Pool کاملاً طبیعی است و هر سایت یا برنامه می‌تواند به Pool مخصوص خود متصل باشد.

بررسی وضعیت Application Pool

یکی از اولین کارهایی که هنگام بررسی مشکل یک سایت باید انجام دهید، مشاهده وضعیت Application Pool مربوط به آن سایت است.

برای این کار:

Get-WebAppPoolState -Name "DefaultAppPool"

اگر Application Pool در حال اجرا باشد، معمولاً مقدار Started نمایش داده می‌شود. این cmdlet به صورت مشخص وضعیت Runtime مربوط به Application Pool را برمی‌گرداند.

برای بررسی چند Pool نیز می‌توانید نام Pool موردنظر را تغییر دهید:

Get-WebAppPoolState -Name "MyWebsitePool"

این کار برای زمانی مفید است که سایت با خطاهایی مانند عدم پاسخ‌گویی مواجه شده و می‌خواهید ابتدا مطمئن شوید Application Pool متوقف نشده است.

مشاهده تنظیمات Application Pool

برای مشاهده تنظیمات یک Application Pool می‌توانید از مسیر IIS استفاده کنید:

Get-ItemProperty IIS:\AppPools\DefaultAppPool

همچنین می‌توانید مشخصات مربوط به یک Pool را مستقیم از همین مسیر بررسی کنید:

Get-Item IIS:\AppPools\DefaultAppPool

PowerShell در این حالت اطلاعات پیکربندی Application Pool را در اختیار شما قرار می‌دهد و می‌توانید تنظیماتی مانند managedRuntimeVersion، managedPipelineMode و autoStart را بررسی کنید. مایکروسافت نیز تغییر خصوصیات Application Pool را از طریق Set-ItemProperty در Provider مربوط به IIS مستند کرده است.

Start کردن Application Pool با PowerShell

اگر Application Pool متوقف شده باشد، می‌توانید آن را با دستور زیر اجرا کنید:

Start-WebAppPool -Name "DefaultAppPool"

این دستور Application Pool مشخص‌شده را Start می‌کند.

بعد از Start کردن، برای بررسی نتیجه می‌توانید وضعیت آن را دوباره بررسی کنید:

Get-WebAppPoolState -Name "DefaultAppPool"

اگر همه چیز درست باشد، وضعیت باید به Started تغییر کرده باشد.

متوقف کردن Application Pool

برای Stop کردن یک Application Pool از دستور زیر استفاده می‌شود:

Stop-WebAppPool -Name "DefaultAppPool"

این دستور Application Pool مشخص‌شده را متوقف می‌کند.

در زمان توقف Application Pool، برنامه‌هایی که از آن Pool استفاده می‌کنند دیگر نمی‌توانند مانند حالت عادی از Worker Process مربوط به آن استفاده کنند. بنابراین در سرورهای عملیاتی، استفاده از این دستور باید با توجه به سایت‌ها و مشتریانی که به Pool متصل هستند انجام شود.

Restart کردن Application Pool

در بسیاری از مواقع لازم نیست Application Pool را به صورت جداگانه Stop و سپس Start کنید. برای Restart کردن مستقیم یک Pool می‌توانید از دستور زیر استفاده کنید:

Restart-WebAppPool -Name "DefaultAppPool"

این cmdlet Application Pool مشخص‌شده را Restart می‌کند.

Restart کردن Application Pool در شرایطی مانند اعمال برخی تغییرات برنامه، رفع بعضی مشکلات موقت Worker Process یا زمانی که برنامه به دلیل یک وضعیت موقت نیاز به شروع مجدد دارد، کاربرد زیادی دارد.

ایجاد Application Pool جدید

برای ایجاد یک Application Pool جدید از New-WebAppPool استفاده کنید:

New-WebAppPool -Name "MyWebsitePool"

مایکروسافت این cmdlet را برای ساخت Application Pool جدید در IIS ارائه کرده است.

بعد از ایجاد Pool می‌توانید تنظیمات موردنیاز آن را تغییر دهید. برای مثال، می‌توانید Runtime مربوط به آن را تنظیم کنید:

Set-ItemProperty -Path IIS:\AppPools\MyWebsitePool -Name managedRuntimeVersion -Value "v4.0"

مایکروسافت نیز تغییر managedRuntimeVersion را با Set-ItemProperty در مسیر IIS:\AppPools مستند کرده است.

تغییر حالت Managed Pipeline

یکی دیگر از تنظیمات مهم Application Pool، حالت Pipeline است. IIS از حالت‌های مختلف پردازش Pipeline پشتیبانی می‌کند و حالت Integrated در IIS جدید به صورت پیش‌فرض استفاده می‌شود. حالت Classic نیز برای برخی برنامه‌های قدیمی ممکن است مورد نیاز باشد.

برای تنظیم حالت Pipeline می‌توانید از Set-ItemProperty استفاده کنید. برای مثال:

Set-ItemProperty -Path IIS:\AppPools\MyWebsitePool -Name managedPipelineMode -Value "Integrated"

یا برای یک برنامه قدیمی که به Classic نیاز دارد:

Set-ItemProperty -Path IIS:\AppPools\MyWebsitePool -Name managedPipelineMode -Value "Classic"

تغییر این گزینه باید متناسب با نوع برنامه انجام شود، زیرا انتخاب اشتباه Pipeline Mode می‌تواند باعث ناسازگاری برنامه با IIS شود.

تنظیم Auto Start برای Application Pool

Application Pool دارای تنظیم autoStart نیز هست. این گزینه تعیین می‌کند Pool به صورت خودکار در فرآیند راه‌اندازی IIS فعال شود یا خیر.

برای فعال کردن آن:

Set-ItemProperty -Path IIS:\AppPools\MyWebsitePool -Name autoStart -Value $true

برای غیرفعال کردن:

Set-ItemProperty -Path IIS:\AppPools\MyWebsitePool -Name autoStart -Value $false

روش استفاده از خصوصیت autoStart هنگام ایجاد و تنظیم Application Pool در مستندات رسمی مایکروسافت نیز نشان داده شده است.

تنظیم Start Mode در IIS

Application Pool در IIS می‌تواند با حالت OnDemand یا AlwaysRunning اجرا شود. در حالت OnDemand، WAS در زمان نیاز و هنگام دریافت درخواست برای برنامه، Pool را راه‌اندازی می‌کند. در حالت AlwaysRunning، Application Pool توسط Windows Process Activation Service به صورت دائمی در حالت آماده اجرا نگه داشته می‌شود.

برای مشاهده یا تنظیم این گزینه می‌توانید از Provider مربوط به IIS استفاده کنید. برای مثال:

Set-ItemProperty -Path IIS:\AppPools\MyWebsitePool -Name startMode -Value "AlwaysRunning"

استفاده از AlwaysRunning باید بر اساس نیاز واقعی برنامه انجام شود، زیرا اجرای دائمی Worker Process با رفتار OnDemand متفاوت است.

تنظیم Idle Timeout

یکی از تنظیمات مهم Application Pool، idleTimeout است. این گزینه مشخص می‌کند Worker Process پس از چه مدت عدم دریافت درخواست جدید، در حالت بدون استفاده باقی بماند. مقدار پیش‌فرض مستندشده برای IIS برابر با 20 دقیقه است و مقدار 00:00:00 برای غیرفعال کردن Idle Timeout استفاده می‌شود.

برای مثال:

Set-ItemProperty -Path IIS:\AppPools\MyWebsitePool -Name processModel.idleTimeout -Value "00:00:00"

در تنظیمات عملیاتی، غیرفعال کردن Idle Timeout همیشه بهترین انتخاب نیست. این مقدار باید بر اساس نوع سایت، میزان مصرف منابع و نحوه اجرای برنامه مشخص شود.

مدیریت Recycling در Application Pool

IIS می‌تواند Worker Process را در شرایط مشخصی Recycle کند. Recycling با Restart کردن کل IIS یکسان نیست و در سطح Application Pool انجام می‌شود.

برای Application Pool می‌توان مواردی مانند زمان، تعداد درخواست، حافظه مجازی و Private Memory را به عنوان شرایط Recycling در نظر گرفت. در مستندات IIS، مقدار memory، privateMemory و requests به عنوان معیارهای قابل تنظیم برای Recycling معرفی شده‌اند.

برای نمونه، می‌توانید تنظیمات Recycling یک Pool را بررسی کنید:

Get-ItemProperty IIS:\AppPools\MyWebsitePool\recycling

در محیط‌های هاستینگ، تنظیمات Recycling اهمیت زیادی دارند؛ زیرا یک تنظیم نامناسب می‌تواند باعث Restartهای غیرضروری برنامه یا قطع شدن موقت سرویس شود.

اتصال یک سایت به Application Pool

Application Pool به تنهایی سایت نیست. یک سایت یا Application باید به یک Pool اختصاص داده شود تا برنامه داخل آن محیط اجرا شود.

مایکروسافت در نمونه‌های PowerShell خود نشان داده است که می‌توان Application Pool مربوط به یک سایت را با Set-ItemProperty تغییر داد.

برای مثال:

Set-ItemProperty IIS:\Sites\MyWebsite -Name applicationPool -Value "MyWebsitePool"

برای یک Application نیز می‌توان Pool را مشخص کرد:

Set-ItemProperty IIS:\Sites\MyWebsite\MyApp -Name applicationPool -Value "MyWebsitePool"

در نتیجه، اگر سایتی به Application Pool اشتباه متصل شده باشد، حتی در صورت سالم بودن خود Pool نیز ممکن است برنامه رفتار مورد انتظار را نداشته باشد.

مشاهده Application Pool مربوط به یک Application

برای بررسی اینکه یک Application در کدام Application Pool قرار دارد، می‌توانید از دستور زیر استفاده کنید:

Get-WebApplication -Site "Default Web Site"

این دستور Applicationهای مربوط به سایت مشخص‌شده را نمایش می‌دهد و یکی از اطلاعات خروجی آن Application Pool مربوط به هر Application است.

این روش در سرورهای هاستینگ بسیار کاربردی است، زیرا به جای باز کردن IIS Manager می‌توانید از PowerShell برای پیدا کردن ارتباط بین Website، Application و Application Pool استفاده کنید.

حذف Application Pool

برای حذف یک Application Pool از IIS می‌توانید از دستور زیر استفاده کنید:

Remove-WebAppPool -Name "MyWebsitePool"

دستور Remove-WebAppPool Application Pool مشخص‌شده را از IIS حذف می‌کند.

برای عملیات حساس می‌توانید قبل از اجرای واقعی از قابلیت WhatIf استفاده کنید:

Remove-WebAppPool -Name "MyWebsitePool" -WhatIf

در این حالت PowerShell نتیجه عملیات را شبیه‌سازی می‌کند و خود حذف را انجام نمی‌دهد. پشتیبانی این cmdlet از -WhatIf و -Confirm در مستندات مایکروسافت نیز مشخص شده است.

اجرای دستورات روی چند Application Pool

یکی از مزیت‌های مهم PowerShell نسبت به کار با رابط گرافیکی، امکان اجرای یک عملیات روی چند Application Pool است.

برای مثال، می‌توانید Application Poolهایی را که در حال اجرا نیستند پیدا کرده و آنها را Start کنید:

Get-ChildItem IIS:\AppPools |
    Where-Object { $_.State -ne "Started" } |
    Start-WebAppPool

مایکروسافت نمونه‌ای مشابه برای پیدا کردن Poolهایی که در وضعیت Started نیستند و Start کردن آنها ارائه کرده است.

این قابلیت در سرورهای هاستینگ که ده‌ها یا صدها Application Pool دارند، می‌تواند زمان مدیریت را به شکل قابل توجهی کاهش دهد.

بررسی سریع Application Pool از دید مدیر سرور

در زمان بروز مشکل برای یک سایت، بهتر است بررسی را از ساده‌ترین موارد شروع کنید. ابتدا نام Application Pool را پیدا کنید، سپس وضعیت آن را بررسی کنید و بعد تنظیمات آن را مشاهده کنید.

برای مثال:

Get-WebApplication -Site "MyWebsite"
Get-WebAppPoolState -Name "MyWebsitePool"
Get-ItemProperty IIS:\AppPools\MyWebsitePool

به این ترتیب می‌توان فهمید Application مربوط به کدام Pool است، Pool اجرا می‌شود یا متوقف است و تنظیمات اصلی آن چگونه است.

نکات مهم هنگام مدیریت Application Pool در هاستینگ

Application Pool یکی از بخش‌های حساس IIS است و تغییر تنظیمات آن می‌تواند مستقیماً روی سرویس سایت‌ها تأثیر بگذارد. به همین دلیل بهتر است قبل از تغییر Runtime، Pipeline Mode، Identity، Recycling یا Start Mode، مشخص باشد که برنامه موردنظر دقیقاً چه نیازهایی دارد.

هویت اجرای Application Pool نیز اهمیت زیادی دارد. در نسخه‌های جدید IIS، ApplicationPoolIdentity به عنوان هویت پیش‌فرض Application Pool استفاده می‌شود. هر Application Pool یک هویت مجزا با نامی مانند IIS AppPool\DefaultAppPool دارد و می‌توان دسترسی فایل‌ها را برای همین هویت تنظیم کرد.

به همین دلیل، در صورتی که برنامه به یک پوشه، فایل یا منبع خاص نیاز دارد، بهتر است به جای دادن دسترسی گسترده به حساب‌های عمومی مانند Administrator، دسترسی موردنیاز را برای Identity همان Application Pool تنظیم کنید.

چک لیست

قبل از اینکه مدیریت Application Pool را در یک سرور عملیاتی انجام دهید، مطمئن شوید نام دقیق Pool را می‌دانید، سایت یا Application مربوط به آن را شناسایی کرده‌اید و وضعیت فعلی Pool را بررسی کرده‌اید. بهتر است قبل از هر تغییر مهم، مقدار تنظیمات فعلی مانند Runtime، Pipeline Mode، Identity، Start Mode و تنظیمات Recycling را ثبت کنید تا در صورت نیاز بتوانید آنها را به حالت قبل برگردانید.

برای Restart یا Stop کردن یک Pool، ابتدا بررسی کنید چه سایت‌ها و برنامه‌هایی از آن استفاده می‌کنند. همچنین در زمان تغییر تنظیمات حساس، بهتر است نتیجه تغییر را بلافاصله با PowerShell بررسی کنید تا مطمئن شوید مقدار جدید واقعاً روی IIS ثبت شده است.

در سرورهای هاستینگ، اجرای دستورات PowerShell به صورت گروهی می‌تواند مدیریت تعداد زیادی Application Pool را آسان کند، اما هر دستور گروهی باید با دقت نوشته شود تا به Poolهای سایر سایت‌ها یا مشتریان آسیب نرسد.

جمع بندی

مدیریت Application Pool های IIS با PowerShell یکی از روش‌های سریع و کاربردی برای مدیران سرور و مدیران سیستم است. با استفاده از ماژول WebAdministration می‌توان وضعیت Poolها را مشاهده کرد، آنها را Start، Stop و Restart کرد، Application Pool جدید ساخت، تنظیمات مختلف را تغییر داد و Poolهای اضافی را حذف کرد.

مهم‌ترین دستورات این آموزش شامل Get-WebAppPoolState برای بررسی وضعیت، Start-WebAppPool برای شروع، Stop-WebAppPool برای توقف، Restart-WebAppPool برای راه‌اندازی مجدد، New-WebAppPool برای ایجاد و Remove-WebAppPool برای حذف Application Pool هستند.

PowerShell زمانی ارزش بیشتری پیدا می‌کند که تعداد سایت‌ها و Application Pool های سرور زیاد باشد. در چنین شرایطی، به جای انجام دستی عملیات در IIS Manager، می‌توان بسیاری از کارهای روزمره را با چند دستور انجام داد و مدیریت IIS را سریع‌تر، دقیق‌تر و قابل تکرار کرد.