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 کلیک کنید.
برای اطلاعات بیشتر، به مستندات رسمی Microsoft مراجعه کنید:
فایل‌های رسمی 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 کلیک کنید.
برای اجرای PHP info diagnostics و بررسی PHP Version، دستورالعمل‌ها را دنبال کنید.
نصب پیش‌نیازها
برای استفاده از 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 هم نیاز دارد. بسته مناسب را دانلود و نصب کنید:
بعد از فعال کردن extension در فایل پیکربندی php.ini و نصب ODBC Driver، وب‌سرور IIS را دوباره راه‌اندازی کنید. برای بررسی اینکه extension با موفقیت load شده است، می‌توانید تابع phpinfo() را اجرا کنید. می‌توانید در Command Prompt دستور php -m را اجرا کنید تا مطمئن شوید ماژول‌ها فعال هستند.
مستندات رسمی نصب imagick extension را که در اینجا آمده است دنبال کنید.
برای جزئیات بیشتر درباره پیش‌نیازهای Cassandra و نصب/پیکربندی کامل، به دستورالعمل‌های نصب Cassandra مراجعه کنید.
آخرین 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.برای اینکه IIS بتواند این extension را load کند، ممکن است لازم باشد permission فایل extension مربوط به ionCube را تغییر دهید. برای این کار، در Explorer روی فایل راست‌کلیک کنید، Properties را بزنید، تب Security را انتخاب کنید و گروه Users را اضافه کنید.
بیشتر 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 کنید.