1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
\r
4 <link href="style.css" REL="stylesheet" TYPE="text/css" MEDIA="screen">
\r
5 <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
\r
6 <title>Kiriwrite Documentation - User Documentation - Chapter 5: Troubleshooting</title>
\r
9 <div class="menubarback">
\r
10 <div class="menubar">
\r
11 <span class="apptitle">Kiriwrite</span>
\r
12 <a href="index.html">Index</a> | <a href="user.html">User
\r
13 Documentation</a> | <a href="tutorial.html">Tutorial Documentation</a> |
\r
14 <a href="developer.html">Developer Documentation</a>
\r
17 <div class="pageinformation">
\r
18 <span class="pagetitle">Chapter 5: Troubleshooting</span><br><br>
\r
19 <span class="heading">5.1 Common Problems</span><br><br>
\r
21 <table class="infotable">
\r
23 <td class="tableheading">Problem</td>
\r
24 <td class="tableheading">Symptom</td>
\r
25 <td class="tableheading">Solution</td>
\r
28 <td class="tabledata">When installing, some of the needed Perl modules have the word 'Error' next to them.</td>
\r
29 <td class="tabledata">The needed Perl modules are more than likely not installed.</td>
\r
30 <td class="tabledata">Install the needed Perl modules from the CPAN archive using the CPAN command interface.<sup>1</sup></td>
\r
33 <td class="tabledata">When installing, an error message appears saying that none of the needed Perl modules for the database modules are installed.</td>
\r
34 <td class="tabledata">The needed Perl module(s) (or the Perl module needed specifically for that certain database module) are more than likely not installed.</td>
\r
35 <td class="tabledata">Install the needed Perl modules from the CPAN archive using the CPAN command interface.</td>
\r
38 <td class="tabledata">When installing, an error message appears saying that some of the directories and files have invalid permissions set.</td>
\r
39 <td class="tabledata">The directories and/or files have invalid permissions set.</td>
\r
40 <td class="tabledata">Change the permissions on the directories and/or files so that are the correct permissions needed.</td>
\r
43 <td class="tabledata">When installing, no database or presentation modules appear in the list of available database or presentation modules.</td>
\r
44 <td class="tabledata">The modules weren't copied or were copied to the wrong directories.</td>
\r
45 <td class="tabledata">Copy or move the database modules to the correct directory.</td>
\r
48 <td class="tabledata">When installing, no languages appears in the languages selection list.</td>
\r
49 <td class="tabledata">The language files weren't copied or were copied to the wrong location.</td>
\r
50 <td class="tabledata">Copy or move the language files to the correct directory.</td>
\r
53 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the configuration file does not exist.</td>
\r
54 <td class="tabledata">The configuration file has been deleted or the installation script wasn't run.</td>
\r
55 <td class="tabledata">Run the installer script (again).</td>
\r
58 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the configuration file has invalid permissions set.</td>
\r
59 <td class="tabledata">The configuration file has invalid permissions set.</td>
\r
60 <td class="tabledata">Change the permissions on the configuration file so that it can be read.</td>
\r
63 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the database module does not exist.</td>
\r
64 <td class="tabledata">The database module has been deleted or renamed.</td>
\r
65 <td class="tabledata">Run the installer script (again).<br>
\r
66 Check if the Modules and Modules/Database directory have the correct permissions set so that they can be read.
\r
70 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the database module has invalid permissions set.</td>
\r
71 <td class="tabledata">The database module has invalid permissions set.</td>
\r
72 <td class="tabledata">Change the permissions on the database module so that they can be read (execute permissions not usually needed).</td>
\r
75 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the presentation module does not exist.</td>
\r
76 <td class="tabledata">The presentation module has been deleted or renamed.</td>
\r
77 <td class="tabledata">Run the installer script (again).<br>
\r
78 Check if the Modules and Modules/Presentation directory have the correct permissions set so that they can be read.
\r
82 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the presentation module has invalid permissions set.</td>
\r
83 <td class="tabledata">The presentation module has invalid permissions set.</td>
\r
84 <td class="tabledata">Change the permissions on the presentation module so that they can be read (execute permissions not usually needed).</td>
\r
87 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the language file does not exist.</td>
\r
88 <td class="tabledata">The language file does not exist.</td>
\r
89 <td class="tabledata">Run the installer script (again).<br>
\r
90 Check if the lang directory has the correct permissions set so that they can be read.
\r
94 <td class="tabledata">When starting Kiriwrite, a critical error message appears saying that the language file has invalid permissions set.</td>
\r
95 <td class="tabledata">The language file has invalid permissions set.</td>
\r
96 <td class="tabledata">Change the permissions on the language file so that they can be read.</td>
\r
99 <td class="tabledata">When viewing the list of databases, an error message appears saying that the permissions of the database directory is invalid.</td>
\r
100 <td class="tabledata">The database directory has incorrect permissions set.</td>
\r
101 <td class="tabledata">Set the correct permissions (read and write) on the database directory.</td>
\r
104 <td class="tabledata">When viewing the template database, an error message appears saying the permissions of the template database is invalid.</td>
\r
105 <td class="tabledata">The template database has invalid permissions set.</td>
\r
106 <td class="tabledata">Set the correct permissions (read and write) on the template database.</td>
\r
109 <td class="tabledata">When viewing the filter database, an error message appears saying that the permissions of the filter database is invalid.</td>
\r
110 <td class="tabledata">The filter database has invalid permissions set.</td>
\r
111 <td class="tabledata">Set the correct permissions (read and write) on the filter database.</td>
\r
114 <td class="tabledata">When compiling the pages, an error message appears saying that the output directory has invalid permissions set.</td>
\r
115 <td class="tabledata">The output directory has invalid permissions set.</td>
\r
116 <td class="tabledata">Set the correct permissions (read and write) on the output directory.</td>
\r
119 <td class="tabledata">When compiling the pages, certain pages do not change when the pages are edited.</td>
\r
120 <td class="tabledata">The pages have invalid permissions set.</td>
\r
121 <td class="tabledata">Set the correct permissions (read and write) on those pages which have invalid permissions set.</td>
\r
124 <td class="tabledata">When compiling the pages, the template database has invalid permissions set.</td>
\r
125 <td class="tabledata">The template database has invalid permissions set.</td>
\r
126 <td class="tabledata">Set the correct permissions (read) on the template database.</td>
\r
129 <td class="tabledata">When compiling the pages, the filter database has invalid permissions set.</td>
\r
130 <td class="tabledata">The filter database has invalid permissions set.</td>
\r
131 <td class="tabledata">Set the correct permissions (read) on the template database.</td>
\r
134 <td class="tabledata">When saving the new settings, an error message appears saying that the configuration file has invalid permissions set.</td>
\r
135 <td class="tabledata">The configuration file has invalid permissions set.</td>
\r
136 <td class="tabledata">Set the correct permissions (read and write) on the configuration file and then change the permissions back to read-only after saving the new settings.</td>
\r
142 <div class="footnote"></div>
\r
144 <sup>1</sup>The CPAN (Comprehensive Perl Archive Network) command interface is normally included with Perl installations and will normally require superuser (root) permissions.
\r