![\"\"](\"https://www.gurock.com/wp-content/uploads/2022/05/Jira20add-on205.png\" "\\"\\"")
![\"\"](\"https://www.gurock.com/wp-content/uploads/2022/05/Jira20add-on207.png\" "\\"\\"")
![\"Jira](\"https://cdn-icons-png.flaticon.com/512/5968/5968875.png\"){kind=icon}
Jira Coverage Check\n\n ℹ️ Important Note:\n
\n\n Starting with TestRail 9.5.1 Server, Cassandra is officially deprecated and enforcement is in place.\n
\n- \n
- \n
\n Admins must first run the Cassandra deprecation script in version 9.4.1 before\n upgrading to more recent versions.\n
\n \n - \n
\n If the script has not been executed, the upgrade to more\n recent\n versions\n will\n be blocked and a warning message will be displayed \n during the upgrade process.\n
\n\n 👉 Please check our\n Cassandra Deprecation\n documentation.\n
\n \n
\n
\n \n
\n\n Preparing the server\n
\n\n TestRail requires a web server, a SQL database (SQL Server) and a working\n PHP\n 8.3 environment to be installed on the server. On Windows Servers,\n TestRail\n works best with Microsoft’s IIS web server and PHP configured to run\n with\n FastCGI.\n
\n\n Installing IIS\n
\n\n To install IIS on Windows Server, run Server Manager. On the Dashboard, under Configure This Local Server, click Add roles and features.\n
\n\n \n
\n
\n Select Role-based or feature-based installation, and\n click\n Next.\n
\n\n
\n \n
\n
\n Select your desired server host to install IIS from the server pool,\n and\n click\n Next. Then, when selecting Server Roles, make sure\n Web Server (IIS) is selected and under\n Web Server > Application Development make sure CGI is\n also selected (if it is not selected already). Click\n Install.\n
\n
\n
\n \n
\n
\n \n
\n\n For more information, please refer to Microsoft’s official documentation:\n
\n \n\n
\n Download the official PHP files in\n .zip format. Use the latest 8.3 version available. \n
\n\n As of 2023, VS16 x64 Non Thread Safe is the recommended\n version to download, as this will be used in the installation documentation.\n
\n\n
\n Once the download is complete, extract the zipped PHP files into\n C:\\php\\ on the host system.\n
\n\n Edit your Environment Variables, and add a new\n Path\n System\n variable C:\\php. \n
\n\n
\n \n
\n
\n Go to the IIS Manager, click on the server host, then\n click\n Handler Mappings, and Add Module Mapping.\n
\n\n
\n \n
\n
\n On the new window, fill in all the fields with the exact information\n shown\n on\n the following image, and then click OK.
\n
\n \n
\n
\n Go back to the server host in the IIS Manager,\n and\n this\n time click Default Document. Click Add\n on the Actions Panel.\n
\n\n
\n \n
\n
\n Fill in the Name field with Index.php and click\n OK. Next, click Add again and\n this\n time\n fill in the Name field with Default.php and click OK.\n
\n\n
\n \n
\n
\n \n
\n\n Follow the\n instructions to run your PHP info diagnostics and check the PHP Version.\n
\n\n Installing the prerequisites\n
\n\n To use TestRail on Windows with a SQL Server database, the following\n PHP\n extensions\n are required:\n
\n- \n
- \n gd PHP extension for generating charts\n \n
- \n sqlsrv_81_nts_x64 PHP extension\n to\n access SQL Server databases\n \n
- \n pdo_mysql PHP extension to access the database\n \n
- \n fileinfo PHP extension for determining file type and encoding\n \n
- \n imagick PHP extension for working with images\n \n
- mbstring PHP extension for working with Unicode strings \n
- curl PHP extension to check for updates etc. \n
- \n openssl PHP extension to handle SSL connections\n \n
- ioncube PHP loader to decode the TestRail PHP files \n
\n
\n Download the\n PHP Microsoft drivers for SQL Server here, and click Download Microsoft Drivers for PHP for SQL Server (Windows).\n
\n Before extracting the files, you must first make sure which Thread Safety you have for your PHP version (ts or nts), otherwise the installation will not work. To see if your version is enabled for Thread Safe or Not Thread Safe, enter the following command:\n
\nphp -i|find \"Thread Safety\"\n Once you have extracted the files, find the corresponding Thread Safety files according to your version and copy the files to your C:\\php\\ext\\ directory. For example:\n
\n- \n
- \n \n
- \n
- php_pdo_sqlsrv_83_nts_x64.dll \n
- php_sqlsrv_83_nts_x64.dll \n
\n
\n To install these extensions, add the following to your php.ini files:\n
\n- \n
- \n \n
- \n
- extension=pdo_sqlsrv_83_nts_x64 \n
- extension=sqlsrv_83_nts_x64 \n
\n
\n
\n The driver also needs the ODBC Driver to be installed. Download the corresponding package and install it:\n
\n- \n
- \n Download the x86 package\n \n
- \n Download the x64 package\n \n
\n
\n After you activate the extension in the PHP.ini configuration file and after you installed the ODBC Driver, please restart your IIS web server. You can check if the extension has been successfully loaded by running the phpinfo() function. You can use the Command Prompt to run ‘php -m’ to confirm the modules are running.
\n
\n
Follow the official imagick extension installation documentation found here.\n
\n
\n The last required PHP extension is the free ionCube PHP loader. You can\n download\n the\n ionCube loader for Windows here.\n
\n\n This installation procedure requires ‘ioncube_loader_win_8.3.dll’, which is found by downloading the Windows VC16 (Non-TS) (64 bits) zip file (ioncube_loaders_win_nonts_vc16_x86-64.zip). Extract all the files on your server, and copy the loader extension to your PHP’s ext directory (usually C:\\php\\ext\\). Next, activate the extension by adding the following line to your PHP.ini file (You can find this file in your installation directory, usually C:\\php\\):\n
\nzend_extension = \"C:\\php\\ext\\ioncube_loader_win_8.3.dll\"\n To verify that the ionCube loader extension has been successfully installed,\n run php -v in the Windows Command Prompt (you need to change\n to\n PHP’s\n installation directory in order to execute this command).\n
\n\n The ionCube loader extension is successfully installed if php -v outputs\n something\n like this (note the ionCube PHP Loader line):\n
\nPHP 8.3.2 (cli) (built: Jan 16 2026 10:12:45) (NTS Visual C++ 2019 x64)\nCopyright (c) The PHP Group\nZend Engine v4.3.2, Copyright (c) Zend Technologies\nwith the ionCube PHP Loader v13.0.2, Copyright (c) 2002-2026, by ionCube Ltd.\n \n
\n\n \n
\n\n In order for IIS to be able to load the extension, you might need\n to\n change\n the permission of the ionCube extension file. To do this, right-click\n the\n file in Explorer, click Properties, select the Security tab, and\n add\n the\n Users group.\n
\n\n \n
\n\n Most extensions should be added automatically, IonCube, and imagick steps.\n If\n you installed PHP manually, you might have to activate the required extensions\n in the PHP.ini file like this:\n
\nzend_extension = \"C:\\php\\ext\\ioncube_loader_win_8.3.dll\"\nextension=gd\nextension=fileinfo\nextension=imagick\nextension=mbstring\nextension=curl\nextension=openssl\nextension=pdo_sqlsrv_83_nts_x64\nextension=sqlsrv_83_nts_x64\n To reload PHP, restart the IIS web server. The easiest way to do this\n is\n to restart\n the World Wide Web Publishing Windows service. You can\n do this\n by opening the Services application from the Administrative Tools and\n restarting\n the service. (Please note that this restarts all IIS application pools\n and\n websites.\n If you are hosting other websites and applications on this server, you\n might\n want to restart the relevant application pool only).\n
\nInstall Chrome Headless Shell Dependency (for Reports)
\n- \n
- \n Install Dependencies - Please ensure that your system\n has\n the ability to unarchive ZIP files.\n \n
- \n Download Chrome Headless Shell Manually - Open the\n Chrome for Testing website\n in a browser and download the latest stable version\n \n
- \n Unzip the File - Right-click the .zip and select\n \"Extract\n All\"\n \n
- \n Move to Desired Location - Move the extracted folder\n anywhere\n (e.g., C:\\Program Files\\ChromeHeadless). Keep note of the location\n where\n you will move the binary, as you will need to add this path to the\n TestRail\n configuration.\n \n
\n