Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Testlink 1.7 installation and configuration document

Installation in windows platform
Installing Apache 2.2.4, Mysql 5.0.45 and PHP 5.2.4 on Windows XP
1. Setting up a directory structure 2. Download and install Apache2.2.4 3. Download and install PHP 5.2.4 4. Configuring Apache 5. Download and install Mysql 5.0.45 6. Install mysqlyog and connect to database 7. Download Testlink application from the symphony site. 8. Configuring Testlink 9. Additional Information 10. Conclusion

1. Setting up a directory structure:

First, let's make a directory where you can put PHP, Apache and MySQL. To avoid any potential problems, it's best to create this directory on a path that does not have any spaces. D:\ProgramFiles (makes sure it is different from C:\Program Files and it is also good practice to avoid spaces because few scripting language wont support installation for ex: Active Perl) Pick something similar for yourself, and create your folder. Inside that folder, create a folder called PHP. Simple enough: now on to the good stuff.

2. Download and install Apache 2.2.4:

Click the following link and download the Apache2.2.4: http://archive.apache.org/dist/httpd/binaries/win32/

Created by: Usha Kannappan

Page 1

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Search for the following msi( windows installer) apache_2.2.4-win32-x86-no_ssl.msi

Step 1: Now we're ready to install. Double-click the installer.

Created by: Usha Kannappan

Page 2

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 2: Click the next button in the Installation Wizard

Step 3: Accept the License agreement and click the next button

Created by: Usha Kannappan

Page 3

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 4: Provide the Server information details in the window. Domain Name : i3v.COM Server Name : The computer name Administrators Email id: Provide administrator email id. (If any error or problem in application you will get the information asking the user to contact the administrator For Ex: Please contact usha.kannappan@gmail.com

Step 5: Choose "Custom" and press "Next".

Created by: Usha Kannappan

Page 4

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 6: On the following screen you will see the default path of Apache to installs. Click the "Change..." , and choose the D:\ProgramFiles folder (or whatever other name you chose) you made when you created the directory structure above. Click "Next". Created by: Usha Kannappan Page 5 11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 7: Continuation

Step 8: Create a folder Apache Software Foundation\Apache2.2.The directory structure is like this: D:\ProgramFiles\Apache Software Foundation\Apache2.2\

Created by: Usha Kannappan

Page 6

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 9: Click the install button and proceed further for installation.

Step 10: You can see the status of Installation status in the Installation wizard. Created by: Usha Kannappan Page 7 11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 11: Once the installation has been completed, you will be getting the following window. Click finish. Congratulation, apache 2.2.4 installation has been successfully finished.

Step 12:

Created by: Usha Kannappan

Page 8

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Let's make sure it worked. Go to your programs folder in the Start menu and find the Apache HTTP Server folder. Go to the Control Apache Server folder, and start Apache

If you installed Apache as a service, you can also start it by double-clicking on the Apache Service Monitor tray icon (which looks like: ) and pressing the "Start" button in the window that appears. If you did not install it as a service, you will see a blank command prompt window appear while Apache is running. This is normal. The first time you run Apache, you will probably see a security warning pop up:

Created by: Usha Kannappan

Page 9

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

This is because windows has detected that Apache is opening a port on your computer, and it is checking with you about whether it should let Apache continue. Click the "Unblock" button to allow Apache to function. Now, let's open up a web browser and make sure Apache is running. Type in the name of your server (e.g. local host, or your domain name or IP address) in the location bar of the browser. http://localhost/ or http://localhost:8080/

Created by: Usha Kannappan

Page 10

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

If so, you're ready to move on. If not, something is wrong. It is hard to be sure what, but it might help to ask for assistance in the ERT forum. Otherwise, your best bet is to uninstall Apache and try again. Before proceeding to forum, check whether the following fields are having correct data and also these are the lines where user can modify. Listen 80 Port 80 ServerType standalone ServerName i3v.COM:80 ServerAdmin Usha.Kannappan@gmail.com

3. Download and install PHP 5.2.4:

Click any one of the following link and download php-5.2.4-Win32.zip (ZIP file) http://fresh.t-systems-sfr.com/pc/src/www/php-5.2.4-Win32.zip/ http://in.php.net/get/php-5.2.4-Win32.zip/from/a/mirror

The PHP documentation is very good; I encourage you to read it over a bit before proceeding, or if you get stuck/confused below. It may seem easier to use the installer, but as you work with PHP, you will probably want to enable several extensions that are not enabled by default, and this is much simpler if you have installed PHP manually. Created by: Usha Kannappan Page 11 11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

After the zip file downloads, place it in your D:\ProgramFiles directory, and unzip it there. When it is done decompressing all the files, you can delete the zip file. Now your PHP is in D:\ProgramFiles\php-5.2.4-Win32 For PHP to work with Apache and to make the CLI available from any command prompt window, we need to add the PHP folder to the PATH environment variable. To do this, right click on your "My Computer" icon (either on your desktop or the start menu) and select "Properties." In the window that pops up, select the advanced tab, and click on the "Environment Variables" button.

Created by: Usha Kannappan

Page 12

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

In the window that appears, select the "Path" variable line from the "System Variables" menu, and click edit:

Created by: Usha Kannappan

Page 13

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) At the end of the "Variable Value" field, type a semicolon (;) and the type in the full path to your PHP folder. For me, this means typing the following at the end of the "Variable Value" field: ; D:\ProgramFiles\php-5.2.4-Win32

