Documentation cannot be found after upgrade

Support knowledgebase (cg_usrshare)
Applies to

SuSE Linux: Versions up to (including) 6.4
This article refers to an older version of SuSE Linux. Therefore some of the informations given in this article may be outdated or the article may contain stale links.

Symptom:

You upgraded different documentation packages from our ftp-server, for example the SDB manually. You are unable to take a look at the internal help system with a webbrowser.

Cause:

To be compatible to the FHS (filesystem hierarchy standard) the location of all documentation files has been changed from /usr/doc to /usr/share/doc. The files won't be found by the webserver apache anymore.

Solution:

Depending on which components were upgraded by you you should make the following changes to the file /etc/httpd/httpd.conf. You can find the corrosponding section in this file around line 790.

Change
ServerSignature On
Alias /howto/       /usr/doc/howto/
Alias /hilfe/       /usr/doc/susehilf/
Alias /doc/         /usr/doc/
Alias /cgi-bin-sdb/ /usr/local/httpd/cgi-bin/
Alias /sdb/         /usr/doc/sdb/
Alias /manual/      /usr/doc/packages/apache/manual/
into
ServerSignature On
Alias /howto/       /usr/share/doc/howto/
Alias /hilfe/       /usr/share/doc/susehilf/
Alias /doc/         /usr/share/doc/
Alias /cgi-bin-sdb/ /usr/local/httpd/cgi-bin/
Alias /sdb/         /usr/share/doc/sdb/
Alias /manual/      /usr/doc/packages/apache/manual/

After changing this, please reload the web-Server by entering the command rcapache reload as user root.

After that the access to the help system and especially the SDB should work without any troubles.

Many thanks to Mr. Eduardo Carriles from Spain for this hint.


Keywords: USR, SHARE, SDB, SUPPORT, KNOWLEDGEBASE, DATABASE, DOCUMENTATION

Categories: SDB , Documentation

SDB-cg_usrshare, Copyright SuSE Linux AG, Nürnberg, Germany - Version: 24. Jul 2000
SuSE Linux AG - Last generated: 24. Jul 2000 by cg (sdb_gen 1.40.0)