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

TestRail ۸.۱.۰ برای همه مشتریان نسخه Server در دسترس است. مشتریانی که می‌خواهند به TestRail ۸.۱.۰ ارتقا دهند، می‌توانند فایل‌های نصب را از TestRail Billing Portal دانلود کنند.

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

برای نصب TestRail روی سرور، به یک web server، یک پایگاه داده SQL یعنی SQL Server، یک پایگاه داده NoSQL یعنی Cassandra ۳.۱۱، و یک محیط فعال PHP ۸.۰ یا 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، هاست سروری را که می‌خواهید 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 را ویرایش کنید و مقدار زیر را به متغیر سیستمی Path اضافه کنید: C:\php. 

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

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

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

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

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

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

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

لینک درایورهای PHP Microsoft برای 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 هم نیاز دارد. بسته مناسب را دانلود و نصب کنید:

• بسته x86 را دانلود کنید
• بسته x64 را دانلود کنید

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

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

آخرین PHP extension موردنیاز، 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 فعال کنید. این فایل معمولاً در پوشه نصب PHP، یعنی C:\php\، قرار دارد:

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

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

اگر خروجی دستور php -v چیزی شبیه نمونه زیر باشد، یعنی extension مربوط به ionCube loader با موفقیت نصب شده است. به خط 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 کنید. توجه داشته باشید که این کار همه IIS application poolها و websiteها را restart می‌کند. اگر websiteها یا applicationهای دیگری هم روی این سرور host می‌کنید، بهتر است فقط application pool مربوط را restart کنید.