آماده‌سازی سرور Windows برای نصب

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

برای نصب 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 استفاده کنید، این مورد به‌صورت خودکار نصب می‌شود.

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

برای استفاده از 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 شما سازگار باشد.

اگر 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.

برای reload کردن PHP، وب‌سرور IIS را restart کنید. ساده‌ترین راه این است که سرویس World Wide Web Publishing را restart کنید. برای این کار، برنامه Services را از Administrative Tools باز کنید و سرویس را restart کنید. (توجه داشته باشید که با این کار همه IIS application poolها و وب‌سایت‌ها restart می‌شوند. اگر وب‌سایت‌ها و applicationهای دیگری روی این سرور میزبانی می‌کنید، بهتر است فقط application pool مربوطه را restart کنید).