301277 - Linux installation instructions

Status: RESOLVED WONTFIX

(Bugzilla :: Documentation, defect)

Description

[guillomovitch]

User-Agent:       Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7.8) Gecko/20050512 Firefox/1.0.4
Build Identifier: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7.8) Gecko/20050512 Firefox/1.0.4

The installation guide has a section about Mandrake 8.0, which is quite
outdated. And there is no mention of other Linux distributions, such as Debian,
whereas just running apt-get install bugzilla is enough. Rather than updating
it, I rewrote it in a more general fashion for all Linux distributions.

Reproducible: Always

Comment 1

[guillomovitch]

Attachment: Patch for installation guide

Comment 2

[Emmanuel Seyman]

> Most Linux distributions includes a package for bugzilla

This may be a bit too general as a comment.
Fedora doesn't have a Bugzilla package, Ubuntu's is in the universe repo which
isn't enabled by default.

Comment 3

[guillomovitch]

Well, feel free to add a chapter on manual installation. Anyway, this is already
less general than previous situation, which was only about Mandriva 8.0.

Comment 4

[A. Karl Kornel]

Suggest confirming.  There doesn't seem to be any other open linux-install-notes
bugs (of course, I may be wrong).

It would be nice to see some general Linux (or even general UNIX) install
instructions, with distro-specific sections as warranted.  However, the generic
bit is a good start.

Reporter, assuming that your installation instructions are still up-to-date, you
should request review from '[e-mail]' to get a review on your
patch.

Comment 5

[Marc Schumann [:Wurblzap]]

Unless I'm mistaken, you should ask review from [e-mail] for
docs related patches.

"<command>urpmi</command> bugzilla on Mandriva" should be
"<command>urpmi bugzilla</command> on Mandriva", right?

Comment 6

[Vlad Dascalu]

Comment on attachment 189747 [details] [diff] [review]
Patch for installation guide

In addition to Marc's suggestion regarding "<command>urpmi</command> bugzilla",
probably we need proper capitalization of the "Bugzilla" word in:

"includes a package for bugzilla"

Comment 7

[guillomovitch]

Attachment: Corrected patch

Comment 8

[Colin Ogilvie [:cso]]

Comment on attachment 196236 [details] [diff] [review]
Corrected patch

>+      <para>Most Linux distributions includes a package for Bugzilla,
>+        intended to run out of the box. Just run standard package
>+        installer for the one you use (aka <command>urpmi
>+          bugzilla</command> on Mandriva, <command>apt-get install
>+          bugzilla</command> on Debian, etc...) and follow
>+        post-installation procedure.

I have the following comments:

"includes" should probably be "include"
"Just run standard" should probably be "Just run the standard"
"aka" should probably be "for example"
"and follow post-installation" should probably be "and follow any post-installation procedures"

Most Linux distributions include a package for Bugzilla, intended to run out of the box. Just run the standard package installer for the one you use (for example <command>urpmi bugzilla</command> on Mandriva, <command>apt-get install bugzilla</command> on Debian, etc...) and follow any post-installation procedures.

Comment 9

[guillomovitch]

Attachment: Updated patch

Comment 10

[Kevin Benton]

Comment on attachment 202019 [details] [diff] [review]
Updated patch

As was previously mentioned, it would probably be best to change the word "Most" to something else, probably many.  I know this is a nit, but a very large part of the Bugzilla community uses Redhat-based installations.  Redhat doesn't include Bugzilla packaging at this time.  According to (I think it was boardwatch) a resource I read recently, over 50% of those using Linux use either RHEL or Fedora Core.

Also, looking at the decision to remove the instructions for Mandrake, I think it would be wise to leave the Mandrake section as-is (unless it's outdated) and add a Linux (General) section above.  I believe this will help the largest number of people.

Hence, the review-.

Apart from those comments, your updates look good.

Someone commented that we should have a manual install section to the documentation.  I agree.  I don't think that should keep us from approving this upate, however.

Comment 11

[guillomovitch]

(In reply to comment #10)
> (From update of attachment 202019 [details] [diff] [review] [edit])
> As was previously mentioned, it would probably be best to change the word
> "Most" to something else, probably many.  I know this is a nit, but a very
> large part of the Bugzilla community uses Redhat-based installations.  Redhat
> doesn't include Bugzilla packaging at this time.  According to (I think it was
> boardwatch) a resource I read recently, over 50% of those using Linux use
> either RHEL or Fedora Core.
Agreed, feel free to do the change.

> Also, looking at the decision to remove the instructions for Mandrake, I think
> it would be wise to leave the Mandrake section as-is (unless it's outdated) and
> add a Linux (General) section above.  I believe this will help the largest
> number of people.
I disagree. I don't find any advantage to keep initial phrasing, wich seems to say that only mandrake 8.0 (which is really old) has everything needed. I prefer the more general formulation I submitted, which include Mandrake (all versions).

Comment 12

[Chris Lawn]

I have recently successfully installed Bugzilla 3.0 on Ubuntu and 3.1.1 on Centos and recommend the following additions
the bellow line needs to added to the httpd.conf (replacing the Bugzilla path of course):
ScriptAlias /cgi-bin/ "/var/www/bugzilla-3.1.1/"

On a clean install of linux, GD will not install, it looks for libgd because it is not installed. I had great trouble finding answers to this: The below should be added:
Extra C and h libraries files must installed before any GD program can be installed.
Debian (Ubuntu) systems use “apt-get libc6-dev” and “apt-get install libgd-gd2-perl”
Redhat (Fedora/Centos) systems use “yum install gd-devel”



Also I found it easer to do a manual install rather then to use the package offered by Ubuntu, maybe just me though.
Redhat (Fedora/Centos) systems use “yum install gd-devel”

Comment 13

[Sam Folk-Williams]

In another bug we decided to move all distro-specific notes to the wiki. The user guide has been updated with this link.

Please add distro-specific notes to this page:

http://wiki.mozilla.org/Bugzilla:Linux_Distro_Installation

-Sam

Comment 14

[Max Kanat-Alexander]

There's already an Ubuntu page in the Wiki--you might want to move the info to that page.