آماده‌سازی سرور ویندوز برای نصب – نسخه ۸.۰.۶.۱۰۱۹

دستورالعمل‌های زیر به شما کمک می‌کند نحوه نصب TestRail روی Windows Server را بفهمید. برای اطلاعات بیشتر درباره سیستم‌عامل‌ها و سیستم‌های سرور پشتیبانی‌شده، اینجا را ببینید.

TestRail برای نصب روی سرور به یک web server، یک SQL database یعنی SQL Server، یک NoSQL database یعنی Cassandra ۳.۱۱، و یک محیط فعال PHP ۸.۰ یا ۸.۱ نیاز دارد. روی Windows Server، TestRail بهترین عملکرد را با web server مایکروسافت یعنی IIS و PHP پیکربندی‌شده برای اجرا با FastCGI دارد.

نصب IIS #

برای نصب IIS روی Windows Server، Server Managerرا اجرا کنید. در Dashboard، زیر Configure This Local Server، روی Add roles and features کلیک کنید.

 

گزینه Role-based or feature-based installation را انتخاب کنید و روی Next کلیک کنید.

 

از server pool، server host موردنظر خود را برای نصب IIS انتخاب کنید و روی Next کلیک کنید. سپس هنگام انتخاب Server Roles، مطمئن شوید Web Server (IIS)  انتخاب شده باشد و زیر Web Server > Application Development  مطمئن شوید CGI  نیز انتخاب شده باشد، اگر از قبل انتخاب نشده است. روی Install کلیک کنید.

 

 

 

 

فایل‌های رسمی PHP را دانلود کنید با فرمت .zip.

از سال ۲۰۲۳، VS16 x64 Non Thread Safe  نسخه پیشنهادی برای دانلود است، چون در مستندات نصب از همین نسخه استفاده می‌شود.

 

بعد از کامل شدن دانلود، فایل‌های فشرده PHP را در مسیر C:\php\ روی سیستم میزبان extract کنید.

بخش Environment Variables را ویرایش کنید و یک System variable جدید برای Path اضافه کنید: C:\php. 

 

 

به IIS Manager بروید، روی server host کلیک کنید، سپس روی Handler Mappings و بعد روی Add Module Mapping کلیک کنید.

 

 

در پنجره جدید، همه فیلدها را دقیقاً مطابق اطلاعاتی که در تصویر زیر نشان داده شده پر کنید و سپس روی OK کلیک کنید.

 

در IIS Manager به server host برگردید و این بار روی Default Document کلیک کنید. در Actions panel روی Add کلیک کنید.

 

 

در فیلد Name مقدار Index.php را وارد کنید و روی OK کلیک کنید. سپس دوباره روی Add کلیک کنید و این بار در فیلد Name مقدار Default.php را وارد کنید و روی OK کلیک کنید.

 

 

نصب پیش‌نیازها #

برای استفاده از TestRail روی Windows با پایگاه‌داده SQL Server، extensionهای PHP زیر لازم هستند:

• extension Cassandra برای دسترسی به پایگاه‌داده NoSQL
• extension PHP gd برای ساخت نمودارها
• extension PHP sqlsrv_81_nts_x64 برای دسترسی به پایگاه‌داده‌های SQL Server
• extension PHP pdo_mysql برای دسترسی به پایگاه‌داده
• extension PHP fileinfo برای تشخیص نوع فایل و encoding آن
• extension PHP imagick برای کار با تصاویر
• extension PHP mbstring برای کار با رشته‌های Unicode
• extension PHP curl برای بررسی به‌روزرسانی‌ها و موارد مشابه
• extension PHP openssl برای مدیریت اتصال‌های SSL
• ionCube PHP Loader برای decode کردن فایل‌های PHP مربوط به TestRail

دانلود کنید: درایورهای PHP مایکروسافت برای SQL Server از اینجا، و روی گزینه زیر کلیک کنید: Download Microsoft Drivers for PHP for SQL Server (Windows).

قبل از استخراج فایل‌ها، ابتدا باید مطمئن شوید که نسخه PHP شما از کدام حالت Thread Safety استفاده می‌کند (ts یا nts)، وگرنه نصب درست انجام نمی‌شود. برای اینکه ببینید نسخه شما Thread Safe است یا Not Thread Safe، دستور زیر را وارد کنید:

