Helix SwarmHelix Swarm
Loading...

index.html

  • //
  • guest/
  • hari_krishna_dara/
  • perforce/
  • p4dti/
  • release/
  • 1.4.2/
  • ag/
  • index.html #1
  • View
  • Commits
  • Open Download .zip Download (209 KB) 
  1. <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
  2. <html>
  3. <head>
  4.    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  5.    <meta name="GENERATOR" content="Mozilla/4.73 [en] (WinNT; U) [Netscape]">
  6.    <title>Perforce Defect Tracking Integration Administrator's Guide</title>
  7. <?xml version="1.0" encoding="UTF-8"?>
  8. </head>
  9. <body text="#000000" bgcolor="#FFFFFF" link="#000099" vlink="#660066" alink="#FF0000">
  10.  
  11. <center><i><a href="http://www.ravenbrook.com/project/p4dti/">Perforce
  12. Defect Tracking Integration Project</a></i>
  13. <br>
  14. <hr /></center>
  15.  
  16. <center>
  17. <h1>
  18. Perforce Defect Tracking Integration Administrator's Guide</h1></center>
  19.  
  20. <center>
  21. <address>
  22. <a href="mailto:rb@ravenbrook.com">Richard Brooksby</a>,
  23. <a href="http://www.ravenbrook.com/">Ravenbrook
  24. Limited</a>, 2000-08-10</address></center>
  25.  
  26. <h2>
  27. <a NAME="section-Contents" id="section-Contents"></a>Contents</h2>
  28.  
  29. <ul>
  30. <li>
  31. <a href="#section-1">1. Introduction</a></li>
  32.  
  33. <li>
  34. <a href="#section-2">2. Overview of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></a></li>
  35.  
  36. <ul>
  37. <li>
  38. <a href="#section-2.1">2.1. Installation, configuration, and maintenance</a></li>
  39.  
  40. <li>
  41. <a href="#section-2.2">2.2. How the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  42. works</a></li>
  43.  
  44. <li>
  45. <a href="#section-2.3">2.3. Limitations: will the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  46. work for your organization?</a></li>
  47. </ul>
  48.  
  49. <li>
  50. <a href="#section-3">3. Prerequisites for installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></a></li>
  51.  
  52. <ul>
  53. <li>
  54. <a href="#section-3.1">3.1. Required experience</a></li>
  55.  
  56. <li>
  57. <a href="#section-3.2">3.2. Perforce prerequisites</a></li>
  58.  
  59. <li>
  60. <a href="#section-3.3">3.3. TeamTrack prerequisites</a></li>
  61.  
  62. <li>
  63. <a href="#section-3.4">3.4. Bugzilla prerequisites</a></li>
  64.  
  65. <li>
  66. <a href="#section-3.5">3.5. User accounts</a></li>
  67. </ul>
  68.  
  69. <li>
  70. <a href="#section-4">4. Installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></a></li>
  71.  
  72. <li>
  73. <a href="#section-5">5. Configuring the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  74. Perforce, and the defect tracker</a></li>
  75.  
  76. <ul>
  77. <li>
  78. <a href="#section-5.1">5.1.&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  79. configuration</a></li>
  80.  
  81. <li>
  82. <a href="#section-5.2">5.2. Perforce configuration</a></li>
  83.  
  84. <li>
  85. <a href="#section-5.3">5.3. TeamTrack configuration</a></li>
  86.  
  87. <li>
  88. <a href="#section-5.4">5.4. Bugzilla configuration</a></li>
  89.  
  90. <li>
  91. <a href="#section-5.5">5.5. Starting and stopping the replicator manually</a></li>
  92.  
  93. <li>
  94. <a href="#section-5.6">5.6. Setting up the replicator to start automatically</a></li>
  95.  
  96. <li>
  97. <a href="#section-5.7">5.7. Advanced configuration</a></li>
  98. </ul>
  99.  
  100. <li>
  101. <a href="#section-6">6. Migrating your defect tracking data to the integrated
  102. system</a></li>
  103.  
  104. <ul>
  105. <li>
  106. <a href="#section-6.1">6.1. Migrating from the defect tracker</a></li>
  107.  
  108. <li>
  109. <a href="#section-6.2">6.2. Creating issues in Perforce</a></li>
  110.  
  111. <li>
  112. <a href="#section-6.3">6.3. Migrating to the defect tracker from Perforce
  113. jobs</a></li>
  114. </ul>
  115.  
  116. <li>
  117. <a href="#section-7">7. Testing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></a></li>
  118.  
  119. <ul>
  120. <li>
  121. <a href="#section-7.1">7.1. Taking a single step</a></li>
  122.  
  123. <li>
  124. <a href="#section-7.2">7.2. Testing your configuration</a></li>
  125.  
  126. <li>
  127. <a href="#section-7.3">7.3. Checking data consistency</a></li>
  128. </ul>
  129.  
  130. <li>
  131. <a href="#section-8">8. Training and documentation</a></li>
  132.  
  133. <li>
  134. <a href="#section-9">9. Maintaining the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></a></li>
  135.  
  136. <ul>
  137. <li>
  138. <a href="#section-9.1">9.1. Maintaining the configuration</a></li>
  139.  
  140. <li>
  141. <a href="#section-9.2">9.2. Refreshing jobs in Perforce</a></li>
  142. </ul>
  143.  
  144. <li>
  145. <a href="#section-10">10. Uninstalling the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</a></abbr></li>
  146.  
  147. <li>
  148. <a href="#section-11">11. Troubleshooting and error messages</a></li>
  149.  
  150. <ul>
  151. <li>
  152. <a href="#section-11.1">11.1. Troubleshooting</a></li>
  153.  
  154. <li>
  155. <a href="#section-11.2">11.2. Error messages by identifier</a></li>
  156.  
  157. <li>
  158. <a href="#section-11.3">11.3. Other error messages</a></li>
  159. </ul>
  160.  
  161. <li>
  162. <a href="#section-A">A. References</a></li>
  163.  
  164. <li>
  165. <a href="#section-B">B. Document history</a></li>
  166.  
  167. <li>
  168. <a href="#section-C">C. Glossary</a></li>
  169.  
  170. <li>
  171. <a href="#section-D">D. Table of commands</a></li>
  172. </ul>
  173.  
  174. <h2>
  175. <a NAME="section-1" id="section-1"></a>1. Introduction</h2>
  176. This manual is the Perforce Defect Tracking Integration Administrator's
  177. Guide. It explains how to install, configure, maintain, and administer
  178. the Perforce Defect Tracking Integration (<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>).
  179. <p>This document is intended for&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  180. administrators. Ordinary users of the defect tracker or Perforce should
  181. read the <i><a href="../ug/index.html">Perforce Defect Tracking Integration
  182. User's Guide</a></i>. (For ideas on how to train your users on the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  183. see <a href="#section-8">section 8, "Training and documentation"</a>.)
  184. <p>This guide does not describe the basics of using the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  185. Perforce, or the defect tracker. Read the <i><a href="../ug/index.html">Perforce
  186. Defect Tracking Integration User's Guide</a></i> to understand the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  187. from a user's perspective.
  188. <h2>
  189. <a NAME="section-2" id="section-2"></a>2. Overview of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></h2>
  190.  
  191. <h3>
  192. <a NAME="section-2.1" id="section-2.1"></a>2.1. Installation, configuration,
  193. and maintenance</h3>
  194. To install and run the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  195. you must:
  196. <ol>
  197. <li>
  198. Get and install the required software (<a href="#section-3">section 3</a>).</li>
  199.  
  200. <li>
  201. Ensure you have met the procedural prerequisites for Perforce and your
  202. defect tracker (<a href="#section-3">section 3</a>).</li>
  203.  
  204. <li>
  205. Download and install the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  206. software (<a href="#section-4">section 4</a>).</li>
  207.  
  208. <li>
  209. Configure the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  210. software (<a href="#section-5">section 5</a>).</li>
  211.  
  212. <li>
  213. Migrate defect tracking data from your defect tracker to the integrated
  214. system (<a href="#section-6">section 6</a>).</li>
  215.  
  216. <li>
  217. Test the installation (<a href="#section-7">section 7</a>).</li>
  218.  
  219. <li>
  220. Train the users (<a href="#section-8">section 8</a>).</li>
  221.  
  222. <li>
  223. Go live (<a href="#section-9">section 9</a>).</li>
  224.  
  225. <li>
  226. Maintain the installation (<a href="#section-9">section 9</a>).</li>
  227. </ol>
  228.  
  229. <h3>
  230. <a NAME="section-2.2" id="section-2.2"></a>2.2. How the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  231. works</h3>
  232. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  233. works by taking over the job tracking system of Perforce and making the
  234. defect tracker's records appear as Perforce jobs. Perforce users can work
  235. with jobs more or less as described in the Perforce manuals, and their
  236. changes are reflected in the defect tracker. For more information on how
  237. Perforce handles jobs, see the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4guide/">Perforce
  238. Command Line User's Guide</a></i>.
  239. <p>Perforce has a mechanism for linking jobs to changelists (the <tt>p4
  240. fix</tt> command), to enable you to record the work done for a particular
  241. reason. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  242. makes these links appear in the defect tracker, making it easy to see what
  243. was done or is currently being done to resolve a defect.
  244. <p>The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  245. replicator is a process that copies data between a defect tracker and a
  246. Perforce server to keep each one up to date with changes made in the other.
  247. This approach allows developers to do their routine defect resolution work
  248. entirely from their Perforce client, without using the defect tracker's
  249. interface. It also allows developers to relate their changes to defect
  250. tracking issues.
  251. <p><a href="#figure-1">Figure 1</a> shows how the replicator communicates
  252. with the defect tracking server and the Perforce server.
  253. <p>The replicator maintains a one-to-one relationship between&nbsp;<dfn>issues</dfn>
  254. in the defect tracker's database and&nbsp;<dfn>jobs</dfn> in the Perforce
  255. repository. (An&nbsp;<dfn>issue</dfn> is a unit of work that the defect
  256. tracker tracks; some examples are bugs, change requests, and enhancement
  257. requests.) In other words, each issue has a corresponding job, and vice
  258. versa. The replicator keeps the contents of a configurable set of fields
  259. in the defect tracker's issues the same as the contents of the corresponding
  260. Perforce job, so that editing one edits the other.
  261. <p>The replicator also copies Perforce's links between jobs and changelists
  262. (called "fixes") to the defect tracker's database, and makes them visible
  263. in the defect tracker's user interface. Replication of links from Perforce
  264. to the defect tracker makes it possible to track, record, and check a number
  265. of things; in particular, it makes it possible to track and record the
  266. changes made for each issue, and find out why a change was made in terms
  267. of issues.
  268. <p>The replicator polls the defect tracking server and the Perforce server
  269. at regular intervals to get a list of recent changes, and attempts to propagate
  270. these changes to the other system. If a defect tracker issue is changed
  271. at the same time as the corresponding Perforce job, the replicator sends
  272. an e-mail with the overwritten Perforce job data to the following people:
  273. <ul>
  274. <li>
  275. The person who changed the job in Perforce.</li>
  276.  
  277. <li>
  278. The owner of the defect tracker issue.</li>
  279.  
  280. <li>
  281. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  282. administrator.</li>
  283. </ul>
  284. Most defect trackers have an idea of&nbsp;<dfn>workflow</dfn>--a set of
  285. rules that control who can do what to which issues. The replicator enforces
  286. the defect tracker's workflow by rejecting changes to jobs in Perforce
  287. that are illegal in the defect tracker. When it comes across such a change,
  288. it undoes the change and sends an e-mail message to the user.
  289. <p>The defect tracker manages the defect tracker records (and therefore
  290. the job contents), while Perforce manages the changelists. Neither side
  291. controls the "fixes" relationship--the links between jobs and changelists.
  292. <p><a href="#figure-1">Figure 1</a> shows how the replicator connects to
  293. the Perforce and defect tracker servers.
  294. <center><a NAME="figure-1" id="figure-1"></a>Figure 1. The replication
  295. architecture
  296. <br><img SRC="replication.gif" ALT="Diagram of the replication architecture" / height=335 width=503></center>
  297.  
  298. <h3>
  299. <a NAME="section-2.3" id="section-2.3"></a>2.3. Limitations: will the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  300. work for your organization?</h3>
  301. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  302. won't work well for every organization. In particular, it has the following
  303. limitations:
  304. <ul>If you're using TeamTrack and your workflow is very complex then the&nbsp;<abbr title="Perforce Defect Tracking
  305.   Integration">P4DTI</abbr>
  306. may make mistakes when translating actions in Perforce into actions in
  307. TeamTrack.
  308. <p>(This is because TeamTrack supports operations that can't be represented
  309. in Perforce, such as a "transition" between two states in a workflow. When
  310. someone edits a job in Perforce, the&nbsp;<abbr
  311.   title="Perforce Defect Tracking Integration">P4DTI</abbr>
  312. tries to guess which TeamTrack transition was meant by looking at the state
  313. you started with and the state you ended up in. However, if you have multiple
  314. transitions between the same two states, then it may guess wrongly. See
  315. <a href="#note-workflows">section 3.3.2, item 6</a> for details of workflows
  316. that the&nbsp;<abbr title="Perforce Defect Tracking
  317.   Integration">P4DTI</abbr>
  318. may have trouble with.)
  319. <p>If you have automation that makes very frequent changes to records in
  320. the defect tracker, then users may be unable to edit jobs from Perforce.
  321. <p>(This is because the&nbsp;<abbr title="Perforce Defect Tracking
  322.   Integration">P4DTI</abbr>
  323. works by polling the databases every 10 seconds (by default). If there
  324. are many updates to the defect tracker in this period then the data in
  325. Perforce will be out of date; any attempt to edit out-of-date data is rejected
  326. by the&nbsp;<abbr
  327.   title="Perforce Defect Tracking Integration">P4DTI</abbr>
  328. because that would introduce inconsistencies.)</ul>
  329.  
  330. <h2>
  331. <a NAME="section-3" id="section-3"></a>3. Prerequisites for installing
  332. the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></h2>
  333.  
  334. <h3>
  335. <a NAME="section-3.1" id="section-3.1"></a>3.1. Required experience</h3>
  336. To administer the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  337. you must have the following experience:
  338. <ul>
  339. <li>
  340. Perforce: You need at least two months of Perforce administration experience,
  341. including a working knowledge of Perforce's command line interface. Read
  342. both the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4guide/">Perforce
  343. Command Line User's Guide</a></i> and the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">Perforce
  344. System Administrator's Guide</a></i>.</li>
  345.  
  346. <li>
  347. The Python programming language: You need to know how to use Python to
  348. assign values to variables, but you do not need to be an expert Python
  349. programmer. To acquire a basic familiarity with Python, read the Python
  350. tutorial at &lt;<a href="http://www.python.org/doc/current/tut/tut.html">http://www.python.org/doc/current/tut/tut.html</a>>.</li>
  351.  
  352. <li>
  353. The defect tracker: You must understand how to administer the defect tracker
  354. and how it is configured at your organization, or have someone with that
  355. knowledge on hand when installing, configuring, and testing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.</li>
  356. </ul>
  357.  
  358. <h3>
  359. <a NAME="section-3.2" id="section-3.2"></a>3.2. Perforce prerequisites</h3>
  360.  
  361. <h4>
  362. <a NAME="section-3.2.1" id="section-3.2.1"></a>3.2.1. Software prerequisites</h4>
  363. Before installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  364. you must obtain and install the following software:
  365. <ol>
  366. <li>
  367. Perforce server software of version 2000.2 or later. You can download server
  368. and client upgrades from the Perforce FTP server at &lt;<a href="ftp://ftp.perforce.com/pub/perforce/">ftp://ftp.perforce.com/pub/perforce/</a>>.
  369. Be sure to read the release notes (available from &lt;<a href="http://www.perforce.com/">http://www.perforce.com/</a>>)
  370. before you install. <a href="http://www.perforce.com/perforce/support.html">Contact
  371. Perforce technical support</a> if you need help.</li>
  372.  
  373. <li>
  374. Perforce client software of version 2001.1 or later for every&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  375. user who uses Perforce, and for the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  376. itself.</li>
  377.  
  378. <li>
  379. Perforce licenses for every defect tracker user who is going to work in
  380. Perforce.</li>
  381.  
  382. <li>
  383. A <i>background user license</i> for the replicator. This is a license
  384. for an automatic process, rather than a person. Perforce provides background
  385. licenses free of charge; <a href="http://www.perforce.com/perforce/contact.html">contact
  386. Perforce Customer Service</a> to get one.</li>
  387. </ol>
  388.  
  389. <h4>
  390. <a NAME="section-3.2.2" id="section-3.2.2"></a>3.2.2. Procedural prerequisites</h4>
  391. Before installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  392. you must do the following:
  393. <ol>
  394. <li>
  395. Back up your Perforce repository. For instructions, see the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">Perforce
  396. System Administrator's Guide</a></i>.</li>
  397.  
  398. <li>
  399. Copy out of Perforce any jobs that you want to keep. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  400. takes over the jobs subsystem of Perforce and rewrites the Perforce jobspec,
  401. and you must delete all jobs from your Perforce repository as part of configuring
  402. the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.
  403. For more information, see <a href="#section-5.2.3">section 5.2.3, "Deleting
  404. Perforce jobs"</a>. You might want to enter any active jobs into the defect
  405. tracking system.</li>
  406.  
  407. <li>
  408. Determine the address and port number of your Perforce server. You will
  409. need this information when you configure the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  410. in <a href="#section-5">section 5, "Configuring the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  411. Perforce, and the defect tracker"</a>.</li>
  412. </ol>
  413. It is possible to keep existing issues that are stored in Perforce jobs.
  414. Migration submits all the Perforce job data to the defect tracker, so that
  415. the issues can be replicated back to Perforce, and so appear in both systems.
  416. This requires more experience of Perforce and some Python programming.
  417. See <a href="../aag/index.html#section-4">section 4, "Migrating to the
  418. defect tracker from Perforce jobs"</a>, of the <i><a href="../aag/index.html">Perforce
  419. Defect Tracking Integration Advanced Administrator's Guide</a></i>.
  420. <div class="teamtrack">
  421. <h3>
  422. <a NAME="section-3.3" id="section-3.3"></a>3.3. TeamTrack prerequisites</h3>
  423.  
  424. <h4>
  425. <a NAME="section-3.3.1" id="section-3.3.1"></a>3.3.1. Software prerequisites</h4>
  426. Before installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  427. you must obtain and install the following software:
  428. <ol>
  429. <li>
  430. TeamTrack version 4.5, 5.0, or 5.5. TeamTrack is available for download
  431. from TeamShare's web site &lt;<a href="http://www.teamshare.com/">http://www.teamshare.com/</a>>.
  432. <b>Note
  433. that TeamTrack 5.01 and 5.02 are not supported: you should upgrade to TeamTrack
  434. 5.5.</b></li>
  435.  
  436. <li>
  437. TeamTrack licenses for every Perforce user who will create or own issues.</li>
  438.  
  439. <li>
  440. An extra TeamTrack license for the replicator. TeamShare provides licenses
  441. free of charge for this purpose. Contact your TeamShare sales representative
  442. to get one.</li>
  443.  
  444. <li>
  445. Python 2.0 for Windows, installed on the TeamTrack server machine. Python
  446. 2.0 is available from &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/2000-10-18/Python-2.0/BeOpen-Python-2_0.exe">http://www.ravenbrook.com/project/p4dti/import/2000-10-18/Python-2.0/BeOpen-Python-2_0.exe</a>>.</li>
  447.  
  448. <li>
  449. The Python interface to Windows, installed on the TeamTrack server machine.
  450. This is available from &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/2001/python-win32all-138/win32all-138.exe">http://www.ravenbrook.com/project/p4dti/import/2001/python-win32all-138/win32all-138.exe</a>>.
  451. You can omit this step if you don't plan to do either of the following:</li>
  452.  
  453. <ul>
  454. <li>
  455. log activity to the Windows Event Log; see the <tt><a href="#config-use_windows_event_log">use_windows_event_log</a></tt>
  456. configuration parameter</li>
  457.  
  458. <li>
  459. run the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  460. as a Windows service; see <a href="#section-5.6.2">section 5.6.2</a>.</li>
  461. </ul>
  462. </ol>
  463.  
  464. <h4>
  465. <a NAME="section-3.3.2" id="section-3.3.2"></a>3.3.2. Procedural prerequisites</h4>
  466. Before installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  467. you must do the following:
  468. <ol>
  469. <li>
  470. Back up your TeamTrack database. For instructions, see the <i>TeamTrack
  471. Administrator Manual</i> for your version of TeamTrack.</li>
  472.  
  473. <li>
  474. Obtain Administrator-level access to the TeamTrack server machine.</li>
  475.  
  476. <li>
  477. Ensure you have at least 5MB of free disk space for the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  478. plus space for logs.</li>
  479.  
  480. <li>
  481. Ensure that your TeamTrack users do <i>not</i> have TeamShare's SourceBridge
  482. plug-in installed. SourceBridge prevents the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  483. from working properly.</li>
  484.  
  485. <li>
  486. Ensure that your TeamTrack server is not running on a secure web server
  487. (that is, the URL to connect to TeamTrack starts with <tt>http:</tt>, not
  488. <tt>https:</tt>). The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  489. does not support TeamTrack running on a secure web server.</li>
  490.  
  491. <li>
  492. <a NAME="note-workflows" id="note-workflows"></a>Check the workflows defined
  493. in your TeamTrack database to make sure that they are compatible with the&nbsp;<abbr title="Perforce Defect Tracking
  494. Integration">P4DTI</abbr>.
  495. In particular:</li>
  496.  
  497. <ol type="a">Make sure you don't have two states with the same name in
  498. a project. For example, when using the workflow in <a href="#figure-2">figure
  499. 2</a>, there's no way for a developer using Perforce to resolve the issue
  500. and assign it to the tester. The developer would normally resolve the issue
  501. by changing the status field, but in this workflow the status field doesn't
  502. change. Rename states so that the workflow has unique state names. For
  503. example, in <a href="#figure-2">figure 2</a>, name the second "Assigned"
  504. state "Resolved".
  505. <center><a NAME="figure-2" id="figure-2"></a>Figure 2. Workflow with two
  506. states with the same name
  507. <br><img SRC="workflow1.gif" ALT="Workflow with two states with the samename" / height=52 width=485></center>
  508. Make sure you don't have two transitions between the same two states, in
  509. the same direction. For example, when using the workflow in
  510. <a href="#figure-3">figure
  511. 3</a>, when the developer using Perforce changes the state of the job from
  512. "assigned" to "resolved", the&nbsp;<abbr
  513. title="Perforce Defect Tracking Integration">P4DTI</abbr>
  514. has no way to work out which transition to apply. Simplify the workflow
  515. so that the transition can be deduced from the start state and the end
  516. state. For example, in <a href="#figure-3">figure 3</a> you could have
  517. a single transition from "Assigned" to "Resolved" and require developers
  518. to specify how they resolved the problem in a field in the defect.
  519. <center><a NAME="figure-3" id="figure-3"></a>Figure 3. Workflow with two
  520. transitions between the same two states (in the same direction)
  521. <br><img SRC="workflow2.gif" ALT="Workflow with two transitions between thesame two states (in the same direction)" / height=98 width=486></center>
  522. Make sure you don't have "Update" transitions (transitions from a state
  523. to itself) that are necessary in your workflow. For example, when using
  524. the workflow in <a href="#figure-4">figure 4</a>, there's no way for the
  525. developer to cause the "Assign to tester" transition using Perforce. The
  526. developer would normally resolve the issue by changing the status field,
  527. but in this workflow the status field doesn't change. Simplify the workflow
  528. so that it doesn't rely on "Update" transitions.
  529. <center><a NAME="figure-4" id="figure-4"></a>Figure 4. Workflow with a
  530. necessary "Update" transition
  531. <br><img SRC="workflow3.gif" ALT="Workflow with a necessary&quot;Update&quot; transition" / height=103 width=349></center>
  532. </ol>
  533. In fact these problems only matter when the problematic part of the workflow
  534. needs to be carried out in Perforce. As long as you know that the problematic
  535. part of workflow is only carried out in TeamTrack, then the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  536. will work fine.
  537. <li>
  538. Ensure that the workflows defined in your TeamTrack database do not require
  539. more than one transition in quick succession from Perforce. The<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  540. can't infer more than one transition at once. To avoid this problem, design
  541. your workflow only with only single steps in Perforce. This is usually
  542. straightforward: developers using the Perforce interface only need to transition
  543. issues from, for example, "assigned" to "closed", and not through a series
  544. of states.</li>
  545.  
  546. <li>
  547. Ensure that your users have the same e-mail address in TeamTrack and in
  548. Perforce; see <a href="#section-3.5">section 3.5, "Matching users"</a>.</li>
  549. </ol>
  550. </div>
  551.  
  552. <div class="bugzilla">
  553. <h3>
  554. <a NAME="section-3.4" id="section-3.4"></a>3.4. Bugzilla prerequisites</h3>
  555.  
  556. <h4>
  557. <a NAME="section-3.4.1" id="section-3.4.1"></a>3.4.1. Software prerequisites</h4>
  558. Before installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  559. you must obtain and install the following software:
  560. <ol>
  561. <li>
  562. Bugzilla 2.10, 2.12, 2.14, or 2.14.1. You can download Bugzilla 2.14.1
  563. from &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/2002-01-05/bugzilla-2.14.1/bugzilla-2.14.1.tar.gz">http://www.ravenbrook.com/project/p4dti/import/2002-01-05/bugzilla-2.14.1/bugzilla-2.14.1.tar.gz</a>>.
  564. <b>Note:</b> If you've changed your Bugzilla code, see <a href="#section-5.4.1">section
  565. 5.4.1, "Patching Bugzilla"</a>.</li>
  566.  
  567. <li>
  568. For installing Bugzilla 2.14.1 on Win2000, you will have to tweak some
  569. code to make it work.You can also download Bugzilla 2.14.1 for windows
  570. from &lt;<a href="http://www.parrus.com/project/p4dti">http://www.parrus.com/project/p4dti</a>>.</li>
  571.  
  572. <li>
  573. MySQL 3.22.19 or later. You must be using Bugzilla with this database manager.
  574. Note that Bugzilla itself may not work with MySQL 3.23.29.</li>
  575.  
  576. <li>
  577. Python 1.5.2 or later, installed on the Bugzilla server machine. Python
  578. 1.5.2 sources are available from &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-1.5.2.tar.gz">http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-1.5.2.tar.gz</a>>.
  579. If you build Python from the sources, note that the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  580. requires the optional <tt>syslog</tt> module. An&nbsp;<abbr title="Red Hat Package Manager">RPM</abbr>
  581. of Python 1.5.2 for RedHat Linux 6.2 is available from &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-1.5.2-13.i386.rpm">http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-1.5.2-13.i386.rpm</a>>.
  582. An&nbsp;<abbr title="Red Hat Package Manager">RPM</abbr> of Python 1.5.2
  583. for RedHat Linux 7.0 is available from &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-1.5.2-27.i386.rpm">http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-1.5.2-27.i386.rpm</a>>.</li>
  584.  
  585. <li>
  586. The MySQLdb Python package, release 0.2.2 to 0.9.1, installed on the Bugzilla
  587. server machine. (MySQLdb releases before 0.2.2 are known to be incompatible
  588. with the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>;
  589. MySQLdb releases after 0.9.1 haven't been tested.) MySQLdb 0.9.1 is available
  590. from &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/2001-10-16/MySQL-python-0.9.1/MySQL-python-0.9.1.tar.gz">http://www.ravenbrook.com/project/p4dti/import/2001-10-16/MySQL-python-0.9.1/MySQL-python-0.9.1.tar.gz</a>>.
  591. To build MySQLdb, you need the Python header files, which come with Python
  592. 1.5.2 but are not included in the Python 1.5.2 RPMs mentioned above. They
  593. are included in the python-devel RPMs for RedHat Linux 6.2: &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-devel-1.5.2-13.i386.rpm">http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-devel-1.5.2-13.i386.rpm</a>>
  594. or for RedHat Linux 7.0: &lt;<a href="http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-devel-1.5.2-27.i386.rpm">http://www.ravenbrook.com/project/p4dti/import/1999-04-13/python-1.5.2/python-devel-1.5.2-27.i386.rpm</a>>.
  595. To install bugzilla on win2000 you need to download the Mysql python zip
  596. package, MySQL-python-0.9.1.win32-py2.2.zip from &lt;<a href="http://www.parrus.com/project/p4dti">http://www.parrus.com/project/p4dti</a>>.&nbsp;
  597. Refer to the release notes for the complete software configuration.</li>
  598. </ol>
  599.  
  600. <h4>
  601. <a NAME="section-3.4.2" id="section-3.4.2"></a>3.4.2. Procedural prerequisites</h4>
  602. Before installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  603. you must do the following:
  604. <ol>
  605. <li>
  606. Back up your Bugzilla database. For instructions, see the <i><a href="http://www.mysql.com/documentation/mysql/">MySQL
  607. manual</a></i> (under "Database Backups", section 21.2 at the time of writing).</li>
  608.  
  609. <li>
  610. Back up your Bugzilla code. As part of&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  611. installation, you must apply a patch to Bugzilla (for details, see <a href="#section-5.4.1">section
  612. 5.4.1, "Patching Bugzilla"</a>). A backup of your Bugzilla code is useful
  613. if you need to uninstall the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.</li>
  614.  
  615. <li>
  616. Ensure that you have at least 2MB of free disk space on the Bugzilla server
  617. machine for the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  618. plus space for logs.</li>
  619.  
  620. <li>
  621. Ensure that your users have the same e-mail address in Bugzilla and in
  622. Perforce; see <a href="#section-3.5">section 3.5, "Matching users"</a>.</li>
  623. </ol>
  624. </div>
  625.  
  626. <h3>
  627. <a NAME="section-3.5" id="section-3.5"></a>3.5. User accounts</h3>
  628. You must ensure that the&nbsp;<abbr title="Perforce Defect Tracking
  629. Integration">P4DTI</abbr>
  630. can work out how users in the defect tracker correspond to users in Perforce,
  631. as follows:
  632. <ol>Create an account in each system for each user who needs to use the
  633. integrated system.
  634. <div class="bugzilla">If you are using Bugzilla, create a Bugzilla account
  635. for every user in Perforce.</div>
  636.  
  637. <div class="teamtrack">If you are using TeamTrack, then you must make sure
  638. that every Perforce user who needs to edit or fix defects has an account
  639. in TeamTrack. (If you're short of licenses, then there's no need for other
  640. TeamTrack users to have accounts in Perforce, or for Perforce users who
  641. don't do defect resolution to have accounts in TeamTrack.)</div>
  642. Make sure that each user has the same e-mail address in the defect tracker
  643. and in Perforce. The&nbsp;<abbr title="Perforce Defect
  644. Tracking Integration">P4DTI</abbr>
  645. uses e-mail address to match up users between the two systems.
  646. <p>(This is necessary in the Bugzilla integration where your e-mail address
  647. is used as your userid. In the TeamTrack integration this allows the&nbsp;<abbr title="Perforce Defect Tracking
  648. Integration">P4DTI</abbr>
  649. to work in organizations where users have been assigned different userids
  650. in the two systems.)
  651. <div class="bugzilla">The&nbsp;<abbr title="Perforce Defect Tracking
  652. Integration">P4DTI</abbr>
  653. supports Bugzilla's "emailsuffix" feature (once you've applied the Bugzilla
  654. patch, <a href="#section-5.4.1">section 5.4.1</a>, and turned on the&nbsp;<abbr
  655. title="Perforce Defect Tracking Integration">P4DTI</abbr>
  656. extensions in Bugzilla, <a href="#section-5.4.3">section 5.4.3</a>), so
  657. if you have "emailsuffix" set to "@company.domain", then the user "joe"
  658. in Bugzilla will match a user in Perforce with the e-mail address "joe@company.domain".</div>
  659. </ol>
  660. There are three problems that can occur if the&nbsp;<abbr title="Perforce
  661. Defect Tracking Integration">P4DTI</abbr>
  662. can't match up users properly:
  663. <ul>
  664. <li>
  665. If someone changes a job in Perforce but the&nbsp;<abbr title="Perforce
  666. Defect Tracking Integration">P4DTI</abbr>
  667. can't find a matching user in the defect tracker, then the change to the
  668. job is disallowed (because the defect tracker requires that changes be
  669. made only by users with the right privileges).</li>
  670.  
  671. <li>
  672. If two users in Perforce have the same e-mail address then the<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  673. chooses the first one it finds when matching a user from the defect tracker.
  674. This choice is likely to be incorrect.</li>
  675.  
  676. <li>
  677. If two users in TeamTrack have the same e-mail address then the<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  678. chooses the first one it finds when matching a user from Perforce. This
  679. choice is likely to be incorrect.</li>
  680. </ul>
  681. To help you prevent these problems, each time you start the&nbsp;<abbr
  682. title="Perforce Defect Tracking Integration">P4DTI</abbr>
  683. it sends an e-mail message to the administrator containing a report listing
  684. the unmatched and duplicate users. An example report is shown in <a href="#figure-5">figure
  685. 5</a>. Read reports you receive and fix the problems.
  686. <center><a NAME="figure-5" id="figure-5"></a>Figure 5. Example e-mail sent
  687. when the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  688. starts</center>
  689.  
  690. <br>&nbsp;
  691. <center><table BORDER CELLSPACING=0 CELLPADDING=5 >
  692. <tr>
  693. <td>
  694. <table BORDER=0 CELLSPACING=0 CELLPADDING=0 >
  695. <tr VALIGN=TOP>
  696. <td></td>
  697.  
  698. <td>
  699. <pre>Date: Tue, 2 Oct 2001 15:26:12 +0100 (BST)
  700. From: p4dti-replicator0@company.domain
  701. To: P4DTI administrator &lt;p4dti-admin@company.domain>
  702. Subject: (P4DTI-8669)&nbsp; The P4DTI replicator has started.
  703.  
  704. (P4DTI-8658)&nbsp; This is an automatically generated e-mail from the Perforce Defect
  705. Tracking Integration replicator 'replicator0'.
  706.  
  707. (P4DTI-8669)&nbsp; The P4DTI replicator has started.</pre>
  708. </td>
  709. </tr>
  710.  
  711. <tr VALIGN=TOP>
  712. <td><a NAME="para-3.5.1" id="para-3.5.1" href="#note-3.5.1"></a><a href="#note-3.5.1" name="para-3.5.1" id="para-3.5.1">1</a></td>
  713.  
  714. <td>
  715. <pre>(P4DTI-867X)&nbsp; The following Perforce users do not correspond to defect tracker
  716. users.&nbsp; The correspondence is based on the e-mail addresses in the defect
  717. tracker and Perforce user records.
  718.  
  719. (P4DTI-6302)&nbsp; These Perforce users will appear in TeamTrack as the user (None).
  720. It will not be possible to assign issues to these users.
  721.  
  722. &nbsp; User&nbsp;&nbsp; E-mail address
  723. &nbsp; -----------------------
  724. &nbsp; nickb&nbsp; nickb@client</pre>
  725. </td>
  726. </tr>
  727.  
  728. <tr VALIGN=TOP>
  729. <td><a NAME="para-3.5.2" id="para-3.5.2" href="#note-3.5.2"></a><a href="#note-3.5.2" name="para-3.5.2" id="para-3.5.2">2</a></td>
  730.  
  731. <td>
  732. <pre>(P4DTI-8705)&nbsp; The following defect tracker users do not correspond to Perforce
  733. users.&nbsp; The correspondence is based on the e-mail addresses in the defect
  734. tracker and Perforce user records.
  735.  
  736. (P4DTI-6299)&nbsp; These TeamTrack users will appear as themselves in Perforce even
  737. though there is no such Perforce user.
  738.  
  739. &nbsp; User&nbsp; E-mail address
  740. &nbsp; ------------------------
  741. &nbsp; nb&nbsp;&nbsp;&nbsp; nb@company.domain</pre>
  742. </td>
  743. </tr>
  744.  
  745. <tr VALIGN=TOP>
  746. <td><a NAME="para-3.5.3" id="para-3.5.3" href="#note-3.5.3"></a><a href="#note-3.5.3" name="para-3.5.3" id="para-3.5.3">3</a></td>
  747.  
  748. <td>
  749. <pre>(P4DTI-6379)&nbsp; These Perforce users have duplicate e-mail addresses.&nbsp; They may
  750. have been matched with the wrong TeamTrack user.
  751.  
  752. &nbsp; User&nbsp; E-mail address
  753. &nbsp; ------------------------
  754. &nbsp; root&nbsp; ndl@company.domain
  755. &nbsp; ndl&nbsp;&nbsp; ndl@company.domain</pre>
  756. </td>
  757. </tr>
  758.  
  759. <tr VALIGN=TOP>
  760. <td><a NAME="para-3.5.4" id="para-3.5.4" href="#note-3.5.4"></a><a href="#note-3.5.4" name="para-3.5.4" id="para-3.5.4">4</a></td>
  761.  
  762. <td>
  763. <pre>(P4DTI-6368)&nbsp; These TeamTrack users have duplicate e-mail addresses.&nbsp; They may
  764. have been matched with the wrong Perforce user.
  765.  
  766. &nbsp; User&nbsp;&nbsp; E-mail address
  767. &nbsp; ------------------------
  768. &nbsp; admin&nbsp; rb@company.domain
  769. &nbsp; rb&nbsp;&nbsp;&nbsp;&nbsp; rb@company.domain</pre>
  770. </td>
  771. </tr>
  772. </table>
  773. </td>
  774. </tr>
  775. </table></center>
  776. Notes on <a href="#figure-5">figure 5</a>:
  777. <ol><a NAME="note-3.5.1" id="note-3.5.1" href="#para-3.5.1"></a><a href="#para-3.5.1" id="note-3.5.1" name="note-3.5.1">Section
  778. 1</a> lists Perforce users that couldn't be matched to a user in the defect
  779. tracker (here TeamTrack). Here the user hasn't set their e-mail address
  780. in Perforce: they still have the default.
  781. <p><a NAME="note-3.5.2" id="note-3.5.2" href="#para-3.5.2"></a><a href="#para-3.5.2" id="note-3.5.2" name="note-3.5.2">Section
  782. 2</a> lists defect tracker users that couldn't be matched to a user in
  783. Perforce.
  784. <p><a NAME="note-3.5.3" id="note-3.5.3" href="#para-3.5.3"></a><a href="#para-3.5.3" id="note-3.5.3" name="note-3.5.3">Section
  785. 3</a> lists Perforce users with duplicate e-mail addresses. In this case,
  786. if a defect tracker user had the address &lt;ndl@company.domain> then the&nbsp;<abbr title="Perforce Defect
  787. Tracking Integration">P4DTI</abbr>
  788. may have matched them wrongly. Give each Perforce user a distinct e-mail
  789. address.
  790. <p><a NAME="note-3.5.4" id="note-3.5.4" href="#para-3.5.4"></a><a href="#para-3.5.4" id="note-3.5.4" name="note-3.5.4">Section
  791. 4</a> lists defect tracker users with duplicate e-mail addresses. Give
  792. each defect tracker user a distinct e-mail address.</ol>
  793.  
  794. <h2>
  795. <a NAME="section-4" id="section-4"></a>4. Installing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></h2>
  796. <b>Note:</b> You might want to practice installing and configuring the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  797. using a test Perforce repository and a test defect tracking database before
  798. you try it with your real data. A copy of your real Perforce repository
  799. would be ideal; for instructions on how to make a copy of your repository,
  800. see the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">Perforce
  801. System Administrator's Guide</a></i>.
  802. <p>The installation for p4dti for bugzilla on Win2000 is distributed as
  803. p4dti-bugzillawin-1.4.2.exe. Transfer this to the local machine and run
  804. "p4dti-bugzillawin-1.4.2."
  805. <p>Installing bugzilla on Win2000 to work with P4DTI&nbsp; is a two step
  806. process. Bugzilla-2.14.1 is not supported by the Bugzilla team on Windows.&nbsp;
  807. One needs to tweak the code to make it work. Further, the P4DTI changes
  808. for Bugzilla needs to be applied on top of Bugzilla.
  809. <p>The p4dti-kit-bugzillawin-1.4.2 contains bugzilla code that works with
  810. p4dti but contains only the minimal features. The complete bugzilla code
  811. can be downloaded from <a href="http://www.parrus.com/project/p4dti">http://www.parrus.com/project/p4dti</a>.
  812. <h2>
  813. <a NAME="section-5" id="section-5"></a>5. Configuring the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  814. Perforce, and the defect tracker</h2>
  815. Work through the subsections in the order in which they appear. <b>Do <i>not</i>
  816. attempt to run the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  817. until you have reached the end of this section, or you might end up with
  818. a non-working installation.</b>
  819. <p>To configure the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  820. with Perforce and your defect tracker, you must:
  821. <ol>
  822. <li>
  823. Specify the location of servers and the data you want to appear in Perforce
  824. (<a href="#section-5.1">section 5.1</a>).</li>
  825.  
  826. <li>
  827. Configure Perforce to accept information from the replicator and, optionally,
  828. install triggers to implement access controls (<a href="#section-5.2">section
  829. 5.2</a>).</li>
  830.  
  831. <li>
  832. Enable&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  833. features, such as the ability to view fixes and changelists from the defect
  834. tracker user interface (<a href="#section-5.3">section 5.3</a> for TeamTrack
  835. or <a href="#section-5.4">section 5.4</a> for Bugzilla).</li>
  836.  
  837. <li>
  838. Start the replicator (<a href="#section-5.5">section 5.5</a>).</li>
  839.  
  840. <li>
  841. Set up the replicator to start automatically when the server machine is
  842. rebooted (<a href="#section-5.6">section 5.6</a>).</li>
  843. </ol>
  844.  
  845. <h3>
  846. <a NAME="section-5.1" id="section-5.1"></a>5.1.&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  847. configuration</h3>
  848. To configure the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  849. you edit definitions of Python variables in the file <tt>config.py</tt>
  850. in the installation directory. Edit these definitions according to the
  851. notes below. All variables in the file must have a value.
  852. <h4>
  853. <a NAME="section-5.1.1" id="section-5.1.1"></a>5.1.1. Essential configuration
  854. parameters</h4>
  855.  
  856. <h4>
  857. <a NAME="config-dt_name" id="config-dt_name"></a><tt>dt_name</tt></h4>
  858. Description: The name of the defect tracking system you're integrating
  859. with. Either <tt>"TeamTrack"</tt> or <tt>"Bugzilla"</tt>.
  860. <p>Example: <tt>"TeamTrack"</tt>
  861. <p>Make sure that this variable is set to the appropriate value for your
  862. defect tracker.
  863. <h4>
  864. <a NAME="config-administrator_address" id="config-administrator_address"></a><tt>administrator_address</tt></h4>
  865. Description: The e-mail address of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  866. administrator.
  867. <p>Example: <tt>"p4dti-admin@company.domain"</tt>
  868. <p>The replicator sends error reports to this address. If this is
  869. <tt>None</tt>,
  870. then the replicator never sends e-mail.
  871. <h4>
  872. <a NAME="config-p4_port" id="config-p4_port"></a><tt>p4_port</tt></h4>
  873. Description: The address and port of the Perforce server with which the
  874. replicator communicates.
  875. <p>Example: <tt>"perforce.company.domain:1666"</tt>
  876. <h4>
  877. <a NAME="config-p4_user" id="config-p4_user"></a><tt>p4_user</tt></h4>
  878. Description: The userid that the replicator uses to log in to the Perforce
  879. server.
  880. <p>Example: <tt>"p4dti-replicator0"</tt>
  881. <p>For information about how the replicator logs in to Perforce, see <a href="#section-5.2">section
  882. 5.2, "Perforce configuration"</a>. If you want to add more replicators
  883. later, incorporate the replicator identifier (<a href="#config-rid">rid</a>)
  884. into this userid.
  885. <h4>
  886. <a NAME="config-p4_password" id="config-p4_password"></a><tt>p4_password</tt></h4>
  887. Description: The password the replicator uses to log in to the Perforce
  888. server. If there is no password, specify "" (empty quotes).
  889. <p>Example: <tt>""</tt>
  890. <p>For information about how the replicator logs in to Perforce, see <a href="#section-5.2">section
  891. 5.2, "Perforce configuration"</a>.
  892. <h4>
  893. <a NAME="config-replicator_address" id="config-replicator_address"></a><tt>replicator_address</tt></h4>
  894. Description: The e-mail address from which the replicator sends e-mail.
  895. This address is used in the "From" field of e-mail that the replicator
  896. sends.
  897. <p>Example: <tt>"p4dti-replicator0@company.domain"</tt>
  898. <p>To make it easier for users to get assistance, make this address an
  899. alias for the <a href="#config-administrator_address">administrator e-mail
  900. address (<tt>administrator_address</tt>)</a>. If you are using Bugzilla,
  901. this e-mail address is also used for the replicator's Bugzilla account;
  902. see <a href="#section-5.4.2">section 5.4.2, "Creating a Bugzilla user for
  903. the replicator"</a>.
  904. <h4>
  905. <a NAME="config-smtp_server" id="config-smtp_server"></a><tt>smtp_server</tt></h4>
  906. Description: The address of the SMTP server that the replicator uses to
  907. send e-mail.
  908. <p>Example: <tt>"smtp.company.domain"</tt>
  909. <p>If this is <tt>None</tt>, then the replicator never sends e-mail.
  910. <p>If you need to run the&nbsp;<abbr title="Perforce Defect Tracking
  911. Integration">P4DTI</abbr>
  912. without being connected to a network (for example, if you want to set it
  913. up on a laptop so that you can give a demonstration), set <tt>smtp_server=None</tt>
  914. so that the replicator doesn't try to send e-mail.
  915. <h4>
  916. <a NAME="config-start_date" id="config-start_date"></a><tt>start_date</tt></h4>
  917. Description: The starting point in time for replication.
  918. <p>Example: <tt>"2001-02-10 00:00:00"</tt>
  919. <p>Issues modified after this date are replicated; issues unchanged after
  920. this date are ignored. Must be a string in the form <tt>"YYYY-MM-DD HH:MM:SS"</tt>.
  921. <div class="teamtrack">
  922. <h4>
  923. <a NAME="section-5.1.2" id="section-5.1.2"></a>5.1.2. TeamTrack configuration
  924. parameters</h4>
  925.  
  926. <h4>
  927. <a NAME="config-teamtrack_version" id="config-teamtrack_version"></a><tt>teamtrack_version</tt></h4>
  928. Description: The major version of your TeamTrack server. Specify
  929. <tt>"4.5"</tt>
  930. for TeamTrack 4.5, or <tt>"5.0"</tt> for TeamTrack 5.0 or later.
  931. <p>Example: <tt>"5.0"</tt>
  932. <h4>
  933. <a NAME="config-closed_state-TeamTrack" id="config-closed_state-TeamTrack"></a><tt>closed_state</tt></h4>
  934. Description: The TeamTrack that maps to the "closed" state in Perforce.
  935. Specify <tt>None</tt> if you want the ordinary state mapping rules to apply.
  936. <p>(Note that you must write <tt>None</tt> literally, not the string <tt>"None"</tt>,
  937. which would mean the state called "None").
  938. <p>Example: <tt>"Resolved"</tt>.
  939. <p>Mapping the TeamTrack state that developers use most often to the "closed"
  940. state in Perforce makes using the&nbsp;<abbr title="Perforce Defect
  941. Tracking Integration">P4DTI</abbr>
  942. easier for the developers, because the Perforce user interfaces make it
  943. easier to fix a job to "closed" than any other state. However, if your
  944. workflow already has a state called "Closed", then you can't use this feature;
  945. set <tt>closed_state = None</tt>.
  946. <h4>
  947. <a NAME="config-replicated_fields-TeamTrack" id="config-replicated_fields-TeamTrack"></a><tt>replicated_fields</tt></h4>
  948. Description: A list of the database names of TeamTrack fields that are
  949. replicated in Perforce. The fields <tt>STATE</tt>, <tt>OWNER</tt>, and
  950. <tt>TITLE</tt> are always replicated, so omit those fields when setting
  951. this variable.
  952. <p>Example: <tt>["DESCRIPTION", "PRIORITY", "SEVERITY"]</tt>
  953. <p>For advice on which fields to replicate, and how to find out their database
  954. names, see <a href="#section-5.1.5">section 5.1.5, "Choosing which fields
  955. to replicate"</a>.
  956. <h4>
  957. <a NAME="config-teamtrack_server" id="config-teamtrack_server"></a><tt>teamtrack_server</tt></h4>
  958. Description: The TeamTrack server hostname and (optionally) port with which
  959. the replicator communicates.
  960. <p>Example: <tt>"teamtrack.company.domain"</tt>
  961. <p>If your TeamTrack server is reached on a path other than <tt>/tmtrack/tmtrack.dll?</tt>
  962. then you must specify the full path to the server in this variable. For
  963. example, <tt>"http://server.company.domain/infosystem/teamtrack/tmtrack.dll?"</tt>.
  964. <p>(Note that <tt>"localhost"</tt> won't work, even if the TeamTrack server
  965. is on the local host.)
  966. <h4>
  967. <a NAME="config-teamtrack_user" id="config-teamtrack_user"></a><tt>teamtrack_user</tt></h4>
  968. Description: The user name that the replicator uses to log into TeamTrack.
  969. <p>Example: <tt>"P4DTI-replicator0"</tt>
  970. <p>See <a href="#section-5.3.2">section 5.3.2, "Creating a TeamTrack user
  971. for the replicator"</a>.
  972. <h4>
  973. <a NAME="config-teamtrack_password" id="config-teamtrack_password"></a><tt>teamtrack_password</tt></h4>
  974. Description: The password that the replicator uses to log into TeamTrack.
  975. If there is no password, specify "" (empty quotes).
  976. <p>Example: <tt>""</tt>
  977. <p>See <a href="#section-5.3.2">section 5.3.2, "Creating a TeamTrack user
  978. for the replicator"</a>.
  979. <h4>
  980. <a NAME="config-use_windows_event_log" id="config-use_windows_event_log"></a><tt>use_windows_event_log</tt></h4>
  981. Description: The replicator logs activity to the Windows event log if (and
  982. only if) this is 1.
  983. <p>Example: <tt>1</tt>
  984. <p>If you set this to 1, you must make sure to install the Python interface
  985. to Windows (item 5 in <a href="#section-3.3.1">section 3.3.1</a>, "Software
  986. prerequisites").
  987. <p>Regardless of the setting of this parameter, the replicator also logs
  988. activity to to the standard output and to the <a href="#config-log_file">log
  989. file (<tt>log_file</tt>)</a>.
  990. <p>The replicator can generate very many log messages. So if you set this
  991. parameter to 1, either specify "Overwrite events as needed" in the Windows
  992. Event Viewer on the machine running the replicator, or else set the <tt><a href="#config-log_level">log_level</a></tt>
  993. to a restrictive value like <tt>message.LOG_WARNING</tt>.</div>
  994.  
  995. <div class="bugzilla">
  996. <h4>
  997. <a NAME="section-5.1.3" id="section-5.1.3"></a>5.1.3. Bugzilla configuration
  998. parameters</h4>
  999.  
  1000. <h4>
  1001. <a NAME="config-closed_state-Bugzilla" id="config-closed_state-Bugzilla"></a><tt>closed_state</tt></h4>
  1002. Description: The Bugzilla state that maps to the "closed" state in Perforce.
  1003. Specify <tt>None</tt> if you want the ordinary state mapping rules to apply.
  1004. <p>(Note that you must write <tt>None</tt> literally, not the string <tt>"None"</tt>,
  1005. which would mean the state called "None").
  1006. <p>Example: <tt>"RESOLVED"</tt>.
  1007. <p>Mapping the defect tracker state that developers use most often to the
  1008. "closed" state in Perforce makes using the&nbsp;<abbr title="Perforce
  1009. Defect Tracking Integration">P4DTI</abbr>
  1010. easier for the developers, because the Perforce user interfaces make it
  1011. easier to fix a job to "closed" than any other state. If you specify a
  1012. <tt>closed_state</tt> then the "CLOSED" state in Bugzilla maps to "bugzilla_closed"
  1013. in Perforce.
  1014. <h4>
  1015. <a NAME="config-replicated_fields-Bugzilla" id="config-replicated_fields-Bugzilla"></a><tt>replicated_fields</tt></h4>
  1016. Description: A list of the names of Bugzilla fields that are replicated
  1017. in Perforce. The fields "bug_status", "short_desc", "assigned_to" and "resolution"
  1018. are always replicated, so omit those fields when setting this variable.
  1019. <p>Example: <tt>["longdesc", "priority", "bug_severity", "product"]</tt>
  1020. <p>For advice on which fields to replicate, see <a href="#section-5.1.5">section
  1021. 5.1.5, "Choosing which fields to replicate"</a>.
  1022. <h4>
  1023. <a NAME="config-dbms_host" id="config-dbms_host"></a><tt>dbms_host</tt></h4>
  1024. Description: The host on which the Bugzilla MySQL server is running.
  1025. <p>Example: <tt>"localhost"</tt>
  1026. <p>Set this value to <tt>"localhost"</tt> if the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  1027. and the Bugzilla MySQL server run on the same machine.
  1028. <h4>
  1029. <a NAME="config-dbms_port" id="config-dbms_port"></a><tt>dbms_port</tt></h4>
  1030. Description: The port number on the <a href="#config-dbms_host">database
  1031. host (<tt>dbms_host</tt>)</a>, on which the Bugzilla MySQL server listens.
  1032. <p>Example: <tt>3306</tt>
  1033. <p>MySQL normally listens on port 3306. Change this setting only if you
  1034. have set up MySQL differently. Note that this parameter is expressed as
  1035. a number, not as a string.
  1036. <h4>
  1037. <a NAME="config-dbms_database" id="config-dbms_database"></a><tt>dbms_database</tt></h4>
  1038. Description: The name of the MySQL database in which Bugzilla stores its
  1039. data.
  1040. <p>Example: <tt>"bugs"</tt>
  1041. <p>Normally set to <tt>"bugs"</tt> during Bugzilla installation (see the
  1042. Bugzilla documentation for <a href="http://www.ravenbrook.com/project/p4dti/import/2000-05-09/bugzilla-2.10/bugzilla-2.10/README">2.10</a>,
  1043. <a href="http://www.ravenbrook.com/project/p4dti/import/2001-04-27/bugzilla-2.12/bugzilla-2_12/docs/html/readme.unix.html#AEN379">2.12</a>,
  1044. <a href="http://www.ravenbrook.com/project/p4dti/import/2001-08-29/bugzilla-2.14/bugzilla-2.14/docs/html/stepbystep.html#AEN768">2.14</a>,
  1045. <a href="http://www.ravenbrook.com/project/p4dti/import/2002-01-05/bugzilla-2.14.1/bugzilla-2.14.1/docs/html/stepbystep.html#AEN768">2.14.1</a>).
  1046. Change this setting only if you have set up Bugzilla differently.
  1047. <h4>
  1048. <a NAME="config-dbms_user" id="config-dbms_user"></a><tt>dbms_user</tt></h4>
  1049. Description: The user name that the replicator uses to log in to MySQL
  1050. to use the Bugzilla database.
  1051. <p>Example: <tt>"bugs"</tt>
  1052. <p>Bugzilla normally logs in to MySQL as user <tt>"bugs"</tt> (see the
  1053. Bugzilla documentation for <a href="http://www.ravenbrook.com/project/p4dti/import/2000-05-09/bugzilla-2.10/bugzilla-2.10/README">2.10</a>,
  1054. <a href="http://www.ravenbrook.com/project/p4dti/import/2001-04-27/bugzilla-2.12/bugzilla-2_12/docs/html/readme.unix.html#AEN379">2.12</a>,
  1055. <a href="http://www.ravenbrook.com/project/p4dti/import/2001-08-29/bugzilla-2.14/bugzilla-2.14/docs/html/stepbystep.html#AEN768">2.14</a>,
  1056. <a href="http://www.ravenbrook.com/project/p4dti/import/2002-01-05/bugzilla-2.14.1/bugzilla-2.14.1/docs/html/stepbystep.html#AEN768">2.14.1</a>).
  1057. Change this setting only if you have configured Bugzilla differently, or
  1058. if you want to set up the replicator to log in as a different user.
  1059. <h4>
  1060. <a NAME="config-dbms_password" id="config-dbms_password"></a><tt>dbms_password</tt></h4>
  1061. Description: The password that the replicator uses to log in to MySQL to
  1062. use the Bugzilla database.
  1063. <p>Example: <tt>""</tt>
  1064. <p>Bugzilla normally logs in with no password (see the Bugzilla documentation
  1065. for <a href="http://www.ravenbrook.com/project/p4dti/import/2000-05-09/bugzilla-2.10/bugzilla-2.10/README">2.10</a>,
  1066. <a href="http://www.ravenbrook.com/project/p4dti/import/2001-04-27/bugzilla-2.12/bugzilla-2_12/docs/html/readme.unix.html#AEN379">2.12</a>,
  1067. <a href="http://www.ravenbrook.com/project/p4dti/import/2001-08-29/bugzilla-2.14/bugzilla-2.14/docs/html/stepbystep.html#AEN768">2.14</a>,
  1068. <a href="http://www.ravenbrook.com/project/p4dti/import/2002-01-05/bugzilla-2.14.1/bugzilla-2.14.1/docs/html/stepbystep.html#AEN768">2.14.1</a>).
  1069. Change this setting if you have configured Bugzilla differently, or you
  1070. want to set up the replicator to log in as a different user and use a password.
  1071. <h4>
  1072. <a NAME="config-bugzilla_directory" id="config-bugzilla_directory"></a><tt>bugzilla_directory</tt></h4>
  1073. Description: The directory in which Bugzilla is installed, or <tt>None</tt>
  1074. if you don't want e-mail processed.
  1075. <p>Example: <tt>"/home/httpd/html/bugzilla"</tt>
  1076. <p>Bugzilla sends e-mail to its users when it notices that a bug has been
  1077. changed. If the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  1078. is running on the Bugzilla server, it is able to use Bugzilla's <tt>processmail</tt>
  1079. script to promptly send e-mail in the same way. This configuration parameter
  1080. allows the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  1081. to locate <tt>processmail</tt>. Set it to <tt>None</tt> if the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  1082. is not running on the Bugzilla server or if you don't want the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  1083. to send these e-mail messages.</div>
  1084.  
  1085. <h4>
  1086. <a NAME="section-5.1.4" id="section-5.1.4"></a>5.1.4. Other configuration
  1087. parameters</h4>
  1088. These parameters support advanced or rarely-used features. Most organizations
  1089. can leave these parameters at their default values, at least to start with,
  1090. and then set them later if necessary.
  1091. <h4>
  1092. <a NAME="config-changelist_url" id="config-changelist_url"></a><tt>changelist_url</tt></h4>
  1093. Description: A format string used to build a URL for a changelist. Specify
  1094. <tt>None</tt> if there are no URLs for changelists.
  1095. <p>This is used by the defect tracker to provide a link from a fix to a
  1096. web page providing more information about the changelist that fixed the
  1097. issue. <a href="#figure-6">Figure 6</a> shows how this works in Bugzilla.
  1098. <p>The value must be a format string valid for passing to <tt>sprintf()</tt>;
  1099. it must have one <tt>%d</tt> format specifier, for which the change number
  1100. is substituted. (Note that because the value gets passed to <tt>sprintf()</tt>,
  1101. you must double other percent signs.)
  1102. <p>In order to use this feature, you must have a web application that can
  1103. provide information about changelists. Applications suitable for this include:
  1104. <ul><a href="http://www.perforce.com/perforce/products/p4web.html">P4Web</a>.
  1105. To allow any user to follow the link from the defect tracker to P4Web,
  1106. you need to run it in "browse mode". See the <a href="http://www.perforce.com/perforce/doc.011/manuals/p4web/index.html">P4Web
  1107. documentation</a> for details.
  1108. <p>For P4Web, set <tt>changelist_url</tt> to something like <tt>"http://info.company.domain:8080/%d?ac=10"</tt>.
  1109. <p><a href="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/perfbrowse/">Perfbrowse</a>.
  1110. For Perfbrowse, set <tt>changelist_url</tt> to something like <tt>"http://info.company.domain/cgi/perfbrowse.cgi?@describe+%d"</tt>.</ul>
  1111.  
  1112. <center><a NAME="figure-6" id="figure-6"></a>Figure 6. Effect of <tt><a href="#config-changelist_url">changelist_url</a></tt>
  1113. and <tt><a href="#config-job_url">job_url</a></tt>
  1114. <br><img SRC="changelist_url.gif" ALT="Figure showing the effect of thechangelist_url and job_url configuration parameters on the fixes tablein Bugzilla." / height=324 width=507></center>
  1115.  
  1116. <h4>
  1117. <a NAME="config-job_url" id="config-job_url"></a><tt>job_url</tt></h4>
  1118. Description: A format string used to build a URL for job descriptions.
  1119. Specify <tt>None</tt> if there is no URL for job descriptions.
  1120. <p>This is used by the defect tracker to provide a link from an issue to
  1121. a web page providing more information about the job that corresponds to
  1122. the issue. <a href="#figure-6">Figure 6</a> shows how this works in Bugzilla.
  1123. <p>Example: <tt>"http://info.company.domain/cgi/perfbrowse.cgi?@job+%s"</tt>
  1124. <p>The string is a format string valid for passing to <tt>sprintf()</tt>;
  1125. it must have one <tt>%s</tt> format specifier, for which the job name is
  1126. substituted. (Note that because it gets passed to <tt>sprintf()</tt>, you
  1127. must double other percent signs.)
  1128. <h4>
  1129. <a NAME="config-log_file" id="config-log_file"></a><tt>log_file</tt></h4>
  1130. Description: The name of the replicator's log file. If <tt>None</tt>, messages
  1131. aren't logged to any file. (Note that you must write <tt>None</tt> literally,
  1132. not the string <tt>"None"</tt>, which would mean the file called "None").
  1133. <p>Example: <tt>"C:\\Program Files\\P4DTI-<i>RELEASE</i>\\p4dti.log"</tt>
  1134. <p>The replicator generates log messages to record its actions. These log
  1135. messages are sent to all of the following locations:
  1136. <ul>
  1137. <li>
  1138. The standard output of the replicator.</li>
  1139.  
  1140. <li>
  1141. The system log (under UNIX and Linux).</li>
  1142.  
  1143. <li>
  1144. The event log (under Windows, if <tt><a href="#config-use_windows_event_log">use_windows_event_log</a></tt>
  1145. is 1).</li>
  1146.  
  1147. <li>
  1148. The file specified by the <tt>log_file</tt> configuration parameter (unless
  1149. it's <tt>None</tt>).</li>
  1150. </ul>
  1151.  
  1152. <h4>
  1153. <a NAME="config-log_level" id="config-log_level"></a><tt>log_level</tt></h4>
  1154. Description: The minimum priority level of messages to log. Messages with
  1155. this priority or a higher priority appear in the replicator's log.
  1156. <p>Example: <tt>message.INFO</tt>
  1157. <p>This parameter must be one of these constants:
  1158. <br>&nbsp;
  1159. <table>
  1160. <tr VALIGN=TOP>
  1161. <td><tt>message.ERR</tt></td>
  1162.  
  1163. <td>Errors.</td>
  1164. </tr>
  1165.  
  1166. <tr VALIGN=TOP>
  1167. <td><tt>message.WARNING</tt></td>
  1168.  
  1169. <td>Warnings; that is, features of your system that the replicator can
  1170. work around, but which you should pay attention to. For example, "Table
  1171. 'PROJECTS' has two entries called 'Compiler'.".</td>
  1172. </tr>
  1173.  
  1174. <tr VALIGN=TOP>
  1175. <td><tt>message.NOTICE</tt></td>
  1176.  
  1177. <td>Significant but expected events. For example, "Job 'BUG00001' overwritten
  1178. by issue 'BUG00001'.".</td>
  1179. </tr>
  1180.  
  1181. <tr VALIGN=TOP>
  1182. <td><tt>message.INFO</tt></td>
  1183.  
  1184. <td>Informational messages. For example, "Replicating issue '123' to job
  1185. 'BUG000123'."</td>
  1186. </tr>
  1187.  
  1188. <tr VALIGN=TOP>
  1189. <td><tt>message.DEBUG</tt></td>
  1190.  
  1191. <td>Debugging messages. For example, "Perforce command: 'p4 -G -u p4dti-replicator0
  1192. -p perforce:1666 job -o BUG00001'."</td>
  1193. </tr>
  1194. </table>
  1195.  
  1196. <h4>
  1197. <a NAME="config-p4_client_executable" id="config-p4_client_executable"></a><tt>p4_client_executable</tt></h4>
  1198. Description: The location of the Perforce client executable.
  1199. <p>Example: <tt>"C:\\Program Files\\Perforce\\p4.exe"</tt>
  1200. <p>This setting doesn't need to be an absolute path name if the directory
  1201. is on the replicator user's path. On Windows this setting might be <tt>"C:\\Program
  1202. Files\\Perforce\\p4.exe"</tt>. On UNIX it might be just <tt>"p4"</tt>.
  1203. <p>The client executable named by this parameter must be of version 2000.2
  1204. or later (run the command <tt>p4 -V</tt> to check the client version),
  1205. and it must be the same version as the Perforce server you are connecting
  1206. to. If there's a mismatch between the Perforce client executable and the
  1207. Perforce server, then you might see the error message <a href="#message-Perforce-Error-2">(P4DTI-7087)
  1208. Value for field 'Options' must be one of ...</a>.
  1209. <h4>
  1210. <a NAME="config-p4_server_description" id="config-p4_server_description"></a><tt>p4_server_description</tt></h4>
  1211. Description: A description of the Perforce server. This might be used by
  1212. the defect tracker to show which Perforce server an issue is replicated
  1213. to.
  1214. <p>Example: <tt>"Hardware development group Perforce server"</tt>
  1215. <h4>
  1216. <a NAME="config-poll_period" id="config-poll_period"></a><tt>poll_period</tt></h4>
  1217. Description: The period of time between the end of one poll of the servers
  1218. and the start of the next, in seconds.
  1219. <p>Example: <tt>10</tt>
  1220. <h4>
  1221. <a NAME="config-prepare_issue" id="config-prepare_issue"></a><tt>prepare_issue(issue,
  1222. job)</tt></h4>
  1223. Description: A function that prepares a new issue for submission to the
  1224. defect tracker by providing values for all the required fields.
  1225. <p>See <a href="../aag/index.html#section-3">section 3, "Allowing users
  1226. to create issues in Perforce"</a> in the <i><a href="../aag/index.html">Perforce
  1227. Defect Tracking Advanced Administrator's Guide</a></i> for the full details.
  1228. <h4>
  1229. <a NAME="config-replicate_p" id="config-replicate_p"></a><tt>replicate_p(issue)</tt></h4>
  1230. Description: A function that selects which issues to start replicating.
  1231. Normally, the&nbsp;<abbr title="Perforce Defect Tracking
  1232. Integration">P4DTI</abbr>
  1233. replicates all issues created or modified after the <tt><a href="#config-start_date">start_date</a></tt>,
  1234. but you can modify this function to further restrict the issues.
  1235. <p>See <a href="../aag/index.html#section-2">section 2, "Select the issues
  1236. to replicate"</a> in the <i><a href="../aag/index.html">Perforce Defect
  1237. Tracking Advanced Administrator's Guide</a></i> for the full details.
  1238. <h4>
  1239. <a NAME="config-replicate_job_p" id="config-replicate_job_p"></a><tt>replicate_job_p(job)</tt></h4>
  1240. Description: A function that selects which jobs in Perforce to replicate.
  1241. Normally, the&nbsp;<abbr title="Perforce Defect Tracking
  1242. Integration">P4DTI</abbr>
  1243. ignores jobs created in Perforce, but you can provide this function to
  1244. allow users to create jobs in Perforce and have them replicated to the
  1245. defect tracker.
  1246. <p>See <a href="../aag/index.html#section-3">section 3, "Allowing users
  1247. to create issues in Perforce"</a> in the <i><a href="../aag/index.html">Perforce
  1248. Defect Tracking Advanced Administrator's Guide</a></i> for the full details.
  1249. <h4>
  1250. <a NAME="config-rid" id="config-rid"></a><tt>rid</tt></h4>
  1251. Description: The replicator identifier.
  1252. <p>Example: <tt>"replicator0"</tt>
  1253. <p>Must be 32 characters or less, start with a letter or underscore, and
  1254. consist only of letters, numbers, and underscores.
  1255. <p>The replicator identifier is used to distinguish between replicators
  1256. when multiple replicators are being used to replicate issues from a defect
  1257. tracker to different Perforce servers. If you have only one replicator,
  1258. it doesn't matter what you use for the replicator identifier; <tt>"replicator0"</tt>
  1259. is a good choice since it allows you to add more replicators later.
  1260. <p>If you change the replicator identifier then your currently replicated
  1261. defect tracker issues stop being replicated. The replicator believes they
  1262. are being handled by another replicator.
  1263. <h4>
  1264. <a NAME="config-sid" id="config-sid"></a><tt>sid</tt></h4>
  1265. Description: The Perforce server identifier.
  1266. <p>Example: <tt>"perforce0"</tt>
  1267. <p>Must be 32 characters or less, start with a letter or underscore, and
  1268. consist only of letters, numbers and underscores. You might want to use
  1269. the hostname of your Perforce server, if it is stable.
  1270. <h4>
  1271. <a NAME="config-use_deleted_selections" id="config-use_deleted_selections"></a><tt>use_deleted_selections</tt></h4>
  1272. Description: If this is 1, deleted TeamTrack states and selections appear
  1273. as options for corresponding fields in Perforce. If this is
  1274. <tt>0</tt>,
  1275. they don't appear in the Perforce jobspec or in drop-down menus in P4Win.
  1276. <p>Example: <tt>0</tt>
  1277. <p>Warning: It is risky to set this to <tt>0</tt> because TeamTrack never
  1278. really deletes a state or selection; it just marks it as deleted. So you
  1279. may have issues in TeamTrack that use those deleted states and selections.
  1280. If <tt>use_deleted_selections</tt> is
  1281. <tt>0</tt> then these issues can't
  1282. be replicated to Perforce. If this happens, you'll see errors like these:
  1283. <ul><a href="#message-P4DTI-6255">(P4DTI-6255) No Perforce state corresponding
  1284. to TeamTrack state 'spong'.</a>
  1285. <p>If this happens you can undelete the state in TeamTrack and restart
  1286. the replicator. Or you can change the state of the issue in TeamTrack so
  1287. that it can be replicated.
  1288. <p><a href="#message-Perforce-Error-3">(P4DTI-7087) Value for field 'Severity'
  1289. must be one of Critical/High/Medium/Low/(None).</a>
  1290. <p>If this happens you can undelete the selection in the Severity field
  1291. in TeamTrack and restart the replicator. Or you can change the severity
  1292. of the issue in TeamTrack so that it can be replicated.</ul>
  1293.  
  1294. <h4>
  1295. <a NAME="config-use_perforce_jobnames" id="config-use_perforce_jobnames"></a><tt>use_perforce_jobnames</tt></h4>
  1296. Description: Determines whether the replicator uses Perforce-style jobnames.
  1297. <p>If this parameter is 1, the&nbsp;<abbr title="Perforce Defect Tracking
  1298. Integration">P4DTI</abbr>
  1299. lets Perforce choose the names of the jobs it creates when replicating
  1300. issues from the defect tracker (so jobs will be named job000001, job000002
  1301. and so on). This means that the job name won't match the name of the corresponding
  1302. issue in the defect tracker.
  1303. <p>If this parameter is 0 (the default), the&nbsp;<abbr title="Perforce
  1304. Defect Tracking Integration">P4DTI</abbr>
  1305. tries to match the defect tracker's names for the issues it replicates.&nbsp;<span 
  1306. class="teamtrack">In
  1307. the TeamTrack integration, jobs are called BUG00001, ENH00002, and so on.</span><span class="bugzilla">In
  1308. the Bugzilla integration, jobs are called bug1, bug2, and so on.</span>
  1309. <p>Example: <tt>1</tt>
  1310. <p>If you change this setting, the&nbsp;<abbr title="Perforce Defect
  1311. Tracking Integration">P4DTI</abbr>
  1312. doesn't rename existing jobs, but new jobs get the style of name you requested.
  1313. <h4>
  1314. <a NAME="section-5.1.5" id="section-5.1.5"></a>5.1.5. Choosing which fields
  1315. to replicate</h4>
  1316. Here's some advice on which fields to replicate:
  1317. <ul>
  1318. <li>
  1319. Replicate any fields that the developers are required to fill in, or they
  1320. won't be able to use Perforce to do their work.</li>
  1321.  
  1322. <li>
  1323. Replicate any other fields that the developers need to do their work; see
  1324. the suggestions below.</li>
  1325.  
  1326. <li>
  1327. Don't replicate other fields--the less information developers need to enter,
  1328. the better the quality of that information. Keeping the number of replicated
  1329. fields low might mean modifying your workflows so that unnecessary fields
  1330. can be omitted. For example, you might have a <tt>FIX_DESCRIPTION</tt>
  1331. field for developers to explain what they did. Now that you're running
  1332. the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  1333. you don't need that field--you can look in the change comments of the associated
  1334. changelists to find out what the developer did--so leave it out.</li>
  1335.  
  1336. <li>
  1337. Note that Perforce has no protections for jobs. This means that any user
  1338. of Perforce can read all fields of all the jobs. So if you have confidential
  1339. information in issues, keep that information out of Perforce, for example
  1340. by separating it out into a field that is not replicated.</li>
  1341. </ul>
  1342.  
  1343. <div class="teamtrack">If you're using TeamTrack's sample database, you
  1344. might want to replicate the following fields:
  1345. <ul>
  1346. <li>
  1347. <tt>DESCRIPTION</tt>, so that developers can understand what the problem
  1348. is.</li>
  1349.  
  1350. <li>
  1351. <tt>SEVERITY</tt>, so that developers can prioritize their work.</li>
  1352.  
  1353. <li>
  1354. <tt>PRIORITY</tt>, so that developers can prioritize their work.</li>
  1355. </ul>
  1356. To find out the database name of a TeamTrack field, follow these steps:
  1357. <ol>
  1358. <li>
  1359. Run the TeamTrack administrator. (Under Windows, choose Start > Programs
  1360. > TeamShare > TeamTrack Administrator.)</li>
  1361.  
  1362. <li>
  1363. Select the&nbsp;<span class="gui">Projects</span> tab.</li>
  1364.  
  1365. <li>
  1366. Select a project from the list (but not the base project).</li>
  1367.  
  1368. <li>
  1369. Click the&nbsp;<span class="gui">Edit</span> button.</li>
  1370.  
  1371. <li>
  1372. Select the&nbsp;<span class="gui">Default Fields</span> tab.</li>
  1373.  
  1374. <li>
  1375. Select the desired field from the list.</li>
  1376.  
  1377. <li>
  1378. Click the&nbsp;<span class="gui">Edit</span> button.</li>
  1379.  
  1380. <li>
  1381. Look in the&nbsp;<span class="gui">Database Field Name</span> field in
  1382. the dialog.</li>
  1383. </ol>
  1384. <a href="#table-1">Table 1</a> shows the field types in TeamTrack and indicates
  1385. which ones may be replicated by the&nbsp;<abbr title="Perforce
  1386. Defect Tracking Integration">P4DTI</abbr>.
  1387. <center><a NAME="table-1" id="table-1"></a>Table 1. Supported field types
  1388. in TeamTrack</center>
  1389.  
  1390. <br>&nbsp;
  1391. <center><table BORDER CELLSPACING=0 CELLPADDING=5 >
  1392. <tr VALIGN=TOP>
  1393. <th>Field type</th>
  1394.  
  1395. <th>Field contents</th>
  1396.  
  1397. <th>Replicable by&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>?</th>
  1398. </tr>
  1399.  
  1400. <tr VALIGN=TOP>
  1401. <td><tt>NUMERIC</tt></td>
  1402.  
  1403. <td>Numeric field, integer or floating-point</td>
  1404.  
  1405. <td>Yes</td>
  1406. </tr>
  1407.  
  1408. <tr VALIGN=TOP>
  1409. <td><tt>TEXT</tt></td>
  1410.  
  1411. <td>Text field up to 255 characters</td>
  1412.  
  1413. <td>Yes</td>
  1414. </tr>
  1415.  
  1416. <tr VALIGN=TOP>
  1417. <td><tt>MEMO</tt></td>
  1418.  
  1419. <td>Memo field</td>
  1420.  
  1421. <td>Yes</td>
  1422. </tr>
  1423.  
  1424. <tr VALIGN=TOP>
  1425. <td><tt>DATETIME</tt></td>
  1426.  
  1427. <td>Date/Time field</td>
  1428.  
  1429. <td>Yes</td>
  1430. </tr>
  1431.  
  1432. <tr VALIGN=TOP>
  1433. <td><tt>SELECTION</tt></td>
  1434.  
  1435. <td>Drop down selection field, one selectable</td>
  1436.  
  1437. <td>Yes</td>
  1438. </tr>
  1439.  
  1440. <tr VALIGN=TOP>
  1441. <td><tt>BINARY</tt></td>
  1442.  
  1443. <td>Binary (two-state) field</td>
  1444.  
  1445. <td>Yes</td>
  1446. </tr>
  1447.  
  1448. <tr VALIGN=TOP>
  1449. <td><tt>STATE</tt></td>
  1450.  
  1451. <td>The system-defined state field</td>
  1452.  
  1453. <td>Yes</td>
  1454. </tr>
  1455.  
  1456. <tr VALIGN=TOP>
  1457. <td><tt>USER</tt></td>
  1458.  
  1459. <td>A drop down selection field containing user names</td>
  1460.  
  1461. <td>Yes</td>
  1462. </tr>
  1463.  
  1464. <tr VALIGN=TOP>
  1465. <td><tt>PROJECT</tt></td>
  1466.  
  1467. <td>System-defined project field</td>
  1468.  
  1469. <td>Yes</td>
  1470. </tr>
  1471.  
  1472. <tr VALIGN=TOP>
  1473. <td><tt>SUMMATION</tt></td>
  1474.  
  1475. <td>Calculated summation fields</td>
  1476.  
  1477. <td>No</td>
  1478. </tr>
  1479.  
  1480. <tr VALIGN=TOP>
  1481. <td><tt>MULTIPLE_SELECTION</tt></td>
  1482.  
  1483. <td>Multi-select selection field</td>
  1484.  
  1485. <td>No</td>
  1486. </tr>
  1487.  
  1488. <tr VALIGN=TOP>
  1489. <td><tt>CONTACT</tt></td>
  1490.  
  1491. <td>Contact selection field</td>
  1492.  
  1493. <td>No</td>
  1494. </tr>
  1495.  
  1496. <tr VALIGN=TOP>
  1497. <td><tt>COMPANY</tt></td>
  1498.  
  1499. <td>Company selection field</td>
  1500.  
  1501. <td>Yes</td>
  1502. </tr>
  1503.  
  1504. <tr VALIGN=TOP>
  1505. <td><tt>INCIDENT</tt></td>
  1506.  
  1507. <td>Incident selection field</td>
  1508.  
  1509. <td>No</td>
  1510. </tr>
  1511.  
  1512. <tr VALIGN=TOP>
  1513. <td><tt>PRODUCT</tt></td>
  1514.  
  1515. <td>Product selection field</td>
  1516.  
  1517. <td>Yes</td>
  1518. </tr>
  1519.  
  1520. <tr VALIGN=TOP>
  1521. <td><tt>SERVICEAGREEMENT</tt></td>
  1522.  
  1523. <td>Service Agreement</td>
  1524.  
  1525. <td>Yes</td>
  1526. </tr>
  1527.  
  1528. <tr VALIGN=TOP>
  1529. <td><tt>FOLDER</tt></td>
  1530.  
  1531. <td>Folder link selection field</td>
  1532.  
  1533. <td>No</td>
  1534. </tr>
  1535.  
  1536. <tr VALIGN=TOP>
  1537. <td><tt>KEYWORDLIST</tt></td>
  1538.  
  1539. <td>Keyword multi-select field</td>
  1540.  
  1541. <td>No</td>
  1542. </tr>
  1543.  
  1544. <tr VALIGN=TOP>
  1545. <td><tt>PRODUCTLIST</tt></td>
  1546.  
  1547. <td>Product multi-select field</td>
  1548.  
  1549. <td>No</td>
  1550. </tr>
  1551.  
  1552. <tr VALIGN=TOP>
  1553. <td><tt>PROBLEM</tt></td>
  1554.  
  1555. <td>Problem selection field.</td>
  1556.  
  1557. <td>No</td>
  1558. </tr>
  1559.  
  1560. <tr VALIGN=TOP>
  1561. <td><tt>RESOLUTION</tt></td>
  1562.  
  1563. <td>Resolution selection field</td>
  1564.  
  1565. <td>No</td>
  1566. </tr>
  1567.  
  1568. <tr VALIGN=TOP>
  1569. <td><tt>MERCHANDISE</tt></td>
  1570.  
  1571. <td>Merchandise selection field</td>
  1572.  
  1573. <td>No</td>
  1574. </tr>
  1575.  
  1576. <tr VALIGN=TOP>
  1577. <td><tt>RELATIONAL</tt></td>
  1578.  
  1579. <td>Relational selection field</td>
  1580.  
  1581. <td>No</td>
  1582. </tr>
  1583.  
  1584. <tr VALIGN=TOP>
  1585. <td><tt>SUBRELATIONAL</tt></td>
  1586.  
  1587. <td>Sub-relational selection field</td>
  1588.  
  1589. <td>No</td>
  1590. </tr>
  1591.  
  1592. <tr VALIGN=TOP>
  1593. <td><tt>SYSTEM</tt></td>
  1594.  
  1595. <td>System field</td>
  1596.  
  1597. <td>No</td>
  1598. </tr>
  1599.  
  1600. <tr VALIGN=TOP>
  1601. <td><tt>MULTIPLE_RELATIONAL</tt></td>
  1602.  
  1603. <td>Multiple relational selection field.</td>
  1604.  
  1605. <td>No</td>
  1606. </tr>
  1607. </table></center>
  1608. Attachments such as notes are stored in separate tables in TeamTrack and
  1609. are not replicated by the&nbsp;<abbr title="Perforce Defect Tracking
  1610. Integration">P4DTI</abbr>.
  1611. If you need to have supplementary information replicated to Perforce, use
  1612. a memo field like "Additional Notes". In TeamTrack you can turn any memo
  1613. field into a "journal" field which consists of a list of entries, each
  1614. headed with the date of the entry and the name of user who added it.</div>
  1615.  
  1616. <div class="bugzilla">If you're using Bugzilla, you might want to replicate
  1617. the following fields:
  1618. <ul>
  1619. <li>
  1620. "longdesc", so that developers can understand what the problem is.</li>
  1621.  
  1622. <li>
  1623. "bug_severity", so that developers can prioritize their work.</li>
  1624.  
  1625. <li>
  1626. "priority", so that developers can prioritize their work.</li>
  1627.  
  1628. <li>
  1629. "target_milestone", if you use target milestones, so that developers can
  1630. prioritize their work.</li>
  1631.  
  1632. <li>
  1633. "product", so that developers can categorize their work.</li>
  1634.  
  1635. <li>
  1636. "component", so that developers can categorize their work.</li>
  1637.  
  1638. <li>
  1639. "version", so that developers can categorize their work.</li>
  1640.  
  1641. <li>
  1642. "op_sys", for additional developer information.</li>
  1643.  
  1644. <li>
  1645. "rep_platform", for additional developer information.</li>
  1646.  
  1647. <li>
  1648. "status_whiteboard", for additional developer information.</li>
  1649.  
  1650. <li>
  1651. "keywords", for additional developer information.</li>
  1652. </ul>
  1653. If you're using Bugzilla, the replicator rejects the following types of
  1654. changes from within Perforce:
  1655. <ul>
  1656. <li>
  1657. Any changes to the following types of field:</li>
  1658.  
  1659. <ul>
  1660. <li>
  1661. Fields that cannot be changed in Bugzilla, such as "creation_ts", "delta_ts",
  1662. and "lastdiffed".</li>
  1663.  
  1664. <li>
  1665. Fields that can only be changed in Bugzilla in very restricted ways, such
  1666. as "groupset", "product", "version", "component", "target_milestone", and
  1667. "everconfirmed".</li>
  1668.  
  1669. <li>
  1670. Fields that, when changed in Bugzilla, have complex side-effects that the
  1671. replicator can't sensibly reproduce, such as "votes" and "keywords".</li>
  1672. </ul>
  1673.  
  1674. <li>
  1675. Changes that do anything to the "longdesc" field other than appending to
  1676. it. This field can be used for long descriptions of the bug. When a Bugzilla
  1677. user adds a comment to a bug, it appears at the end of this field. Perforce
  1678. users can also only modify this field by appending to it; any text that
  1679. they append is replicated to Bugzilla as a new comment.</li>
  1680.  
  1681. <li>
  1682. Invalid changes to fields that must contain Bugzilla users, such as "assigned_to",
  1683. "reporter", and "qacontact". These fields may contain a Perforce user name,
  1684. if the Perforce user corresponds to a Bugzilla user, or a Bugzilla user's
  1685. e-mail address. The "qacontact" field may also contain "None". If a Perforce
  1686. user changes one of these fields to some other string, the replicator rejects
  1687. the change.</li>
  1688. </ul>
  1689. The following table lists the field names for Bugzilla 2.10, 2.12, 2.14,
  1690. and 2.14.1. If you have modified Bugzilla, your field names may differ.
  1691. To display the set of Bugzilla field names, type <tt>mysqlshow bugs bugs</tt>
  1692. at a shell prompt.
  1693. <center><a NAME="table-2" id="table-2"></a>Table 2. Bugzilla field names</center>
  1694.  
  1695. <br>&nbsp;
  1696. <center><table BORDER CELLSPACING=0 CELLPADDING=5 >
  1697. <tr ALIGN=LEFT VALIGN=TOP>
  1698. <th>Field name</th>
  1699.  
  1700. <th>Name on Bugzilla form</th>
  1701.  
  1702. <th>Replication policy</th>
  1703. </tr>
  1704.  
  1705. <tr VALIGN=TOP>
  1706. <td>bug_id</td>
  1707.  
  1708. <td>Bug #</td>
  1709.  
  1710. <td>always, read only</td>
  1711. </tr>
  1712.  
  1713. <tr VALIGN=TOP>
  1714. <td>bug_status</td>
  1715.  
  1716. <td>Status</td>
  1717.  
  1718. <td>always, read/write</td>
  1719. </tr>
  1720.  
  1721. <tr VALIGN=TOP>
  1722. <td>assigned_to</td>
  1723.  
  1724. <td>Assigned To</td>
  1725.  
  1726. <td>always, read/write, user</td>
  1727. </tr>
  1728.  
  1729. <tr VALIGN=TOP>
  1730. <td>short_desc</td>
  1731.  
  1732. <td>Summary</td>
  1733.  
  1734. <td>always, read/write</td>
  1735. </tr>
  1736.  
  1737. <tr VALIGN=TOP>
  1738. <td>resolution</td>
  1739.  
  1740. <td>Resolution</td>
  1741.  
  1742. <td>always, read/write</td>
  1743. </tr>
  1744.  
  1745. <tr VALIGN=TOP>
  1746. <td>bug_file_loc</td>
  1747.  
  1748. <td>URL</td>
  1749.  
  1750. <td>read/write</td>
  1751. </tr>
  1752.  
  1753. <tr VALIGN=TOP>
  1754. <td>bug_severity</td>
  1755.  
  1756. <td>Severity</td>
  1757.  
  1758. <td>read/write</td>
  1759. </tr>
  1760.  
  1761. <tr VALIGN=TOP>
  1762. <td>op_sys</td>
  1763.  
  1764. <td>OS</td>
  1765.  
  1766. <td>read/write</td>
  1767. </tr>
  1768.  
  1769. <tr VALIGN=TOP>
  1770. <td>priority</td>
  1771.  
  1772. <td>Priority</td>
  1773.  
  1774. <td>read/write</td>
  1775. </tr>
  1776.  
  1777. <tr VALIGN=TOP>
  1778. <td>rep_platform</td>
  1779.  
  1780. <td>Platform</td>
  1781.  
  1782. <td>read/write</td>
  1783. </tr>
  1784.  
  1785. <tr VALIGN=TOP>
  1786. <td>reporter</td>
  1787.  
  1788. <td>Reporter</td>
  1789.  
  1790. <td>read/write, user</td>
  1791. </tr>
  1792.  
  1793. <tr VALIGN=TOP>
  1794. <td>qa_contact</td>
  1795.  
  1796. <td>QA Contact</td>
  1797.  
  1798. <td>read/write, user or None</td>
  1799. </tr>
  1800.  
  1801. <tr VALIGN=TOP>
  1802. <td>status_whiteboard</td>
  1803.  
  1804. <td>Status Whiteboard</td>
  1805.  
  1806. <td>read/write</td>
  1807. </tr>
  1808.  
  1809. <tr VALIGN=TOP>
  1810. <td>reporter_accessible</td>
  1811.  
  1812. <td>Reporter checkbox</td>
  1813.  
  1814. <td>read/write</td>
  1815. </tr>
  1816.  
  1817. <tr VALIGN=TOP>
  1818. <td>assignee_accessible</td>
  1819.  
  1820. <td>Assignee checkbox</td>
  1821.  
  1822. <td>read/write</td>
  1823. </tr>
  1824.  
  1825. <tr VALIGN=TOP>
  1826. <td>qacontact_accessible</td>
  1827.  
  1828. <td>QA Contact checkbox</td>
  1829.  
  1830. <td>read/write</td>
  1831. </tr>
  1832.  
  1833. <tr VALIGN=TOP>
  1834. <td>cclist_accessible</td>
  1835.  
  1836. <td>CC List checkbox</td>
  1837.  
  1838. <td>read/write</td>
  1839. </tr>
  1840.  
  1841. <tr VALIGN=TOP>
  1842. <td>longdesc</td>
  1843.  
  1844. <td>Description</td>
  1845.  
  1846. <td>append only</td>
  1847. </tr>
  1848.  
  1849. <tr VALIGN=TOP>
  1850. <td>groupset</td>
  1851.  
  1852. <td>-</td>
  1853.  
  1854. <td>read only</td>
  1855. </tr>
  1856.  
  1857. <tr VALIGN=TOP>
  1858. <td>creation_ts</td>
  1859.  
  1860. <td>Opened</td>
  1861.  
  1862. <td>read only</td>
  1863. </tr>
  1864.  
  1865. <tr VALIGN=TOP>
  1866. <td>delta_ts</td>
  1867.  
  1868. <td>-</td>
  1869.  
  1870. <td>read only</td>
  1871. </tr>
  1872.  
  1873. <tr VALIGN=TOP>
  1874. <td>product</td>
  1875.  
  1876. <td>Product</td>
  1877.  
  1878. <td>read only</td>
  1879. </tr>
  1880.  
  1881. <tr VALIGN=TOP>
  1882. <td>version</td>
  1883.  
  1884. <td>Version</td>
  1885.  
  1886. <td>read only</td>
  1887. </tr>
  1888.  
  1889. <tr VALIGN=TOP>
  1890. <td>component</td>
  1891.  
  1892. <td>Component</td>
  1893.  
  1894. <td>read only</td>
  1895. </tr>
  1896.  
  1897. <tr VALIGN=TOP>
  1898. <td>target_milestone</td>
  1899.  
  1900. <td>Target Milestone</td>
  1901.  
  1902. <td>read only</td>
  1903. </tr>
  1904.  
  1905. <tr VALIGN=TOP>
  1906. <td>votes</td>
  1907.  
  1908. <td>Votes</td>
  1909.  
  1910. <td>read only</td>
  1911. </tr>
  1912.  
  1913. <tr VALIGN=TOP>
  1914. <td>keywords</td>
  1915.  
  1916. <td>Keywords</td>
  1917.  
  1918. <td>read only</td>
  1919. </tr>
  1920.  
  1921. <tr VALIGN=TOP>
  1922. <td>lastdiffed</td>
  1923.  
  1924. <td>-</td>
  1925.  
  1926. <td>read only</td>
  1927. </tr>
  1928.  
  1929. <tr VALIGN=TOP>
  1930. <td>everconfirmed</td>
  1931.  
  1932. <td>-</td>
  1933.  
  1934. <td>read only</td>
  1935. </tr>
  1936. </table></center>
  1937. The following fields are displayed on the Bugzilla bug form but are kept
  1938. in separate database tables and cannot be replicated:
  1939. <ul>
  1940. <li>
  1941. "Cc"</li>
  1942.  
  1943. <li>
  1944. "Attachments"</li>
  1945.  
  1946. <li>
  1947. "Depends on"</li>
  1948.  
  1949. <li>
  1950. "Blocks"</li>
  1951. </ul>
  1952. </div>
  1953. If you need to change the list of replicated fields after you've started
  1954. using the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  1955. see <a href="#section-9">section 9, "Maintaining the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>"</a>.
  1956. <h3>
  1957. <a NAME="section-5.2" id="section-5.2"></a>5.2. Perforce configuration</h3>
  1958. To configure Perforce, you must:
  1959. <ol>
  1960. <li>
  1961. Create a Perforce user for the replicator (<a href="#section-5.2.1">section
  1962. 5.2.1</a>).</li>
  1963.  
  1964. <li>
  1965. Install Perforce triggers to enforce workflow (optional; <a href="#section-5.2.2">section
  1966. 5.2.2</a>).</li>
  1967.  
  1968. <li>
  1969. Delete all Perforce jobs, if you have not already done so (<a href="#section-5.2.3">section
  1970. 5.2.3</a>).</li>
  1971. </ol>
  1972.  
  1973. <h4>
  1974. <a NAME="section-5.2.1" id="section-5.2.1"></a>5.2.1. Creating a Perforce
  1975. user for the replicator</h4>
  1976. Create a user in Perforce for the replicator; for instructions, see the
  1977. <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">Perforce
  1978. System Administrator's Guide</a></i>. The replicator user must have the
  1979. following properties:
  1980. <ul>The userid must be the same as the <a href="#config-p4_user">replicator
  1981. Perforce userid (<tt>p4_user</tt>)</a> that you specified in the&nbsp;<abbr
  1982. title="Perforce Defect Tracking Integration">P4DTI</abbr>
  1983. configuration.
  1984. <p>The e-mail address must match the <a href="#config-replicator_address">replicator
  1985. e-mail address (<tt>replicator_address</tt>)</a>.
  1986. <p>If you're using the Perforce protections, make the replicator a super
  1987. user so that it can set the jobspec. For instructions, see the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">Perforce
  1988. System Administrator's Guide</a></i>. You'll need to add a line like
  1989. <blockquote><tt>super user p4dti-replicator0 * //...</tt></blockquote>
  1990. to the protections list.</ul>
  1991. For information on getting a license from Perforce Software for this extra
  1992. user, see <a href="#section-3.2">section 3.2, "Perforce prerequisites"</a>.
  1993. <h4>
  1994. <a NAME="section-5.2.2" id="section-5.2.2"></a>5.2.2. Installing Perforce
  1995. triggers to enforce workflow</h4>
  1996. You can use the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  1997. in combination with a Perforce&nbsp;<dfn>trigger</dfn> to enforce extra
  1998. workflow restrictions. For example, if your organization assigns priorities
  1999. to issues, you can prevent changes being made to areas of the repository
  2000. unless they resolve at least one defect of priority 3 or higher.
  2001. <p>The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2002. comes with an example trigger script that you can adapt for your needs,
  2003. installed as <tt>example_trigger.py</tt> in the default installation directory.
  2004. <p>To enforce workflow restrictions, follow these steps:
  2005. <ol>
  2006. <li>
  2007. Configure the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2008. to replicate the defect tracker fields that you want to check. For example,
  2009. you can check that the "priority" or "severity" is above a certain level,
  2010. or that a manager has set the "approval" field. See the <tt>replicated_fields</tt>
  2011. configuration parameter (for <a href="#config-replicated_fields-Bugzilla">Bugzilla</a>
  2012. or <a href="#config-replicated_fields-TeamTrack">TeamTrack</a>).</li>
  2013.  
  2014. <li>
  2015. Adapt the trigger script for your needs. You must be able to do a small
  2016. amount of Python programming to adapt the trigger script. The example script
  2017. contains comments to help you.</li>
  2018.  
  2019. <li>
  2020. Install the trigger script. For instructions on installing and managing
  2021. trigger scripts, see the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">Perforce
  2022. System Administrator's Guide</a></i>.</li>
  2023. </ol>
  2024.  
  2025. <h4>
  2026. <a NAME="section-5.2.3" id="section-5.2.3"></a>5.2.3. Deleting Perforce
  2027. jobs</h4>
  2028. You must delete all jobs from your Perforce installation. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2029. takes over the jobs subsystem of Perforce and rewrites the Perforce jobspec.
  2030. <p>For instructions, see the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4guide/">Perforce
  2031. Command Line User's Guide</a></i>.
  2032. <p>It is possible to keep existing issues that are stored in Perforce jobs.
  2033. Migration submits all the Perforce job data to the defect tracker, so that
  2034. the issues can be replicated back to Perforce, and so appear in both systems.
  2035. This requires more experience of Perforce and some Python programming.
  2036. See <a href="../aag/index.html#section-4">section 4, "Migrating to the
  2037. defect tracker from Perforce jobs"</a>, of the <i><a href="../aag/index.html">Perforce
  2038. Defect Tracking Integration Advanced Administrator's Guide</a></i>.
  2039. <p>If you already use Perforce jobs and have significant tools that depend
  2040. on your jobspec, the configuration options described in <a href="#section-5.1">section
  2041. 5.1, "<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr> configuration"</a>,
  2042. might not be flexible enough to support your requirements. However, you
  2043. might be able to write your own configuration and use your own jobspec.
  2044. To write your own configuration, you must understand the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2045. configuration architecture and be fluent in the Python programming language.
  2046. See the <i>Perforce Defect Tracking Integration Integrator's Guide</i>
  2047. for details of how to configure the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2048. and guidance on developing your own configuration. Note that neither Perforce
  2049. nor the manufacturer of your defect tracker can support a configuration
  2050. that you write yourself.
  2051. <div class="teamtrack">
  2052. <h3>
  2053. <a NAME="section-5.3" id="section-5.3"></a>5.3. TeamTrack configuration</h3>
  2054. To configure TeamTrack, you must:
  2055. <ol>
  2056. <li>
  2057. Update the Windows Registry (<a href="#section-5.3.1">section 5.3.1</a>).</li>
  2058.  
  2059. <li>
  2060. Create a TeamTrack user for the replicator (<a href="#section-5.3.2">section
  2061. 5.3.2</a>).</li>
  2062.  
  2063. <li>
  2064. Provide field descriptions (<a href="#section-5.3.3">section 5.3.3</a>).</li>
  2065. </ol>
  2066.  
  2067. <h4>
  2068. <a NAME="section-5.3.1" id="section-5.3.1"></a>5.3.1. Updating the Windows
  2069. Registry</h4>
  2070. You need to add a TeamTrack value to the Windows Registry to tell TeamTrack
  2071. that the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2072. is present. To do this, double-click the <tt>p4dti.reg</tt> file that comes
  2073. with the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2074. (it's installed in <tt>c:\program files\p4dti\p4dti.reg</tt> by default).
  2075. <h4>
  2076. <a NAME="section-5.3.2" id="section-5.3.2"></a>5.3.2. Creating a TeamTrack
  2077. user for the replicator</h4>
  2078. You need to create a TeamTrack user for the replicator. This user corresponds
  2079. to the <a href="#config-teamtrack_user">replicator TeamTrack userid (<tt>teamtrack_user</tt>)</a>
  2080. parameter you set in <a href="#section-5.1">section 5.1, "<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2081. configuration"</a>.
  2082. <p>To create a TeamTrack user for the replicator, follow these steps:
  2083. <ol>
  2084. <li>
  2085. Run the TeamTrack Administrator. (Under Windows, choose Start > Programs
  2086. > TeamShare > TeamTrack Administrator.)</li>
  2087.  
  2088. <li>
  2089. Select the&nbsp;<span class="gui">Users</span> tab.</li>
  2090.  
  2091. <li>
  2092. Click the&nbsp;<span class="gui">Add</span> button.</li>
  2093.  
  2094. <li>
  2095. On the&nbsp;<span class="gui">General</span> tab, in the Login ID field,
  2096. enter the replicator user name (see the <a href="#config-teamtrack_user">replicator
  2097. Teamtrack userid (<tt>teamtrack_user</tt>)</a> parameter).</li>
  2098.  
  2099. <li>
  2100. Click the&nbsp;<span class="gui">User</span> product access radio button
  2101. (see <a href="#figure-7">Figure 7</a>).</li>
  2102.  
  2103. <li>
  2104. On the&nbsp;<span class="gui">Privileges</span> tab, select the&nbsp;<span class="gui">System</span>
  2105. tab and then select the "<span class="gui">Connect using the&nbsp;<abbr title="Application Programmer Interface">API</abbr></span>"
  2106. check box (see <a href="#figure-8">Figure 8</a>).</li>
  2107.  
  2108. <li>
  2109. On the&nbsp;<span class="gui">Privileges</span> tab, select the&nbsp;<span 
  2110. class="gui">Item</span>
  2111. tab.</li>
  2112.  
  2113. <li>
  2114. In the pane at the left, select the base project.</li>
  2115.  
  2116. <li>
  2117. In the pane at the right, select the "<span class="gui">Submit New Items</span>",
  2118. "<span class="gui">Update All Items</span>" and "<span 
  2119. class="gui">Transition
  2120. All Items</span>" check boxes (see <a href="#figure-9">Figure 9</a>).</li>
  2121.  
  2122. <li>
  2123. Click&nbsp;<span class="gui">OK</span> to add the user.</li>
  2124. </ol>
  2125. For information on getting a license from TeamShare for this extra user,
  2126. see <a href="#section-3.3">section 3.3, "TeamTrack prerequisites"</a>.
  2127. <center><a NAME="figure-7" id="figure-7"></a>Figure 7. New user: General
  2128. tab
  2129. <br><img SRC="tt-new-user-general.gif" ALT="Screen shot showing the general tab for creating a new user in TeamTrack Administrator" / height=455 width=556></center>
  2130.  
  2131. <center><a NAME="figure-8" id="figure-8"></a>Figure 8. New user: Privileges
  2132. tab, System tab
  2133. <br><img SRC="tt-new-user-privileges.gif" ALT="Screen shot showing the System tab on the Privileges tab for creating a new user in TeamTrack Administrator" / height=455 width=556></center>
  2134.  
  2135. <center><a NAME="figure-9" id="figure-9"></a>Figure 9. New user: Privileges
  2136. tab, Item tab
  2137. <br><img SRC="tt-new-user-privileges-2.gif" ALT="Screen shot showing the Item tab on the Privileges tab for creating a new user in TeamTrack Administrator" / height=455 width=556></center>
  2138.  
  2139. <h4>
  2140. <a NAME="section-5.3.3" id="section-5.3.3"></a>5.3.3. Providing field descriptions</h4>
  2141. The replicator uses TeamTrack issue field descriptions as the source for
  2142. the Perforce job field descriptions. These job field descriptions appear
  2143. in comments in every job form (if you're using the Perforce command line)
  2144. and as tooltips for the fields in the job editing dialog (if you're using
  2145. P4Win, the Perforce Windows GUI).
  2146. <p>TeamTrack leaves field descriptions blank when you create a database,
  2147. so you must provide descriptions of fields that your developers edit. For
  2148. example, you might describe the <tt>TITLE</tt> field as "A one-sentence
  2149. statement of the problem from the user's perspective", and the <tt>DESCRIPTION</tt>
  2150. field as "A detailed description of the problem from the user's perspective,
  2151. including how to reproduce it."
  2152. <p>To enter field descriptions, follow these steps:
  2153. <ol>
  2154. <li>
  2155. Run the TeamTrack Administrator. (Under Windows, choose Start > Programs
  2156. > TeamShare > TeamTrack Administrator.)</li>
  2157.  
  2158. <li>
  2159. Select the&nbsp;<span class="gui">Workflows</span> tab.</li>
  2160.  
  2161. <li>
  2162. Select the&nbsp;<span class="gui">Issue Workflow</span>.</li>
  2163.  
  2164. <li>
  2165. Click the&nbsp;<span class="gui">Edit</span> button.</li>
  2166.  
  2167. <li>
  2168. Select the&nbsp;<span class="gui">Default Fields</span> tab.</li>
  2169.  
  2170. <li>
  2171. Select the field you want to describe.</li>
  2172.  
  2173. <li>
  2174. Click the&nbsp;<span class="gui">Edit</span> button.</li>
  2175.  
  2176. <li>
  2177. Enter the description in the&nbsp;<span class="gui">Description</span>
  2178. field.</li>
  2179.  
  2180. <li>
  2181. Click&nbsp;<span class="gui">OK</span> to save your entries.</li>
  2182.  
  2183. <li>
  2184. Repeat steps 6 to 9 until you're done.</li>
  2185.  
  2186. <li>
  2187. Click the&nbsp;<span class="gui">OK</span> button.</li>
  2188. </ol>
  2189. </div>
  2190.  
  2191. <div class="bugzilla">
  2192. <h3>
  2193. <a NAME="section-5.4" id="section-5.4"></a>5.4. Bugzilla configuration</h3>
  2194. To configure Bugzilla, you must:
  2195. <ol>
  2196. <li>
  2197. Patch Bugzilla (<a href="#section-5.4.1">section 5.4.1</a>).</li>
  2198.  
  2199. <li>
  2200. Create a Bugzilla user for the replicator (<a href="#section-5.4.2">section
  2201. 5.4.2</a>).</li>
  2202.  
  2203. <li>
  2204. Enable the&nbsp;<abbr title="Perforce Defect Tracking
  2205. Integration">P4DTI</abbr>
  2206. extensions in Bugzilla (<a href="#section-5.4.3">section 5.4.3</a>).</li>
  2207. </ol>
  2208.  
  2209. <h4>
  2210. <a NAME="section-5.4.1" id="section-5.4.1"></a>5.4.1. Patching Bugzilla</h4>
  2211. You need to make some minor modifications to the Bugzilla code so that
  2212. users can see Perforce information on Bugzilla bug forms, and so that the&nbsp;<abbr title="Perforce Defect Tracking
  2213. Integration">P4DTI</abbr>
  2214. can access the values of Bugzilla configuration parameters. These modifications
  2215. are distributed as patchfiles for versions 2.10, 2.12, 2.14, and 2.14.1
  2216. of Bugzilla.
  2217. <p>If you have modified Bugzilla at your site, you might still be able
  2218. to apply the patch successfully. Changes to the database schema, the permissions
  2219. rules, or the workflow rules are likely to cause the<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2220. to malfunction. You might need to modify the&nbsp;<abbr title="Perforce
  2221. Defect Tracking Integration">P4DTI</abbr>
  2222. if you have changed these parts of Bugzilla.
  2223. <p>The patch for all Bugzilla versions changes the following Bugzilla files:
  2224. <ul>
  2225. <li>
  2226. <tt>bug_form.pl</tt>, adding a Perforce section to the bug form.</li>
  2227.  
  2228. <li>
  2229. <tt>defparams.pl</tt>, adding a parameter to control whether or not the
  2230. Perforce section appears.</li>
  2231.  
  2232. <li>
  2233. <tt>doeditparams.pl</tt>, creating and maintaining a database table containing
  2234. Bugzilla's configuration parameters.</li>
  2235. </ul>
  2236. The patches for Bugzilla 2.14 and 2.14.1 also change this file:
  2237. <ul>
  2238. <li>
  2239. <tt>globals.pl</tt>, deleting unsafe environment variables so that the
  2240. <tt>processmail</tt> script can be run by the&nbsp;<abbr
  2241. title="Perforce Defect Tracking Integration">P4DTI</abbr>.</li>
  2242. </ul>
  2243. These changes are small and self-contained. If your changes do not affect
  2244. these files or only affect them in minor ways, the patch should operate
  2245. correctly. If the patch program fails because of your Bugzilla modifications,
  2246. it might still be possible to introduce the changes by hand. If you cannot
  2247. apply the patch, the replicator might still work, but the extensions listed
  2248. in <a href="#section-5.4.3">section 5.4.3</a> will not be available.
  2249. <p>To apply the patch, follow these steps:
  2250. <ol>
  2251. <li>
  2252. Make a copy of your Bugzilla code so that you can uninstall the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2253. if necessary.</li>
  2254.  
  2255. <li>
  2256. Go to your Bugzilla installation directory.</li>
  2257.  
  2258. <li>
  2259. Enter the following command:</li>
  2260.  
  2261. <blockquote><tt>patch &lt; <i>p4dti-install-dir</i>/bugzilla-<i>bugzilla-version</i>-patch</tt></blockquote>
  2262. (where <i>p4dti-install-dir</i> is your&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2263. installation directory) and <i>bugzilla-version</i> is your version of
  2264. Bugzilla (2.10, 2.12, 2.14, or 2.14.1).
  2265. <li>
  2266. Check the output of the patch program carefully to ensure it succeeded.</li>
  2267. </ol>
  2268.  
  2269. <h4>
  2270. <a NAME="section-5.4.2" id="section-5.4.2"></a>5.4.2. Creating a Bugzilla
  2271. user for the replicator</h4>
  2272. You need to create a Bugzilla user for the replicator. The replicator uses
  2273. e-mail addresses to work out which Perforce user corresponds to which Bugzilla
  2274. user. A Perforce user that does not correspond to a Bugzilla user is translated
  2275. to the replicator's Bugzilla user, except for user fields (for example,
  2276. "AssignedTo") in jobs. The replicator rejects a change when there is no
  2277. Bugzilla user corresponding to a changed user field.
  2278. <p>To create a Bugzilla user for the replicator, follow these steps:
  2279. <ol>
  2280. <li>
  2281. In a Web browser, go to &lt;<span class="url">http://<i>your-bugzilla-path</i>/editusers.cgi</span>>.</li>
  2282.  
  2283. <li>
  2284. Log in if prompted.</li>
  2285.  
  2286. <li>
  2287. Click&nbsp;<span class="gui">Submit</span> to display the user list.</li>
  2288.  
  2289. <li>
  2290. At the bottom of the user list, click "<span class="gui">Add a new user</span>".</li>
  2291.  
  2292. <li>
  2293. In the "Login name" field, enter the <a href="#config-replicator_address">replicator
  2294. e-mail address (<tt>replicator_address</tt>)</a>.</li>
  2295.  
  2296. <li>
  2297. In the "Real name" field, enter a name like "Perforce defect tracking integration".</li>
  2298.  
  2299. <li>
  2300. Enter a password.</li>
  2301.  
  2302. <li>
  2303. In the "Disable text" field, enter something like "This user can access
  2304. Bugzilla only as the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2305. replicator process" to prevent access through the Bugzilla user interface.</li>
  2306.  
  2307. <li>
  2308. Click&nbsp;<span class="gui">Add</span> to create the user.</li>
  2309. </ol>
  2310.  
  2311. <h4>
  2312. <a NAME="section-5.4.3" id="section-5.4.3"></a>5.4.3. Enabling the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2313. extensions in Bugzilla</h4>
  2314. After patching the Bugzilla code, you need to enable the&nbsp;<abbr
  2315. title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2316. extensions in Bugzilla. There are two extensions:
  2317. <ul>Bugzilla's bug form includes information about the corresponding job
  2318. in Perforce, and a table of fixes.
  2319. <p>Bugzilla saves its configuration parameters in its database, making
  2320. it possible for the&nbsp;<abbr title="Perforce Defect Tracking
  2321.   Integration">P4DTI</abbr>
  2322. to support the "emailsuffix" feature.</ul>
  2323. To enable the extensions, follow these steps:
  2324. <ol>
  2325. <li>
  2326. In a Web browser, go to &lt;<span class="url">http://<i>your-bugzilla-path</i>/editparams.cgi</span>>.</li>
  2327.  
  2328. <li>
  2329. Log in as the Bugzilla administrator if prompted.</li>
  2330.  
  2331. <li>
  2332. Set the "p4dti" parameter to "on" (if it is not already on).</li>
  2333.  
  2334. <li>
  2335. Click "<span class="gui">Submit changes</span>" to enable the extensions.</li>
  2336. </ol>
  2337. To disable use of the&nbsp;<abbr title="Perforce Defect Tracking
  2338. Integration">P4DTI</abbr>
  2339. from the Bugzilla user interface, set the "p4dti" parameter to "off".</div>
  2340.  
  2341. <h3>
  2342. <a NAME="section-5.5" id="section-5.5"></a>5.5. Starting and stopping the
  2343. replicator manually</h3>
  2344. To start the replicator, follow these steps from the operating system command
  2345. line:
  2346. <ol>
  2347. <li>
  2348. Go to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2349. installation directory.</li>
  2350.  
  2351. <li>
  2352. Run the command <tt>python run.py</tt>.</li>
  2353. </ol>
  2354. The first time you start the replicator, it displays log output explaining
  2355. how the replicator is setting up the defect tracker schema extensions,
  2356. as shown in <a href="#figure-10">the following figure</a>:
  2357. <center><a NAME="figure-10" id="figure-10"></a>Figure 10. Example replicator
  2358. log output on startup (TeamTrack integration)</center>
  2359.  
  2360. <br>&nbsp;
  2361. <center><table BORDER CELLSPACING=0 CELLPADDING=5 >
  2362. <tr>
  2363. <td>
  2364. <pre>2001-03-12 20:05:45 UTC&nbsp; (P4DTI-6018)&nbsp; Installing field 'P4DTI_RID' in the TS_CASES table.
  2365. 2001-03-12 20:05:45 UTC&nbsp; (P4DTI-6018)&nbsp; Installing field 'P4DTI_SID' in the TS_CASES table.
  2366. 2001-03-12 20:05:45 UTC&nbsp; (P4DTI-6018)&nbsp; Installing field 'P4DTI_JOBNAME' in the TS_CASES table.
  2367. 2001-03-12 20:05:46 UTC&nbsp; (P4DTI-603X)&nbsp; Installed all new fields in the TS_CASES table.
  2368. 2001-03-12 20:05:47 UTC&nbsp; (P4DTI-6040)&nbsp; Put 'LAST_CHANGE' parameter in replicator configuration with value '0'.
  2369. 2001-03-12 20:05:47 UTC&nbsp; (P4DTI-6040)&nbsp; Put 'SERVER' parameter in replicator configuration with value '"{'sid': 'perforce0', 'description': 'Perforce server on sandpiper'}"'.
  2370. 2001-03-12 20:05:47 UTC&nbsp; (P4DTI-6040)&nbsp; Put 'STATUS_VALUES' parameter in replicator configuration with value '"{'sid': 'perforce0', 'description': '_new/assigned/closed/verified/deferred'}"'.
  2371. 2001-03-12 20:05:47 UTC&nbsp; (P4DTI-6040)&nbsp; Put 'CHANGELIST_URL' parameter in replicator configuration with value '"{'sid': 'perforce0', 'description': 'http://sandpiper.ravenbrook.com:8080/%d?ac=10'}"'.
  2372. 2001-03-12 20:05:48 UTC&nbsp; (P4DTI-8002)&nbsp; Mailing 'P4DTI administrator &lt;gdr+admin@ravenbrook.com>' re: '(P4DTI-8669)&nbsp; The P4DTI replicator has started.'.
  2373. ...</pre>
  2374. </td>
  2375. </tr>
  2376. </table></center>
  2377. Each log entry consists of the date of the entry, a message identifier,
  2378. and the message text. You can use the message identifier of an error message
  2379. to look it up in <a href="#section-11.2">section 11.2, "Error messages
  2380. by identifier"</a>.
  2381. <p>During its startup sequence, the replicator creates Perforce jobs corresponding
  2382. to every defect tracker issue created or modified after the (<tt><a href="#config-start_date">start_date</a></tt>).
  2383. It then polls for changes every <tt><a href="#config-poll_period">poll_period</a></tt>
  2384. seconds and replicates those changes. <a href="#figure-11">Figure 11</a>
  2385. shows typical replicator log output when it is replicating a change.
  2386. <center><a NAME="figure-11" id="figure-11"></a>Figure 11. Example replicator
  2387. log output on replication (TeamTrack integration)</center>
  2388.  
  2389. <br>&nbsp;
  2390. <center><table BORDER CELLSPACING=0 CELLPADDING=5 >
  2391. <tr>
  2392. <td>
  2393. <pre>2001-03-12 19:59:29 UTC&nbsp; (P4DTI-8057)&nbsp; Replicating job 'CHG00003' to issue 'CHG00003'.
  2394. 2001-03-12 19:59:30 UTC&nbsp; (P4DTI-824X)&nbsp; -- Changed fields: {'SEVERITY': 46, 'VERSION': 53, 'STATE': 2, 'PRIORITY': 17}.
  2395. 2001-03-12 19:59:30 UTC&nbsp; (P4DTI-6007)&nbsp; -- Transition: 3; User: rb.
  2396. 2001-03-12 19:59:30 UTC&nbsp; (P4DTI-8261)&nbsp; -- Defect tracker made changes as a result of the update: {'Owner': 'gdr'}.</pre>
  2397. </td>
  2398. </tr>
  2399. </table></center>
  2400. To stop the replicator on Windows, follow these steps:
  2401. <ol>
  2402. <li>
  2403. Select the command window in which the replicator is running.</li>
  2404.  
  2405. <li>
  2406. Press Control-C and wait for the replicator to next poll (this takes up
  2407. to <tt><a href="#config-poll_period">poll_period</a></tt> seconds).</li>
  2408. </ol>
  2409. To stop the replicator on Unix systems, kill the replicator process. If
  2410. it's running in a shell, bring it to the foreground and type Control-C.
  2411. If not, find out the process id of the replicator process and run the command
  2412. <tt>kill -TERM
  2413. <i>replicator-process-id</i></tt>.
  2414. <h3>
  2415. <a NAME="section-5.6" id="section-5.6"></a>5.6. Setting up the replicator
  2416. to start automatically</h3>
  2417. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2418. can be run as a daemon on Unix and as an NT service on Windows. Check that
  2419. the replicator <a href="#section-5.5">starts manually</a> and runs correctly,
  2420. before leaving it to run automatically.
  2421. <h4>
  2422. <a NAME="section-5.6.1" id="section-5.6.1"></a>5.6.1. Running automatically
  2423. on Unix</h4>
  2424. If you installed the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2425. using the Linux&nbsp;<abbr title="Red Hat Package Manager">RPM</abbr> as
  2426. described in <a href="#section-4.3">section 4.3, "Linux installation"</a>,
  2427. a startup script is automatically created in <tt>/etc/rc.d/init.d</tt>
  2428. directory, so that the replicator starts as a daemon when the machine is
  2429. booted. Alternatively you can start the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2430. daemon manually by calling the startup script yourself:
  2431. <blockquote><tt>/etc/rc.d/init.d/p4dti start</tt></blockquote>
  2432. The replicator halts automatically when the system is shut down. You can
  2433. stop the replicator daemon manually using the stop script:
  2434. <blockquote><tt>/etc/rc.d/init.d/p4dti stop</tt></blockquote>
  2435. On Solaris or other Unixes (and on Linux if you did not use the&nbsp;<abbr title="Red Hat Package Manager">RPM</abbr>
  2436. installer), you might want to adapt the Linux startup script. It is in
  2437. the file named <tt>startup-script</tt> in the installation directory.
  2438. <h4>
  2439. <a NAME="section-5.6.2" id="section-5.6.2"></a>5.6.2. Running automatically
  2440. on Windows</h4>
  2441. On Windows, you can choose to install the&nbsp;<abbr title="Perforce
  2442. Defect Tracking Integration">P4DTI</abbr>
  2443. as a service. The replicator then starts when the machine is booted. You
  2444. need not be logged on to the machine for the service to run or to stay
  2445. running.
  2446. <p>To install the service, follow these steps from the operating system
  2447. command line:
  2448. <ol>
  2449. <li>
  2450. Go to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2451. installation directory.</li>
  2452.  
  2453. <li>
  2454. Run the command:</li>
  2455.  
  2456. <blockquote><tt>python service.py</tt></blockquote>
  2457. </ol>
  2458. Once the service has been installed, it can be started in any of the following
  2459. ways:
  2460. <ul>
  2461. <li>
  2462. Use the control panel to start the Services applet and scroll down until
  2463. you find "P4DTI". Click on this once, then click "Start".</li>
  2464.  
  2465. <li>
  2466. Go to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2467. installation directory and run the command: <tt>python service.py start</tt>.</li>
  2468.  
  2469. <li>
  2470. When the machine reboots, the service starts automatically.</li>
  2471. </ul>
  2472. Once the service is running, it can be halted in any of the following ways.
  2473. Note that you need not halt the service the same way that you started it.
  2474. <ul>
  2475. <li>
  2476. Use the control panel to start the Services applet and scroll down until
  2477. you find "P4DTI". Click on this once, then click "Stop".</li>
  2478.  
  2479. <li>
  2480. Go to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2481. installation directory and run the command: <tt>python service.py stop</tt>.</li>
  2482.  
  2483. <li>
  2484. When the machine is shut down, the service stops automatically.</li>
  2485. </ul>
  2486. To uninstall the service, go to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2487. installation directory and run the command:
  2488. <blockquote><tt>python service.py remove</tt></blockquote>
  2489.  
  2490. <h3>
  2491. <a NAME="section-5.7" id="section-5.7"></a>5.7. Advanced configuration</h3>
  2492. Not all of the flexibility of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2493. is available using the configuration options described in this section.
  2494. Advanced configuration of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2495. is possible, but beyond the scope of this manual. Here are some of the
  2496. things that are possible with advanced configuration:
  2497. <ul>
  2498. <li>
  2499. Connecting a defect tracker to multiple Perforce servers.</li>
  2500.  
  2501. <li>
  2502. Working with an existing Perforce jobs database and an existing Perforce
  2503. jobspec.</li>
  2504.  
  2505. <li>
  2506. Fine control over which defect tracker issues are replicated to Perforce.</li>
  2507.  
  2508. <li>
  2509. Fine control over which issue fields are replicated, and their names.</li>
  2510.  
  2511. <li>
  2512. Arbitrary translation of issue data between the defect tracker and Perforce.</li>
  2513.  
  2514. <li>
  2515. Queries based on combined defect tracker and Perforce data.</li>
  2516.  
  2517. <li>
  2518. Working with locally customized versions of Bugzilla.</li>
  2519.  
  2520. <li>
  2521. Redirection or fine control of logging.</li>
  2522.  
  2523. <li>
  2524. Arbitrary mappings between Perforce and defect tracker user names.</li>
  2525.  
  2526. <li>
  2527. Alternative policies for handling conflicts between defect tracker and
  2528. Perforce changes to issues.</li>
  2529. </ul>
  2530. <a href="http://www.perforce.com/perforce/support.html">Contact Perforce
  2531. technical support</a> if you need any of these facilities.
  2532. <h2>
  2533. <a NAME="section-6" id="section-6"></a>6. Migrating your defect tracking
  2534. data to the integrated system</h2>
  2535.  
  2536. <h3>
  2537. <a NAME="section-6.1" id="section-6.1"></a>6.1. Migrating from the defect
  2538. tracker</h3>
  2539. You do not need to take any special action to migrate defect tracking data
  2540. from your defect tracker to the integrated system. The replicator starts
  2541. replicating defect tracker issues as soon as it starts up. Only issues
  2542. that are created or modified after the <tt><a href="#config-start_date">start_date</a></tt>
  2543. are replicated to Perforce.
  2544. <h3>
  2545. <a NAME="section-6.2" id="section-6.2"></a>6.2. Allowing users to create
  2546. issues in Perforce</h3>
  2547. See <a href="../aag/index.html#section-3">section 3, "Allowing users to
  2548. create issues in Perforce"</a> in the <i><a href="../aag/index.html">Perforce
  2549. Defect Tracking Advanced Administrator's Guide</a></i>.
  2550. <h3>
  2551. <a NAME="section-6.3" id="section-6.3"></a>6.3. Migrating to the defect
  2552. tracker from Perforce jobs</h3>
  2553. See <a href="../aag/index.html#section-4">section 4, "Migrating to the
  2554. defect tracker from Perforce jobs"</a> in the <i><a href="../aag/index.html">Perforce
  2555. Defect Tracking Advanced Administrator's Guide</a></i>.
  2556. <h2>
  2557. <a NAME="section-7" id="section-7"></a>7. Testing the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></h2>
  2558.  
  2559. <h3>
  2560. <a NAME="section-7.1" id="section-7.1"></a>7.1. Taking a single step</h3>
  2561. When you're testing your&nbsp;<abbr title="Perforce Defect Tracking
  2562. Integration">P4DTI</abbr>
  2563. configuration, you might need to tell the<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2564. take a single step; that is, to poll the defect tracker and Perforce for
  2565. changes, replicate those changes, then stop. If you need to do this:
  2566. <ol>
  2567. <li>
  2568. Change to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2569. installation directory.</li>
  2570.  
  2571. <li>
  2572. Run the command <tt>python poll.py</tt>.</li>
  2573. </ol>
  2574.  
  2575. <h3>
  2576. <a NAME="section-7.2" id="section-7.2"></a>7.2. Testing your configuration</h3>
  2577. Test the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2578. configuration by creating a test issue and taking it through a complete
  2579. life-cycle (that is, through the workflow) as described in the <i><a href="../ug/index.html">Perforce
  2580. Defect Tracking Integration User's Guide</a></i>. You might need to adapt
  2581. the use cases described in the user's guide to your organization's workflow.
  2582. <p>Test the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2583. from both Perforce and the defect tracker. In Perforce, test the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2584. using the interface that your developers are most likely to use. The main
  2585. Perforce interfaces are:
  2586. <ul>
  2587. <li>
  2588. P4, the Perforce command line.</li>
  2589.  
  2590. <li>
  2591. P4Win, the Perforce GUI.</li>
  2592.  
  2593. <li>
  2594. The Perforce IDE integrations, if you use them.</li>
  2595. </ul>
  2596.  
  2597. <h3>
  2598. <a NAME="section-7.3" id="section-7.3"></a>7.3. Checking data consistency</h3>
  2599. To run the consistency checker and manage its output, follow these steps:
  2600. <ol>
  2601. <li>
  2602. Change to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2603. installation directory.</li>
  2604.  
  2605. <li>
  2606. Run the command <tt>python check.py</tt>.</li>
  2607. </ol>
  2608. You can also examine the database using a database application (for example,
  2609. Microsoft Access or the <tt>mysql</tt> command) to ensure the Perforce
  2610. data is in there.
  2611. <h2>
  2612. <a NAME="section-8" id="section-8"></a>8. Training and documentation</h2>
  2613. You might want to provide training for Perforce and defect tracker users
  2614. before they adopt the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2615. for everyday use. If so, consider preparing training materials that walk
  2616. them through the workflow for an issue, using the procedures that are documented
  2617. in the <i><a href="../ug/index.html">Perforce Defect Tracking Integration
  2618. User's Guide</a></i>.
  2619. <p>Even if you don't have a formal training session for your users, ensure
  2620. that they:
  2621. <ul>
  2622. <li>
  2623. Read the <i><a href="../ug/index.html">Perforce Defect Tracking Integration
  2624. User's Guide</a></i>.</li>
  2625.  
  2626. <li>
  2627. Upgrade their Perforce clients to version 2001.1 or later.</li>
  2628.  
  2629. <li>
  2630. Uninstall SourceBridge, if it's installed on their machines.</li>
  2631.  
  2632. <li>
  2633. Know not to edit the P4DTI-* fields in jobs.</li>
  2634. </ul>
  2635.  
  2636. <h2>
  2637. <a NAME="section-9" id="section-9"></a>9. Maintaining the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></h2>
  2638.  
  2639. <h3>
  2640. <a NAME="section-9.1" id="section-9.1"></a>9.1. Maintaining the configuration</h3>
  2641. You must stop and restart the replicator as described in <a href="#section-5.5">section
  2642. 5.5, "Starting the replicator manually"</a> after changing any of the configuration
  2643. parameters described in <a href="#section-5.1">section 5.1, "<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2644. configuration"</a>.
  2645. <p>You must also refresh Perforce jobs, as described in <a href="#section-9.2">section
  2646. 9.2, "Refreshing jobs in Perforce"</a>, after changing either:
  2647. <ol>
  2648. <li>
  2649. the list of replicated fields (<tt>replicated_fields</tt> for <a href="#config-replicated_fields-Bugzilla">Bugzilla</a>
  2650. or <a href="#config-replicated_fields-TeamTrack">TeamTrack</a>), or</li>
  2651.  
  2652. <li>
  2653. the <a href="#config-start_date">start date for replication (<tt>start_date</tt>)</a>.</li>
  2654. </ol>
  2655. Perforce uses the field number in the jobspec to find data, not the field
  2656. name (for more information, see the <i><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">Perforce
  2657. System Administrator's Guide</a></i>). If you change the list of replicated
  2658. fields, then the field numbers change, which means that the fields of existing
  2659. jobs in Perforce will be mixed up. Refreshing the jobs re-creates them
  2660. from the defect tracker with the correct fields.
  2661. <h3>
  2662. <a NAME="section-9.2" id="section-9.2"></a>9.2. Refreshing jobs in Perforce</h3>
  2663. Refreshing jobs updates all jobs in Perforce by replicating them from the
  2664. defect tracker's database. This procedure is necessary if:
  2665. <ul>
  2666. <li>
  2667. The Perforce jobs become corrupted.</li>
  2668.  
  2669. <li>
  2670. You change the set of replicated fields in the replicator's configuration.
  2671. For details, see <a href="#section-9.1">section 9.1, "Maintaining the configuration"</a>.</li>
  2672.  
  2673. <li>
  2674. You change the start date of replication in the replicator's configuration.
  2675. For details, see <a href="#section-9.1">section 9.1</a>.</li>
  2676. </ul>
  2677. To refresh the Perforce jobs, follow these steps from the operating system
  2678. command line:
  2679. <ol>
  2680. <li>
  2681. Stop the replicator.</li>
  2682.  
  2683. <li>
  2684. Go to the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2685. installation directory.</li>
  2686.  
  2687. <li>
  2688. Run the command <tt>python refresh.py</tt>.</li>
  2689.  
  2690. <li>
  2691. Start the replicator again by running the command <tt>python run.py</tt>.</li>
  2692. </ol>
  2693.  
  2694. <h2>
  2695. <a NAME="section-10" id="section-10"></a>10. Uninstalling the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr></h2>
  2696. To uninstall the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  2697. follow these steps:
  2698. <ol>
  2699. <li>
  2700. Tell your staff. Ask them to stop using either Perforce jobs or the defect
  2701. tracking, whichever you're not planning to use in future.</li>
  2702.  
  2703. <li>
  2704. Stop the replicator by following the instructions in <a href="#section-5.5">section
  2705. 5.5, "Starting the replicator manually"</a> (or <a href="#section-5.6">section
  2706. 5.6, "Setting up the replicator to start automatically"</a>).</li>
  2707.  
  2708. <li>
  2709. Remove any hooks that you created in <a href="#section-5.6">section 5.6,
  2710. "Setting up the replicator to start automatically"</a>, such as Windows
  2711. services, entries in <tt>/etc/rc.d</tt>, and so on.</li>
  2712.  
  2713. <li>
  2714. If you're using Bugzilla:</li>
  2715.  
  2716. <ol type="a">
  2717. <li>
  2718. Disable the Bugzilla extensions that were enabled in <a href="#section-5.4.3">section
  2719. 5.4.3, "Enabling the Bugzilla extensions"</a>.</li>
  2720.  
  2721. <li>
  2722. Delete the replicator's Bugzilla user that was created in <a href="#section-5.4.2">section
  2723. 5.4.2, "Creating a Bugzilla user for the replicator"</a>.</li>
  2724.  
  2725. <li>
  2726. optionally, restore the unpatched copy of Bugzilla made in <a href="#section-5.4.1">section
  2727. 5.4.1, "Patching Bugzilla"</a>.</li>
  2728. </ol>
  2729.  
  2730. <li>
  2731. If you're using TeamTrack:</li>
  2732.  
  2733. <ol type="a">
  2734. <li>
  2735. Delete the replicator's TeamTrack user that was created in <a href="#section-5.3.2">section
  2736. 5.3.2, "Creating a TeamTrack user for the replicator"</a>.</li>
  2737. </ol>
  2738.  
  2739. <li>
  2740. Remove any Perforce triggers that were added in <a href="#section-5.2.2">section
  2741. 5.2.2, "Installing Perforce triggers to enforce workflow"</a>.</li>
  2742.  
  2743. <li>
  2744. Delete the replicator's Perforce user created in <a href="#section-5.2.1">section
  2745. 5.2.1, "Creating a Perforce user for the replicator"</a>.</li>
  2746.  
  2747. <li>
  2748. If you installed using the Linux&nbsp;<abbr title="Red Hat Package Manager">RPM</abbr>,
  2749. as described in <a href="#section-4.3">section 4.3, "Linux installation"</a>,
  2750. uninstall using the command</li>
  2751.  
  2752. <blockquote><tt>rpm -e p4dti</tt></blockquote>
  2753. Otherwise, delete the contents of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2754. installation directory.&nbsp;<!--
  2755. <li> If you're using Bugzilla, run <code class="source">r.dt.bugzilla.drop_p4dti_tables()</code> to delete the <abbr title="Perforce Defect Tracking Integration">P4DTI</abbr> tables from the database, and restore the backup copy of Bugzilla that you made before you installed the <abbr title="Perforce Defect Tracking Integration">P4DTI</abbr> (see <a href="#section-3.4.2">section 3.4.2, "Procedural prerequisites"</a>). </li>
  2756. --></ol>
  2757.  
  2758. <h2>
  2759. <a NAME="section-11" id="section-11"></a>11. Troubleshooting and error
  2760. messages</h2>
  2761.  
  2762. <h3>
  2763. <a NAME="section-11.1" id="section-11.1"></a>11.1. Troubleshooting</h3>
  2764. To troubleshoot a problem with the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  2765. follow these steps:
  2766. <ol>Look in the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2767. log. If you find an error message, see if it is listed in <a href="#section-11.2">section
  2768. 11.2, "Error messages"</a>.
  2769. <p>Check your configuration against <a href="#section-5.1">section 5.1,
  2770. "<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr> configuration"</a>.
  2771. Are the hostnames, userids, and passwords correct? Most problems with the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2772. are caused by incorrect or inconsistent configuration.
  2773. <p>See if there is any online support for your problem. Visit the P4DTI
  2774. issue reports page &lt;<a href="http://www.ravenbrook.com/project/p4dti/issue/">http://www.ravenbrook.com/project/p4dti/issue/</a>>,
  2775. choose your release and select the "Support information" report.
  2776. <p>If you can't solve the problem, contact Perforce support (for details,
  2777. see &lt;<a href="http://www.perforce.com/perforce/support.html">http://www.perforce.com/perforce/support.html</a>>).
  2778. Provide the following information:
  2779. <ol type="a">
  2780. <li>
  2781. What you did immediately prior to the error's occurrence.</li>
  2782.  
  2783. <li>
  2784. What you think should have happened.</li>
  2785.  
  2786. <li>
  2787. What actually happened.</li>
  2788.  
  2789. <li>
  2790. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2791. release you are using (look in the <tt>readme.txt</tt> that came with your&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2792. distribution to identify the release).</li>
  2793.  
  2794. <li>
  2795. The Perforce release you are using. To determine your Perforce release,
  2796. enter "<tt>p4 info</tt>" at the operating system command line.</li>
  2797.  
  2798. <li>
  2799. The name and release of the defect tracker you are using. To determine
  2800. your TeamTrack release, click the information symbol in the top right of
  2801. the page; include the Version, Browser, Web Server and Database entries
  2802. in your problem report. To determine your Bugzilla release, check the top
  2803. of a bug form.</li>
  2804.  
  2805. <li>
  2806. A section of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2807. log that includes the error that you're reporting and some context around
  2808. that error.</li>
  2809.  
  2810. <li>
  2811. Copies of any related e-mail messages generated by the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.</li>
  2812.  
  2813. <li>
  2814. A copy of your <tt>config.py</tt> file.</li>
  2815. </ol>
  2816. </ol>
  2817.  
  2818. <h3>
  2819. <a NAME="section-11.2" id="section-11.2"></a>11.2. Error messages by identifier</h3>
  2820. This isn't a complete list, but it covers the errors that have been seen
  2821. in testing, or which are reasonably likely to come up, or which need some
  2822. explanation. If you see a message not covered in this section or <a href="#section-11.3">section
  2823. 11.3, "Other error messages"</a> and which is not self-explanatory, please
  2824. contact Perforce support (see <a href="#section-11.1">section 11.1, "Troubleshooting"</a>).
  2825. <h4>
  2826. <a NAME="message-P4DTI-1058" id="message-P4DTI-1058"></a>(P4DTI-1058) Given
  2827. '%s' when expecting a string or integer.&nbsp;<br />
  2828. <a NAME="message-P4DTI-1069" id="message-P4DTI-1069"></a>(P4DTI-1069) Select
  2829. '%s' of %s returns no rows.&nbsp;<br />
  2830. <a NAME="message-P4DTI-107X" id="message-P4DTI-107X"></a>(P4DTI-107X) Select
  2831. '%s' of %s expecting one row but returns %d.&nbsp;<br />
  2832. <a NAME="message-P4DTI-1080" id="message-P4DTI-1080"></a>(P4DTI-1080) Trying
  2833. to fetch a row from non-select '%s'.&nbsp;<br />
  2834. <a NAME="message-P4DTI-1091" id="message-P4DTI-1091"></a>(P4DTI-1091) Select
  2835. '%s' of %s returned an unfetchable row.&nbsp;<br />
  2836. <a NAME="message-P4DTI-1105" id="message-P4DTI-1105"></a>(P4DTI-1105) Trying
  2837. to fetch rows from non-select '%s'.&nbsp;<br />
  2838. <a NAME="message-P4DTI-1116" id="message-P4DTI-1116"></a>(P4DTI-1116) Select
  2839. '%s' of %s returned unfetchable rows.&nbsp;<br />
  2840. <a NAME="message-P4DTI-1127" id="message-P4DTI-1127"></a>(P4DTI-1127) Select
  2841. '%s' of %s expecting no more than one row but returns %d.&nbsp;<br />
  2842. <a NAME="message-P4DTI-1138" id="message-P4DTI-1138"></a>(P4DTI-1138) Select
  2843. '%s' of %s returns %d columns but %d values.&nbsp;<br />
  2844. <a NAME="message-P4DTI-1160" id="message-P4DTI-1160"></a>(P4DTI-1160) Couldn't
  2845. insert row in table '%s'.&nbsp;<br />
  2846. <a NAME="message-P4DTI-1171" id="message-P4DTI-1171"></a>(P4DTI-1171) Couldn't
  2847. update row in table '%s' where %s.&nbsp;<br />
  2848. <a NAME="message-P4DTI-1229" id="message-P4DTI-1229"></a>(P4DTI-1229) Nothing
  2849. in p4dti_replications table: database corrupted?&nbsp;<br />
  2850. <a NAME="message-P4DTI-1273" id="message-P4DTI-1273"></a>(P4DTI-1273) Bugzilla's
  2851. fielddefs table does not include '%s'.</h4>
  2852. The replicator has had an unexpected difficulty in accessing the Bugzilla
  2853. database. Possibly there is a problem with MySQL or MySQLdb. Possibly you
  2854. are running a version of Bugzilla which is incompatible with the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  2855. or have customized Bugzilla in such a way that the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2856. has become confused. Please contact Perforce support (see <a href="#section-11.1">section
  2857. 11.1, "Troubleshooting"</a>).
  2858. <h4>
  2859. <a NAME="message-P4DTI-1207" id="message-P4DTI-1207"></a>(P4DTI-1207) Unknown
  2860. or future P4DTI/Bugzilla schema version %s detected.</h4>
  2861. It looks as though you've been running with a later release of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2862. and then downgraded to an older release. We don't support downgrading;
  2863. use the most recent release.
  2864. <h4>
  2865. <a NAME="message-P4DTI-123X" id="message-P4DTI-123X"></a>(P4DTI-123X) Bugzilla
  2866. version %s is not supported by the P4DTI.</h4>
  2867. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2868. doesn't support your version of Bugzilla. Upgrade to a supported release
  2869. (see <a href="#section-3.4.1">section 3.4.1</a>).
  2870. <h4>
  2871. <a NAME="message-P4DTI-2006" id="message-P4DTI-2006"></a>(P4DTI-2006) Configuration
  2872. parameter '%s' must be 0 or 1.&nbsp;<br />
  2873. <a NAME="message-P4DTI-2017" id="message-P4DTI-2017"></a>(P4DTI-2017) Configuration
  2874. parameter '%s' (value '%s') is not a valid date. The right format is 'YYYY-MM-DD
  2875. HH:MM:SS'.&nbsp;<br />
  2876. <a NAME="message-P4DTI-2028" id="message-P4DTI-2028"></a>(P4DTI-2028) Configuration
  2877. parameter '%s' (value '%s') is not a valid e-mail address.&nbsp;<br />
  2878. <a NAME="message-P4DTI-2039" id="message-P4DTI-2039"></a>(P4DTI-2039) Configuration
  2879. parameter '%s' must be a function.&nbsp;<br />
  2880. <a NAME="message-P4DTI-204X" id="message-P4DTI-204X"></a>(P4DTI-204X) Configuration
  2881. parameter '%s' must be an integer.&nbsp;<br />
  2882. <a NAME="message-P4DTI-2050" id="message-P4DTI-2050"></a>(P4DTI-2050) Configuration
  2883. parameter '%s' must be a list.&nbsp;<br />
  2884. <a NAME="message-P4DTI-2061" id="message-P4DTI-2061"></a>(P4DTI-2061) Configuration
  2885. parameter '%s' must be a list of %s.&nbsp;<br />
  2886. <a NAME="message-P4DTI-2072" id="message-P4DTI-2072"></a>(P4DTI-2072) Configuration
  2887. parameter '%s' must be a string.&nbsp;<br />
  2888. <a NAME="message-P4DTI-2083" id="message-P4DTI-2083"></a>(P4DTI-2083) Configuration
  2889. parameter '%s' must be None or a string.&nbsp;<br />
  2890. <a NAME="message-P4DTI-2094" id="message-P4DTI-2094"></a>(P4DTI-2094) Configuration
  2891. parameter '%s' (value '%s') must be from 1 to 32 characters long, start
  2892. with a letter or number, and consist of letters, numbers and underscores
  2893. only.&nbsp;<br />
  2894. <a NAME="message-P4DTI-2108" id="message-P4DTI-2108"></a>(P4DTI-2108) Configuration
  2895. parameter '%s' (value '%s') must contain exactly one %%d format specifier,
  2896. any number of doubled percents, but no other format specifiers.&nbsp;<br />
  2897. <a NAME="message-P4DTI-2119" id="message-P4DTI-2119"></a>(P4DTI-2119) Configuration
  2898. parameter '%s' (value '%s') must contain exactly one %%s format specifier,
  2899. any number of doubled percents, but no other format specifiers.</h4>
  2900. Preliminary checking of the parameters set in <tt>config.py</tt> has found
  2901. a problem. Correct the named parameter and start the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2902. again.
  2903. <h4>
  2904. <a NAME="message-P4DTI-3009" id="message-P4DTI-3009"></a>(P4DTI-3009) Two
  2905. Bugzilla states '%s' and '%s' map to the same Perforce state '%s'.</h4>
  2906. You are running a version of Bugzilla with different bug statuses from
  2907. those in Bugzilla 2.10, 2.12, 2.14, or 2.14.1. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2908. has attempted to choose a sensible translation of these bug statuses to
  2909. Perforce job states, but has failed. You may be able to fix this by changing
  2910. the <tt><a href="#config-closed_state-Bugzilla">closed_state</a></tt> parameter.
  2911. Otherwise you must modify your Bugzilla configuration.
  2912. <p>The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2913. chooses the names of states of Perforce jobs based on the status names
  2914. in Bugzilla. It uses the following translation system:
  2915. <ul>
  2916. <li>
  2917. To avoid user confusion in the Perforce interface, the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2918. translates all state names to lower case.</li>
  2919.  
  2920. <li>
  2921. Perforce job states can't contain spaces and various other characters,
  2922. so the&nbsp;<abbr title="Perforce Defect Tracking
  2923. Integration">P4DTI</abbr>
  2924. translates spaces to underscores, and translates other special characters.</li>
  2925.  
  2926. <li>
  2927. If the <tt><a href="#config-closed_state-Bugzilla">closed_state</a></tt>
  2928. parameter is not None, the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2929. translates this status to "closed" and translates "CLOSED" to "bugzilla_closed".</li>
  2930.  
  2931. <li>
  2932. Perforce jobs can't have the state "new" or "ignore", because these states
  2933. have special meaning to the Perforce server. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2934. prefixes a Bugzilla status which would translate to either of these with
  2935. "bugzilla_", so (in particular) "NEW" translates to Perforce state "bugzilla_new".</li>
  2936. </ul>
  2937. For instance, if the <tt><a href="#config-closed_state-Bugzilla">closed_state</a></tt>
  2938. parameter is <tt>"RESOLVED"</tt>, the&nbsp;<abbr title="Perforce Defect
  2939. Tracking Integration">P4DTI</abbr>
  2940. uses the following translation table for the default Bugzilla statuses:&nbsp;
  2941. <center><table BORDER CELLSPACING=0 CELLPADDING=5 >
  2942. <tr ALIGN=LEFT VALIGN=TOP>
  2943. <th>Bugzilla status</th>
  2944.  
  2945. <th>Perforce state</th>
  2946. </tr>
  2947.  
  2948. <tr ALIGN=LEFT VALIGN=TOP>
  2949. <td>UNCONFIRMED</td>
  2950.  
  2951. <td>unconfirmed</td>
  2952. </tr>
  2953.  
  2954. <tr ALIGN=LEFT VALIGN=TOP>
  2955. <td>NEW</td>
  2956.  
  2957. <td>bugzilla_new</td>
  2958. </tr>
  2959.  
  2960. <tr ALIGN=LEFT VALIGN=TOP>
  2961. <td>ASSIGNED</td>
  2962.  
  2963. <td>assigned</td>
  2964. </tr>
  2965.  
  2966. <tr ALIGN=LEFT VALIGN=TOP>
  2967. <td>RESOLVED</td>
  2968.  
  2969. <td>closed</td>
  2970. </tr>
  2971.  
  2972. <tr ALIGN=LEFT VALIGN=TOP>
  2973. <td>VERIFIED</td>
  2974.  
  2975. <td>verified</td>
  2976. </tr>
  2977.  
  2978. <tr ALIGN=LEFT VALIGN=TOP>
  2979. <td>CLOSED</td>
  2980.  
  2981. <td>bugzilla_closed</td>
  2982. </tr>
  2983.  
  2984. <tr ALIGN=LEFT VALIGN=TOP>
  2985. <td>REOPENED</td>
  2986.  
  2987. <td>reopened</td>
  2988. </tr>
  2989. </table></center>
  2990. Alternatively, if the <tt><a href="#config-closed_state-Bugzilla">closed_state</a></tt>
  2991. parameter is <tt>"CLOSED"</tt> or <tt>None</tt>, the<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  2992. uses the following translation table for the default Bugzilla statuses:&nbsp;
  2993. <center><table BORDER CELLSPACING=0 CELLPADDING=5 >
  2994. <tr ALIGN=LEFT VALIGN=TOP>
  2995. <th>Bugzilla status</th>
  2996.  
  2997. <th>Perforce state</th>
  2998. </tr>
  2999.  
  3000. <tr ALIGN=LEFT VALIGN=TOP>
  3001. <td>UNCONFIRMED</td>
  3002.  
  3003. <td>unconfirmed</td>
  3004. </tr>
  3005.  
  3006. <tr ALIGN=LEFT VALIGN=TOP>
  3007. <td>NEW</td>
  3008.  
  3009. <td>bugzilla_new</td>
  3010. </tr>
  3011.  
  3012. <tr ALIGN=LEFT VALIGN=TOP>
  3013. <td>ASSIGNED</td>
  3014.  
  3015. <td>assigned</td>
  3016. </tr>
  3017.  
  3018. <tr ALIGN=LEFT VALIGN=TOP>
  3019. <td>RESOLVED</td>
  3020.  
  3021. <td>resolved</td>
  3022. </tr>
  3023.  
  3024. <tr ALIGN=LEFT VALIGN=TOP>
  3025. <td>VERIFIED</td>
  3026.  
  3027. <td>verified</td>
  3028. </tr>
  3029.  
  3030. <tr ALIGN=LEFT VALIGN=TOP>
  3031. <td>CLOSED</td>
  3032.  
  3033. <td>closed</td>
  3034. </tr>
  3035.  
  3036. <tr ALIGN=LEFT VALIGN=TOP>
  3037. <td>REOPENED</td>
  3038.  
  3039. <td>reopened</td>
  3040. </tr>
  3041. </table></center>
  3042.  
  3043. <h4>
  3044. <a NAME="message-P4DTI-301X" id="message-P4DTI-301X"></a>(P4DTI-301X) You
  3045. specified the closed_state '%s', but there's no such Bugzilla state.</h4>
  3046. Check the <tt><a href="#config-closed_state-Bugzilla">closed_state</a></tt>
  3047. parameter. It must be a valid Bugzilla state.
  3048. <h4>
  3049. <a NAME="message-P4DTI-3020" id="message-P4DTI-3020"></a>(P4DTI-3020) The
  3050. '%s' column of Bugzilla's 'bugs' table is not an enum type.</h4>
  3051. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3052. is incompatible with the version of Bugzilla which you are running. You
  3053. are running a very old version of Bugzilla, or have customized Bugzilla.
  3054. <h4>
  3055. <a NAME="message-P4DTI-3031" id="message-P4DTI-3031"></a>(P4DTI-3031) Configuration
  3056. parameter 'bugzilla_directory' does not name a directory.&nbsp;<br />
  3057. <a NAME="message-P4DTI-3042" id="message-P4DTI-3042"></a>(P4DTI-3042) Configuration
  3058. parameter 'bugzilla_directory' does not name a directory containing a processmail
  3059. script.</h4>
  3060. Check the <tt><a href="#config-bugzilla_directory">bugzilla_directory</a></tt>
  3061. parameter. It must either be <tt>None</tt> or a string naming the Bugzilla
  3062. installation directory.
  3063. <h4>
  3064. <a NAME="message-P4DTI-3053" id="message-P4DTI-3053"></a>(P4DTI-3053) Bugzilla's
  3065. table 'profiles' does not have a 'login_name' column.&nbsp;<br />
  3066. <a NAME="message-P4DTI-3064" id="message-P4DTI-3064"></a>(P4DTI-3064) The
  3067. 'login_name' column of Bugzilla's 'profiles' table does not have a 'text'
  3068. type.&nbsp;<br />
  3069. <a NAME="message-P4DTI-3075" id="message-P4DTI-3075"></a>(P4DTI-3075) Bugzilla's
  3070. table 'bugs' does not have a '%s' column.&nbsp;<br />
  3071. <a NAME="message-P4DTI-3086" id="message-P4DTI-3086"></a>(P4DTI-3086) The
  3072. 'bug_status' column of Bugzilla's 'bugs' table is not an enum type.&nbsp;<br />
  3073. <a NAME="message-P4DTI-3097" id="message-P4DTI-3097"></a>(P4DTI-3097) The
  3074. 'resolution' column of Bugzilla's 'bugs' table is not an enum type.&nbsp;<br />
  3075. <a NAME="message-P4DTI-3100" id="message-P4DTI-3100"></a>(P4DTI-3100) The
  3076. 'resolution' column of Bugzilla's 'bugs' table does not have a 'FIXED'
  3077. value.</h4>
  3078. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3079. is incompatible with the version of Bugzilla which you are running. You
  3080. are running a very old version of Bugzilla, or have customized Bugzilla.
  3081. <h4>
  3082. <a NAME="message-P4DTI-3111" id="message-P4DTI-3111"></a>(P4DTI-3111) Field
  3083. '%s' specified in 'replicated_fields' is a system field: leave it out!</h4>
  3084. Some fields are always replicated. For details, see the <tt><a href="#config-replicated_fields-Bugzilla">replicated_fields</a></tt>
  3085. parameter.
  3086. <p>Remove the system fields from your list of replicated fields and start
  3087. the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3088. again.
  3089. <h4>
  3090. <a NAME="message-P4DTI-3122" id="message-P4DTI-3122"></a>(P4DTI-3122) Field
  3091. '%s' appears twice in 'replicated_fields'.</h4>
  3092. Each replicated field must only appear once in the <tt><a href="#config-replicated_fields-Bugzilla">replicated_fields</a></tt>
  3093. parameter. Remove the duplicate and start the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3094. again.
  3095. <h4>
  3096. <a NAME="message-P4DTI-3133" id="message-P4DTI-3133"></a>(P4DTI-3133) Field
  3097. '%s' specified in 'replicated_fields' list not in Bugzilla 'bugs' table.</h4>
  3098. The <tt><a href="#config-replicated_fields-Bugzilla">replicated_fields</a></tt>
  3099. parameter specifies a field which is not in Bugzilla.
  3100. <h4>
  3101. <a NAME="message-P4DTI-3144" id="message-P4DTI-3144"></a>(P4DTI-3144) Field
  3102. '%s' specified in 'replicated_fields' list has type '%s': this is not yet
  3103. supported by P4DTI.&nbsp;<br />
  3104. <a NAME="message-P4DTI-3155" id="message-P4DTI-3155"></a>(P4DTI-3155) Field
  3105. '%s' specified in 'replicated_fields' list has floating-point type: this
  3106. is not yet supported by P4DTI.</h4>
  3107. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3108. doesn't support all Bugzilla field types. One of the fields in your <tt><a href="#config-replicated_fields-Bugzilla">replicated_fields</a></tt>
  3109. parameter has an unsupported type.
  3110. <p>Remove the field from your <tt><a href="#config-replicated_fields-Bugzilla">replicated_fields</a></tt>
  3111. and start the replicator again.
  3112. <p>If you really need this field to be replicated, see the advice for <a href="#message-P4DTI-4067">(P4DTI-4067)</a>.
  3113. <h4>
  3114. <a NAME="message-P4DTI-3166" id="message-P4DTI-3166"></a>(P4DTI-3166) You
  3115. can't have a field called 'code' in the Perforce jobspec.</h4>
  3116. You are running a version of Bugzilla with different bug fields from those
  3117. in Bugzilla 2.10, 2.12, 2.14, or 2.14.1, and are trying to replicate a
  3118. field called "code". Perforce doesn't allow a job field called "code".
  3119. Remove the "code" field from the <tt><a href="#config-replicated_fields-Bugzilla">replicated_fields</a></tt>
  3120. parameter or modify your Bugzilla configuration to rename the field.
  3121. <h4>
  3122. <a NAME="message-P4DTI-3177" id="message-P4DTI-3177"></a>(P4DTI-3177) Too
  3123. many fields to replicate: Perforce jobs can contain only 99 fields.</h4>
  3124. Reduce the number of fields that you replicate by removing items from the
  3125. <tt><a href="#config-replicated_fields-Bugzilla">replicated_fields</a></tt>
  3126. parameter.
  3127. <h4>
  3128. <a NAME="message-P4DTI-4001" id="message-P4DTI-4001"></a>(P4DTI-4001) Two
  3129. TeamTrack states '%s' and '%s' map to the same Perforce state '%s'.</h4>
  3130. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3131. chooses the names of states of Perforce jobs based on the state names in
  3132. TeamTrack. It uses the following mapping system:
  3133. <ul>
  3134. <li>
  3135. Perforce job states can't contain spaces and various other characters,
  3136. so the&nbsp;<abbr title="Perforce Defect Tracking
  3137. Integration">P4DTI</abbr>
  3138. maps spaces to underscores, and translates other special characters.</li>
  3139.  
  3140. <li>
  3141. To avoid user confusion in the Perforce interface, the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3142. maps all state names to lower case, which means that you can't have defect
  3143. tracker states which are only distinguished by differences in case. (But
  3144. note that in TeamTrack, which has different issue workflows for different
  3145. projects, it's OK to have states with the same name as long as they are
  3146. in different projects.)</li>
  3147.  
  3148. <li>
  3149. Perforce jobs can't have the state "new" or "ignore", because these states
  3150. have special meaning to the Perforce server. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3151. maps a defect tracker state "new" (or "New", "NEW", and so on) to Perforce
  3152. state "_new" and a defect tracker state "ignore" to Perforce state "_ignore".
  3153. This mapping system means that you also can't have states called " new"
  3154. or " ignore" with an initial space (or " New", " Ignore", and so on) in
  3155. the defect tracker at the same time as one called "new" or "ignore".</li>
  3156. </ul>
  3157. Resolve this problem by making the state names distinct in TeamTrack. Do
  3158. not use spaces at the beginning of state names.
  3159. <h4>
  3160. <a NAME="message-P4DTI-4012" id="message-P4DTI-4012"></a>(P4DTI-4012) You
  3161. specified the closed_state '%s', but there's no such TeamTrack state.</h4>
  3162. See <a href="#message-P4DTI-301X">(P4DTI-301X)</a>.
  3163. <h4>
  3164. <a NAME="message-P4DTI-4023" id="message-P4DTI-4023"></a>(P4DTI-4023) Couldn't
  3165. get descriptions for TeamTrack system fields STATE, OWNER, and TITLE.</h4>
  3166. You may be using a version of TeamTrack with a release of the&nbsp;<abbr
  3167. title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3168. that doesn't support it. If so, upgrade to a&nbsp;<abbr title="Perforce Defect Tracking
  3169. Integration">P4DTI</abbr>
  3170. release that supports your version of TeamTrack.
  3171. <p>This could happen if you don't have a tTrack solution in your TeamTrack
  3172. database. If so, create one.
  3173. <h4>
  3174. <a NAME="message-P4DTI-4034" id="message-P4DTI-4034"></a>(P4DTI-4034) Field
  3175. '%s' specified in 'replicated_fields' list not in TeamTrack FIELDS table.</h4>
  3176. You can specify a list of fields for the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3177. to replicate into jobs; for details, see the <tt><a href="#config-replicated_fields-TeamTrack">replicated_fields</a></tt>
  3178. parameter. This error means that the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3179. couldn't find one of the fields in the list. This problem might happen
  3180. if you change the set of fields in TeamTrack.
  3181. <p>Double-check the field names you specified as the <tt>replicated_fields</tt>.
  3182. If you're changing fields in TeamTrack, see <a href="#section-9">section
  3183. 9, "Maintaining the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>"</a>,
  3184. for important information.
  3185. <h4>
  3186. <a NAME="message-P4DTI-4045" id="message-P4DTI-4045"></a>(P4DTI-4045) Field
  3187. '%s' specified in 'replicated_fields' list is a system field: leave it
  3188. out!</h4>
  3189. See <a href="#message-P4DTI-3111">(P4DTI-3111)</a>.
  3190. <h4>
  3191. <a NAME="message-P4DTI-4056" id="message-P4DTI-4056"></a>(P4DTI-4056) Field
  3192. '%s' appears twice in 'replicated_fields'.</h4>
  3193. See <a href="#message-P4DTI-3122">(P4DTI-3122)</a>.
  3194. <h4>
  3195. <a NAME="message-P4DTI-4067" id="message-P4DTI-4067"></a>(P4DTI-4067) Field
  3196. '%s' has type %d: this is not supported by P4DTI.</h4>
  3197. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3198. doesn't support all TeamTrack field types. One of the fields in your <tt><a href="#config-replicated_fields-TeamTrack">replicated_fields</a></tt>
  3199. parameter has an unsupported type.
  3200. <p>You can determine the list of supported types from the <tt>type_table</tt>
  3201. in <tt>configure_teamtrack.py</tt>. The most notable unsupported type is
  3202. "MULTIPLE_SELECTION", because Perforce does not provide any kind of multiple
  3203. selection interface.
  3204. <p>If you really need to have the field replicated, you have the following
  3205. options:
  3206. <ul>
  3207. <li>
  3208. Change the set of fields in TeamTrack to avoid the type.</li>
  3209.  
  3210. <li>
  3211. Change your workflow to avoid needing that particular field from the Perforce
  3212. interface.</li>
  3213.  
  3214. <li>
  3215. Submit a request to Perforce.</li>
  3216.  
  3217. <li>
  3218. Implement a new subclass of <tt>replicator.translator</tt> to handle the
  3219. field type (for the existing translators, see <tt>dt_teamtrack.py</tt>).
  3220. For instructions on how to extend the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>,
  3221. and how to contribute your extensions back to the community, see the <i>Perforce
  3222. Defect Tracking Integration Integrator's Guide</i>.</li>
  3223. </ul>
  3224.  
  3225. <h4>
  3226. <a NAME="message-P4DTI-4078" id="message-P4DTI-4078"></a>(P4DTI-4078) You
  3227. can't have a field called 'code' in the Perforce jobspec.</h4>
  3228. Perforce uses the field "code" to pass internal status information to clients.
  3229. <p>In TeamTrack, change the logical name of the field to something other
  3230. than "code" by following these steps:
  3231. <ol>
  3232. <li>
  3233. Run the TeamTrack Administrator. (Under Windows, choose Start > Programs
  3234. > TeamShare > TeamTrack Administrator.)</li>
  3235.  
  3236. <li>
  3237. Select the Workflow tab.</li>
  3238.  
  3239. <li>
  3240. Select the workflow containing the field called "code".</li>
  3241.  
  3242. <li>
  3243. Click the Edit button.</li>
  3244.  
  3245. <li>
  3246. Select the Default Fields tab.</li>
  3247.  
  3248. <li>
  3249. Select the "code" field.</li>
  3250.  
  3251. <li>
  3252. Click the Edit button.</li>
  3253.  
  3254. <li>
  3255. Change the Logical Field Name.</li>
  3256.  
  3257. <li>
  3258. Click OK.</li>
  3259.  
  3260. <li>
  3261. Click OK again.</li>
  3262. </ol>
  3263.  
  3264. <h4>
  3265. <a NAME="message-P4DTI-4089" id="message-P4DTI-4089"></a>(P4DTI-4089) Too
  3266. many fields to replicate: Perforce jobs can contain only 99 fields.</h4>
  3267. See <a href="#message-P4DTI-3177">(P4DTI-3177)</a>.
  3268. <h4>
  3269. <a NAME="message-P4DTI-5004" id="message-P4DTI-5004"></a>(P4DTI-5004) User
  3270. %d isn't in the right bug group to edit bug %d.</h4>
  3271. A Perforce user has made a change to a bug which Bugzilla would not allow
  3272. them to edit.
  3273. <p>Bugzilla bugs can be grouped into "bug groups", which restrict the ability
  3274. of users to view or edit them. Perforce protections cannot express these
  3275. bug groups, so the replicator must enforce the Bugzilla restrictions by
  3276. rejecting changes made by users outside the necessary bug group.
  3277. <p>Another possible cause is that the&nbsp;<abbr title="Perforce Defect
  3278. Tracking Integration">P4DTI</abbr>
  3279. has failed to find a Bugzilla user corresponding to the Perforce user.
  3280. See <a href="#section-3.5">section 3.5, "User accounts"</a> for details
  3281. of how users are mapped from one system to the other, and how to diagnose
  3282. problems.
  3283. <h4>
  3284. <a NAME="message-P4DTI-5015" id="message-P4DTI-5015"></a>(P4DTI-5015) User
  3285. %d doesn't have permission to change field '%s' of bug %d to %s.</h4>
  3286. A Perforce user has made a change which Bugzilla would not have permitted
  3287. them to make.
  3288. <p>Bugzilla has complex access controls which prohibit some users from
  3289. making some changes to bugs. Perforce protections cannot express these
  3290. controls so the replicator enforces these controls by rejecting changes
  3291. to jobs which would not be permitted by Bugzilla.
  3292. <p>Another possible cause is that the&nbsp;<abbr title="Perforce Defect
  3293. Tracking Integration">P4DTI</abbr>
  3294. has failed to find a Bugzilla user corresponding to the Perforce user.
  3295. See <a href="#section-3.5">section 3.5, "User accounts"</a> for details
  3296. of how users are mapped from one system to the other, and how to diagnose
  3297. problems.
  3298. <h4>
  3299. <a NAME="message-P4DTI-5026" id="message-P4DTI-5026"></a>(P4DTI-5026) The
  3300. P4DTI does not support marking bugs as DUPLICATE from Perforce.</h4>
  3301. A Perforce user has changed a job's status to "duplicate".
  3302. <p>When a bug is marked as a duplicate in Bugzilla, the number of the other
  3303. bug is provided and a message identifying it is appended to the long description.
  3304. The Perforce job interface provides no easy way of expressing this, so
  3305. the replicator does not allow it.
  3306. <h4>
  3307. <a NAME="message-P4DTI-5037" id="message-P4DTI-5037"></a>(P4DTI-5037) Bugzilla
  3308. does not allow a transition from status '%s' to '%s'.</h4>
  3309. A Perforce user has changed the 'status' field of a bug in a way not permitted
  3310. by Bugzilla. For instance, moving a bug directly from UNCONFIRMED to CLOSED.
  3311. These transitions are not allowed in Bugzilla, and the replicator enforces
  3312. that prohibition by rejecting such a change.
  3313. <p>It is difficult but possible to cause this error by making more than
  3314. one change to the status in rapid succession (between two consecutive replicator
  3315. polls). The replicator can't tell if that has happened, so has to reject
  3316. the change anyway.
  3317. <h4>
  3318. <a NAME="message-P4DTI-5048" id="message-P4DTI-5048"></a>(P4DTI-5048) Cannot
  3319. change Bugzilla field '%s'.</h4>
  3320. A Perforce user has made a change to a field which the replicator treats
  3321. as read-only. See <a href="#section-5.1.5">section 5.1.5, "Choosing which
  3322. fields to replicate"</a>.
  3323. <h4>
  3324. <a NAME="message-P4DTI-5059" id="message-P4DTI-5059"></a>(P4DTI-5059) Can
  3325. only append to Bugzilla field '%s'.</h4>
  3326. A Perforce user has changed the long description text in some way other
  3327. than appending to it. See <a href="#section-5.1.5">section 5.1.5, "Choosing
  3328. which fields to replicate"</a>.
  3329. <h4>
  3330. <a NAME="message-P4DTI-506X" id="message-P4DTI-506X"></a>(P4DTI-506X) Updating
  3331. non-existent Bugzilla field '%s'.&nbsp;<br />
  3332. <a NAME="message-P4DTI-5092" id="message-P4DTI-5092"></a>(P4DTI-5092) No
  3333. Perforce status corresponding to Bugzilla status '%s'.&nbsp;<br />
  3334. <a NAME="message-P4DTI-5106" id="message-P4DTI-5106"></a>(P4DTI-5106) No
  3335. Bugzilla status corresponding to Perforce status '%s'.</h4>
  3336. These errors indicate a serious configuration error; someone's changed
  3337. configure_bugzilla.py and broken it.
  3338. <h4>
  3339. <a NAME="message-P4DTI-5070" id="message-P4DTI-5070"></a>(P4DTI-5070) Bugzilla
  3340. does not have a group called '%s'.&nbsp;<br />
  3341. <a NAME="message-P4DTI-5081" id="message-P4DTI-5081"></a>(P4DTI-5081) Bugzilla's
  3342. fielddefs table does not include '%s'.</h4>
  3343. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3344. is incompatible with the version of Bugzilla which you are running. You
  3345. are running a very old version of Bugzilla, or have customized Bugzilla.
  3346. <h4>
  3347. <a NAME="message-P4DTI-5117" id="message-P4DTI-5117"></a>(P4DTI-5117) Perforce
  3348. field value '%s' could not be translated to a number for replication to
  3349. Bugzilla.</h4>
  3350. A Perforce user has set a field, which corresponds to a numeric field in
  3351. Bugzilla, to something which couldn't be converted to a number.
  3352. <h4>
  3353. <a NAME="message-P4DTI-5128" id="message-P4DTI-5128"></a>(P4DTI-5128) Bugzilla
  3354. P4DTI user '%s' has e-mail address matching Perforce user '%s', not Perforce
  3355. P4DTI user '%s'.</h4>
  3356. The replicator Perforce user (<tt><a href="#config-p4_user">p4_user</a></tt>
  3357. parameter) has an e-mail address that does not match the <tt><a href="#config-replicator_address">replicator_address</a></tt>
  3358. parameter. See <a href="#section-5.2.1">section 5.2.1, "Creating a Perforce
  3359. user for the replicator"</a>.
  3360. <h4>
  3361. <a NAME="message-P4DTI-5139" id="message-P4DTI-5139"></a>(P4DTI-5139) Bugzilla
  3362. P4DTI user '%s' is not a known Bugzilla user.</h4>
  3363. There is no Bugzilla user whose e-mail address matches the <tt><a href="#config-replicator_address">replicator_address</a></tt>
  3364. parameter. See <a href="#section-5.4.2">section 5.4.2, "Creating a Bugzilla
  3365. user for the replicator"</a>.
  3366. <h4>
  3367. <a NAME="message-P4DTI-514X" id="message-P4DTI-514X"></a>(P4DTI-514X) There
  3368. is no Bugzilla user corresponding to Perforce user '%s'.</h4>
  3369. You have changed a user field in a job to a Perforce user who does not
  3370. have a Bugzilla user record. The replicator is unable to replicate that
  3371. field back to Bugzilla.
  3372. <h4>
  3373. <a NAME="message-P4DTI-5172" id="message-P4DTI-5172"></a>(P4DTI-5172) Can't
  3374. create Bugzilla bug without short_desc field.&nbsp;<br />
  3375. <a NAME="message-P4DTI-5183" id="message-P4DTI-5183"></a>(P4DTI-5183) Can't
  3376. create Bugzilla bug with empty short_desc field.&nbsp;<br />
  3377. <a NAME="message-P4DTI-5194" id="message-P4DTI-5194"></a>(P4DTI-5194) Can't
  3378. create Bugzilla bug without product field.&nbsp;<br />
  3379. <a NAME="message-P4DTI-5208" id="message-P4DTI-5208"></a>(P4DTI-5208) Can't
  3380. create Bugzilla bug for non-existent product '%s'.&nbsp;<br />
  3381. <a NAME="message-P4DTI-5219" id="message-P4DTI-5219"></a>(P4DTI-5219) Can't
  3382. create Bugzilla bug for product '%s' with no components.&nbsp;<br />
  3383. <a NAME="message-P4DTI-522X" id="message-P4DTI-522X"></a>(P4DTI-522X) Can't
  3384. create Bugzilla bug without component field.&nbsp;<br />
  3385. <a NAME="message-P4DTI-5230" id="message-P4DTI-5230"></a>(P4DTI-5230) Can't
  3386. create Bugzilla bug: product '%s' has no component '%s'.&nbsp;<br />
  3387. <a NAME="message-P4DTI-5241" id="message-P4DTI-5241"></a>(P4DTI-5241) Can't
  3388. create Bugzilla bug for product '%s' with no versions.&nbsp;<br />
  3389. <a NAME="message-P4DTI-5252" id="message-P4DTI-5252"></a>(P4DTI-5252) Can't
  3390. create Bugzilla bug without version field.&nbsp;<br />
  3391. <a NAME="message-P4DTI-5263" id="message-P4DTI-5263"></a>(P4DTI-5263) Can't
  3392. create Bugzilla bug: product '%s' has no version '%s'.&nbsp;<br />
  3393. <a NAME="message-P4DTI-5285" id="message-P4DTI-5285"></a>(P4DTI-5285) Can't
  3394. create Bugzilla bug with invalid groupset '%s'.&nbsp;<br />
  3395. <a NAME="message-P4DTI-530X" id="message-P4DTI-530X"></a>(P4DTI-530X) Can't
  3396. create Bugzilla bug with bug_status '%s' and no resolution.&nbsp;<br />
  3397. <a NAME="message-P4DTI-5310" id="message-P4DTI-5310"></a>(P4DTI-5310) Can't
  3398. create Bugzilla bug with field '%s'.&nbsp;<br />
  3399. <a NAME="message-P4DTI-5321" id="message-P4DTI-5321"></a>(P4DTI-5321) Can't
  3400. create Bugzilla bug without reporter field.</h4>
  3401. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3402. has tried to create a new bug in Bugzilla but the new bug doesn't satisfy
  3403. a Bugzilla constraint. There are two solutions:
  3404. <ul>Edit the Perforce job so that it can be translated to a new bug that
  3405. does satisfy the constraint.
  3406. <p>Change your <tt><a href="../aag/index.html#config-translate_jobspec">translate_jobspec</a></tt>
  3407. and <tt><a href="../aag/index.html#config-prepare_issue">prepare_issue</a></tt>
  3408. functions so that they satisfy the constraint. Then
  3409. <ul>If you were migrating, re-run the migration starting from the job which
  3410. couldn't be migrated [<a href="../aag/index.html#section-4.10" title="Perforce Defect
  3411.     Tracking Integration Advanced Administrator's Guide">GDR
  3412. 2001-11-14, 4.10</a>].
  3413. <p>Otherwise, restart the replicator (see <a href="#section-5.5">section
  3414. 5.5</a>) and update the job so that it is replicated again (by running
  3415. a command like <tt>p4 job -o <i>JOBNAME</i> | p4 job -i</tt>.</ul>
  3416. </ul>
  3417.  
  3418. <h4>
  3419. <a NAME="message-P4DTI-5354" id="message-P4DTI-5354"></a>(P4DTI-5354) '%s'
  3420. not a Bugzilla group.</h4>
  3421. An entry in <tt><a href="../aag/index.html#config-migrated_user_groups">migrated_user_groups</a></tt>
  3422. is not a Bugzilla group. Fix the parameter and re-run migration of users
  3423. [<a href="../aag/index.html#section-4.4" title="Perforce
  3424. Defect Tracking Integration Advanced Administrator's Guide">GDR
  3425. 2001-11-14, 4.4</a>].
  3426. <h4>
  3427. <a NAME="message-P4DTI-5376" id="message-P4DTI-5376"></a>(P4DTI-5376) User
  3428. %d is disabled, so cannot edit bug %d.</h4>
  3429.  
  3430. <h4>
  3431. <a NAME="message-P4DTI-5387" id="message-P4DTI-5387"></a>(P4DTI-5387) User
  3432. 0 cannot edit bug %d.</h4>
  3433.  
  3434. <h4>
  3435. <a NAME="message-P4DTI-5398" id="message-P4DTI-5398"></a>(P4DTI-5398) Can't
  3436. create Bugzilla bug with reporter 0.</h4>
  3437. The P4DTI has attempted to create a new Bugzilla bug (either as part of
  3438. migration of pre-existing jobs or when replicating a newly-created job),
  3439. and was unable to deduce the reporting user. See
  3440. <a href="../aag/index.html#section-3">section
  3441. 3, "Allowing users to create ussies in Perforce"</a> and <a href="../aag/index.html#section-4">section
  3442. 4, "Migrating to the defect tracker from Perforce jobs"</a> , of the
  3443. <i><a href="../aag/index.html">Perforce
  3444. Defect Tracking Integration Advanced Administrator's Guide</a></i>.
  3445. <h4>
  3446. <a NAME="message-P4DTI-5401" id="message-P4DTI-5401"></a>(P4DTI-5401) Can't
  3447. change Bugzilla field '%s' to 0.</h4>
  3448. A user in Perforce has changed one of the required user fields ("Reporter"
  3449. or "Assigned_To") to "None". This value is only permitted in the optional
  3450. user field ("QA_Contact").
  3451. <h4>
  3452. <a NAME="message-P4DTI-6142" id="message-P4DTI-6142"></a>(P4DTI-6142) No
  3453. transition from state '%s' to state '%s'.</h4>
  3454. A user in Perforce has changed the state of a job in an illegal fashion
  3455. (for example, changing the state from "assigned" to "verified", bypassing
  3456. the state "resolved").
  3457. <p>Either change the state in a legal way, or modify the TeamTrack workflow
  3458. so that there is a transition corresponding to the desired state change.
  3459. <h4>
  3460. <a NAME="message-P4DTI-6153" id="message-P4DTI-6153"></a>(P4DTI-6153) No
  3461. login id in TeamTrack's USERS table corresponding to replicator's login
  3462. id '%s'.</h4>
  3463. The replicator couldn't find an entry in TeamTrack's table of users for
  3464. its own login id. Did you delete this user accidentally? If so, add it
  3465. again and restart the&nbsp;<abbr title="Perforce Defect Tracking
  3466. Integration">P4DTI</abbr>.
  3467. If not, please contact Perforce support (see
  3468. <a href="#section-11.1">section
  3469. 11.1, "Troubleshooting"</a>).
  3470. <h4>
  3471. <a NAME="message-P4DTI-6164" id="message-P4DTI-6164"></a>(P4DTI-6164) No
  3472. LAST_CHANGE record for this replicator.</h4>
  3473. Someone has reconnected the TeamTrack server to a new TeamTrack database
  3474. without first stopping the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.
  3475. Either reconnect to the old TeamTrack database or restart the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.
  3476. <h4>
  3477. <a NAME="message-P4DTI-6175" id="message-P4DTI-6175"></a>(P4DTI-6175) TeamTrack
  3478. database version %d is not supported by the P4DTI. The minimum supported
  3479. version is %d.</h4>
  3480. You're running an old version of TeamTrack that isn't supported by the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.
  3481. Upgrade your TeamTrack server to a supported version. See <a href="#section-3.3.1">section
  3482. 3.3.1, "TeamTrack software prerequisites"</a>.
  3483. <h4>
  3484. <a NAME="message-P4DTI-6186" id="message-P4DTI-6186"></a>(P4DTI-6186) Incorrect
  3485. date in Perforce: '%s' is not in the format 'YYYY/mm/dd HH:MM:SS'.</h4>
  3486. You've entered something in a date/time field in Perforce that couldn't
  3487. be recognized as a date and time. Date/time values in Perforce must be
  3488. in the format year/month/day hour:minutes:seconds, with four digits for
  3489. the year, and two digits for everything else. For example,
  3490. <tt>2001/08/04
  3491. 04:14:56</tt>.
  3492. <h4>
  3493. <a NAME="message-P4DTI-6197" id="message-P4DTI-6197"></a>(P4DTI-6197) Incorrect
  3494. time in Perforce: '%s' is not in the format 'H:MM:SS'.</h4>
  3495. You've entered something in an elapsed time field in Perforce that couldn't
  3496. be recognized as an elapsed time. Elapsed time values in Perforce must
  3497. be in the format <tt>H:MM:SS</tt>. For example <tt>4:14:56</tt> or <tt>100:00:00</tt>.
  3498. <h4>
  3499. <a NAME="message-P4DTI-6211" id="message-P4DTI-6211"></a>(P4DTI-6211) No
  3500. TeamTrack entity in table '%s' with id %d.&nbsp;<br />
  3501. <a NAME="message-P4DTI-6233" id="message-P4DTI-6233"></a>(P4DTI-6233) No
  3502. TeamTrack selection name for selection id '%d'.&nbsp;<br />
  3503. <a NAME="message-P4DTI-6266" id="message-P4DTI-6266"></a>(P4DTI-6266) No
  3504. state name for TeamTrack state %d.</h4>
  3505. The TeamTrack database is inconsistent: a foreign key reference was not
  3506. found. If you've recently edited your TeamTrack workflow, then this might
  3507. be due to a race condition; try restarting the replicator (see <a href="#section-5.5">section
  3508. 5.5</a>). If the problem persists, contact Perforce support (see <a href="#section-11.1">section
  3509. 11.1, "Troubleshooting"</a>).
  3510. <h4>
  3511. <a NAME="message-P4DTI-6222" id="message-P4DTI-6222"></a>(P4DTI-6222) No
  3512. TeamTrack entity in table '%s' with name '%s'.&nbsp;<br />
  3513. <a NAME="message-P4DTI-6244" id="message-P4DTI-6244"></a>(P4DTI-6244) No
  3514. TeamTrack selection for field '%s' corresponding to Perforce selection
  3515. '%s'.&nbsp;<br />
  3516. <a NAME="message-P4DTI-6277" id="message-P4DTI-6277"></a>(P4DTI-6277) Perforce
  3517. state '%s' is unknown.&nbsp;<br />
  3518. <a NAME="message-P4DTI-6426" id="message-P4DTI-6426"></a>(P4DTI-6426) No
  3519. TeamTrack state corresponding to Perforce state '%s'.</h4>
  3520. A Perforce job has a field with a value that's illegal in TeamTrack (for
  3521. example, a non-existent project). Either correct the job so that all fields
  3522. are legal, or update your TeamTrack workflow to add the new value and restart
  3523. the replicator (see <a href="#section-5.5">section 5.5</a>).
  3524. <h4>
  3525. <a NAME="message-P4DTI-6255" id="message-P4DTI-6255"></a>(P4DTI-6255) No
  3526. Perforce state corresponding to TeamTrack state '%s'.</h4>
  3527. The replicator is trying to replicate an issue in TeamTrack that can't
  3528. be translated to Perforce because its state is unknown.
  3529. <p>This can happen if you've added a state to the TeamTrack workflow. In
  3530. that case you need to restart the replicator (see <a href="#section-5.5">section
  3531. 5.5</a>).
  3532. <p>It can also happen if you've set <tt><a href="#config-use_deleted_selections">use_deleted_selections</a></tt>
  3533. to 0 but there's an issue in a deleted state. See that configuration parameter
  3534. for advice.
  3535. <h4>
  3536. <a NAME="message-P4DTI-6288" id="message-P4DTI-6288"></a>(P4DTI-6288) No
  3537. TeamTrack state in project '%s' corresponding to Perforce state '%s'.</h4>
  3538. A user in Perforce changed the state of a job to a state that is not legal
  3539. for the project to which the job belongs. (Note that the state is legal
  3540. in some other project, otherwise it wouldn't be possible to set the job
  3541. to that state.)
  3542. <p>Set the job to a state that is legal for its project, or modify the
  3543. TeamTrack workflow so that the desired state is legal in the project.
  3544. <p>If you get this message frequently, this is a sign that your TeamTrack
  3545. workflow is too complicated for people to follow accurately in Perforce.
  3546. You should consider unifying the workflows for different projects, so that
  3547. developers aren't confused about which states are legal for which jobs.
  3548. <p>(Of course, it would be nice if Perforce only showed the states that
  3549. are legal for the project to which the job belongs. But that requires Perforce
  3550. to understand the full details of TeamTrack project, workflow and state
  3551. definitions. Perforce does not have this capability.)
  3552. <h4>
  3553. <a NAME="message-P4DTI-6335" id="message-P4DTI-6335"></a>(P4DTI-6335) The
  3554. TeamTrack field %s is append-only: you're not allowed to edit previous
  3555. comments.</h4>
  3556. A user in Perforce has updated other users' comments in an append-only
  3557. journal field; this isn't allowed. Either edit the field properly (by adding
  3558. new material at the end), or else change the field definition in TeamTrack
  3559. so that it's no longer append-only (in the TeamTrack Administrator, select
  3560. the "Workflows" tab, choose the workflow, click "Edit...", select the "Default
  3561. Fields" tab, choose the field, click "Edit...", select the "Options" tab,
  3562. uncheck the "Append only" checkbox, click "OK", click "OK") and restart
  3563. the replicator (see
  3564. <a href="#section-5.5">section 5.5</a>).
  3565. <h4>
  3566. <a NAME="message-P4DTI-6404" id="message-P4DTI-6404"></a>(P4DTI-6404) Can't
  3567. submit new issue to TeamTrack: SUBMITTER %d is unknown.</h4>
  3568. When creating a new issue in TeamTrack based on a job in Perforce, the
  3569. replicator couldn't guess a good value for the
  3570. <tt>SUBMITTER</tt> field
  3571. in TeamTrack. TeamTrack requires this field to contain a valid user. Possible
  3572. causes are:
  3573. <ul>A Perforce user couldn't be translated to a TeamTrack user. Fix the
  3574. problem and try again. See <a href="#section-3.5">section 3.5, "User accounts"</a>.
  3575. <p>The replicator's guessing algorithm has failed (it looks in the <tt>P4DTI-user</tt>,
  3576. <tt>Owner</tt> and <tt>User</tt> fields in the job, if any, takes the first
  3577. user it finds, and translates that). If so, you'll need to supply a valid
  3578. user in your <tt><a href="../aag/index.html#config-prepare_issue">prepare_issue</a></tt>
  3579. function; then
  3580. <ul>If you were migrating, re-run the migration starting from the job which
  3581. couldn't be migrated [<a href="../aag/index.html#section-4.10" title="Perforce Defect
  3582.     Tracking Integration Advanced Administrator's Guide">GDR
  3583. 2001-11-14, 4.10</a>].
  3584. <p>Otherwise, restart the replicator (see <a href="#section-5.5">section
  3585. 5.5</a>) and update the job so that it is replicated again (by running
  3586. a command like <tt>p4 job -o <i>JOBNAME</i> | p4 job -i</tt>.</ul>
  3587. </ul>
  3588.  
  3589. <h4>
  3590. <a NAME="message-P4DTI-6415" id="message-P4DTI-6415"></a>(P4DTI-6415) Submitted
  3591. new issue to TeamTrack with issue id %05d, but couldn't find it in the
  3592. database.</h4>
  3593. The replicator couldn't find a newly-submitted issue in the TeamTrack database.
  3594. Please contact Perforce support (see <a href="#section-11.1">section 11.1,
  3595. "Troubleshooting"</a>).
  3596. <h4>
  3597. <a NAME="message-P4DTI-7043" id="message-P4DTI-7043"></a>(P4DTI-7043) Perforce
  3598. client changelevel %d is not supported by P4DTI. Client must be at changelevel
  3599. %d or above.</h4>
  3600. The Perforce client executable specified by the <tt><a href="#config-p4_client_executable">p4_client_executable</a></tt>
  3601. parameter is an old version not supported by the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.
  3602. Install a supported version (see <a href="#section-3.2.1">section 3.2.1,
  3603. "Perforce software prerequisites"</a>) and set the <tt><a href="#config-p4_client_executable">p4_client_executable</a></tt>
  3604. parameter to name it.
  3605. <h4>
  3606. <a NAME="message-P4DTI-7054" id="message-P4DTI-7054"></a>(P4DTI-7054) The
  3607. command '%s' didn't report a recognizable version number. Check your setting
  3608. for the 'p4_client_executable' parameter.</h4>
  3609. Your setting for the <tt><a href="#config-p4_client_executable">p4_client_executable</a></tt>
  3610. parameter doesn't name a Perforce client executable (or doesn't name one
  3611. that's supported by the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.
  3612. Correct your setting.
  3613. <h4>
  3614. <a NAME="message-P4DTI-7076" id="message-P4DTI-7076"></a>(P4DTI-7076) The
  3615. Perforce client exited with error code %d. The server might be down; the
  3616. server address might be incorrect; or your Perforce licence might have
  3617. expired.</h4>
  3618. Check your setting for the <tt><a href="#config-p4_port">p4_port</a></tt>
  3619. parameter. Check that the Perforce server is running happily. Check that
  3620. it has enough disk space. Check that your Perforce licence is up to date.
  3621. <h4>
  3622. <a NAME="message-P4DTI-7065" id="message-P4DTI-7065"></a>(P4DTI-7065) %s
  3623. The Perforce client exited with error code %d.&nbsp;<br />
  3624. <a NAME="message-P4DTI-7087" id="message-P4DTI-7087"></a>(P4DTI-7087) %s</h4>
  3625. There's a problem with Perforce. Look up the text of the error message
  3626. in <a href="#section-11.3">section 11.3, "Other error messages"</a>, for
  3627. advice.
  3628. <h4>
  3629. <a NAME="message-P4DTI-7098" id="message-P4DTI-7098"></a>(P4DTI-7098) The
  3630. Perforce interface does not support the operating system '%s'.</h4>
  3631. You've installed the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3632. on an unsupported operating system. See the release notes for details of
  3633. the supported operating systems.
  3634. <h4>
  3635. <a NAME="message-P4DTI-7101" id="message-P4DTI-7101"></a>(P4DTI-7101) Jobspec
  3636. fields '%s' and '%s' have the same number %d.</h4>
  3637. The replicator was trying to install a new Perforce jobspec, but it can't
  3638. because two fields have the same field number (field number is a unique
  3639. key in Perforce). If you're using advanced configuration [<a href="../ig/index.html#section-8.6" title="Perforce Defect Tracking Integration Integrator's Guide">GDR
  3640. 2000-10-16, 8.6</a>], then check that your <tt><a href="../ig/index.html#config-jobspec">jobspec</a></tt>
  3641. configuration parameter gives unique numbers to each field; see [<a href="../ig/index.html#section-8.4" title="Perforce Defect Tracking
  3642. Integration Integrator's Guide">GDR
  3643. 2000-10-16, 8.4</a>]. Otherwise, contact Perforce support (see <a href="#section-11.1">section
  3644. 11.1, "Troubleshooting"</a>).
  3645. <h4>
  3646. <a NAME="message-P4DTI-8341" id="message-P4DTI-8341"></a>(P4DTI-8341) The
  3647. Perforce server changelevel %d is not supported by the P4DTI. See the P4DTI
  3648. release notes for Perforce server versions supported by the P4DTI.&nbsp;<br />
  3649. <a NAME="message-P4DTI-8352" id="message-P4DTI-8352"></a>(P4DTI-8352) The
  3650. Perforce command 'p4 info' didn't report a recognisable version.</h4>
  3651. You are running a version of the Perforce server that is not supported
  3652. by the&nbsp;<abbr title="Perforce Defect Tracking
  3653. Integration">P4DTI</abbr>.
  3654. See the release notes for supported Perforce server versions.
  3655. <h4>
  3656. <a NAME="message-P4DTI-8363" id="message-P4DTI-8363"></a>(P4DTI-8363) P4DTI
  3657. fields not found in Perforce jobspec.</h4>
  3658. If you're using advanced configuration [<a href="../ig/index.html#section-8.6" title="Perforce Defect
  3659. Tracking Integration Integrator's Guide">GDR
  3660. 2000-10-16, 8.6</a>], then check that your <tt><a href="../ig/index.html#config-jobspec">jobspec</a></tt>
  3661. configuration parameter has the required&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3662. fields; see [<a href="../ig/index.html#section-8.4" title="Perforce Defect Tracking Integration Integrator's
  3663. Guide">GDR
  3664. 2000-10-16, 8.4</a>]. Otherwise, contact Perforce support (see <a href="#section-11.1">section
  3665. 11.1, "Troubleshooting"</a>).
  3666. <h4>
  3667. <a NAME="message-P4DTI-8727" id="message-P4DTI-8727"></a>(P4DTI-8727) Issue
  3668. '%s' should be replicated but is not.&nbsp;<br />
  3669. <a NAME="message-P4DTI-8738" id="message-P4DTI-8738"></a>(P4DTI-8738) Issue
  3670. '%s' should be replicated to job '%s' but that job either does not exist
  3671. or is not replicated.&nbsp;<br />
  3672. <a NAME="message-P4DTI-8749" id="message-P4DTI-8749"></a>(P4DTI-8749) Issue
  3673. '%s' is replicated to job '%s' but that job is replicated to issue '%s'.&nbsp;<br />
  3674. <a NAME="message-P4DTI-875X" id="message-P4DTI-875X"></a>(P4DTI-875X) Job
  3675. '%s' would need the following set of changes in order to match issue '%s':
  3676. %s.&nbsp;<br />
  3677. <a NAME="message-P4DTI-8760" id="message-P4DTI-8760"></a>(P4DTI-8760) Job
  3678. '%s' has associated filespec '%s' but there is no corresponding filespec
  3679. for issue '%s'.&nbsp;<br />
  3680. <a NAME="message-P4DTI-8771" id="message-P4DTI-8771"></a>(P4DTI-8771) Issue
  3681. '%s' has associated filespec '%s' but there is no corresponding filespec
  3682. for job '%s'.&nbsp;<br />
  3683. <a NAME="message-P4DTI-8782" id="message-P4DTI-8782"></a>(P4DTI-8782) Change
  3684. %s fixes job '%s' but there is no corresponding fix for issue '%s'.&nbsp;<br />
  3685. <a NAME="message-P4DTI-8793" id="message-P4DTI-8793"></a>(P4DTI-8793) Change
  3686. %d fixes issue '%s' but there is no corresponding fix for job '%s'.&nbsp;<br />
  3687. <a NAME="message-P4DTI-8807" id="message-P4DTI-8807"></a>(P4DTI-8807) Change
  3688. %s fixes job '%s' with status '%s', but change %d fixes issue '%s' with
  3689. status '%s'.&nbsp;<br />
  3690. <a NAME="message-P4DTI-8818" id="message-P4DTI-8818"></a>(P4DTI-8818) Job
  3691. '%s' is marked as being replicated to issue '%s' but that issue is being
  3692. replicated to job '%s'.&nbsp;<br />
  3693. <a NAME="message-P4DTI-8829" id="message-P4DTI-8829"></a>(P4DTI-8829) Job
  3694. '%s' is marked as being replicated to issue '%s' but that issue either
  3695. doesn't exist or is not being replicated by this replicator.&nbsp;<br />
  3696. <a NAME="message-P4DTI-8862" id="message-P4DTI-8862"></a>(P4DTI-8862) 1
  3697. inconsistency found.&nbsp;<br />
  3698. <a NAME="message-P4DTI-8873" id="message-P4DTI-8873"></a>(P4DTI-8873) %d
  3699. inconsistencies found.&nbsp;<br />
  3700. <a NAME="message-P4DTI-8884" id="message-P4DTI-8884"></a>(P4DTI-8884) Asked
  3701. for issue '%s' but got an error instead.&nbsp;<br />
  3702. <a NAME="message-P4DTI-8895" id="message-P4DTI-8895"></a>(P4DTI-8895) Job
  3703. '%s' has a date field in the wrong format: %s.</h4>
  3704. The Perforce jobs database is inconsistent with the TeamTrack database.
  3705. This might be a consequence of frequent activity in the two systems (because
  3706. the&nbsp;<abbr title="Perforce Defect Tracking
  3707. Integration">P4DTI</abbr>
  3708. works by polling, there's a delay between changing one system and the the
  3709. other system being brought up to date); if so, the databases will be made
  3710. consistent if you cease activity and poll twice (<a href="#section-7.1">section
  3711. 7.1, "Taking a single step"</a>).
  3712. <p>If polling doesn't make the databases consistent, then you can either
  3713. make them consistent by editing the offending jobs, or by refreshing the
  3714. Perforce jobs (<a href="#section-9.2">section 9.2, "Refreshing jobs in
  3715. Perforce"</a>).
  3716. <p>If that doesn't work, contact Perforce support (see <a href="#section-11.1">section
  3717. 11.1, "Troubleshooting"</a>).
  3718. <h4>
  3719. <a NAME="message-P4DTI-891X" id="message-P4DTI-891X"></a>(P4DTI-891X) Error
  3720. (%s): %s</h4>
  3721. There's a problem in the defect tracker. Look up the text of the error
  3722. message in <a href="#section-11.3">section 11.3, "Other error messages"</a>,
  3723. for advice.
  3724. <h4>
  3725. <a NAME="message-P4DTI-9060" id="message-P4DTI-9060"></a>(P4DTI-9060) Defect
  3726. tracker '%s' does not support migration of Perforce users.</h4>
  3727. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3728. doesn't provide automated support for migrating users from Perforce to
  3729. TeamTrack. You have to create new uses in TeamTrack by hand using the TeamTrack
  3730. Administrator.
  3731. <h4>
  3732. <a NAME="message-P4DTI-913X" id="message-P4DTI-913X"></a>(P4DTI-913X) Error
  3733. in P4DTI logger: %s</h4>
  3734. Something's gone wrong with the P4DTI logger. Look up the text of the error
  3735. message in <a href="#section-11.3">section 11.3, "Other error messages"</a>,
  3736. for advice.
  3737. <h4>
  3738. <a NAME="message-P4DTI-9242" id="message-P4DTI-9242"></a>(P4DTI-9242) Expected
  3739. translate_jobspec to return a dictionary, but instead it returned %s.</h4>
  3740. Check that you have a line like <tt>return job</tt> at the end of your
  3741. <tt><a href="../aag/index.html#config-translate_jobspec">translate_jobspec</a></tt>
  3742. function.
  3743. <h4>
  3744. <a NAME="message-P4DTI-10037" id="message-P4DTI-10037"></a>(P4DTI-10037)
  3745. TeamTrack version %s is not supported by the P4DTI.</h4>
  3746. Check your setting for the <tt><a href="#config-teamtrack_version">teamtrack_version</a></tt>
  3747. parameter. See the release notes for the supported versions.
  3748. <h4>
  3749. <a NAME="message-P4DTI-10059" id="message-P4DTI-10059"></a>(P4DTI-10059)
  3750. MySQLdb version '%s' (release '%s') detected. This release is incompatible
  3751. with the P4DTI.</h4>
  3752. You're using a release of the Python database module MySQLdb which is known
  3753. to be incompatible with the P4DTI. Install a supported release of MySQLdb.
  3754. See <a href="#section-3.4.1">section 3.4.1, "Bugzilla software prerequisites"</a>.
  3755. <h4>
  3756. <a NAME="message-P4DTI-1006X" id="message-P4DTI-1006X"></a>(P4DTI-1006X)
  3757. MySQLdb version '%s' (release '%s') detected. This release is not supported
  3758. by the P4DTI, but may work.</h4>
  3759. You're using a release of the Python database module MySQLdb which is not
  3760. supported by the P4DTI, but which may work anyway. If you have problems
  3761. accessing the Bugzilla database, install a supported release of MySQLdb.
  3762. See <a href="#section-3.4.1">section 3.4.1, "Bugzilla software prerequisites"</a>.
  3763. <h4>
  3764. <a NAME="message-P4DTI-10106" id="message-P4DTI-10106"></a>(P4DTI-10106)
  3765. Fatal error in P4DTI service: %s.</h4>
  3766. Something's happened to the&nbsp;<abbr title="Perforce Defect Tracking
  3767. Integration">P4DTI</abbr>
  3768. when running as an NT service. Look up the text of the error message in
  3769. <a href="#section-11.3">section 11.3, "Other error messages"</a>, for advice.
  3770. <h4>
  3771. <a NAME="message-P4DTI-10172" id="message-P4DTI-10172"></a>(P4DTI-10172)
  3772. An attempt to write a log message to standard output failed.</h4>
  3773. Something has gone wrong with the standard output of the replicator. This
  3774. can happen if standard output was originally connected to a terminal, but
  3775. the terminal has been closed without stopping the replicator.
  3776. <p>The remedy is to start the replicator with the startup script, as described
  3777. in <a href="#section-5.6.1">section 5.6.1, "Running automatically on Unix"</a>,
  3778. or to redirect the standard output to somewhere safe, for example
  3779. <blockquote><tt>python run.py > /dev/null</tt></blockquote>
  3780.  
  3781. <h3>
  3782. <a NAME="section-11.3" id="section-11.3"></a>11.3. Other Error messages</h3>
  3783.  
  3784. <h4>
  3785. <a NAME="error-Perl-1" id="error-Perl-1"></a>Insecure $ENV{BASH_ENV} while
  3786. running with -T switch at ./processmail line %d</h4>
  3787. You're using Bugzilla 2.14 or 2.14.1, but the patch hasn't been applied
  3788. yet. See <a href="#section-5.4.1">section 5.4.1, "Patching Bugzilla"</a>.
  3789. <h4>
  3790. <a NAME="error-_mysql.InternalError-1" id="error-_mysql.InternalError-1"></a>_mysql.InternalError:
  3791. (3, "Error writing file '%s' (Errcode: 28)")</h4>
  3792. We've seen this error when MySQL has run out of disk space.
  3793. <h4>
  3794. <a NAME="error-_mysql.OperationalError-1" id="error-_mysql.OperationalError-1"></a>_mysql.OperationalError:
  3795. (1045, "Access denied for user: '%s@%s' (Using password: NO)")</h4>
  3796. The <tt><a href="#config-dbms_user">dbms_user</a></tt> parameter is set
  3797. incorrectly or the <tt><a href="#config-dbms_password">dbms_password</a></tt>
  3798. parameter is set to None when a password is required.
  3799. <h4>
  3800. <a NAME="error-_mysql.OperationalError-2" id="error-_mysql.OperationalError-2"></a>_mysql.OperationalError:
  3801. (1045, "Access denied for user: '%s@%s' (Using password: YES)")</h4>
  3802. The <tt><a href="#config-dbms_password">dbms_password</a></tt> parameter
  3803. is set incorrectly.
  3804. <h4>
  3805. <a NAME="error-_mysql.OperationalError-3" id="error-_mysql.OperationalError-3"></a>_mysql.OperationalError:
  3806. (1049, "Unknown database '%s'")</h4>
  3807. The MySQL server on <tt><a href="#config-dbms_host">dbms_host</a></tt>
  3808. doesn't serve a database whose name matches the <tt><a href="#config-dbms_database">dbms_database</a></tt>
  3809. parameter.
  3810. <h4>
  3811. <a NAME="error-_mysql.OperationalError-4" id="error-_mysql.OperationalError-4"></a>_mysql.OperationalError:
  3812. (2003, "Can't connect to MySQL server on '%s' (111)")</h4>
  3813. A MySQL connection couldn't be established to the host given by the <tt><a href="#config-dbms_host">dbms_host</a></tt>
  3814. parameter on either the port given by the <tt><a href="#config-dbms_port">dbms_port</a></tt>
  3815. parameter or the default MySQL port 3306. Possible causes include:
  3816. <ul>
  3817. <li>
  3818. The MySQL server is down.</li>
  3819.  
  3820. <li>
  3821. The MySQL server is configured to serve on a different port number</li>
  3822. </ul>
  3823.  
  3824. <h4>
  3825. <a NAME="error-_mysql.OperationalError-5" id="error-_mysql.OperationalError-5"></a>_mysql.OperationalError:
  3826. (2005, "Unknown MySQL Server Host '%s' (2)")</h4>
  3827. The host given by the <tt><a href="#config-dbms_host">dbms_host</a></tt>
  3828. parameter could not be located.
  3829. <h4>
  3830. <a NAME="error-_mysql.OperationalError-6" id="error-_mysql.OperationalError-6"></a>_mysql.OperationalError:
  3831. (2006, 'MySQL server has gone away')</h4>
  3832. The connection to the MySQL server has been lost. The replicator will recover
  3833. when the server connection is re-established.
  3834. <h4>
  3835. <a NAME="message-Perforce-Error-1" id="message-Perforce-Error-1"></a>Perforce
  3836. error: Can't create a new user - over licence quota</h4>
  3837. You don't have a licence for the replicator. See <a href="#section-3.2.1">section
  3838. 3.2.1, "Perforce software prerequisites"</a>.
  3839. <p>This might be because you changed the <tt><a href="#config-p4_user">p4_user</a></tt>
  3840. parameter but didn't delete the old userid.
  3841. <h4>
  3842. <a NAME="message-Perforce-Error-2" id="message-Perforce-Error-2"></a>Perforce
  3843. error: Error detected at line %d. Value for field 'Options' must be one
  3844. of noallwrite/allwrite,noclobber/clobber,nocompress/compress,unlocked/locked,nomodtime/modtime,normdir/rmdir.</h4>
  3845. You're using a Perforce client that's incompatible with the Perforce server
  3846. (for example, you're using a Perforce 2000.2 client to connect to a Perforce
  3847. 2001.1 server). Check your setting for the <tt><a href="#config-p4_client_executable">p4_client_executable</a></tt>
  3848. parameter.
  3849. <h4>
  3850. <a NAME="message-Perforce-Error-3" id="message-Perforce-Error-3"></a>Perforce
  3851. error: Error detected at line %d. Value for field '%s' must be one of %s.</h4>
  3852. The replicator is trying to replicate an issue that's has a selection that
  3853. isn't valid in Perforce.
  3854. <p>This can happen if you've added an option to a field in the defect tracker.
  3855. In that case you need to restart the replicator (see <a href="#section-5.5">section
  3856. 5.5</a>).
  3857. <p>It can also happen if you've set <tt><a href="#config-use_deleted_selections">use_deleted_selections</a></tt>
  3858. to 0 but there's an issue with a deleted option. See that configuration
  3859. parameter for advice.
  3860. <h4>
  3861. <a NAME="message-Perforce-Error-4" id="message-Perforce-Error-4"></a>Perforce
  3862. error: You don't have permission for this operation</h4>
  3863. You haven't given the replicator permission to edit the Perforce jobspec.
  3864. The replicator needs to have superuser privileges in Perforce. For instructions,
  3865. see <a href="#section-5.2.1">section 5.2.1, "Creating a Perforce user for
  3866. the replicator"</a>.
  3867. <h4>
  3868. <a NAME="error-socket.error-1" id="error-socket.error-1"></a>socket.error:
  3869. (10222, 'invalid argument')</h4>
  3870. Your SMTP server may be refusing connections. Check your <tt><a href="#config-smtp_server">smtp_server</a></tt>
  3871. parameter. Check that your SMTP server is up and running.
  3872. <h4>
  3873. <a NAME="error-socket.error-2" id="error-socket.error-2"></a>socket.error:
  3874. host not found</h4>
  3875. You may have specified the wrong hostname for the SMTP server. Check your
  3876. <tt><a href="#config-smtp_server">smtp_server</a></tt> parameter. Check
  3877. that your SMTP server is up and running.
  3878. <h4>
  3879. <a NAME="error-TeamShare-API-Error-1" id="error-TeamShare-API-Error-1"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3880. error: ERROR: (no message from the TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>)</h4>
  3881. This means that TeamTrack reported an error, but provided no information
  3882. about the cause of the error. The Windows Application Log on the TeamTrack
  3883. server machine often contains more information about why problems are occurring.
  3884. Use the Event Viewer to examine the Windows Application Log on that machine.
  3885. <p>This might be because you are using TeamTrack version 5.0 or later,
  3886. but you specified <tt>teamtrack_version = "4.5"</tt>. Check your setting
  3887. for the <tt><a href="#config-teamtrack_version">teamtrack_version</a></tt>
  3888. parameter.
  3889. <h4>
  3890. <a NAME="error-TeamShare-API-Error-7" id="error-TeamShare-API-Error-7"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3891. error: ERROR: Unable to find transition 0.</h4>
  3892. The replicator user may not have the "Update All Issues" privilege. Check
  3893. the privileges for the replicator user: see <a href="#section-5.3.2">section
  3894. 5.3.2, "Creating a TeamTrack user for the replicator"</a>.
  3895. <h4>
  3896. <a NAME="error-TeamShare-API-Error-2" id="error-TeamShare-API-Error-2"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3897. error: SERVER_ERROR: Authentication Failed. Invalid user id or password</h4>
  3898. You haven't created a user in TeamTrack for the replicator (for instructions,
  3899. see <a href="#section-5.3.2">section 5.3.2, "Creating a TeamTrack user
  3900. for the replicator"</a>), or else you've given the replicator incorrect
  3901. values for the <tt><a href="#config-teamtrack_user">teamtrack_user</a></tt>
  3902. and <tt><a href="#config-teamtrack_password">teamtrack_password</a></tt>
  3903. parameters.
  3904. <h4>
  3905. <a NAME="error-TeamShare-API-Error-3" id="error-TeamShare-API-Error-3"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3906. error: SERVER_ERROR: Access Denied. You do not have&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3907. connect privileges.</h4>
  3908. The replicator's TeamTrack user lacks the "Connect using the&nbsp;<abbr title="Application Programmer Interface">API</abbr>"
  3909. privilege. You need to use the TeamTrack Administrator to assign this privilege.
  3910. See <a href="#section-5.3.2">section 5.3.2, "Creating a TeamTrack user
  3911. for the replicator"</a>.
  3912. <h4>
  3913. <a NAME="error-TeamShare-API-Error-6" id="error-TeamShare-API-Error-6"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3914. error: SERVER_ERROR: Server error: -1.</h4>
  3915. You may be using TeamTrack 4.5 but have specified <tt><a href="#config-teamtrack_version">teamtrack_version</a>
  3916. = "5.0"</tt>. Check your setting for the <tt><a href="#config-teamtrack_version">teamtrack_version</a></tt>
  3917. parameter.
  3918. <p>Or your TeamTrack server may be running on a secure web server (its
  3919. address starts <tt>https:</tt>). The&nbsp;<abbr
  3920. title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3921. does not support TeamTrack on a secure web server.
  3922. <h4>
  3923. <a NAME="error-TeamShare-API-Error-4" id="error-TeamShare-API-Error-4"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3924. error: SOCKET_CONNECT_FAILED: Socket Connect failed.</h4>
  3925. The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  3926. can't connect to the TeamTrack server. Check that TeamTrack is up and running.
  3927. Check your setting for the <tt><a href="#config-teamtrack_server">teamtrack_server</a></tt>
  3928. parameter.
  3929. <h4>
  3930. <a NAME="error-TeamShare-API-Error-8" id="error-TeamShare-API-Error-8"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3931. error: SOCKET_READ_ERROR: Authentication Failed. No user information.</h4>
  3932. TeamTrack is not accepting authentication information from the HTTP header
  3933. because you have turned off this feature.
  3934. <p>Set up TeamTrack to accept authentication information from the HTTP
  3935. header. In the TeamTrack Administrator, choose Options > Settings; choose
  3936. the&nbsp;<span class="gui">Server</span> tab; click the&nbsp;<span 
  3937. class="gui">"Accept
  3938. Info From Browser/Header"</span> checkbox. (Note that you do not have to
  3939. turn off the&nbsp;<span class="gui">"Accept Info From Form/URL/Cookie"</span>
  3940. checkbox. If both boxes are checked, TeamTrack tries to get the authentication
  3941. information from a cookie first, and the HTTP header second.)
  3942. <h4>
  3943. <a NAME="error-TeamShare-API-Error-5" id="error-TeamShare-API-Error-5"></a>TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  3944. error: SOCKET_READ_ERROR: Socket error.</h4>
  3945. You may have tried to connect to a TeamTrack server with an incorrect user
  3946. id or password. Check your settings for the <tt><a href="#config-teamtrack_user">teamtrack_user</a></tt>
  3947. and <tt><a href="#config-teamtrack_password">teamtrack_password</a></tt>
  3948. parameters.
  3949. <p>The replicator user may not have the "Connect using the API" privilege.
  3950. Check the privileges for the replicator user: see <a href="#section-5.3.2">section
  3951. 5.3.2, "Creating a TeamTrack user for the replicator"</a>.
  3952. <h2>
  3953. <a NAME="section-A" id="section-A"></a>A. References</h2>
  3954.  
  3955. <table>
  3956. <tr VALIGN=TOP>
  3957. <td>[<a NAME="ref-BeOpen-PythonLabs-2000-10-16" id="ref-BeOpen-PythonLabs-2000-10-16" href="http://www.python.org/doc/current/tut/tut.html"></a><a href="http://www.python.org/doc/current/tut/tut.html" id="ref-BeOpen-PythonLabs-2000-10-16" name="ref-BeOpen-PythonLabs-2000-10-16">BeOpen
  3958. PythonLabs 2000-10-16</a>]</td>
  3959.  
  3960. <td>"Python Tutorial"; Guido van Rossum (Fred L. Drake, Jr., editor); <a href="http://www.python.org/doc/current/tut/tut.html">BeOpen
  3961. PythonLabs</a>; 2000-10-16; &lt;<a href="http://www.python.org/doc/current/tut/tut.html">http://www.python.org/doc/current/tut/tut.html</a>>.&nbsp;</td>
  3962. </tr>
  3963.  
  3964. <tr VALIGN=TOP>
  3965. <td>[<a NAME="ref-Bugzilla-1999-02-25" id="ref-Bugzilla-1999-02-25" href="http://www.ravenbrook.com/project/p4dti/import/2000-05-09/bugzilla-2.10/bugzilla-2.10/README"></a><a href="http://www.ravenbrook.com/project/p4dti/import/2000-05-09/bugzilla-2.10/bugzilla-2.10/README" id="ref-Bugzilla-1999-02-25" name="ref-Bugzilla-1999-02-25">Bugzilla
  3966. 1999-02-25</a>]</td>
  3967.  
  3968. <td>Bugzilla 2.10 Installation README file; Ry4an Brase, Bryce Nesbitt,
  3969. Dan Mosedale, Martin Pool, Terry Weissman; <a href="http://www.mozilla.org/">The
  3970. Mozilla Organization</a>; 1999-02-25&nbsp;</td>
  3971. </tr>
  3972.  
  3973. <tr VALIGN=TOP>
  3974. <td>[<a NAME="ref-Bugzilla-2001-04-24" id="ref-Bugzilla-2001-04-24" href="http://www.ravenbrook.com/project/p4dti/import/2001-04-27/bugzilla-2.12/bugzilla-2_12/docs/html/"></a><a href="http://www.ravenbrook.com/project/p4dti/import/2001-04-27/bugzilla-2.12/bugzilla-2_12/docs/html/" id="ref-Bugzilla-2001-04-24" name="ref-Bugzilla-2001-04-24">Bugzilla
  3975. 2001-04-24</a>]</td>
  3976.  
  3977. <td>"The Bugzilla Guide (for Bugzilla 2.12)"; <a href="mailto:barnboy@trilobyte.net">Matthew
  3978. P Barnson</a>; 2001-04-24.&nbsp;</td>
  3979. </tr>
  3980.  
  3981. <tr VALIGN=TOP>
  3982. <td>[<a NAME="ref-Bugzilla-2001-08-07" id="ref-Bugzilla-2001-08-07" href="http://www.ravenbrook.com/project/p4dti/import/2001-08-29/bugzilla-2.14/bugzilla-2.14/docs/html/"></a><a href="http://www.ravenbrook.com/project/p4dti/import/2001-08-29/bugzilla-2.14/bugzilla-2.14/docs/html/" id="ref-Bugzilla-2001-08-07" name="ref-Bugzilla-2001-08-07">Bugzilla
  3983. 2001-08-07</a>]</td>
  3984.  
  3985. <td>"The Bugzilla Guide" (for Bugzilla 2.14); <a href="mailto:barnboy@trilobyte.net">Matthew
  3986. P Barnson</a>; 2001-08-07.&nbsp;</td>
  3987. </tr>
  3988.  
  3989. <tr VALIGN=TOP>
  3990. <td>[<a NAME="ref-GDR-2001-11-14" id="ref-GDR-2001-11-14" href="../aag/index.html"></a><a href="../aag/index.html" id="ref-GDR-2001-11-14" name="ref-GDR-2001-11-14">GDR
  3991. 2001-11-14</a>]</td>
  3992.  
  3993. <td>"Perforce Defect Tracking Integration Advanced Administrator's Guide";
  3994. <a href="mailto:gdr@ravenbrook.com">Gareth Rees</a>; <a href="http://www.ravenbrook.com/">Ravenbrook
  3995. Limited</a>; 2001-11-14.&nbsp;</td>
  3996. </tr>
  3997.  
  3998. <tr VALIGN=TOP>
  3999. <td>[<a NAME="ref-MySQL-2000-07-02" id="ref-MySQL-2000-07-02" href="http://www.ravenbrook.com/project/p4dti/import/2000-07-02/MySQL-3.23.20-Reference.html"></a><a href="http://www.ravenbrook.com/project/p4dti/import/2000-07-02/MySQL-3.23.20-Reference.html" id="ref-MySQL-2000-07-02" name="ref-MySQL-2000-07-02">MySQL
  4000. 2000-07-02</a>]</td>
  4001.  
  4002. <td>"MySQL Reference Manual for version 3.23.20-beta"; <a href="http://www.mysql.com/">MySQL</a>;
  4003. 2000-07-02.&nbsp;</td>
  4004. </tr>
  4005.  
  4006. <tr VALIGN=TOP>
  4007. <td>[<a NAME="ref-Perforce-2001-06-18a" id="ref-Perforce-2001-06-18a" href="http://www.perforce.com/perforce/doc.011/manuals/p4guide/"></a><a href="http://www.perforce.com/perforce/doc.011/manuals/p4guide/" id="ref-Perforce-2001-06-18a" name="ref-Perforce-2001-06-18a">Perforce
  4008. 2001-06-18a</a>]</td>
  4009.  
  4010. <td>"Perforce 2001.1 Command Line User's Guide"; <a href="http://www.perforce.com/">Perforce
  4011. Software</a>; 2001-06-18; &lt;<a href="http://www.perforce.com/perforce/doc.011/manuals/p4guide/">http://www.perforce.com/perforce/doc.011/manuals/p4guide/</a>>,
  4012. &lt;<a href="ftp://ftp.perforce.com/pub/perforce/r01.1/doc/manuals/p4guide/p4guide.pdf">ftp://ftp.perforce.com/pub/perforce/r01.1/doc/manuals/p4guide/p4guide.pdf</a>>.&nbsp;</td>
  4013. </tr>
  4014.  
  4015. <tr VALIGN=TOP>
  4016. <td>[<a NAME="ref-Perforce-2001-06-18b" id="ref-Perforce-2001-06-18b" href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/"></a><a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/" id="ref-Perforce-2001-06-18b" name="ref-Perforce-2001-06-18b">Perforce
  4017. 2001-06-18b</a>]</td>
  4018.  
  4019. <td>"Perforce 2001.1 System Administrator's Guide"; <a href="http://www.perforce.com/">Perforce
  4020. Software</a>; 2001-06-18; &lt;<a href="http://www.perforce.com/perforce/doc.011/manuals/p4sag/">http://www.perforce.com/perforce/doc.011/manuals/p4sag/</a>>,
  4021. &lt;<a href="ftp://ftp.perforce.com/pub/perforce/r01.1/doc/manuals/p4sag/p4sag.pdf">ftp://ftp.perforce.com/pub/perforce/r01.1/doc/manuals/p4sag/p4sag.pdf</a>>.&nbsp;</td>
  4022. </tr>
  4023.  
  4024. <tr VALIGN=TOP>
  4025. <td>[<a NAME="ref-RB-2000-08-10" id="ref-RB-2000-08-10" href="../ug/index.html"></a><a href="../ug/index.html" id="ref-RB-2000-08-10" name="ref-RB-2000-08-10">RB
  4026. 2000-08-10</a>]</td>
  4027.  
  4028. <td>"Perforce Defect Tracking Integration User's Guide"; <a href="mailto:rb@ravenbrook.com">Richard
  4029. Brooksby</a>; <a href="http://www.ravenbrook.com/">Ravenbrook Limited</a>;
  4030. 2000-08-10.&nbsp;</td>
  4031. </tr>
  4032.  
  4033. <tr VALIGN=TOP>
  4034. <td>[<a NAME="ref-GDR-2000-10-16" id="ref-GDR-2000-10-16" href="../ig/index.html"></a><a href="../ig/index.html" id="ref-GDR-2000-10-16" name="ref-GDR-2000-10-16">GDR
  4035. 2000-10-16</a>]</td>
  4036.  
  4037. <td>"Perforce Defect Tracking Integration Integrator's Guide"; <a href="mailto:gdr@ravenbrook.com">Gareth
  4038. Rees</a>; <a href="http://www.ravenbrook.com/">Ravenbrook Limited</a>;
  4039. 2000-10-16.&nbsp;</td>
  4040. </tr>
  4041.  
  4042. <tr VALIGN=TOP>
  4043. <td>[<a NAME="ref-TeamShare-2002-01-31" id="ref-TeamShare-2002-01-31"></a>TeamShare
  4044. 2002-01-31]</td>
  4045.  
  4046. <td>"TeamTrack Administrator Manual 5.5"; <a href="http://www.teamshare.com/">TeamShare</a>;
  4047. 2002-01-31.&nbsp;</td>
  4048. </tr>
  4049. </table>
  4050.  
  4051. <h2>
  4052. <a NAME="section-B" id="section-B"></a>B. Document History</h2>
  4053.  
  4054. <table>
  4055. <tr VALIGN=TOP>
  4056. <td>2002-05-06</td>
  4057.  
  4058. <td><a href="mailto:ram@parrus.com">Ram</a></td>
  4059.  
  4060. <td>Added windows notes for Bugzilla software prerequisites.</td>
  4061. </tr>
  4062.  
  4063. <tr VALIGN=TOP>
  4064. <td>2000-08-10</td>
  4065.  
  4066. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4067.  
  4068. <td>Created placeholder.</td>
  4069. </tr>
  4070.  
  4071. <tr VALIGN=TOP>
  4072. <td>2000-09-11</td>
  4073.  
  4074. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4075.  
  4076. <td>Added instructions for demonstrating the integration and notes on version
  4077. 0.2.</td>
  4078. </tr>
  4079.  
  4080. <tr VALIGN=TOP>
  4081. <td>2000-09-20</td>
  4082.  
  4083. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4084.  
  4085. <td>Replaced demo instructions with full documentation outline from documentation
  4086. plan.</td>
  4087. </tr>
  4088.  
  4089. <tr VALIGN=TOP>
  4090. <td>2000-10-15</td>
  4091.  
  4092. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4093.  
  4094. <td>Added installation and uninstallation sections, and other sections
  4095. discussed in [RB 2000-10-07]. Removed parts specific to Ravenbrook Information
  4096. System.</td>
  4097. </tr>
  4098.  
  4099. <tr VALIGN=TOP>
  4100. <td>2000-10-16</td>
  4101.  
  4102. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4103.  
  4104. <td>Merged with master sources and GDR's demonstration instructions for
  4105. version 0.2. More edits required to make this consistent with the master
  4106. sources.</td>
  4107. </tr>
  4108.  
  4109. <tr VALIGN=TOP>
  4110. <td>2000-10-19</td>
  4111.  
  4112. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4113.  
  4114. <td>Updated to fix defects in release 0.3.1 [<a href="http://www.ravenbrook.com/project/p4dti/doc/2000-10-17/release-0.3.1-test-report/">GDR
  4115. 2000-10-17a</a>] and release 0.3.2 [<a href="http://www.ravenbrook.com/project/p4dti/doc/2000-10-18/release-0.3.2-test-report/">RB
  4116. 2000-10-18b</a>].</td>
  4117. </tr>
  4118.  
  4119. <tr VALIGN=TOP>
  4120. <td>2000-11-25</td>
  4121.  
  4122. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4123.  
  4124. <td>Removed "system" from title. Made lots of minor formatting and transition
  4125. edits. Moved Glossary to end of document. Reorganized Section 4.</td>
  4126. </tr>
  4127.  
  4128. <tr VALIGN=TOP>
  4129. <td>2000-11-26</td>
  4130.  
  4131. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4132.  
  4133. <td>Improved prerequisites section. Added draft Bugzilla prerequisites.
  4134. Formatted troubleshooting section. Updated version 0.3 references to version
  4135. 0.4.&nbsp;</td>
  4136. </tr>
  4137.  
  4138. <tr VALIGN=TOP>
  4139. <td>2000-11-27</td>
  4140.  
  4141. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4142.  
  4143. <td>Added readership. Removed some false statements.</td>
  4144. </tr>
  4145.  
  4146. <tr VALIGN=TOP>
  4147. <td>2000-11-29</td>
  4148.  
  4149. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4150.  
  4151. <td>Revised section 5 (configuration) to explain how to use the automatic
  4152. configuration engine for TeamTrack. Moved material from sections 4 and
  4153. 5 to make an appendix E for advanced configuration. Added section 4.6,
  4154. a placeholder that will describe how to create a Perforce user for the
  4155. replicator. The integration with TeamTrack now requires Python 2.0.</td>
  4156. </tr>
  4157.  
  4158. <tr VALIGN=TOP>
  4159. <td>2000-11-29</td>
  4160.  
  4161. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4162.  
  4163. <td>Corrected overview and improved replicator diagram. Changed prerequisites
  4164. to point at Perforce 2000.2 beta release. Added proper text to Bugzilla
  4165. prerequisites section. Cross-referenced to User's Guide.&nbsp;</td>
  4166. </tr>
  4167.  
  4168. <tr VALIGN=TOP>
  4169. <td>2000-11-29</td>
  4170.  
  4171. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4172.  
  4173. <td>Changed "&amp;mdash;" to "--" because the former doesn't display properly
  4174. in Netscape. Made some minor edits in Sections 1-3.</td>
  4175. </tr>
  4176.  
  4177. <tr VALIGN=TOP>
  4178. <td>2000-11-30</td>
  4179.  
  4180. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4181.  
  4182. <td>Corrected figure numbers in the text that were off by one. Finished
  4183. editing the&nbsp;<abbr title="Administrator's Guide">AG</abbr>. Swapped
  4184. round Sections D and E. Searched the doc for "dfn" tags and incorporated
  4185. those terms into the glossary. Deleted the list in Section 4.1 and folded
  4186. its single entry into the preceding sentence. Added a short note to Section
  4187. 4.4 to the effect that if you're using IIS, you don't need to stop and
  4188. restart the TeamTrack server. Added a note to Section 4.6 that we need
  4189. to tell admins to make the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  4190. user a Perforce super user and add it to the "p4 protect" table if they're
  4191. using it.</td>
  4192. </tr>
  4193.  
  4194. <tr VALIGN=TOP>
  4195. <td>2000-11-30</td>
  4196.  
  4197. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4198.  
  4199. <td>Added instructions to upgrade users Perforce clients and to stop using
  4200. TeamShare SourceBridge. Told the administrator to check the Windows event
  4201. log when things go wrong, because the TeamShare&nbsp;<abbr title="Application Programmer Interface">API</abbr>
  4202. doesn't tell the replicator about errors.</td>
  4203. </tr>
  4204.  
  4205. <tr VALIGN=TOP>
  4206. <td>2000-11-30</td>
  4207.  
  4208. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4209.  
  4210. <td>Added comments to the example jobspec in section D.2, and fixed the
  4211. formatting. Added note saying that you may not have a field called "code".
  4212. Listed the TeamTrack workflows that won't work well. Wrote advice on how
  4213. to configure the integration. Added the <tt>changelist_url</tt> configuration
  4214. parameter.</td>
  4215. </tr>
  4216.  
  4217. <tr VALIGN=TOP>
  4218. <td>2000-12-01</td>
  4219.  
  4220. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4221.  
  4222. <td>Moved TeamTrack and Bugzilla configuration sections into the Configuration
  4223. chapter, after the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  4224. configuration instructions. Added basic Linux installation instructions.
  4225. Rewrote sections of the configuration instructions to go with the new flow.
  4226. Deleted section on switching TeamTrack databases. Updated registry editing
  4227. and Team Track privilege instructions. Added instructions for creating
  4228. a Perforce user for the replicator. Explained multiple transition limitation.
  4229. Updated screenshots.&nbsp;</td>
  4230. </tr>
  4231.  
  4232. <tr VALIGN=TOP>
  4233. <td>2000-12-04</td>
  4234.  
  4235. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4236.  
  4237. <td>Made list of configuration parameters in <a href="#section-5.2">section
  4238. 5.2</a> consistent with the configuration file (by alphabetizing both lists).
  4239. Added missing configuration parameter <tt>closed_state</tt>. Added note
  4240. in section 5.2 about checking the configuration.</td>
  4241. </tr>
  4242.  
  4243. <tr VALIGN=TOP>
  4244. <td>2000-12-05</td>
  4245.  
  4246. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4247.  
  4248. <td>Changed figures to use "div" tags in line with the user manual and
  4249. to allow more flexible use of material in figures. Added basic notes on
  4250. Bugzilla configuration (more to come).&nbsp;</td>
  4251. </tr>
  4252.  
  4253. <tr VALIGN=TOP>
  4254. <td>2000-12-06</td>
  4255.  
  4256. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4257.  
  4258. <td>Added section 2.3 about supported platform configurations.</td>
  4259. </tr>
  4260.  
  4261. <tr VALIGN=TOP>
  4262. <td>2000-12-07</td>
  4263.  
  4264. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4265.  
  4266. <td>Advised admin to make e-mail addresses or userids the same in TeamTrack
  4267. and Perforce. Advised admin to restart when users are added or changed.</td>
  4268. </tr>
  4269.  
  4270. <tr VALIGN=TOP>
  4271. <td>2000-12-07</td>
  4272.  
  4273. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4274.  
  4275. <td>Removed "TeamTrack only" notice from "replicated_fields" configuration
  4276. parameter heading.&nbsp;</td>
  4277. </tr>
  4278.  
  4279. <tr VALIGN=TOP>
  4280. <td>2000-12-08</td>
  4281.  
  4282. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4283.  
  4284. <td>Documented translation of "ignore" state. Improved advice about what
  4285. to do with a field called "code". Fixed table of contents.&nbsp;</td>
  4286. </tr>
  4287.  
  4288. <tr VALIGN=TOP>
  4289. <td>2000-12-08</td>
  4290.  
  4291. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4292.  
  4293. <td>Documented <tt>refresh_perforce.py</tt>.&nbsp;</td>
  4294. </tr>
  4295.  
  4296. <tr VALIGN=TOP>
  4297. <td>2000-12-08</td>
  4298.  
  4299. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4300.  
  4301. <td>Documented translation of "ignore" state. Improved advice about what
  4302. to do with a field called "code". Fixed table of contents.&nbsp;</td>
  4303. </tr>
  4304.  
  4305. <tr VALIGN=TOP>
  4306. <td>2000-12-08</td>
  4307.  
  4308. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4309.  
  4310. <td>Documented <tt>refresh_perforce.py</tt>.&nbsp;</td>
  4311. </tr>
  4312.  
  4313. <tr VALIGN=TOP>
  4314. <td>2000-12-08</td>
  4315.  
  4316. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4317.  
  4318. <td>Brought configuration section 5.2 up to date with Bugzilla configurator
  4319. (see <a href="http://www.ravenbrook.com/project/p4dti/issue/job000115/">job000115</a>).&nbsp;</td>
  4320. </tr>
  4321.  
  4322. <tr VALIGN=TOP>
  4323. <td>2000-12-08</td>
  4324.  
  4325. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4326.  
  4327. <td>Updated to match unified configuration file and related re-organization
  4328. of sources.&nbsp;</td>
  4329. </tr>
  4330.  
  4331. <tr VALIGN=TOP>
  4332. <td>2000-12-11</td>
  4333.  
  4334. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4335.  
  4336. <td>Noted that the <tt><a href="#config-changelist_url">changelist_url</a></tt>
  4337. configuration parameter must be suitable for passing to <tt>sprintf()</tt>.</td>
  4338. </tr>
  4339.  
  4340. <tr VALIGN=TOP>
  4341. <td>2000-12-13&nbsp;</td>
  4342.  
  4343. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4344.  
  4345. <td>Updated for version 0.5 to cover Bugzilla supported platforms, configurations,
  4346. and known issues. Added changelist_url for use with P4Web.&nbsp;</td>
  4347. </tr>
  4348.  
  4349. <tr VALIGN=TOP>
  4350. <td>2000-12-13&nbsp;</td>
  4351.  
  4352. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4353.  
  4354. <td>Moving the Python 1.5.2 sources and Linux&nbsp;<abbr title="Red Hat Package Manager">RPM</abbr>
  4355. to the project imports.&nbsp;</td>
  4356. </tr>
  4357.  
  4358. <tr VALIGN=TOP>
  4359. <td>2000-12-15&nbsp;</td>
  4360.  
  4361. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4362.  
  4363. <td>Added verbose configuration item.&nbsp;</td>
  4364. </tr>
  4365.  
  4366. <tr VALIGN=TOP>
  4367. <td>2000-12-15&nbsp;</td>
  4368.  
  4369. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4370.  
  4371. <td>Added more chat about bugzilla_user.&nbsp;</td>
  4372. </tr>
  4373.  
  4374. <tr VALIGN=TOP>
  4375. <td>2000-12-15&nbsp;</td>
  4376.  
  4377. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4378.  
  4379. <td>More about e-mail addresses, python script names, and deleting jobs.&nbsp;</td>
  4380. </tr>
  4381.  
  4382. <tr VALIGN=TOP>
  4383. <td>2000-12-22&nbsp;</td>
  4384.  
  4385. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4386.  
  4387. <td>Started improving the manual as agreed in e-mail from RB (Documentation
  4388. preparation meeting with LMB, 2000-12-20).&nbsp;</td>
  4389. </tr>
  4390.  
  4391. <tr VALIGN=TOP>
  4392. <td>2001-01-01&nbsp;</td>
  4393.  
  4394. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4395.  
  4396. <td>Continued improving the manual as agreed in e-mail from RB, modulo
  4397. deleting things (Documentation preparation meeting with LMB, 2000-12-20).
  4398. Removed spaces around em-dashes as per "Read Me First!"&nbsp;</td>
  4399. </tr>
  4400.  
  4401. <tr VALIGN=TOP>
  4402. <td>2001-01-02</td>
  4403.  
  4404. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4405.  
  4406. <td>The recommendation for administrator experience (<a href="#section-3">section
  4407. 3</a>) is more realistic. Moved text from Appendix D to the Integrator's
  4408. Guide, and replaced with a reference. Replaced "company.com" with "company.domain"
  4409. since the former exists. Fixed typos and improved wording to fix defects
  4410. recorded in [<a href="http://www.ravenbrook.com/project/p4dti/doc/2000-12-08/release-0.4.2-test-report/">GDR
  4411. 2000-12-08b</a>], [<a href="http://www.ravenbrook.com/project/p4dti/doc/2000-12-08/release-0.4.2-test-report-2/">GDR
  4412. 2000-12-08c</a>], and [<a href="http://www.ravenbrook.com/project/p4dti/doc/2000-12-31/release-0.4.2-test-report/">GDR
  4413. 2000-12-09</a>]. Made cross-references consistent. Added two error messages
  4414. to section 13.2. Added figures 5 and 6 showing example log output. Added
  4415. <a href="#section-5.4.3">section 5.4.3</a> about providing field descriptions.</td>
  4416. </tr>
  4417.  
  4418. <tr VALIGN=TOP>
  4419. <td>2001-01-02&nbsp;</td>
  4420.  
  4421. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4422.  
  4423. <td>Merged GDR's changes to master manuals with this branch. Got about
  4424. two-thirds of the way through a heavy copyedit.&nbsp;</td>
  4425. </tr>
  4426.  
  4427. <tr VALIGN=TOP>
  4428. <td>2001-01-03&nbsp;</td>
  4429.  
  4430. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4431.  
  4432. <td>Made some changes suggested by GDR. Finished copyedit; noticed a number
  4433. of things I didn't catch in the copyedit, so I'm sure there are other problems.
  4434. Verified links. Indicated which comments I thought had been dealt with,
  4435. in case GDR has time to work on this document tomorrow. Did a once-over
  4436. in IE5 to make sure I didn't break anything too badly in the last two days.&nbsp;</td>
  4437. </tr>
  4438.  
  4439. <tr VALIGN=TOP>
  4440. <td>2001-01-05&nbsp;</td>
  4441.  
  4442. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4443.  
  4444. <td>Dealt with about half of the changes that TC@perforce suggested.&nbsp;</td>
  4445. </tr>
  4446.  
  4447. <tr VALIGN=TOP>
  4448. <td>2001-01-06&nbsp;</td>
  4449.  
  4450. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4451.  
  4452. <td>Procedurized and listed everything, as per TC@perforce's suggestions.&nbsp;</td>
  4453. </tr>
  4454.  
  4455. <tr VALIGN=TOP>
  4456. <td>2001-01-07&nbsp;</td>
  4457.  
  4458. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4459.  
  4460. <td>Edited references. Replaced Section 5.3.3.&nbsp;</td>
  4461. </tr>
  4462.  
  4463. <tr VALIGN=TOP>
  4464. <td>2001-01-07&nbsp;</td>
  4465.  
  4466. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4467.  
  4468. <td>Removed extraneous title material and Sections A and B. Removed comments
  4469. and sent them in an e-mail to p4dti-staff. Did final copyedit and finished
  4470. prepping manual to send to TC@perforce.&nbsp;</td>
  4471. </tr>
  4472.  
  4473. <tr VALIGN=TOP>
  4474. <td>2001-01-20&nbsp;</td>
  4475.  
  4476. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4477.  
  4478. <td>Incorporated TC's handwritten edits. Cut lots of stuff out of the glossary.&nbsp;</td>
  4479. </tr>
  4480.  
  4481. <tr VALIGN=TOP>
  4482. <td>2001-01-21&nbsp;</td>
  4483.  
  4484. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4485.  
  4486. <td>Re-added author, date, and other title material, and Sections A and
  4487. B. Added comments on what I'd been doing to the manual in the interim (not
  4488. much). Edited some new material from GDR. As per GDR's e-mail of 2001-01-18,
  4489. point 5, deleted Section C and moved the material in Section D to Section
  4490. 5.3.3. Fixed XREFS to Section 5; checked XREFS to Sections 12, 13, C, and
  4491. D. Added material on when you might want to refresh jobs. Edited Section
  4492. 10 slightly. Checked that procedure lead-ins and lists meet TC's specifications.
  4493. Copied in Nick's changes to the info on patching Bugzilla and to the closed_state
  4494. and replicated_fields parameters. Deleted mentions of bugzilla_user. Corrected
  4495. internal XREFS. Copied over information on log files from master sources.
  4496. Ran the spelling checker.&nbsp;</td>
  4497. </tr>
  4498.  
  4499. <tr VALIGN=TOP>
  4500. <td>2001-01-22</td>
  4501.  
  4502. <td><a href="mailto:lmb@ravenbrook.com">LMB</a></td>
  4503.  
  4504. <td>As per TC@perforce's request and GDR's instructions, added menu command
  4505. for how to start the TeamTrack Administrator from Windows. Added upgrade
  4506. instructions to Section 4.&nbsp;</td>
  4507. </tr>
  4508.  
  4509. <tr VALIGN=TOP>
  4510. <td>2001-01-29</td>
  4511.  
  4512. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4513.  
  4514. <td>Added <tt><a href="#config-bugzilla_directory">bugzilla_directory</a></tt>
  4515. configuration parameter.</td>
  4516. </tr>
  4517.  
  4518. <tr VALIGN=TOP>
  4519. <td>2001-02-01&nbsp;</td>
  4520.  
  4521. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4522.  
  4523. <td>Updated references to Perforce manuals to version 2000.2. Added steps
  4524. to section 10, "Uninstalling the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>",
  4525. to undo all installation steps. Added missing information to section 9,
  4526. "Maintaining the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>",
  4527. and clarified some of the existing instructions.&nbsp;</td>
  4528. </tr>
  4529.  
  4530. <tr VALIGN=TOP>
  4531. <td>2001-02-02&nbsp;</td>
  4532.  
  4533. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4534.  
  4535. <td>Implemented paper review comments of 2001-01-25 by TC@perforce.&nbsp;</td>
  4536. </tr>
  4537.  
  4538. <tr VALIGN=TOP>
  4539. <td>2001-02-12</td>
  4540.  
  4541. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4542.  
  4543. <td>Added <tt><a href="#config-start_date">start_date</a></tt> configuration
  4544. parameter. Renamed <tt>refresh_perforce.py</tt> to <tt>refresh.py</tt>.</td>
  4545. </tr>
  4546.  
  4547. <tr VALIGN=TOP>
  4548. <td>2001-02-13</td>
  4549.  
  4550. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4551.  
  4552. <td>Added note about security of jobs. Added socket.error error message
  4553. to section 11.2. Alphabetized messages in section 11.2. Added note about
  4554. "localhost" not working as a value for the teamtrack_server configuration
  4555. parameter. Indicated that administrator_address and smtp_server can be
  4556. None.</td>
  4557. </tr>
  4558.  
  4559. <tr VALIGN=TOP>
  4560. <td>2001-02-14&nbsp;</td>
  4561.  
  4562. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4563.  
  4564. <td>Added Linux&nbsp;<abbr title="Red Hat Package Manager">RPM</abbr> instructions.&nbsp;</td>
  4565. </tr>
  4566.  
  4567. <tr VALIGN=TOP>
  4568. <td>2001-02-15&nbsp;</td>
  4569.  
  4570. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4571.  
  4572. <td>Fixed "zcat" to "gunzip -c" to fool-proof unpacking.&nbsp;</td>
  4573. </tr>
  4574.  
  4575. <tr VALIGN=TOP>
  4576. <td>2001-02-16&nbsp;</td>
  4577.  
  4578. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4579.  
  4580. <td>Added brief instructions for starting the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  4581. automatically.&nbsp;</td>
  4582. </tr>
  4583.  
  4584. <tr VALIGN=TOP>
  4585. <td>2001-02-16&nbsp;</td>
  4586.  
  4587. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4588.  
  4589. <td>Added section 6.1, on migrating sets of issues. Also add some poll_period
  4590. and start_date references.&nbsp;</td>
  4591. </tr>
  4592.  
  4593. <tr VALIGN=TOP>
  4594. <td>2001-02-21</td>
  4595.  
  4596. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4597.  
  4598. <td>Documented <tt>p4dti.reg</tt> in section 5.3.1.</td>
  4599. </tr>
  4600.  
  4601. <tr VALIGN=TOP>
  4602. <td>2001-02-22</td>
  4603.  
  4604. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4605.  
  4606. <td>Documented MySQLdb and MySQL versions in section 3.4.1.</td>
  4607. </tr>
  4608.  
  4609. <tr VALIGN=TOP>
  4610. <td>2001-02-22</td>
  4611.  
  4612. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4613.  
  4614. <td>Gave instructions in section 11.1 on identifying the release that you're
  4615. using. Added "Can't create a new user - over licence quota" to error messages
  4616. in section 11.2. Wrote section 6.2 on migrating from Perforce jobs.</td>
  4617. </tr>
  4618.  
  4619. <tr VALIGN=TOP>
  4620. <td>2001-02-26</td>
  4621.  
  4622. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4623.  
  4624. <td>Added Bugzilla-related errors to section 11.2.</td>
  4625. </tr>
  4626.  
  4627. <tr VALIGN=TOP>
  4628. <td>2001-02-27</td>
  4629.  
  4630. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4631.  
  4632. <td>Alphabetized the list of error messages in section 11.2. Gave full
  4633. error messages, including prefixes, for each error. Improved error descriptions.</td>
  4634. </tr>
  4635.  
  4636. <tr VALIGN=TOP>
  4637. <td>2001-03-02&nbsp;</td>
  4638.  
  4639. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4640.  
  4641. <td>Added missing contents entries. Fixed some HTML errors and tidied up
  4642. some other HTML. Transferred copyright to Perforce under their license.
  4643. Added section on advanced configuration.&nbsp;</td>
  4644. </tr>
  4645.  
  4646. <tr VALIGN=TOP>
  4647. <td>2001-03-02</td>
  4648.  
  4649. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4650.  
  4651. <td>Removed section 9.3 on tracking down TeamTrack errors section, since
  4652. it's redundant with section 11.2.</td>
  4653. </tr>
  4654.  
  4655. <tr VALIGN=TOP>
  4656. <td>2001-03-05&nbsp;</td>
  4657.  
  4658. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4659.  
  4660. <td>Added e-mail messages to the list of things we'd like in bug reports.
  4661. Added some missing "abbr" tags.&nbsp;</td>
  4662. </tr>
  4663.  
  4664. <tr VALIGN=TOP>
  4665. <td>2001-03-13</td>
  4666.  
  4667. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4668.  
  4669. <td>Added message ids to the messages in section 11.2; moved messages without
  4670. ids in section 11.3. Added some missing error messages. Removed <tt>verbose</tt>
  4671. parameter; added <tt>log_level</tt> parameter. Alphabetized section 5.1.</td>
  4672. </tr>
  4673.  
  4674. <tr VALIGN=TOP>
  4675. <td>2001-03-16</td>
  4676.  
  4677. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4678.  
  4679. <td>Changed "daemon licence" to "background user licence" for consistency
  4680. with Perforce's own terminology. Background user licences are available
  4681. from Perforce Customer Service, not Technical Support.</td>
  4682. </tr>
  4683.  
  4684. <tr VALIGN=TOP>
  4685. <td>2001-03-16</td>
  4686.  
  4687. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4688.  
  4689. <td>Added text for messages 105-117, 200-209, 314, 315.</td>
  4690. </tr>
  4691.  
  4692. <tr VALIGN=TOP>
  4693. <td>2001-04-11&nbsp;</td>
  4694.  
  4695. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4696.  
  4697. <td>Updated version to 1.1.&nbsp;</td>
  4698. </tr>
  4699.  
  4700. <tr VALIGN=TOP>
  4701. <td>2001-04-20&nbsp;</td>
  4702.  
  4703. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4704.  
  4705. <td>Fixed reference to Bugzilla download at info.ravenbrook.com to point
  4706. to www.ravenbrook.com.&nbsp;</td>
  4707. </tr>
  4708.  
  4709. <tr VALIGN=TOP>
  4710. <td>2001-05-17</td>
  4711.  
  4712. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4713.  
  4714. <td>Removed occurrences of messages 844-847, 607-612 from example replicator
  4715. output (not produced any more).</td>
  4716. </tr>
  4717.  
  4718. <tr VALIGN=TOP>
  4719. <td>2001-05-23</td>
  4720.  
  4721. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4722.  
  4723. <td>Provided link to online support information.</td>
  4724. </tr>
  4725.  
  4726. <tr VALIGN=TOP>
  4727. <td>2001-05-24</td>
  4728.  
  4729. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4730.  
  4731. <td>Updated for Bugzilla 2.12.</td>
  4732. </tr>
  4733.  
  4734. <tr VALIGN=TOP>
  4735. <td>2001-07-03</td>
  4736.  
  4737. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4738.  
  4739. <td>Added <tt><a href="#config-teamtrack_version">teamtrack_version</a></tt>
  4740. configuration parameter. Added error messages from the TeamTrack 5.0 API
  4741. and error message from the TeamTrack 4.5 API when connecting to a TeamTrack
  4742. 5.0 server.&nbsp;</td>
  4743. </tr>
  4744.  
  4745. <tr VALIGN=TOP>
  4746. <td>2001-07-09</td>
  4747.  
  4748. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4749.  
  4750. <td>Updated TeamTrack screen shots to version 5.0.</td>
  4751. </tr>
  4752.  
  4753. <tr VALIGN=TOP>
  4754. <td>2001-07-09</td>
  4755.  
  4756. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4757.  
  4758. <td><abbr title="Red Hat Package Manager">RPM</abbr> users should use the
  4759. stop script to stop the replicator.</td>
  4760. </tr>
  4761.  
  4762. <tr VALIGN=TOP>
  4763. <td>2001-07-09</td>
  4764.  
  4765. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4766.  
  4767. <td>Added job_url config parameter.</td>
  4768. </tr>
  4769.  
  4770. <tr VALIGN=TOP>
  4771. <td>2001-07-14</td>
  4772.  
  4773. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4774.  
  4775. <td>Updated references to Perforce manuals to 2001.1, since we now support
  4776. that version.</td>
  4777. </tr>
  4778.  
  4779. <tr VALIGN=TOP>
  4780. <td>2001-07-15</td>
  4781.  
  4782. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4783.  
  4784. <td>Explained how to set up an integration without being connected to a
  4785. network.</td>
  4786. </tr>
  4787.  
  4788. <tr VALIGN=TOP>
  4789. <td>2001-07-17</td>
  4790.  
  4791. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4792.  
  4793. <td>Added more error messages to troubleshooting section.</td>
  4794. </tr>
  4795.  
  4796. <tr VALIGN=TOP>
  4797. <td>2001-07-24</td>
  4798.  
  4799. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4800.  
  4801. <td>The&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  4802. doesn't support TeamTrack on a secure web server. Added more troubleshooting
  4803. advice for TeamTrack errors.</td>
  4804. </tr>
  4805.  
  4806. <tr VALIGN=TOP>
  4807. <td>2001-07-25</td>
  4808.  
  4809. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4810.  
  4811. <td>Changed restarting instructions: Bugzilla users don't need to restart
  4812. the replicator when adding a new user.</td>
  4813. </tr>
  4814.  
  4815. <tr VALIGN=TOP>
  4816. <td>2001-07-25</td>
  4817.  
  4818. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4819.  
  4820. <td>The replicator user needs submit, update and transition privileges
  4821. in TeamTrack 5.0.</td>
  4822. </tr>
  4823.  
  4824. <tr VALIGN=TOP>
  4825. <td>2001-07-28</td>
  4826.  
  4827. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4828.  
  4829. <td>Reordered section 5.1 so that configuration parameters appear in the
  4830. same order as in config.py.</td>
  4831. </tr>
  4832.  
  4833. <tr VALIGN=TOP>
  4834. <td>2001-07-31</td>
  4835.  
  4836. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4837.  
  4838. <td>Added error from incompatibility between Perforce client and server.</td>
  4839. </tr>
  4840.  
  4841. <tr VALIGN=TOP>
  4842. <td>2001-08-07</td>
  4843.  
  4844. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4845.  
  4846. <td>No need to restart the TeamTrack integration when you add a user.</td>
  4847. </tr>
  4848.  
  4849. <tr VALIGN=TOP>
  4850. <td>2001-09-03</td>
  4851.  
  4852. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4853.  
  4854. <td>Added Bugzilla 2.14.</td>
  4855. </tr>
  4856.  
  4857. <tr VALIGN=TOP>
  4858. <td>2001-09-12</td>
  4859.  
  4860. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4861.  
  4862. <td>Added <tt><a href="#config-use_windows_event_log">use_windows_event_log</a></tt>
  4863. configuration parameter and prerequisite.</td>
  4864. </tr>
  4865.  
  4866. <tr VALIGN=TOP>
  4867. <td>2001-09-13</td>
  4868.  
  4869. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4870.  
  4871. <td>Added TeamTrack error message "SOCKET_READ_ERROR: Authentication Failed.
  4872. No user information." to troubleshooting section.</td>
  4873. </tr>
  4874.  
  4875. <tr VALIGN=TOP>
  4876. <td>2001-09-26</td>
  4877.  
  4878. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4879.  
  4880. <td>Added section on limitations of the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.</td>
  4881. </tr>
  4882.  
  4883. <tr VALIGN=TOP>
  4884. <td>2001-10-04</td>
  4885.  
  4886. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4887.  
  4888. <td>Improved description of workflows that don't work well with the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>.
  4889. Added table of supported field types.</td>
  4890. </tr>
  4891.  
  4892. <tr VALIGN=TOP>
  4893. <td>2001-10-07</td>
  4894.  
  4895. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4896.  
  4897. <td>Added <tt><a href="#config-use_perforce_jobnames">use_perforce_jobnames</a></tt>
  4898. parameter.</td>
  4899. </tr>
  4900.  
  4901. <tr VALIGN=TOP>
  4902. <td>2001-10-18</td>
  4903.  
  4904. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4905.  
  4906. <td>Added troubleshooting advice for messages 123, 127, 615, 618, and 619.</td>
  4907. </tr>
  4908.  
  4909. <tr VALIGN=TOP>
  4910. <td>2001-09-23</td>
  4911.  
  4912. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4913.  
  4914. <td>Added new command <tt>poll.py</tt> and table of commands.</td>
  4915. </tr>
  4916.  
  4917. <tr VALIGN=TOP>
  4918. <td>2001-10-25</td>
  4919.  
  4920. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  4921.  
  4922. <td>Improved information on supported MySQLdb releases. Added troubleshooting
  4923. advice for messages 1005 and 1006.</td>
  4924. </tr>
  4925.  
  4926. <tr VALIGN=TOP>
  4927. <td>2001-11-05</td>
  4928.  
  4929. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4930.  
  4931. <td>Added section on replicating new jobs from Perforce to the defect tracker.</td>
  4932. </tr>
  4933.  
  4934. <tr VALIGN=TOP>
  4935. <td>2001-11-08</td>
  4936.  
  4937. <td><a href="mailto:ndl@ravenbrook.com">NDL</a></td>
  4938.  
  4939. <td>Added section 5.6.2, on running as an NT service; cleaned up sections
  4940. 5.5 and 5.6.</td>
  4941. </tr>
  4942.  
  4943. <tr VALIGN=TOP>
  4944. <td>2001-11-14</td>
  4945.  
  4946. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4947.  
  4948. <td>Moved material requiring Python programming or knowledge of defect
  4949. tracker schema to the Advanced Administrator's Guide.</td>
  4950. </tr>
  4951.  
  4952. <tr VALIGN=TOP>
  4953. <td>2001-11-19</td>
  4954.  
  4955. <td><a href="mailto:ndl@ravenbrook.com">NDL</a></td>
  4956.  
  4957. <td>Message 891 becomes more general. Document message 1017.</td>
  4958. </tr>
  4959.  
  4960. <tr VALIGN=TOP>
  4961. <td>2001-11-22</td>
  4962.  
  4963. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4964.  
  4965. <td>Documented <tt><a href="#config-use_deleted_selections">use_deleted_selections</a></tt>
  4966. configuration parameter and associated error messages.</td>
  4967. </tr>
  4968.  
  4969. <tr VALIGN=TOP>
  4970. <td>2001-11-22&nbsp;</td>
  4971.  
  4972. <td><a href="mailto:rb@ravenbrook.com">RB</a></td>
  4973.  
  4974. <td>Cross-referenced sections on deleting Perforce jobs to the migration
  4975. section of the AAG.&nbsp;</td>
  4976. </tr>
  4977.  
  4978. <tr VALIGN=TOP>
  4979. <td>2001-11-27</td>
  4980.  
  4981. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4982.  
  4983. <td>Documented a processmail-related error message that can come up when
  4984. migrating if you haven't applied the Bugzilla patch.</td>
  4985. </tr>
  4986.  
  4987. <tr VALIGN=TOP>
  4988. <td>2001-12-03</td>
  4989.  
  4990. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4991.  
  4992. <td>Added remaining error messages to section 11.</td>
  4993. </tr>
  4994.  
  4995. <tr VALIGN=TOP>
  4996. <td>2002-01-24</td>
  4997.  
  4998. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  4999.  
  5000. <td>Noted support for Bugzilla's "emailsuffix" feature.</td>
  5001. </tr>
  5002.  
  5003. <tr VALIGN=TOP>
  5004. <td>2002-01-31</td>
  5005.  
  5006. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  5007.  
  5008. <td>Documented the supported MySQLdb versions. Changed MySQLdb link from
  5009. release 0.3.0 to release 0.9.1.</td>
  5010. </tr>
  5011.  
  5012. <tr VALIGN=TOP>
  5013. <td>2002-01-31</td>
  5014.  
  5015. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  5016.  
  5017. <td>Added Bugzilla 2.14.1.</td>
  5018. </tr>
  5019.  
  5020. <tr VALIGN=TOP>
  5021. <td>2002-02-01</td>
  5022.  
  5023. <td><a href="mailto:gdr@ravenbrook.com">GDR</a></td>
  5024.  
  5025. <td>Noted support for TeamTrack 5.5.</td>
  5026. </tr>
  5027.  
  5028. <tr VALIGN=TOP>
  5029. <td>2002-03-14</td>
  5030.  
  5031. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  5032.  
  5033. <td>Removed support for TeamTrack 5.02.</td>
  5034. </tr>
  5035.  
  5036. <tr VALIGN=TOP>
  5037. <td>2002-04-08</td>
  5038.  
  5039. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  5040.  
  5041. <td>Add _accessible fields to the Bugzilla fields table.</td>
  5042. </tr>
  5043.  
  5044. <tr VALIGN=TOP>
  5045. <td>2002-04-09</td>
  5046.  
  5047. <td><a href="mailto:nb@ravenbrook.com">NB</a></td>
  5048.  
  5049. <td>Remove extraneous paragraph close tag.</td>
  5050. </tr>
  5051. </table>
  5052.  
  5053. <h2>
  5054. <a NAME="section-C" id="section-C"></a>C. Glossary</h2>
  5055.  
  5056. <table>
  5057. <tr VALIGN=TOP>
  5058. <td><a NAME="term-changelist" id="term-changelist" href="#term-changelist"></a><a href="#term-changelist" id="term-changelist" name="term-changelist">changelist</a></td>
  5059.  
  5060. <td>An atomic change transaction in Perforce.&nbsp;</td>
  5061. </tr>
  5062.  
  5063. <tr VALIGN=TOP>
  5064. <td><a NAME="term-background-user-license" id="term-background-user-license" href="#term-background-user-license"></a><a href="#term-background-user-license" id="term-background-user-license" name="term-background-user-license">background
  5065. user license</a>
  5066. <br><a NAME="term-daemon-license" id="term-daemon-license" href="#term-daemon-license"></a><a href="#term-daemon-license" id="term-daemon-license" name="term-daemon-license">daemon
  5067. license</a></td>
  5068.  
  5069. <td>A license for a process rather than a person.&nbsp;</td>
  5070. </tr>
  5071.  
  5072. <tr VALIGN=TOP>
  5073. <td><a NAME="term-fix" id="term-fix" href="#term-fix"></a><a href="#term-fix" id="term-fix" name="term-fix">fix</a></td>
  5074.  
  5075. <td>A link between a job and a changelist.&nbsp;</td>
  5076. </tr>
  5077.  
  5078. <tr VALIGN=TOP>
  5079. <td><a NAME="term-issue" id="term-issue" href="#term-issue"></a><a href="#term-issue" id="term-issue" name="term-issue">issue</a></td>
  5080.  
  5081. <td>A unit of work tracked by the defect tracker, for example, a bug, a
  5082. change request, or an enhancement request.&nbsp;</td>
  5083. </tr>
  5084.  
  5085. <tr VALIGN=TOP>
  5086. <td><a NAME="term-job" id="term-job" href="#term-job"></a><a href="#term-job" id="term-job" name="term-job">job</a></td>
  5087.  
  5088. <td>A unit of work tracked by Perforce.&nbsp;</td>
  5089. </tr>
  5090.  
  5091. <tr VALIGN=TOP>
  5092. <td><a NAME="term-replicator" id="term-replicator" href="#term-replicator"></a><a href="#term-replicator" id="term-replicator" name="term-replicator">replicator</a></td>
  5093.  
  5094. <td>A process that copies (replicates) data between a defect tracker and
  5095. a Perforce server in order to keep each one up to date with changes made
  5096. in the other. Replication allows developers to do their routine defect
  5097. resolution work entirely from their Perforce client, without needing to
  5098. use the defect tracker's interface. It also allows developers to relate
  5099. their changes to defect tracking issues.&nbsp;</td>
  5100. </tr>
  5101.  
  5102. <tr VALIGN=TOP>
  5103. <td><a NAME="term-workflow" id="term-workflow" href="#term-workflow"></a><a href="#term-workflow" id="term-workflow" name="term-workflow">workflow</a></td>
  5104.  
  5105. <td>A set of rules that control who can do what to which issues.&nbsp;</td>
  5106. </tr>
  5107. </table>
  5108.  
  5109. <h2>
  5110. <a NAME="section-D" id="section-D"></a>D. Table of commands</h2>
  5111.  
  5112. <table BORDER CELLSPACING=0 CELLPADDING=5 >
  5113. <tr VALIGN=TOP>
  5114. <th>Command</th>
  5115.  
  5116. <th>Description</th>
  5117.  
  5118. <th>Reference</th>
  5119. </tr>
  5120.  
  5121. <tr VALIGN=TOP>
  5122. <td><tt>python check.py</tt></td>
  5123.  
  5124. <td>Check that the defect tracker database is consistent with the Perforce
  5125. jobs and fixes, and report any inconsistencies.</td>
  5126.  
  5127. <td><a href="#section-7.3">7.3</a></td>
  5128. </tr>
  5129.  
  5130. <tr VALIGN=TOP>
  5131. <td><tt>python check_jobs.py</tt></td>
  5132.  
  5133. <td>Check that Perforce jobs are consistent with the Perforce jobspec.</td>
  5134.  
  5135. <td>[<a href="../aag/index.html#section-4.5" title="Perforce Defect Tracking Integration Advanced Administrator's Guide">GDR
  5136. 2001-11-14, 4.5</a>]</td>
  5137. </tr>
  5138.  
  5139. <tr VALIGN=TOP>
  5140. <td><tt>python migrate.py</tt></td>
  5141.  
  5142. <td>Migrate Perforce jobs to defect tracker issues.</td>
  5143.  
  5144. <td>[<a href="../aag/index.html#section-4.10" title="Perforce Defect Tracking Integration Advanced Administrator's Guide">GDR
  5145. 2001-11-14, 4.10</a>]</td>
  5146. </tr>
  5147.  
  5148. <tr VALIGN=TOP>
  5149. <td><tt>python migrate_users.py</tt></td>
  5150.  
  5151. <td>Create defect tracker users corresponding to Perforce users.</td>
  5152.  
  5153. <td>[<a href="../aag/index.html#section-4.4" title="Perforce Defect Tracking Integration Advanced Administrator's Guide">GDR
  5154. 2001-11-14, 4.4</a>]</td>
  5155. </tr>
  5156.  
  5157. <tr VALIGN=TOP>
  5158. <td><tt>python poll.py</tt></td>
  5159.  
  5160. <td>Poll the defect tracker and Perforce for changes, replicate those changes,
  5161. then stop.</td>
  5162.  
  5163. <td><a href="#section-7.1">7.1</a></td>
  5164. </tr>
  5165.  
  5166. <tr VALIGN=TOP>
  5167. <td><tt>python refresh.py</tt></td>
  5168.  
  5169. <td>Delete all jobs and fixes in Perforce, then copy all the replicated
  5170. issues from the defect tracker again. For use when you change the <tt>replicated_fields</tt>
  5171. (for <a href="#config-replicated_fields-Bugzilla">Bugzilla</a> or <a href="#config-replicated_fields-TeamTrack">TeamTrack</a>)
  5172. or <tt><a href="#config-start_date">start_date</a></tt> configuration parameters.</td>
  5173.  
  5174. <td><a href="#section-9.2">9.2</a></td>
  5175. </tr>
  5176.  
  5177. <tr VALIGN=TOP>
  5178. <td><tt>python run.py</tt></td>
  5179.  
  5180. <td>Run the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  5181. replicator.</td>
  5182.  
  5183. <td><a href="#section-5.5">5.5</a></td>
  5184. </tr>
  5185.  
  5186. <tr VALIGN=TOP>
  5187. <td><tt>python service.py <i>[argument]</i></tt></td>
  5188.  
  5189. <td>Manage the&nbsp;<abbr title="Perforce Defect Tracking Integration">P4DTI</abbr>
  5190. replicator as a Windows NT Service. With no argument, installs the service.
  5191. Otherwise specify one of: <tt>start</tt>, <tt>stop</tt> or <tt>remove</tt>.</td>
  5192.  
  5193. <td><a href="#section-5.6.2">5.6.2</a></td>
  5194. </tr>
  5195.  
  5196. <tr VALIGN=TOP>
  5197. <td><tt>python teamtrack_query.py</tt></td>
  5198.  
  5199. <td>Query the TeamTrack database.</td>
  5200.  
  5201. <td>[<a href="../aag/index.html#section-6" title="Perforce Defect Tracking Integration Advanced Administrator's Guide">GDR
  5202. 2001-11-14, 6</a>]</td>
  5203. </tr>
  5204. </table>
  5205.  
  5206. <hr />
  5207. <p><font size=-1>This document is copyright &copy; 2001 Perforce Software,
  5208. Inc. All rights reserved.</font>
  5209. <p><font size=-1>Redistribution and use of this document in any form, with
  5210. or without modification, is permitted provided that redistributions of
  5211. this document retain the above copyright notice, this condition and the
  5212. following disclaimer.</font>
  5213. <p><b><font size=-1>This document is provided by the copyright holders
  5214. and contributors "as is" and any express or implied warranties, including,
  5215. but not limited to, the implied warranties of merchantability and fitness
  5216. for a particular purpose are disclaimed. In no event shall the copyright
  5217. holders and contributors be liable for any direct, indirect, incidental,
  5218. special, exemplary, or consequential damages (including, but not limited
  5219. to, procurement of substitute goods or services; loss of use, data, or
  5220. profits; or business interruption) however caused and on any theory of
  5221. liability, whether in contract, strict liability, or tort (including negligence
  5222. or otherwise) arising in any way out of the use of this document, even
  5223. if advised of the possibility of such damage.</font></b>
  5224. </body>
  5225. </html>
# Change User Description Committed
#1 5093 Hari Krishna Dara Populating perforce branch.
I will be adding p4admin files to it. 		20 years ago
//guest/perforce_software/p4dti/release/1.4.2/ag/index.html
#2 1879 Gerry Thompson P4DTI 1.4.2 port to Bugzilla on Windows 2000.
Code from Parrus Technology and documentati...on
updates. «		 23 years ago
#1 1669 richard_brooksby Push P4DTI release 1.4.2 to the public repository. 23 years ago