PERFORCE DEFECT TRACKING INTEGRATION README FOR RELEASE 0.4.0 Richard Brooksby, Ravenbrook Limited, 2000-10-30 1. INTRODUCTION This is a beta release of the Perforce Defect Tracking Integration (P4DTI). The primary purpose of this release is to test the software in realistic conditions at real customer sites, to find defects and fix them before the general release in 2001-02. The Perforce Defect Tracking Integration version 0.4 is beta test software, only intended for use during the beta program of the project. The software _will_ be defective. We recommend that you do not rely on the integration in your organization, but we would like you to try it out and let us know about any problems. We are very interested in your feedback on the beta. Please write to . For up-to-date information about releases of the P4DTI, see the releases index . Reports of defects found in releases will be posted there. For general information about the project, see the project front page . The readership of this document is anyone who wants to download and use the Perforce Defect Tracking Integration. This document is not confidential. 2. SUPPORTED CONFIGURATIONS This release supports: - Perforce 2000.2 on any platform; - TeamTrack internal build 4402 (available from Ravenbrook) running on Windows NT 4. - Bugzilla 2.10 Instructions for obtaining the internal TeamTrack build are included in the Administrator's Guide that is installed when you follow the instructions in the "Installation" section below. 3. INSTALLATION 3.1. Installing the TeamTrack integration On the TeamTrack server machine, run the "p4dti-teamtrack-0.4.0.exe" installer program that came with this document. This will unpack the integration. We recommend installing the integration in "C:\Program Files\P4DTI\" but you can ask the installer to put it somewhere else. Then consult the Administrator's Guide (installed by default in "C:\Program Files\P4DTI\sag\index.html") for further instructions. 3.2. Installing the Bugzilla integration On the Bugzilla server machine, unpack the tarball that came with this document using the command: zcat p4dti-bugzilla-0.4.0.tar.gz | tar xvf - Then consult the Administrator's Guide (which unpacks to "p4dti/sag/index.html") for further instructions. 4. RELEASE NOTES 4.1. What's New ???? 4.2. What's Changed Here is a summary of the significant changes made since version 0.3, which was used during the alpha program [RB 2000-11-04]. ???? 5. KNOWN DEFECTS IMPORTANT: Read the defect reports in the releases index . You will find information about defects found _after_ release. There could be vital information there which we couldn't know when we wrote this document. If you don't read the document you might meet the same problems, waste a lot of time, and possibly DESTROY ALL YOUR DATA. This is a list of major defects which were known at the time of release. ???? 6. GETTING SUPPORT Sorry, this alpha release isn't supported in any way by Ravenbrook Limited, Perforce Software, or TeamShare. We _are_ interested in your experiences if you decide to have a go. Please write to the addresses listed in the "Project Contacts" below. 7. PROJECT CONTACTS If you have feedback on this beta software please write to . If you have questions about the project please write to . If you have a comment on the project, you can write to . You can also join the p4dti-discussion mailing list. The goals of the list are: 1. to provide feedback to the project on requirements, design, implementation, etc.; 2. to allow people to exchange information and experience with using and adapting the project; 3. to keep people informed about project progress. To join, send a message with the word "subscribe" in the _body_ to or send the word "help" for general information. Please note that the mailing list will be archived and the archive may be published. A. REFERENCES [RB 2000-11-04] "Perforce Defect Tracking Integration Alpha Programme Report"; Richard Brooksby; Ravenbrook Limited; 2000-11-04; . B. DOCUMENT HISTORY 2000-10-19 RB Created using FreeBSD release documents as a model. 2000-11-08 RB Updated to explain purpose of release 0.3.3. Added references to reports. Improved instructions for obtaining special client and builds. Added a summary of changes. Added readership and confidentiality. 2000-11-20 RB Made it clearer where the Administrator's Guide and the installer file come from. 2000-11-30 RB Partially updated for version 0.4. --- Copyright 2000 Ravenbrook Limited. This document is provided "as is", without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this document. You may make and distribute copies and derivative works of this document provided that (1) you do not charge a fee for this document or for its distribution, and (2) you retain as they appear all copyright and licence notices and document history entries, and (3) you append descriptions of your modifications to the document history. $Id: //info.ravenbrook.com/project/p4dti/branch/2000-11-29/bugzilla-resolution/readme.txt#2 $