Hit OK in each window until they have all closed, and restart your computer. Pick up back here when you've restarted. OK, you restarted and you're back. Let's make sure PHP is working. Go to Start->Run and type cmd and press OK to bring up a command window. At the command prompt, type php -v and press Enter. If you updated the PATH varaible correctly, you should see something like:

Created by: Usha Kannappan

Page 14

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

If you get an error message like, "php is not recognized as an internal or external command, operable program or batch file" go back and check to make sure you completed all the steps of adding your PHP folder to your PATH variable, and that you typed the file path correctly. Now open you PHP folder, and change the name of the file php.ini-recommended to php.ini. The settings in this file are all pretty much exactly as they should be. If you are installing Apache and PHP on your own system for testing purposes, it is probably a good idea to open your php.ini file in a text editor, and change the setting on or about line 357 from display_errors = Off to display_errors = On so that you will see any errors generated by your scripts and will be able to easily debug them. If you are planning on making your server public, it is best to leave this setting Off, because displaying errors can expose information about your file system, databases, and server configuration that should be kept private. Either way, the setting on line 367, log_errors = On will ensure that you will have a log of errors that you can review. Make the following changes to the file: doc_root =D:\ProgramFiles\Apache Software Foundation\Apache2.2\htdocs extension_dir = "D:\ProgramFiles\php-5.2.4-Win32\ext" Save the php.ini file and close it. You can find more information about configuring PHP in the Runtime Configuration section of the PHP manual.

4. Configuring Apache
Now that we've got PHP and Apache working separately, we need to get them to work together. Go to your Apache2.2/conf folder, and open up the httpd.conf file in a text editor. You can get Apache to run PHP as either a CGI binary, or an Apache Module. Generally speaking, it is faster and more secure to do the latter, which you do by adding the following to your httpd.conf file: 1. At the top of the LoadModule section, starting around line 130, adds the line LoadModule php5_module "D:/ProgramFiles/php-5.2.4Win32/php5apache2_2.dll" Created by: Usha Kannappan Page 15 11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) (Note those are forward slashes, not backslashes, in the path) where you replace "D:/ProgramFiles/php-5.2.4-Win32/php5apache2.dll" with the path to php5apache2.dll on your computer. You can actually add settings anywhere you would like, but putting the similar ones together helps keep things organized.

2. In the AddType section around line 754, add the following line: AddType application/x-httpd-php .php You can add other extensions besides .php if you want PHP to parse other file types as well. For example, if you want to be able to include PHP in .html documents: I recommend everyone to add the following line in their httpd file. AddType application/x-httpd-php .php .html .phtml .pwml .php3 .php4 .inc

3. In Testlink application, we are going to open an index.php file not index.html. So add the following line, so that when you click the Testlink folder, it will automatically point to the index.php.

Created by: Usha Kannappan

Page 16

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) DirectoryIndex index.html index.shtml index.wml index.pwml index.php index.php3 index.php4

