1.3 Kiriwrite Installer Script

After pointing your browser to the installer script, a page appears which guides you through configuring the settings for Kiriwrite.

At the top of the page a drop down box is available to change the language of the installer script to another language which is more easier to understand, simply select the language from the drop down box and click on the Switch button, the script will then switch to the selected language.

The installer script will preform three tests, the first being to check if all the needed modules are there, the second test is to check if the modules needed for the database modules are there and finally a test to check if the directories have their correct permissions set.

Before the settings can be configured, checks are made to make sure that all of the needed modules are installed properly. If any of the needed modules are missing an error message will appear saying that one or more of the required Perl modules is missing and will need to be installed which can be done from the CPAN interface.

The installer script then checks to see if at least of the Perl modules for the database modules are installed. If none of the Perl modules needed for the database modules are found then an error message will appear saying that none of the Perl modules needed for the database modules are installed and will need to be installed which can be done from the CPAN interface.

Finally, the installer script then checks to see if the directories have the minimum correct permissions set. If one or more of the directories has an error, then a message appears saying to make sure that the correct permissions are set.


When the installer finds that everything is fine in regards to Perl modules and file permissions, a form appears allowing to configure the Kiriwrite installation to specific needs. Some default values are given which will work with the file-based database modules.

The configuration settings in detail:

Setting	Description
Database Directory	Specifies the database directory to use for storing databases that are created by the file-based database modules. This option is ignored by the server-based modules.
Output Directory	Specifies the output directory to use to store the compiled pages.
Images (URI path)	Specifies the Images (URI path) to use for displaying images when using the page template with Kiriwrite.
Text Area Columns	Specifies the width of the text area when editing notes, pages and templates.
Text Area Rows	Specifies the height of the text area when editing notes, pages and templates.
Date Format	Specifies the date format to use when list the pages from the database. A selection of date formats are available from the drop down box or a custom one can be entered into the text box next to the drop down box.
Language	Specifies the system language to use in Kiriwrite. If the language used in the installer script is available as language to use in Kiriwrite then that language will be selected by default.
Presentation Module	Specifies the presentation module to use in Kiriwrite.
Database Module	Specifies the database module to use in Kiriwrite. SQLite is a file-based database module which uses the database directory and the SQLite Perl module while MySQL5 is a server-based database module which uses a MySQL 5.x server from the MySQL Perl module.

The following options are used only by the server-based database modules:

Setting	Description
Database Server	Specifies the database server to use.
Database Port	Specifies the database port to use.
Database Protocol	Specifies the database protocol to use.
Database Name	Specifies the database name to use.
Database Username	Specifies the database username to use.
Database Password	Specifies the database password to use.
Database Table Prefix	Specifies the table prefix to use. Multiple Kiriwrite installations can use the same server database so long as the table prefix is different.

There is an option that is enabled by default to attempt to delete the installation script after the configuration file has been written since the installation script would no longer be needed after that. Unchecking the box for this option disables this.

Click on the Save Settings button to write the configuration file or the Reset Settings button to restore the settings to their default values.

After clicking on the Save Settings button, some checks are made to make sure that data passed is correct, the configuration file is written (and the installer script deleted if requested) and a message appears saying that Kiriwrite can now be used by clicking on the link at the bottom of the page.