1) Remember that the script "script/bugzilla_api_server.pl" must be invoked before starting the connector. Starting the connector without running this script will generate an error (like "can not connect to server").
To run the script, issue two commands, something like:
cd /var/www/0.9/script/bugzilla_api_server.pl
2) Navigate to this URL in your browser: http://localhost:3000/ . Does the "Welcome to the world of Catalyst." display?
The banner should look something like:
Bugzilla::API on Catalyst 5.80030
3) Navigate to this URL in your browser: http://localhost/bugzilla/ .
The "Welcome to Bugzilla" page should display.
You should see the details page for bug id "37000".
--- assigned_to: name: integrations real_name: Integrations cf_copy_to_story: --- cf_move_to_rally: --- cf_rally_id: '10040878322' cf_rally_url: https://rally1.rallydev.com/slm/#/detail/defect/<DEFECT_OID>
cf_test2: --- cf_update_rally: --- classification: Unclassified component: Garbage creation_time: 2011-08-25T17:06:00Z creator: name: integrations real_name: Integrations id: 37000 is_cc_accessible: 1 is_confirmed: 1 is_creator_accessible: 1 last_change_time: 2013-01-07T16:09:43Z op_sys: Linux platform: PC priority: P5 product: Garbage qa_contact: name: ~ ref: http://<YOUR_HOST_NAME>:3000/bug/1
severity: enhancement status: CONFIRMED summary: Initial landing on moon causes dust clouds target_milestone: --- version: unspecified Note: You may also use an alternate URL which contains your credentials as follows: http://localhost:3000/bug/1?username=<
[email protected]>&password=<PASSWORD>
5) If the Bugzilla API is installed properly, one of these two URLs will be accessible:
(Again, please use your value for localhost:port) http://localhost:3000/configuration
-- or -- http://localhost:3000/configuration?username=<
[email protected]>&password=<PASSWORD>
The output in the browser should look something like; --- announcement: '' field: alias: description: Alias is_active: !!perl/scalar:JSON::XS::Boolean 1 type: 1 assigned_to: description: Assignee is_active: !!perl/scalar:JSON::XS::Boolean 1 type: 0 ..... version: - unspecified version: 4.0.2
6) The "json_pure" Ruby Gem must be installed on your system. And it should be version 1.2.4 (that is the version which passed all of our Bugzilla tests).
To view the Ruby Gems installed on your system, use this command:
gem list
7) If your site uses a proxy server to connect to Bugzilla:
- The connector itself does not have the capability to use proxy authentication.
- Your IT department may be able to enable access to your Bugzilla server if a proxy is involved.
8) What version of Bugzilla API have you installed?
Please note that we have tested 0.9 and 1.0 only.
9) There is a custom field which must be created in Bugzilla, which will contain the Rally ID of any bug copied from Rally to Bugzilla.
The "Type:" of this field must be "Free Text", and NOT the somewhat mis-leading "Bug ID" type,
which is the default type used if "Free Text" is not specifically selected.