php -i|find "Thread Safety"

بعد از استخراج فایل‌ها، فایل‌های Thread Safety متناسب با نسخه خود را پیدا کنید و آن‌ها را در مسیر C:\php\ext\ کپی کنید. برای مثال:

• • php_pdo_sqlsrv_81_nts_x64.dll
  • php_sqlsrv_81_nts_x64.dll

برای نصب این extensionها، موارد زیر را به فایل‌های php.ini خود اضافه کنید:

• • extension=pdo_sqlsrv_81_nts_x64
  • extension=sqlsrv_81_nts_x64

 

این driver به نصب ODBC Driver هم نیاز دارد. package متناسب را دانلود و نصب کنید:

• دانلود package x86
• دانلود package x64

 

بعد از فعال کردن extension در فایل پیکربندی PHP.ini و نصب ODBC Driver، وب‌سرور IIS را restart کنید. برای بررسی اینکه extension با موفقیت load شده است، می‌توانید تابع phpinfo() را اجرا کنید. همچنین می‌توانید در Command Prompt دستور php -m را اجرا کنید تا مطمئن شوید moduleها فعال هستند.

مستندات رسمی نصب extension imagick را از اینجا دنبال کنید.

آخرین extension موردنیاز PHP، ionCube PHP Loader رایگان است. می‌توانید ionCube Loader برای Windows را از اینجا دانلود کنید.

برای این روش نصب، به فایل «ioncube_loader_win_8.۱.dll» نیاز دارید. این فایل را با دانلود Windows VC16 (Non-TS) (64-bit) یعنی فایل zip با نام ioncube_loaders_win_nonts_vc16_x86-۶۴.zip دریافت کنید. همه فایل‌ها را روی سرور extract کنید و extension مربوط به loader را در پوشه ext مربوط به PHP کپی کنید (معمولاً C:\php\ext\). سپس extension را با اضافه کردن خط زیر به فایل PHP.ini فعال کنید (این فایل معمولاً در پوشه نصب، یعنی C:\php\، قرار دارد):

zend_extension = "C:\php\ext\ioncube_loader_win_8.1.dll"

برای مطمئن شدن از نصب موفق ionCube loader extension، دستور php -v را در Windows Command Prompt اجرا کنید (برای اجرای این دستور باید ابتدا وارد پوشه نصب PHP شوید).

اگر خروجی php -v شبیه نمونه زیر باشد، ionCube loader extension با موفقیت نصب شده است (به خط ionCube PHP Loader توجه کنید):

PHP 8.1.14 (cli) (built: Jan 4 2023 12:24:57) (NTS Visual C++ 2019 x64)
Copyright (c) The PHP Group
Zend Engine v4.1.14, Copyright (c) Zend Technologies
with the ionCube PHP Loader v12.0.5, Copyright (c) 2002-2022, by ionCube Ltd.

بیشتر extensionها باید به‌صورت خودکار اضافه شوند، اما لازم است مراحل تکمیلی Cassandra، IonCube و imagick را هم انجام دهید. اگر PHP را دستی نصب کرده‌اید، ممکن است لازم باشد extensionهای موردنیاز را در فایل PHP.ini به شکل زیر فعال کنید:

zend_extension = "C:\php\ext\ioncube_loader_win_8.1.dll"
extension=cassandra
extension=gd
extension=fileinfo
extension=imagick
extension=mbstring
extension=curl
extension=openssl
extension=pdo_sqlsrv_81_nts_x64
extension=sqlsrv_81_nts_x64

برای reload شدن PHP، وب‌سرور IIS را restart کنید. ساده‌ترین راه این است که سرویس World Wide Web Publishing Windows را restart کنید. برای این کار، از Administrative Tools برنامه Services را باز کنید و سرویس را restart کنید. (توجه داشته باشید که این کار همه application poolها و وب‌سایت‌های IIS را restart می‌کند. اگر وب‌سایت‌ها و applicationهای دیگری روی این سرور host می‌کنید، بهتر است فقط application pool مربوطه را restart کنید).