Installation instruction of Testlink

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 won’t 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 Administrator’s 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 quot;Customquot; and press quot;Nextquot;. 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 quot;Change...quot; , and choose the D:ProgramFiles folder (or whatever other name you chose) you made when you created the directory structure above. Click quot;Nextquot;. 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 FoundationApache2.2”.The directory structure is like this: D:ProgramFilesApache Software FoundationApache2.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 quot;Startquot; 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 quot;Unblockquot; 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:ProgramFilesphp-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 quot;My Computerquot; icon (either on your desktop or the start menu) and select quot;Properties.quot; In the window that pops up, select the advanced tab, and click on the quot;Environment Variablesquot; 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 quot;Pathquot; variable line from the quot;System Variablesquot; 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 quot;Variable Valuequot; 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 quot;Variable Valuequot; field: ; D:ProgramFilesphp-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, quot;php is not recognized as an internal or external command, operable program or batch filequot; 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:ProgramFilesApache Software FoundationApache2.2htdocs extension_dir = quot;D:ProgramFilesphp-5.2.4-Win32extquot; 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 quot;D:/ProgramFiles/php-5.2.4- Win32/php5apache2_2.dllquot; 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 quot;D:/ProgramFiles/php-5.2.4-Win32/php5apache2.dllquot; 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 quot;D:/ProgramFiles/php-5.2.4-Win32/quot; (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 quot;PHPIniDir D:/ProgramFiles/php-5.2.4-Win32/quot;), 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.45- win32.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 quot;Nextquot; 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:ProgramFilesMySQL5.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 quot;superuserquot; 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 quot;Executequot; 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:ProgramFilesphp-5.2.4- Win32php.ini] 3. Copy libmysql.dll from D:ProgramFilesphp-5.2.4-Win32ext and paste it in C:WINDOWSsystem32 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 FoundationApache2.2htdocs”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) 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

Installation instruction of Testlink

by usha kannappan on Nov 06, 2008

Accessibility

Categories

Upload Details

Usage Rights

1 Embed 28

Statistics

Installation instruction of Testlink Document Transcript