4. Finally, add the following line, somewhere that seems sensible to you: PHPIniDir "D:/ProgramFiles/php-5.2.4-Win32/" (Again, replace the path I used with the one you chose on your computer). Note: If Apache does not seem to recognize your PHPIniDir directive, make sure you have the trailing slash (i.e. not PHPIniDir "PHPIniDir D:/ProgramFiles/php-5.2.4-Win32/"), as mentioned in the user comments in the PHP manual Save the httpd.conf file, and start Apache as discussed above (or restart it if it is running). Open your Apache2.2htdocs folder. This is the root folder for all of your web server documents that you will view in your web browser. Start by erasing all the default files currently in there. Next, make a file called phpinfo.php that contains the following: <?php phpinfo(); ?> and save it in your htdocs folder. Now open a web browser and go to http://localhost/phpinfo.php. You should see a page that looks like

If not, make sure that all the lines that you added to your httpd.conf file are exactly as they appear above (including the trailing slashes where applicable), and that all paths are correct. Created by: Usha Kannappan Page 17 11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

5. Download and install Mysql 5.0.45

Download mysql-essential-5.0.45-win32.msi from any of the following sites. http://findfiles.com/list.php?string=mysql-essential-5.0.45win32.msi&size=23975424&db=Mirrors http://download.softagency.net/MySQL/Downloads/MySQL-5.0/

Make a MySQL folder in your ProgramFiles directory. Run Setup.exe. Click "Next" at the first screen.

Created by: Usha Kannappan

Page 18

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 1: Double click the mysql-essential-5.0.45-win32.msi. It will start the windows installer.

Step 2: Click next and proceed for further installation process

Created by: Usha Kannappan

Page 19

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 3: Choose custom radio button then choose the directory where you want to download the mysql. (D:\ProgramFiles\MySQL5.0). After choosing the directories click back and choose custom. Click next and proceed for installation

Step 4: Click Install to proceed for installation.

Created by: Usha Kannappan

Page 20

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 5: You can see the installation process in the next window.

Step 6: Click next

Created by: Usha Kannappan

Page 21

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 7: Click finish Now you finished installation but you need to configure mysql.

Step 8: MySQL Configuration file wizard will open after your setup wizard. Click Next to proceed

Created by: Usha Kannappan

Page 22

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 9: Select Detailed Configuration and click Next button.

Step 10: Next you will be getting a server type wizard. Choose Developer machine then click Next button.

Created by: Usha Kannappan

Page 23

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 11: Choose Multifunctional Database and click Next

Step 12: Click next and proceed further installation.

Created by: Usha Kannappan

Page 24

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 13: Click if the no. of concurrent connection is less than 20 then go for Decision support (DSS)/OLAP. If the no. of concurrent connection is 500 at a time (load is heavy) then go for Online Transaction Processing (OLTP) If the no. of concurrent connection is neither 20 or else not heavy like 500 then go for manual testing. In this documentation, I had chosen Decision support (DSS)/OLAP.

Step 14: Now you have to set the network port. By default MySQL you will be having 3306 port, if in your machine some other Database server is using 3306 port then go for different PORT(3307, 3308,3309). In this documentation, I am using 3308.

Created by: Usha Kannappan

Page 25

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 15: Click next to proceed.

Created by: Usha Kannappan

Page 26

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step 16: Now you will be getting Windows option window, where you can set the name for mysql service (By default MySQL). Click next to proceed.

Note that you can use the Apache Service monitor to start and stop MySQL (and other services). On the next screen, pick a root password. This is the main "superuser" password for your server: I gave root as the password. Now your mysql is having the following information UserName : root Password : root Port : 3308

Created by: Usha Kannappan

Page 27

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Step: 17: Continuation

Step 18: Finally, click the "Execute" button to configure your MySQL server:

Created by: Usha Kannappan

Page 28

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Its not a big deal if you do not configure your server right at first, you can always run the config wizard again later. It is in your MySQLbin folder, MySQLInstanceConfig.exe. If MySQL has been successfully installed, you will get mysql directory in Start Menu programs.

In order to verify whether MySQL is working fine or not. Click the MySQL Command Line Client in the Start Menu program Enter the password of MYSQL (Password is root), you will getting details of MYSQL.

Created by: Usha Kannappan

Page 29

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

1. Restart (this is so your PATH variable gets updated). 2. Uncomment the line extension=php_mysql.dll (around line 650) in your php.ini and (re)start Apache. [php.ini is in D:\ProgramFiles\php-5.2.4Win32\php.ini] 3. Copy libmysql.dll from D:\ProgramFiles\php-5.2.4-Win32\ext and paste it in C:\WINDOWS\system32 4. Have a look at your phpinfo.php file. If you sucessfully set up MySQL, it should have a section that looks like this:

