1.3 Installer Script

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

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 authentication 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 authentication modules are found then an error message will appear saying that none of the Perl modules needed for the authentication 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 Xestia Scanner Server installation to specific needs. Some default values are given which will work with the file-based authentication modules.

The configuration settings in detail:

Setting	Description
Images (URI path)	Specifies the URI path for the images used in the page layout.
Scans (URI path)	Specifies the URI path for the scanned images.
Scans (Filesystem path)	Specifies the Filesystem path to store the scanned images when processed by an output module.
Date Format	Specifies the date format to use.
System Language	Specifies the language to use for Xestia Scanner Server.
Presentation Module	Specifies the presentation module.
Output Module	Specifies the default output module to use after a scan is made.
Authentication Module	Specifies the authentication module to use for the user management.
Database Server	Specifies the database server to use for the authentication module.
Database Port	Specifies the database server port to use for the authentication module.
Database Protocol	Specifies the database protocol to use for the authentication module.
Database Name	Specifies the database name to use for the authentication module.
Database Username	Specifies the database username to use for the authentication module.
Database Password	Specifies the database password to use for the authentication module.
Database Table Prefix	Specifies the database table prefix to use for the authentication module.

There are two options also available to delete the installer script when finished and also the multiuser script if it is not needed.

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 and multiuser installer scripts are deleted if requested) and a message appears saying that Xestia Scanner Server can now be used by clicking on the link at the bottom of the page.

If the authentication module selected is a module which needs to be setup for the user management (which is also known as a multiuser authentication module) then you'll be prompted to run the Multiuser Installer script.