Chapter 5: Troubleshooting

5.1 Common Problems

Problem Symptom Solution
When installing, some of the needed Perl modules have the word 'Error' next to them. The needed Perl modules are more than likely not installed. Install the needed Perl modules from the CPAN archive using the CPAN command interface.1
When installing, an error message appears saying that none of the needed Perl modules for the database modules are installed. The needed Perl module(s) (or the Perl module needed specifically for that certain database module) are more than likely not installed. Install the needed Perl modules from the CPAN archive using the CPAN command interface.
When installing, an error message appears saying that some of the directories and files have invalid permissions set. The directories and/or files have invalid permissions set. Change the permissions on the directories and/or files so that are the correct permissions needed.
When installing, no database or presentation modules appear in the list of available database or presentation modules. The modules weren't copied or were copied to the wrong directories. Copy or move the database modules to the correct directory.
When installing, no languages appears in the languages selection list. The language files weren't copied or were copied to the wrong location. Copy or move the language files to the correct directory.
When starting Kiriwrite, a critical error message appears saying that the configuration file does not exist. The configuration file has been deleted or the installation script wasn't run. Run the installer script (again).
When starting Kiriwrite, a critical error message appears saying that the configuration file has invalid permissions set. The configuration file has invalid permissions set. Change the permissions on the configuration file so that it can be read.
When starting Kiriwrite, a critical error message appears saying that the database module does not exist. The database module has been deleted or renamed. Run the installer script (again).
Check if the Modules and Modules/Database directory have the correct permissions set so that they can be read.
When starting Kiriwrite, a critical error message appears saying that the database module has invalid permissions set. The database module has invalid permissions set. Change the permissions on the database module so that they can be read (execute permissions not usually needed).
When starting Kiriwrite, a critical error message appears saying that the presentation module does not exist. The presentation module has been deleted or renamed. Run the installer script (again).
Check if the Modules and Modules/Presentation directory have the correct permissions set so that they can be read.
When starting Kiriwrite, a critical error message appears saying that the presentation module has invalid permissions set. The presentation module has invalid permissions set. Change the permissions on the presentation module so that they can be read (execute permissions not usually needed).
When starting Kiriwrite, a critical error message appears saying that the language file does not exist. The language file does not exist. Run the installer script (again).
Check if the lang directory has the correct permissions set so that they can be read.
When starting Kiriwrite, a critical error message appears saying that the language file has invalid permissions set. The language file has invalid permissions set. Change the permissions on the language file so that they can be read.
When viewing the list of databases, an error message appears saying that the permissions of the database directory is invalid. The database directory has incorrect permissions set. Set the correct permissions (read and write) on the database directory.
When viewing the template database, an error message appears saying the permissions of the template database is invalid. The template database has invalid permissions set. Set the correct permissions (read and write) on the template database.
When viewing the filter database, an error message appears saying that the permissions of the filter database is invalid. The filter database has invalid permissions set. Set the correct permissions (read and write) on the filter database.
When compiling the pages, an error message appears saying that the output directory has invalid permissions set. The output directory has invalid permissions set. Set the correct permissions (read and write) on the output directory.
When compiling the pages, certain pages do not change when the pages are edited. The pages have invalid permissions set. Set the correct permissions (read and write) on those pages which have invalid permissions set.
When compiling the pages, the template database has invalid permissions set. The template database has invalid permissions set. Set the correct permissions (read) on the template database.
When compiling the pages, the filter database has invalid permissions set. The filter database has invalid permissions set. Set the correct permissions (read) on the template database.
When saving the new settings, an error message appears saying that the configuration file has invalid permissions set. The configuration file has invalid permissions set. 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.

1The CPAN (Comprehensive Perl Archive Network) command interface is normally included with Perl installations and will normally require superuser (root) permissions.