Created by: Usha Kannappan

Page 30

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

That's all. Remember to use MySQL with PHP, it has to be running, and you need to create users, tables etc. for PHP to work with. Once MySQL is running, you can access it via the command line by typing mysql -u root -p and entering your root password (which you set during the MySQL installation) when prompted. You can also access the mysqladmin command this way to add other users to your databases (there is also a command line connection option in the MySQL section of your program list in the Start menu). Note: Some time, you cannot able to include mysql in PHP , the problem will be either the php_mysql.dll is a corrupted one. Try to download php_mysql.dll for php-5.2.4-Win32 or else delete all php_mysql.dll from your system completely except from the following location D:/ProgramFiles/php-5.2.4-Win32/ext.

Download Testlink :

Created by: Usha Kannappan

Page 31

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Download the testlink from the sourceforge.net, http://sourceforge.net/project/showfiles.php?group_id=90976 http://sourceforge.net/project/showfiles.php?group_id=90976&package_id=216115

Unzip and paste the testlink in root directory(ie. Paste the Testlilnk in D:\ProgramFiles\ Apache Software Foundation\Apache2.2\htdocs\Testlink) Now open any browser (ex: Internet explorer , mozilla firefox) and type the following to access Testlink http://localhost/Testlink/ http://ipaddress/Testlink/

Created by: Usha Kannappan

Page 32

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Enter all the required information in the field. Especially Database username and password(root, admin) and enter the Database name. The testlink will create a database in mysql for the testlink and give connection to the testlilnk.

Created by: Usha Kannappan

Page 33

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Created by: Usha Kannappan

Page 34

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Created by: Usha Kannappan

Page 35

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Created by: Usha Kannappan

Page 36

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Created by: Usha Kannappan

Page 37

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Congratulation!!!! Testlink has been successfully installed and now you can start exploring the Testlink in your application.

Additional Information:
Some user they are little difficult in using mysql in command prompt. For those user, Sqlyog is a very good tool. SQL yog is nothing but an editor for Mysql. The following is the way to install and start using sql yog.

6. Install mysqlyog and connect to database:

About SQLYOG: SQLyog is a compact Win32 Front End for the MySQL database server. The program is aimed at users that are familiar with SQL statements and need an easy to use, no fuss, and graphical interface to execute SQL queries Click the following link to download SQLYog. http://www.freedownloadscenter.com/Utilities/Misc__Utilities/SQLyog.html

Created by: Usha Kannappan

Page 38

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 1: Double click the SQLyog40.exe which will start the installer. Click Next to proceed.

Created by: Usha Kannappan

Page 39

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 2: Accept the license agreement then click Next button

Step 3:

Created by: Usha Kannappan

Page 40

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP) Choose the location to install the sqlyog. As per the document, I installed the sqlyog in D:\ProgramFiles\ and create a folder SQLYOG then click install.

Step 4: Installation has been successfully finished. Click Finish to terminate.

Step 5: After the installation has been completed, you can see the sqlyog shortcut in desktop and also in start menu. Click the sqylog. Now you will be getting the following screen. Click ok and proceed to make connection to the database. Created by: Usha Kannappan Page 41 11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Step 6: Click New button and give some name for Server Connections. The second step is give the host address value (i.e) If you are planning to open the sqlyog in the installed server machine, then you can give localhost. Suppose if you want to connect to the server machine then give the IPaddress of the server machine. UserName is root(default value). Password is the value which you gave while installing the mysql. In this document , we gave root and mysql port is 3306.

Created by: Usha Kannappan

Page 42

11/6/2008

Testlink-Installation Instruction (Configuring Apache, MySQL and PHP)

Now the user can able to view the testlink database and the tables present in the Database. 2 . Common Errors and how to avoid it: 1. Sometimes you will be getting an error message, Fatal error, your maximum execution time of 30 seconds exceeded the limit. In that case check you have to modify your php.ini file which is located in the following location. D:/ProgramFiles/php-5.2.4-Win32/php.ini. Search for max_execution time=30 seconds

Created by: Usha Kannappan

Page 43

11/6/2008