برای نصب TestRail روی یک سیستم Windows Server، دستورالعمل‌های زیر را دنبال کنید. برای اطلاعات بیشتر درباره سیستم‌عامل‌ها و سرورهای پشتیبانی‌شده، الزامات نصب را بررسی کنید.
توصیه می‌کنیم از پکیج‌های یکپارچه PHP/Apache/MySQL برای Windows، مانند XAMPP، استفاده نکنید. در عوض، همان‌طور که در ادامه توضیح داده شده است، برای بهترین عملکرد و پایداری در محیط‌های Windows بهتر است از IIS، PHP با FastCGI، و SQL Server استفاده کنید. گزینه جایگزین، استفاده از Linux، Apache، و MySQL است؛ هر دو محیط به‌خوبی کار می‌کنند.
آماده‌سازی سرور
برای نصب TestRail روی سرور، به یک web server، یک پایگاه‌داده SQL یعنی SQL Server یا MySQL، یک پایگاه‌داده NoSQL یعنی Cassandra ۳.۱۱، و یک محیط PHP فعال نیاز دارید. روی Windows Server، TestRail با web server مایکروسافت یعنی IIS و PHP پیکربندی‌شده برای اجرا با FastCGI بهترین عملکرد را دارد. ساده‌ترین روش نصب PHP روی Windows استفاده از Web Platform Installer مایکروسافت است.
برای نصب PHP با Web Platform Installer، در بالای پنجره، تب Products را انتخاب کنید و سپس پکیج‌های زیر را انتخاب کنید؛ برای این کار روی دکمه Add کنار هر پکیج کلیک کنید:
- PHP 7.3.x یا PHP 7.4.x
- Microsoft Drivers 5.8 for PHP 7.3 for SQL Server in IIS یا Microsoft Drivers ۵.۸ for PHP 7.4 for SQL Server in IIS
TestRail برای اتصال به پایگاه‌داده‌های SQL Server به پکیج SQL driver نیاز دارد. سپس با کلیک روی دکمه Install هر دو پکیج و همه وابستگی‌های آن‌ها، مانند خود IIS، را نصب کنید. دقت کنید نسخه کامل IIS را نصب کنید، نه IIS Express.
اگر نمی‌خواهید برای نصب PHP از Web Platform Installer استفاده کنید، Microsoft روش نصب دستی PHP روی IIS 6 و IIS 7 را هم توضیح داده است. هنگام نصب دستی PHP، باید Microsoft SQL Server Driver for PHP را نیز نصب کنید. این driver نیاز دارد SQL Server Native Client نصب شده باشد؛ اگر از Web Platform Installer استفاده کنید، این مورد به‌صورت خودکار نصب می‌شود.
نصب دستی PHP، یعنی نصب خارج از Web Platform Installer، خارج از محدوده پشتیبانی TestRail است.
نصب پیش‌نیازها
برای استفاده از TestRail روی Windows با پایگاه‌داده SQL Server، extensionهای PHP زیر لازم هستند:
- extension sqlsrv برای PHP جهت دسترسی به پایگاه‌داده‌های SQL Server
- extension curl برای PHP جهت بررسی updateها و موارد مشابه
- PHP extension مربوط به json برای فایل‌های پیکربندی و integrationها
- PHP extension مربوط به mbstring برای کار با رشته‌های Unicode
- ionCube PHP loader برای decode کردن فایل‌های PHP مربوط به TestRail
- PHP extension مربوط به zlib که امکان خواندن و نوشتن فایل‌های فشرده gzip (.gz) را به‌صورت transparent فراهم می‌کند (فقط برای مشتریان Enterprise لازم است).
- PDO_Dblib extension برای اجرای صحیح Phinx
همچنین باید درایور Cassandra را نصب کنید تا با سیستم‌عامل محل نصب TestRail شما سازگار باشد.
برای اطلاعات بیشتر درباره پیش‌نیازهای Cassandra و نصب/پیکربندی کامل آن، به دستورالعمل‌های نصب Cassandra مراجعه کنید.
اگر PHP را طبق توضیحات بالا با Web Platform Installer نصب کرده باشید، بیشتر extensionها باید به‌صورت خودکار اضافه شده باشند، اما لازم است مراحل اضافی مربوط به Cassandra و IonCube را هم انجام دهید. اگر PHP را به‌صورت دستی نصب کرده‌اید، ممکن است لازم باشد extensionهای موردنیاز را در فایل PHP.ini به این شکل فعال کنید:
extension=php_sqlsrv.dll
extension=php_curl.dll
extension=php_json.dll
extension=php_mbstring.dll
extension=php_pdo_sqlsrv.dllآخرین PHP extension موردنیاز، ionCube PHP loader رایگان است. می‌توانید ionCube loader را برای Windows از اینجا دانلود کنید. برای اینکه بدانید کدام نسخه را باید دانلود کنید، جدول زیر را ببینید.
| نسخه PHP | IonCube Loader |
|---|---|
| 7.3 & 7.4 | Windows VC15 (Non-TS) (32 bits) Windows VC15 (Non-TS) (64 bits) |
بعد از دانلود و استخراج فایل‌ها روی سرور، extension مربوط به loader نسخه PHP خودتان را، مثلا ioncube_loader_win_7.۳.dll، در دایرکتوری ext مربوط به PHP کپی کنید (معمولا C:\\Program Files (x86)\\PHPv7.۳\\ext یا مسیری مشابه). سپس با اضافه کردن خط زیر به فایل PHP.ini، extension را فعال کنید (لطفا مسیر دایرکتوری را متناسب با محیط خود تنظیم کنید و برای جداکننده مسیر از دو backslash استفاده کنید). باید مسیر کامل فایل را وارد کنید. فایل PHP.ini را می‌توانید در دایرکتوری نصب PHP پیدا کنید (معمولا C:Program Files (x86)PHP7.۳ یا مسیری مشابه):
zend_extension =
"C:\\\\Program Files\\\\PHP\\\\v7.3\\\\ext\\\\ioncube_loader_win_7.3.dll"برای بررسی اینکه ionCube loader extension با موفقیت نصب شده است، دستور php -v را در Windows Command Prompt اجرا کنید (برای اجرای این دستور باید ابتدا به دایرکتوری نصب PHP بروید).
اگر خروجی php -v چیزی شبیه نمونه زیر باشد، یعنی ionCube loader extension با موفقیت نصب شده است (به خط ionCube PHP Loader توجه کنید):
PHP 7.3.25 (cli) (built: Nov 24 2020 13:41:31) ( NTS MSVC15 (Visual C++ 2017) x64 )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.25, Copyright (c) 1998-2018 Zend Technologies
with the ionCube PHP Loader v10.4.5, Copyright (c) 2002-2020, by ionCube Ltd.برای اینکه IIS بتواند extension را load کند، ممکن است لازم باشد permission فایل extension مربوط به ionCube را تغییر دهید. برای این کار، در Explorer روی فایل راست‌کلیک کنید، Properties را بزنید، تب Security را انتخاب کنید و گروه Users را اضافه کنید.
برای reload کردن PHP، وب‌سرور IIS را restart کنید. ساده‌ترین راه این است که سرویس World Wide Web Publishing را restart کنید. برای این کار، برنامه Services را از Administrative Tools باز کنید و سرویس را restart کنید. (توجه داشته باشید که با این کار همه IIS application poolها و وب‌سایت‌ها restart می‌شوند. اگر وب‌سایت‌ها و applicationهای دیگری روی این سرور میزبانی می‌کنید، بهتر است فقط application pool مربوطه را restart کنید).