Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 106301 - Update virt-mail-howto for apache2
Summary: Update virt-mail-howto for apache2
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: nm (RETIRED)
URL: http://www.gentoo.org/doc/en/virt-mai...
Whiteboard:
Keywords:
: 183560 (view as bug list)
Depends on:
Blocks: apache1-is-dead
  Show dependency tree
 
Reported: 2005-09-17 11:50 UTC by MinusVee
Modified: 2007-07-16 02:32 UTC (History)
6 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
virt-mail-howto.xml.diff (for apache-2*) (virt-mail-howto.xml-apache2.diff,1.73 KB, text/plain)
2007-05-01 07:06 UTC, Christian Heim (RETIRED)
Details
Switch from apache to apache2 (virt-mail-howto.diff,11.55 KB, patch)
2007-07-12 18:55 UTC, Sven Vermeulen
Details | Diff
New patch for virt-mail-howto (virt-mail-howto.diff,11.45 KB, patch)
2007-07-13 05:46 UTC, Sven Vermeulen
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description MinusVee 2005-09-17 11:50:44 UTC
The documents mention to change /etc/apache/conf/vhosts/ssl.default-vhost.conf
 (code listing 8.2 in http://www.gentoo.org/doc/en/virt-mail-howto.xml).

This appears to be the old file. In Apache2, the correct file is:
/etc/apache2/conf/modules.d/41_mod_ssl.default-vhost.conf

The other references to "apache" need to be changed to "apache2", but this is 
the only one which isn't obviously analogous. (The others should still be fixed 
though.)

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 Jan Kundrát (RETIRED) gentoo-dev 2005-12-19 05:21:38 UTC
Hmm, this won't be trivial enough. The guide still says "This document uses apache-1.3.x. Apache-2 has been marked stable in portage. However there are still a number of issues with php integration. Until php support in apache-2.0.x is marked stable, this guide will continue to use the 1.3.x version.", which is not true, unfortunately.

> In Apache2, the correct file is:
> /etc/apache2/conf/modules.d/41_mod_ssl.default-vhost.conf

/etc/apache2/modules.d/41_mod_ssl.default-vhost.conf , actually.

Back to docs-team :-(.
Comment 2 nm (RETIRED) gentoo-dev 2006-05-29 09:38:28 UTC
CCing jakub for some possible help :)
Comment 3 Jakub Moc (RETIRED) gentoo-dev 2006-10-20 10:54:12 UTC
I didn't forget about this, bug it needs to be half-rewritten, so not finished yet.
Comment 4 nm (RETIRED) gentoo-dev 2006-11-06 08:59:08 UTC
Updated summary.
Comment 5 Karel Hala 2007-01-22 23:50:29 UTC
Just looking into roadmap... The document about installing Qmail MTA is obsolete as well. Probably it would be fine to update it like the Postfix one. Guys, don't know about your staff relations (applied last year once without much success), if you would need a hand about server stuff, let me know, may have a some time... 
Comment 6 nm (RETIRED) gentoo-dev 2007-01-23 00:00:27 UTC
(In reply to comment #5)
> Just looking into roadmap... The document about installing Qmail MTA is
> obsolete as well. Probably it would be fine to update it like the Postfix one.
> Guys, don't know about your staff relations (applied last year once without
> much success), if you would need a hand about server stuff, let me know, may
> have a some time... 

The qmail doc is irrelevant to this bug. Please stay on-target; this bug is only concerned with the Virtual Mail Howto. Mail vapier@gentoo.org your suggestions/corrections for the qmail doc.

In the mean time, any patches or suggestions you have for virt-mail-howto would be most welcome. We don't just hand out developer titles; we need to see a proven track record of good fixes, additions, etc.
Comment 7 Jan Kundrát (RETIRED) gentoo-dev 2007-01-23 09:53:37 UTC
(In reply to comment #5)
> Guys, don't know about your staff relations (applied last year once without
> much success), if you would need a hand about server stuff, let me know, may
> have a some time... 

Karel,
the best way to get started is probably to check bugzilla for bugs assigned to docs-team@gentoo.org or having this address in the CC list. Also feel free to hang on in #gentoo-doc on freenode.

