source: trunk/TROUBLESHOOTING @ 89

Last change on this file since 89 was 89, checked in by kake, 19 years ago

Note on private module dirs

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 1.6 KB
Line 
1OpenGuides Troubleshooting Guide
2================================
3
4If you wish to install the OpenGuides modules in a private directory,
5the Module::Build incantation for this is
6
7  perl Build.PL config='sitelib=/path/to/my/modules/'
8
9----------------------------------------------------------------------
10
11If any or all of the modules required by the OpenGuides scripts are in
12a private directory, then you'll need to tell the scripts where to find
13them.  The only way I can see to do this is to install everything and
14then manually edit the scripts wiki.cgi (or whatever you called it).
15supersearch.cgi and preferences.cgi to include a line something like
16
17  use lib qw( /path/to/my/modules/ );
18
19at the top of the scripts before any other modules are required.
20
21----------------------------------------------------------------------
22
23If you see the following message in your webserver error logs:
24
25  "Unable to tie -map_name [...] datafiles directory [...] does not exist
26   and cannot be created."
27
28This means that the directory you specified in your configuration as
29"indexing_directory" does not exist and cannot be created by the user
30that your CGI is running as.  This might mean one of two things:
31
32 - you've specified an indexing_directory within your own webspace but
33   your CGIs are running not as you but as a dedicated webserver user
34   such as 'nobody' or 'www-data'
35
36or
37
38 - you've specified an indexing_directory in a place that you're not
39   allowed to write to
40
41or a combination of both.  Your ISP or sysadmin might be able to help you
42further with this problem if you can't figure it out yourself.
43
44----------------------------------------------------------------------
Note: See TracBrowser for help on using the repository browser.