http://docs.gurock.com/ 2012-05-17T13:44:16+02:00 http://docs.gurock.com/ http://docs.gurock.com/lib/tpl/gurock/images/favicon.ico text/html 2011-10-31T09:55:13+02:00 http://docs.gurock.com/testrail-admin/admin-creating-backup?rev=1320051313&do=diff We recommend creating backups of your TestRail installation regularly and especially when upgrading to a new TestRail version. There are three parts that need to be considered when backing up TestRail: the database, the installation files and the attachments. See below for how to backup these application parts. text/html 2011-09-21T18:29:39+02:00 http://docs.gurock.com/testrail-admin/admin-optimizing?rev=1316622579&do=diff TestRail is already designed for high performance out of the box, but there are a few things you can do to optimize the performance of a TestRail installation. Some of these things are easier to implement (such as enabling HTTP compression or using a fast web browser). Other things such as using a dedicated application server or optimizing database performance is usually only needed for larger installations (50 users and more) or when you plan to make many concurrent requests. text/html 2011-10-07T17:46:05+02:00 http://docs.gurock.com/testrail-admin/admin-restoring-backup?rev=1318002365&do=diff This article explains how to restore a TestRail backup in case you need to recover from a hardware failure, if you want to move a TestRail installation to a new server or to migrate a TestRail Hosted account to a local instance. In all these cases you should have a logical (SQL) database backup as well as copies of all file attachments, if any. text/html 2011-03-24T21:59:10+02:00 http://docs.gurock.com/testrail-admin/admin-securing?rev=1301000350&do=diff TestRail was designed and built using best practices to ensure that TestRail is a secure application. To further protect your TestRail installation, using additional mechanisms such as enabling SSL/HTTPS is recommended. Using HTTPS Enabling and using HTTPS for your TestRail web server is an important step to secure your TestRail installation, especially if you are accessing TestRail over unsecure networks (i.e. the Internet). TestRail will work with SSL out of the box, but it's generally recom… text/html 2011-03-24T22:01:43+02:00 http://docs.gurock.com/testrail-admin/admin-staging?rev=1301000503&do=diff Creating a staging server for your TestRail server can make sense if you want to test a TestRail update before deploying it to your production system or if you would like to experiment with the integration options or customizations. This guide explains how to set up a staging server and it also provides some ideas on how to test your TestRail system. Please note that setting up and maintaining a staging server is not a substitute for proper backups. text/html 2010-12-08T18:16:00+02:00 http://docs.gurock.com/testrail-admin/howto-background-task?rev=1291828560&do=diff The TestRail background task is responsible, among other things, for sending out email notifications for test changes if this feature is enabled. The background task is a simple PHP script that needs to be triggered in regular intervals to do its work. The easiest way to do this is to schedule it as a background job with the tools your operating system provides. See below on how to install the background task on Windows and Unix/Linux operating systems. text/html 2011-09-05T17:16:48+02:00 http://docs.gurock.com/testrail-admin/howto-installing-ioncube?rev=1315235808&do=diff The free ionCube PHP loader is required to install and run TestRail on your server. This extension decrypts the protected TestRail PHP files and optimizes their execution. See below to learn how to install ionCube on Windows and Unix/Linux systems. Installing ionCube on Windows You can download the ionCube loader for Windows here (you might need a different version if you didn't install PHP via the Web Platform Installer): text/html 2012-05-06T12:22:28+02:00 http://docs.gurock.com/testrail-admin/howto-installing-php-windows?rev=1336299748&do=diff The easiest way to install PHP on Windows is to use Microsoft's Web Platform Installer. To install PHP with the Web Platform Installer, select the Products tab at the top of the window and select the following packages (by pressing the Add buttons next to the packages): text/html 2010-12-18T16:42:46+02:00 http://docs.gurock.com/testrail-admin/howto-installing-sqlsrv?rev=1292686966&do=diff To connect to a SQL Server database when TestRail is installed on a Windows Server system, you need to install the Microsoft SQL Server Driver for PHP (called sqlsrv). This new extension is a high-performance driver optimized for PHP and SQL Server 2005 and 2008. TestRail doesn't support the legacy SQL Server driver mssql that is still shipped with some PHP distributions. text/html 2011-08-14T11:41:26+02:00 http://docs.gurock.com/testrail-admin/howto-mysql-db?rev=1313314886&do=diff TestRail's installer automatically creates all needed database tables, but you first need to create an empty database and database user. To do this, use your favorite MySQL administration tool (such as phpMyAdmin), or use the mysql command line tool to create the database table and user: text/html 2010-12-08T18:18:43+02:00 http://docs.gurock.com/testrail-admin/howto-running-phpinfo?rev=1291828723&do=diff The phpinfo() function can be used to output a large amount of information about your PHP installation and can be used to identify installation and configuration problems. To run the function, just create a new file called test.php and place it into the root directory of your web server. Now open the file in a text editor and add the following content: text/html 2011-08-14T11:41:26+02:00 http://docs.gurock.com/testrail-admin/howto-sqlserver-db?rev=1313314886&do=diff TestRail's installer automatically creates all needed database tables and initial data in the next step, but you first need to create an empty database and database user. You can either install the free Microsoft SQL Server 2008 Express edition or use a full SQL Server installation. If you download the Express edition, make sure to download and install the version with Advanced Services, as it is very likely that TestRail will make use of the database's full-text search feature in the future. A… text/html 2011-11-18T11:55:56+02:00 http://docs.gurock.com/testrail-admin/installation-requirements?rev=1321613756&do=diff TestRail is a web application that is installed directly on your web or application server. It uses a database (SQL Server or MySQL) to store the application data and requires a working PHP environment to run. Please see below for the exact server requirements and supported versions. text/html 2011-09-05T17:13:23+02:00 http://docs.gurock.com/testrail-admin/installation-unix?rev=1315235603&do=diff Please see below for instructions on how to install TestRail on common Unix-based server systems, including Linux. See the requirements to learn more about supported operating and server systems. Preparing the server As TestRail is a web application (based on PHP), TestRail requires a web server, a database (MySQL) and a working PHP environment to be installed on the server. Installing Linux, Apache, MySQL and PHP (commonly referred to as LAMP) is out of scope of this installation guide. Howev… text/html 2010-12-17T19:42:04+02:00 http://docs.gurock.com/testrail-admin/installation-upgrading?rev=1292611324&do=diff This topic explains how to upgrade an existing TestRail installation to a new version. Please follow these steps to upgrade your TestRail installation. Backup It is strongly recommended to make a backup of your TestRail installation files and TestRail database before upgrading to a newer version. In case there's a problem with the upgrade, a backup is the only way to roll back the changes and revert to your previous (working) installation. We recommend making backups of your TestRail installat… text/html 2012-05-06T12:22:50+02:00 http://docs.gurock.com/testrail-admin/installation-windows?rev=1336299770&do=diff Please see below for instructions on how to install TestRail on a Windows Server system. See the requirements to learn more about the supported operating and server systems. Preparing the server As TestRail is a web application (based on PHP), TestRail requires a web server, a database (SQL Server or MySQL) and a working PHP environment to be installed on the server. On Windows Servers, TestRail works best with Microsoft's IIS web server and PHP configured to run with FastCGI. The easiest wa… text/html 2011-10-06T17:15:00+02:00 http://docs.gurock.com/testrail-admin/start?rev=1317914100&do=diff This TestRail Administration manual explains how to install TestRail on your server and how to troubleshoot server problems. Please do not hesitate to contact us if you have any questions that aren't answered in this guide. * Installation * Requirements * Installation on Windows * Installation on Unix/Linux * Upgrading TestRail