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

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

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

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، میزبان سروری را که می‌خواهید IIS روی آن نصب شود انتخاب کنید و روی Next کلیک کنید. سپس، هنگام انتخاب Server Roles، مطمئن شوید Web Server (IIS)  انتخاب شده است و زیر بخش Web Server > Application Development  مطمئن شوید که CGI  نیز انتخاب شده است، اگر از قبل انتخاب نشده باشد. روی Install کلیک کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

php -i|find "Thread Safety"

پس از extract کردن فایل‌ها، فایل‌های 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 را restart کنید. می‌توانید با اجرای تابع phpinfo(). می‌توانید در Command Prompt دستور php -m را اجرا کنید تا مطمئن شوید ماژول‌ها فعال هستند.

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

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

برای این نصب به فایل «ioncube_loader_win_8.۱.dll» نیاز دارید. این فایل را با دانلود Windows VC16 (Non-TS) (64 bits) فایل 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 service را restart کنید. برای این کار، اپلیکیشن Services را از Administrative Tools باز کنید و این service را restart کنید. توجه داشته باشید که با این کار همه IIS application poolها و وب‌سایت‌ها restart می‌شوند. اگر وب‌سایت‌ها و applicationهای دیگری هم روی این سرور host کرده‌اید، بهتر است فقط application pool مربوطه را restart کنید.