دسته‌ها را مشاهده کنید

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

مدت زمان مطالعه: : 5 دقیقه

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

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

توصیه می‌کنیم از پکیج‌های یکپارچه Windows برای PHP/Apache/MySQL، مثل XAMPP، استفاده نکنید. برای محیط‌های Windows بهتر است از IIS، PHP با FastCGI و SQL Server استفاده کنید تا performance و reliability بهتری داشته باشید؛ جزئیات این روش در ادامه توضیح داده شده است. گزینه جایگزین، استفاده از Linux، Apache و MySQL است، اما هر دو محیط به‌خوبی کار می‌کنند.

آماده‌سازی server #

TestRail برای نصب روی server به یک 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 کلیک کنید.

image8.png

 

گزینه Role-based or feature-based installation را انتخاب کنید و روی Next کلیک کنید.

 

image12.png

از server pool، server host موردنظر را برای نصب IIS انتخاب کنید و روی Next کلیک کنید. سپس هنگام انتخاب Server Roles، مطمئن شوید که Web Server (IIS)  انتخاب شده باشد و در مسیر Web Server > Application Development  مطمئن شوید که CGI  هم انتخاب شده باشد (اگر از قبل انتخاب نشده است). روی Install کلیک کنید.

 

 

image7.png

 

  #

برای اطلاعات بیشتر، به مستندات رسمی Microsoft مراجعه کنید:

 

فایل‌های رسمی PHP را دانلود کنید در قالب .zip.

طبق وضعیت سال ۲۰۲۳، VS16 x64 Non Thread Safe  نسخه پیشنهادی برای دانلود است، چون در مستندات نصب از همین نسخه استفاده می‌شود.

image2.png

 

پس از تکمیل دانلود، فایل‌های فشرده PHP را در مسیر C:\php\ روی سیستم میزبان استخراج کنید.

بخش Environment Variables را ویرایش کنید و یک متغیر سیستمی Path جدید اضافه کنید: C:\php. 

 

image9.png

 

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

 

image13.png

 

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

image11.png

 

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

 

image4.png

 

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

 

image3.png

 

  #

دستورالعمل‌های اجرای PHP info diagnostics و بررسی PHP Version را دنبال کنید.

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

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

  • extension Cassandra برای دسترسی به دیتابیس NoSQL
  • extension gd برای PHP جهت تولید نمودارها
  • extension PHP با نام sqlsrv_81_nts_x64 برای دسترسی به دیتابیس‌های SQL Server
  • extension pdo_mysql برای PHP جهت دسترسی به دیتابیس
  • extension fileinfo برای PHP جهت تشخیص نوع فایل و encoding آن
  • extension imagick برای PHP جهت کار با تصویرها
  • extension mbstring برای PHP جهت کار با رشته‌های Unicode
  • extension curl برای PHP جهت بررسی به‌روزرسانی‌ها و موارد مشابه
  • extension openssl برای PHP جهت مدیریت اتصال‌های SSL
  • ionCube PHP Loader برای decode کردن فایل‌های PHP مربوط به TestRail

فایل PHP Microsoft drivers for 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 کردن فایل‌ها، با توجه به نسخه PHP خود فایل‌های مربوط به 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 web server را restart کنید. برای بررسی اینکه extension با موفقیت load شده است، می‌توانید تابع phpinfo() را اجرا کنید. برای اطمینان از فعال بودن ماژول‌ها، می‌توانید در Command Prompt دستور php -m را اجرا کنید.


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

  #

برای جزئیات بیشتر درباره پیش‌نیازهای Cassandra و نصب/پیکربندی کامل، به دستورالعمل‌های نصب Cassandra مراجعه کنید. 

آخرین extension موردنیاز PHP، ionCube PHP Loader رایگان است. می‌توانید ionCube Loader for Windows را از اینجا دانلود کنید.

این روش نصب به «ioncube_loader_win_8.۱.dll» نیاز دارد؛ این فایل را می‌توانید با دانلود بسته Windows VC16 (Non-TS) (64-bit) با نام 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 کنید. برای این کار، اپلیکیشن Services را از Administrative Tools باز کنید و سرویس را restart کنید. توجه داشته باشید که این کار همه IIS application poolها و وب‌سایت‌ها را restart می‌کند. اگر روی این سرور وب‌سایت‌ها و applicationهای دیگری را host می‌کنید، بهتر است فقط application pool مربوطه را restart کنید.

به‌روزرسانی شده در ۱۴۰۵-۰۴-۱۷

احساسات شما چیست؟

  • خوشحال
  • عادی
  • ناراحت

دیدگاهتان را بنویسید