In case anyone is interested, I thought I would post my experience of
installing DocBook Wiki on Fedora 8 Linux.
Overall, DocBook Wiki is a fairly complex product to install. I plodded
through the install instructions quite carefully, to make sure
everything I needed was installed. In my 'developer' installation of
Fedora 8, I found that the following required packages were missing:
xmlto, xmltex, docbook-utils-pdf. Note that both MySql and dblatex are
available as RPM packages (package names, mysql and dblatex). It's
generally better to install these products using RPM, if possible, so
you can let 'yum' take care of working out all the dependencies.
I encountered two significant gotchas whilst installing, however:
- Installing the MySql database on Linux is not so trivial.
- The way the scripts invoke 'sudo' is incompatible with
SELinux.
Installing MySql on Linux
-------------------------
I installed MySql in the form of an RPM package, using 'yum'. I'd
recommend doing it this way for the sake of automatically working out
dependencies. But there is a catch (at least with the version of the
package I installed). Contrary to what you might expect, none of the
default users had blank passwords (the RPM package automatically runs
mysql_install_db, which creates default grant tables). This meant that I
couldn't run any of the mysql commands (and neither could Web Notes).
After a bit of Googling, I came across the following hack for resetting
the mysql 'root' user password:
1. Kill the mysql daemon (you need to login as root and then do a 'kill
-9' first on 'mysqld_safe' and then on 'mysqld').
2. Start the mysql daemon with authentication disabled. Login as root
and enter:
# mysqld_safe --skip_grant_tables
3. You should now be able to execute mysql commands without supplying a
password. Enter the following commands to reset the mysql 'root' user
password:
# mysql -u root mysql
mysql> update user set password=PASSWORD('<new_password>') where
user='root';
mysql> flush privileges;
4. Kill and restart the daemon, this time *without* the
--skip_grant_tables flag.
And remember to edit the Web Notes settings in books.conf before running
DocBook Wiki's install/install.sh script.
Something else to watch out for is to make sure that the daemon port
(3306) is not blocked by your firewall (didn't affect me, but it seems
to be a common enough gotcha).
'sudo' Incompatibility with SELinux
-----------------------------------
You have to do a little bit of initialization to get 'sudo' working,
which is done automatically by invoking the script
install/sudo_config.sh. This script worked fine for me. However, 'sudo'
does not work properly when invoked from within the install/install.sh
script, because of an incompatibility with SELinux security settings.
When I invoked install/install.sh, it ran very quickly (about 10 seconds
or so). In retrospect, this should have made me suspicious (a successful
run of the install.sh script actually takes several minutes to
complete). When I tried to browse to the normal book view
(http://localhost/books/index.php), I got a page that was completely
blank, except for a line 'db unable to access...[or something like
that]' (the error message was from WebNotes, which failed to access
MySql). I *was* able to access the 'admin.php' page (default superuser
login is: user=superuser, password=admin), but the page was garbled,
with a 'sudo' error message scattered across several fields.
While the admin.php page is loading, SELinux pops up a little warning
bubble in the corner or your screen (message is something like "AVC
access denied"). If you click on the little yellow star icon on the
Gnome menu bar, you can access the SELinux log, which describes the
problem in detail.
Since I understand absolutely nothing about SELinux, I decided that the
simplest solution was to disable it altogether. Here's how:
1. Login as root and edit the file /etc/selinux/config.
2. Search for the SELINUX setting and change its value to 'disabled'.
3. Reboot.
After fixing the SELinux issue, I re-ran the install/install.sh script
and the install worked perfectly.
----------------------------
IONA Technologies GmbH (registriert in Deutschland, AG Darmstadt)
Registernummer: HRB 7939
Geschäftsadresse: Im Leuschnerpark 4, D- 64347 Griesheim, Deutschland
-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Doc-book-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/doc-book-users
