Documentation/English (British)/user-chapter5.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">\r
   2 <html>\r
   3         <head>\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
   7         </head>\r
   8         <body>\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
  15                         </div>\r
  16                 </div>\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
  20 \r
  21 <table class="infotable">\r
  22     <tr>\r
  23         <td class="tableheading">Problem</td>\r
  24         <td class="tableheading">Symptom</td>\r
  25         <td class="tableheading">Solution</td>\r
  26     </tr>\r
  27     <tr>\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
  31     </tr>\r
  32     <tr>\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
  36     </tr>\r
  37     <tr>\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
  41     </tr>\r
  42     <tr>\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
  46     </tr>\r
  47     <tr>\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
  51     </tr>\r
  52     <tr>\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
  56     </tr>\r
  57     <tr>\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
  61     </tr>\r
  62     <tr>\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
  67         </td>\r
  68     </tr>\r
  69     <tr>\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
  73     </tr>\r
  74     <tr>\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
  79         </td>\r
  80     </tr>\r
  81     <tr>\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
  85     </tr>\r
  86     <tr>\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
  91         </td>\r
  92     </tr>\r
  93     <tr>\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
  97     </tr>\r
  98     <tr>\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
 102     </tr>\r
 103     <tr>\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
 107     </tr>\r
 108     <tr>\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
 112     </tr>\r
 113     <tr>\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
 117     </tr>\r
 118     <tr>\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
 122     </tr>\r
 123     <tr>\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
 127     </tr>\r
 128     <tr>\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
 132     </tr>\r
 133     <tr>\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
 137     </tr>\r
 138 </table>\r
 139 \r
 140 <br>\r
 141 \r
 142 <div class="footnote"></div>\r
 143 \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
 145                 </div>\r
 146         </body>\r
 147 </html>\r