BLUEPRINT TEAM REPOSITORY Installation Guide for Windows For Requirements Center & Requirements Center Test Definition
Table Of Contents Contents Table of Contents Getting Started... 3 About the Blueprint Team Repository Installation Guide... 3 Before You Begin... 3 Installation Tasks... 3 Downloading the Installation Files... 4 Install a Java Virtual Machine... 4 Disable Microsoft IIS... 5 Installation... 5 Installing the Blueprint Team Repository... 5 Installing the Web Server... 9 Installing the Repository... 14 Confirming a Successful Repository Installation... 22 Configuring the Team Repository for LDAP User Authentication... 23 Next Steps... 24 Configuring Requirements Center... 24 Troubleshooting... 25 Installation reports that port for Apache is in use... 25 Co-Installation with Microsoft IIS... 26 Configuring the Server Port... 27 Restart Apache... 28 2009, Blueprint Software Systems Inc. All rights reserved. No part of this document may be reproduced in any form or by any means without written permission from Blueprint Software Systems Inc. Trademarks used in this document is the property of their respective owners. The information in this document is subject to change without notice and should not be construed as a commitment by Blueprint Software Systems Inc. While all reasonable care has been taken to ensure accuracy, Blueprint assumes no responsibility for errors that may appear in this document. If you would like to order additional copies of this guide contact support@blueprintsys.com 2
Getting Started Getting Started About the Blueprint Team Repository Installation Guide In this guide, you ll find the following information and instructions: A planning section with links to the system requirements. Instructions for installing Blueprint Team Repository v1.0 for Windows. Hypertext links in this guide are identified with blue text. Most links will take you to a topic in this guide. Other links take you to an outside site such as the Blueprint Worldwide Customer Support web site. To continue viewing this guide, switch your active application back to Adobe Reader. Before You Begin Retrieve the Blueprint Team Repository Hardware and Software Requirements document from the Blueprint Worldwide Customer Support web site: Updates to Blueprint Team Repository software and documentation are made available periodically. Please check the Blueprint Worldwide Customer Support Downloads web site for updates and select the appropriate files. Microsoft IIS For a successful installation, we recommend uninstalling or temporarily disabling Microsoft IIS from your system prior to installation of the Blueprint Team Repository. Installation of the Blueprint Team Repository will not succeed otherwise. Apache Web Port & Microsoft IIS The default port for the web server is Port 80. Please see the section on Co-Installation with Microsoft IIS prior to executing the installation of the Blueprint Team Repository. Directories & Filenames: This document uses the directory locations and file names pre-selected by the application. If you select different locations or file names, remember to substitute your own choices when following the instructions. Install User: Ensure that you have administrator rights for the machine on which you re installing. Installation Tasks Installing the Blueprint Team Repository v1.0 for Windows involves the following tasks, each of which is described in more detail in the following pages. 1. Downloading the Team Repository installation files 2. Installing Java Virtual Machine 3. Disabling Microsoft IIS 4. Installing the Team Repository a. Configure preferences b. Install the Web Server c. Install the Repository 5. Confirming a Successful Repository Installation 6. Configuring the team repository for LDAP user authentication (Optional) 3
Getting Started Downloading the Installation Files The installation files that Blueprint currently supports are maintained on our web site. For access, contact your Blueprint Sales or Customer Support representative. 1. Open a web browser and navigate to the web address provided by your Blueprint representative. 2. On the Downloads page, click the link: Blueprint Team Repository for Windows v1.0 to download the software. 3. Record the location of the directory where you saved the file. Install a Java Virtual Machine If a Java Virtual Machine is not detected, the installer will cease the installation process. Please download an appropriate JVM, install, and then re-execute the Blueprint Team Repository Installer. 4
Installation Disable Microsoft IIS If Microsoft IIS Web Server is resident on the host server, you will need to temporarily disable it during the installation of the Blueprint Team Repository. If applicable, follow the instructions to disable the service, otherwise please continue with the Installation. To temporarily disable IIS: 1. Select Start > Control Panel > Administrative Tools > Services. The Windows Service Manager opens. 2. Locate the service named: Windows World Wide Web Service 3. Select Properties then the General tab. 4. If the service is currently running, select the STOP button. 5. Select OK and close the appropriate windows. Installation Installing the Blueprint Team Repository To install the application: 1. Run the installer executable, Btr_install_20090820.exe that you have downloaded and extracted. The Team Repository Installer checks your system for installation of a Java Virtual Machine. If successful, you will be presented the Blueprint Team Repository splash screen. 5
Installation 2. Select the Next button to move through the installation steps. At any time, you can select Previous to move back, or select Cancel to cancel the installation. 3. A License Agreement is presented. Indicate your acceptance of the license and select the Next button to continue. 6
Installation 4. The Installer reviews your system and verifies that all required components are installed. 5. The preferences for the repository alias, repository name, and repository installation location are presented. Accept the default selections by selecting Next or modify your configuration as appropriate. 7
Installation 6. The preferences for the default administrator account are presented. Provide a username and password. Re-enter the password for confirmation. Select Next to continue. 7. A Pre-Installation Summary displays the install folder and shortcut location for your confirmation. If you want to make changes, select Previous and update your settings. Otherwise, select Install to continue with installation of the web server. 8
Installation Web Server Installing the Web Server 1. The Team Repository installer starts the installer for the Apache Web Server. Select Next to continue. 2. The Apache License Agreement is presented. Indicate your acceptance of the license and select the Next button to continue. 9
Installation Web Server 3. The Apache Read This First screen is presented. Select the Next button to continue. 4. The preferences for Server Information are presented. We recommend accepting the default settings. Select the Next button to continue. In the event that you require Apache to use an alternate port other then port 80, please see the section on Co-Installing with Microsoft IIS and/or Configuring the Server Port before continuing. See Table 1: Server Information, on the following page for additional descriptions of these options. 10
Installation Web Server Table 1: Server Information In this window Perform the following action Network Domain Accept the default, or enter localhost or your domain name Server Name Accept the default, or enter localhost, or server name, or IP Address Administrator s Email Accept the default or enter the administrator s email address Install Apache HTTP Server For All Users, on Port 80, as a Service To use an alternate port, please refer to the section on changing the port before continuing. Complete the installation by accepting the default selections, clicking Next until Finish. 5. The Apache Setup Type screen is presented. Accept the default, Typical, and select the Next button to continue. 11
Installation Web Server 6. The Apache Destination Folder screen is presented. Accept the default install location or select Change and select an alternative install path. Select the Next button to continue. 7. The Apache Ready To Install screen is presented. Select the Install button to continue. 12
Installation Web Server The Apache Installation process begins. 8. Configure the Windows Firewall to allow for the communication protocol and port. Select the Unblock button to continue. Note: Some systems may already be configured to allow this, in which case you will not be presented this dialog. Continue to the next step. 13
Installation Web Server 9. The Apache installation completes. Select the Finish button to continue. Installing the Repository 1. The Team Repository installer starts the installer for the Subversion repository. Select Yes to continue. 14
Installation - Repository 2. The Subversion Welcome screen is presented. Select the Next button to continue. - 3. The Subversion License Agreement screen is presented. Indicate your acceptance of the - license and select the Next button to continue. 15
Installation - Repository 4. The Subversion Information screen is presented. Select the Next button to continue. 16
Installation - Repository 5. The Subversion Select Destination Location screen is presented. Accept the default path or select the Browse button to select an alternative location. Select the Next button to continue. 6. The Subversion Select Start Menu Folder screen is presented. Select the Next button to continue. 17
Installation - Repository 7. The Subversion Select Additional Tasks screen is presented. Ensure the Apache Module: Install and configure Subversion modules is selected for installation. Select the Next button to continue. Note: If the Apache module, Install and configure Subversion modules is not present as seen above, it is most likely that the Apache Web Server was not successfully installed. Please cancel and correct before continuing.- 8. A Ready to Install screen provide a summary of the options selected for the pending installation. If you want to make changes, select < Back and update your settings. 18
Installation - Repository 9. If the summary is acceptable, select Install to continue. 10. A Subversion Information screen is presented with Post installation notes for Subversion. Select Next > to continue. 19
Installation - Repository 11. The Subversion Installation completes. Select the Finish button to complete. The installer creates the repository and required configuration files. 20
Installation - Repository The Team Repository Installation completes. Select the Done button. 21
Installation - Repository Confirming a Successful Repository Installation 1. Launch a web browser. 2. Enter http://<servername>/<alias>/<name> using the values you entered during Step #5 of the Blueprint Team Repository Installation. For a default installation: http://<servername>/blueprint/projects 3. Log in with your administrator credentials as configured in Team Repository Installation. For a default installation: admin, admin 4. If you see the following you have configured the system correctly. 22
Installation - Repository Configuring the Team Repository for LDAP User Authentication The blueprint team repository can optionally be configured to authenticate users against an Active Directory LDAP Server. This configuration should only be performed by a resource familiar with Apache installation and configuration. Configuring LDAP user authentication also requires specific environmental and domain values, and will require the assistance of a network or system administrator. Download Implementing LDAP with the Blueprint Team Repository for detailed instructions. 23
Installation - Repository Next Steps Configuring Requirements Center To configure access to the repository from Requirements Center: 1. Launch Requirements Center. 2. In the Project Explorer, right-click and select Open Repository Browser. 3. In the Repository view, click the Connect to Repository icon. Table 3: Add SVN Repository Location In this window Perform the following action URL In a production environment: http://<servername>/<alias>/<name> where <servername> must be the actual server name or IP Address, <alias> as configured in Step#5, and <name> as configured in Step#5. For a default installation: http://<servername>/blueprint/projects In a standalone installation you can also use localhost for the servername Authentication Select User Credentials User Name Password Enter your username as provided by your administrator Enter your password as provided by your administrator Save Password Check off Save Password For further information on how to use Requirements Center to interact with the Repository, please refer to Chapter 12: Configuration Management and Shared Projects in the Requirements Center User Guide. 24
Troubleshooting Troubleshooting Installation reports that port for Apache is in use If you see either of the following error messages, the port that Apache is attempting to use (port 80), is already in use by another program. See Co-Installation with Microsoft IIS and Configuring the Server Port to remedy this problem. 25
Troubleshooting Co-Installation with Microsoft IIS The default port for the Blueprint Definition Web Server (Apache) is port 80. This is also the standard communication port for Microsoft IIS and other web servers. In order to have a coinstallation of both MS IIS and Apache, an alternate port must be configured for use with the Apache server. The Apache Installer provides an opportunity for the user to select an alternate port, however WE DO NOT RECOMMEND CHANGING THE PORT at this point in the installation process. We recommended installing the Apache Web Server with the default settings and then reconfigure the server port following the installation as this will allow for the installer to setup and configure the Apache Web Server as a Windows Service. Port 80 must be available during the Apache installation process. Therefore MS IIS will need to be temporarily disabled during the Blueprint Team Repository installation process. Selecting the alternate port as provided by the Apache Installer will disable the installer from installing the Apache Web Server as a Windows Service. The Apache Web Server will then require manual start and stop procedures. 26
Troubleshooting Configuring the Server Port 1. Open the Apache configuration file located at: C:\Program Files\Apache Group\Apache2\conf\httpd.conf 2. Search for the line that begins with "Listen". In a default installation, it should read: Listen 80. 3. Edit the Listen directive to listen to another port. i.e. 8088. 4. Save and close the file. 5. Restart Apache (see Restart Apache ) a. Confirm the installation of Apache. b. Open a web browser, and enter: http://<servername>:8088/ c. If successful, the Apache server home page appears 27
Troubleshooting Restart Apache This assumes Apache is running as a Windows Service. 1. Select Start > Programs > Apache HTTP Server 2.0.59 > Control Apache Server > Restart Apache or alternatively: 2. In the system tray, select (left-click) the Apache Control Icon and select Restart or alternatively: 3. In the system tray, select (right-click) the Apache Control Icon, Open the Apache Monitor, and select Restart. Select Exit to close the Monitor. 28