Bug 234327

Summary:	net-im/jabberd-1.6.1.1-r1 does not provide enough help to get started
Product:	Gentoo Linux	Reporter:	Maurice van der Pot (RETIRED) <griffon26>
Component:	[OLD] Server	Assignee:	Thomas Anderson (tanderson) (RETIRED) <tanderson>
Status:	RESOLVED FIXED
Severity:	normal
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Maurice van der Pot (RETIRED) gentoo-dev

2008-08-09 20:23:03 UTC

The default configuration file no longer contains examples for using files to store user data, because it is recommended to use a database (either mysql or postgresql).

The files that should help to get a user started (README.*, mysql.sql, etc) are not installed by the current ebuild, but they should.

It would also be nice if the ebuild could give some hints. For instance the upgrade to 1.6 could mention that the default storage is now a database and refer to README.filespool for people who want to keep storing everything in files.

It could also give a 5-step plan to setting up the server (in this case with mysql):
1) modify /etc/jabber/jabberd.xml
2) create a jabber database
3) create a mysql user and grant this user access to the jabber db
4) mysql jabber -u jabber -p < /usr/share/doc/jabberd-1.6.1.1-r1/mysql.sql
5) optionally import the file spool data: jabberd -c /etc/jabber/jabberd.xml -I /var/spool/jabber

Note that for me this last step did not terminate, but it looks like the data was imported successfully anyway.

Comment 1 Thomas Anderson (tanderson) (RETIRED) gentoo-dev

2008-08-10 18:37:40 UTC

Fixed in CVS, thanks!