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

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

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

TestRail برای نصب روی سرور به یک web server، یک پایگاه داده SQL (SQL Server)، یک پایگاه داده NoSQL (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 را در مسیر C:\php\ روی سیستم میزبان extract کنید.

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

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

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

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

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

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

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

• extension cassandra برای دسترسی به دیتابیس NoSQL
• PHP extension gd برای ساخت نمودارها
• sqlsrv_81_nts_x64 PHP extension برای دسترسی به دیتابیس‌های SQL Server
• PHP extension pdo_mysql برای دسترسی به دیتابیس
• PHP extension fileinfo برای تشخیص نوع فایل و encoding آن
• PHP extension imagick برای کار با تصاویر
• PHP extension mbstring برای کار با رشته‌های Unicode
• PHP extension curl برای بررسی به‌روزرسانی‌ها و موارد مشابه
• PHP extension openssl برای مدیریت اتصال‌های SSL
• ionCube PHP Loader برای رمزگشایی فایل‌های 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 هم نیاز دارد. پکیج متناسب را دانلود و نصب کنید:

• دانلود پکیج x86
• دانلود پکیج x64

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

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

آخرین 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\ است. سپس با افزودن خط زیر به فایل PHP.ini، این extension را فعال کنید. این فایل معمولاً در دایرکتوری نصب 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 Service را restart کنید. برای این کار، برنامه Services را از Administrative Tools باز کنید و سرویس را restart کنید. توجه داشته باشید که این کار همه IIS application poolها و وب‌سایت‌ها را restart می‌کند. اگر وب‌سایت‌ها یا applicationهای دیگری هم روی این سرور میزبانی می‌کنید، بهتر است فقط application pool مربوطه را restart کنید.