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 کلیک کنید.
#
برای اطلاعات بیشتر، به مستندات رسمی Microsoft مراجعه کنید:
فایلهای رسمی 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 کلیک کنید. سپس روی Add در Actions panel کلیک کنید.
در فیلد Name مقدار زیر را وارد کنید: Index.php و روی OK کلیک کنید. سپس دوباره روی Add کلیک کنید و این بار در فیلد Name مقدار زیر را وارد کنید: Default.php و روی OK کلیک کنید.
#
برای اجرای PHP info diagnostics و بررسی PHP Version، دستورالعملها را دنبال کنید.
نصب پیشنیازها #
برای استفاده از TestRail روی Windows همراه با database SQL Server، اکستنشنهای PHP زیر لازم هستند:
- اکستنشن cassandra برای دسترسی به database نوع NoSQL
- اکستنشن gd در PHP برای ساخت نمودارها
- اکستنشن PHP با نام sqlsrv_81_nts_x64 برای دسترسی به databaseهای SQL Server
- اکستنشن pdo_mysql در PHP برای دسترسی به database
- اکستنشن fileinfo در PHP برای تشخیص نوع فایل و encoding آن
- اکستنشن imagick در PHP برای کار با تصویرها
- اکستنشن mbstring در PHP برای کار با رشتههای Unicode
- اکستنشن curl در PHP برای بررسی بهروزرسانیها و موارد مشابه
- اکستنشن openssl در PHP برای مدیریت اتصالهای SSL
- ionCube PHP loader برای decode کردن فایلهای PHP مربوط به TestRail
برای دانلود،
درایورهای Microsoft 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
برای نصب این اکستنشنها، موارد زیر را به فایلهای php.ini اضافه کنید:
-
- extension=pdo_sqlsrv_81_nts_x64
- extension=sqlsrv_81_nts_x64
این driver به نصب ODBC Driver هم نیاز دارد. package مناسب را دانلود و نصب کنید:
بعد از فعال کردن اکستنشن در فایل تنظیمات PHP.ini و نصب ODBC Driver، لطفاً وبسرور IIS را restart کنید. برای بررسی اینکه اکستنشن با موفقیت load شده است، میتوانید تابع phpinfo() را اجرا کنید. همچنین میتوانید در Command Prompt دستور php -m را اجرا کنید تا مطمئن شوید moduleها فعال هستند.
مستندات رسمی نصب اکستنشن imagick را در اینجا ببینید.
#
برای اطلاعات بیشتر، به دستورالعمل نصب Cassandra مراجعه کنید؛ در آنجا پیشنیازهای Cassandra و مراحل کامل نصب و پیکربندی توضیح داده شده است.
آخرین اکستنشن PHP موردنیاز، 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 کنید و فایل loader extension را در پوشه ext مربوط به PHP کپی کنید؛ این پوشه معمولاً C:\php\ext\ است. سپس با اضافه کردن خط زیر به فایل PHP.ini، extension را فعال کنید. این فایل معمولاً در پوشه نصب PHP، یعنی 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.
#
برای اینکه IIS بتواند این extension را load کند، ممکن است لازم باشد permission فایل ionCube extension را تغییر دهید. برای این کار، در 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 کنید. برای این کار، برنامه Services را از Administrative Tools باز کنید و سرویس را restart کنید. توجه داشته باشید که با این کار همه IIS application poolها و وبسایتها restart میشوند. اگر وبسایتها یا برنامههای دیگری هم روی این سرور میزبانی میکنید، بهتر است فقط application pool مربوطه را restart کنید.
نصب dependency مربوط به Chrome Headless Shell برای گزارشها #
- نصب dependencyها – مطمئن شوید سیستم شما امکان extract کردن فایلهای ZIP را دارد.
- دانلود دستی Chrome Headless Shell – در مرورگر، وبسایت Chrome for Testing را باز کنید و آخرین نسخه stable را دانلود کنید.
- Extract کردن فایل – روی فایل .zip راستکلیک کنید و Extract All را انتخاب کنید.
- انتقال به محل دلخواه – پوشه extractشده را به هر مسیری که میخواهید منتقل کنید؛ برای مثال C:\Program Files\ChromeHeadless. محل binary را یادداشت کنید، چون باید این مسیر را به تنظیمات TestRail اضافه کنید.