Any contributions are more than welcome, yet they don't have to mean that you'll become developer in one month, to be honest. If you contribute enough, you'll surely get noticed, though.

Hope this helps...
Comment 8 nm (RETIRED) gentoo-dev 2007-03-29 18:08:26 UTC
Got a request from UberLord on IRC to edit http://www.gentoo.org/doc/en/virt-mail-howto.xml#doc_chap5 (code listing 5.1) and replace "nano -w CA.pl" with a command to just run "./CA.pl -newreq-nodes" instead, as he said it's a whole lot easier.
Comment 9 Christian Heim (RETIRED) gentoo-dev 2007-05-01 07:06:42 UTC
Created attachment 117814 [details]
virt-mail-howto.xml.diff (for apache-2*)

Find attached the necessary changes for =net-www/apache-2*. I've no clue if that will work, so I guess someone has to test it, but that ain't me :-P
Comment 10 Jakub Moc (RETIRED) gentoo-dev 2007-06-28 18:22:01 UTC
*** Bug 183560 has been marked as a duplicate of this bug. ***
Comment 11 nm (RETIRED) gentoo-dev 2007-07-12 07:17:30 UTC
I'll right, I'll commit the fixes listed in this bug so far. CCing the apache team to please review the doc and comment on its current state and the patches etc. in this bug. Need some serious attention, here, especially since bug 178189 was wrongly closed despite having open blockers, like this bug.

Guys, can you please review and comment, thanks.
Comment 12 Sven Vermeulen 2007-07-12 10:31:16 UTC
Josh

Can you hold this one for a sec? I'm performing the installation currently step by step and am editing everything for the apache2 change. There are more changes necessary than the ones listed by Christian so far. I hope to get a diff this evening or tomorrow at the latest.
Comment 13 Sven Vermeulen 2007-07-12 18:55:07 UTC
Created attachment 124673 [details, diff]
Switch from apache to apache2

This diff updates the guide to use apache2 as well as easier certificate creation, small update on phpmyadmin configuration, simplified user creation and use default mailman location (as intended by the ebuild).
Comment 14 nm (RETIRED) gentoo-dev 2007-07-12 19:48:22 UTC
(In reply to comment #13)
> Created an attachment (id=124673) [edit]
> Switch from apache to apache2
> 
> This diff updates the guide to use apache2 as well as easier certificate
> creation, small update on phpmyadmin configuration, simplified user creation
> and use default mailman location (as intended by the ebuild).
> 

Patch looks good content-wise except for a couple of things. First, it doesn't apply cleanly:

$ patch -p0 <virt-mail-howto.diff 
patching file virt-mail-howto.xml
Hunk #4 FAILED at 312.
Hunk #8 succeeded at 729 with fuzz 2.
Hunk #10 FAILED at 796.
Hunk #11 succeeded at 885 with fuzz 2.
Hunk #14 FAILED at 954.
3 out of 16 hunks FAILED

Did you base yours off some version besides the latest in CVS? Yes, I'm all synced up too. :)

Second, there's a weird substitution in the code, you sure this part is accurate?

-# <i>./CA.pl -newreq</i>
+;;; # <i>./CA.pl -newreq</i>

Prefacing the shell prompt with ;;; seems weird to me anyway. :)

Also, do I still need phreak's patch on top of yours? Anyway, much thanks for this update!
Comment 15 Sven Vermeulen 2007-07-13 05:46:46 UTC
Created attachment 124734 [details, diff]
New patch for virt-mail-howto

This is so fun... the XML target was obtained through ?passthru=1. I recreated the patch (removing the line with ';;;' in front of it - it isn't necessary) and then tried to apply it to the original XML... got the same fail results. 

Reason: diff'ed with -ut which switched blanks. This is a new diff without the "-t" which seems to work.

Mind you, I'm at Windows now so double-check if the file doesn't have those pesky ^M characters...
Comment 16 nm (RETIRED) gentoo-dev 2007-07-16 02:32:33 UTC
Fixed in CVS. I used swift's megapatch (thanks!) as well as a bit of phreak's patch that was accidentally left out. Plus I made some other minor fixups throughout the doc.

Thanks to everyone who helped out with this bug over the last two years.