Documentation/English (British)/user-chapter4.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>Xestia Scanner Server Documentation - User Documentation - Chapter 4: Troubleshooting</title>\r
   7         </head>\r
   8         <body>\r
   9                 <div class="menubarback">\r
  10                         <div class="menubar">\r
  11                                 <span class="apptitle">Xestia Scanner Server</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 4: Troubleshooting</span>\r
  19 <br><br>\r
  20 <b>4.1 Common Problems</b>\r
  21 <br><br>\r
  22 <table class="infotable">\r
  23  <tr>\r
  24   <td class="tableheading">Problem</td>\r
  25   <td class="tableheading">Symptom</td>\r
  26   <td class="tableheading">Solution</td>\r
  27  </tr>\r
  28  <tr>\r
  29   <td class="tabledata">When installing, some of the needed Perl modules have the word ‘Error’ next to them.</td>\r
  30   <td class="tabledata">The needed Perl modules are more than likely not installed.</td>\r
  31   <td class="tabledata">Install the needed Perl modules from the CPAN<sup>1</sup> archive using the CPAN command interface.</td>\r
  32  </tr>\r
  33  <tr>\r
  34   <td class="tabledata">When installing, an error message appears saying that none of the needed Perl modules for the authentication modules are installed.</td>\r
  35   <td class="tabledata">The needed Perl module(s) (or the Perl module needed specifically for that certain authentication module) are more than likely not installed.</td>\r
  36   <td class="tabledata">Install the needed Perl modules from the CPAN archive using the CPAN command interface.</td>\r
  37  </tr>\r
  38  <tr>\r
  39   <td class="tabledata">When installing, an error message appears saying that some of the directories and files have invalid permissions set.</td>\r
  40   <td class="tabledata">The directories and/or files have invalid permissions set.</td>\r
  41   <td class="tabledata">Change the permissions on the directories and/or files so that are the correct permissions needed.</td>\r
  42  </tr>\r
  43  <tr>\r
  44   <td class="tabledata">When installing, no authentication or presentation modules appear in the list of available authentication or presentation modules.</td>\r
  45   <td class="tabledata">The modules weren't copied or were copied to the wrong directories.</td>\r
  46   <td class="tabledata">Copy or move the authentication modules to the correct directory.</td>\r
  47  </tr>\r
  48  <tr>\r
  49   <td class="tabledata">When installing, no languages appears in the languages selection list.</td>\r
  50   <td class="tabledata">The language files weren't copied or were copied to the wrong location.</td>\r
  51   <td class="tabledata">Copy or move the language files to the correct directory.</td>\r
  52  </tr>\r
  53  <tr>\r
  54   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the configuration file does not exist.</td>\r
  55   <td class="tabledata">The configuration file has been deleted or the installation script wasn't run.</td>\r
  56   <td class="tabledata">Run the installer script (again).</td>\r
  57  </tr>\r
  58  <tr>\r
  59   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the configuration file has invalid permissions set.</td>\r
  60   <td class="tabledata">The configuration file has invalid permissions set.</td>\r
  61   <td class="tabledata">Change the permissions on the configuration file so that it can be read.</td>\r
  62  </tr>\r
  63  <tr>\r
  64   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the authentication module does not exist.</td>\r
  65   <td class="tabledata">The authentication module has been deleted or renamed.</td>\r
  66   <td class="tabledata">Run the installer script (again).<br>Check if the Modules and Modules/Auth directory have the correct permissions set so that they can be read.</td>\r
  67  </tr>\r
  68  <tr>\r
  69   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the authentication module has invalid permissions set.</td>\r
  70   <td class="tabledata">The authentication module has invalid permissions set.</td>\r
  71   <td class="tabledata">Change the permissions on the authentication module so that they can be read (execute permissions not usually needed).</td>\r
  72  </tr>\r
  73  <tr>\r
  74   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the presentation module does not exist.</td>\r
  75   <td class="tabledata">The presentation module has been deleted or renamed.</td>\r
  76   <td class="tabledata">Run the installer script (again).<br>Check if the Modules and Modules/Presentation directory have the correct permissions set so that they can be read.</td>\r
  77  </tr>\r
  78  <tr>\r
  79   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the presentation module has invalid permissions set.</td>\r
  80   <td class="tabledata">The presentation module has invalid permissions set.</td>\r
  81   <td class="tabledata">Change the permissions on the presentation module so that they can be read (execute permissions not usually needed).</td>\r
  82  </tr>\r
  83  <tr>\r
  84   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the language file does not exist.</td>\r
  85   <td class="tabledata">The language file does not exist.</td>\r
  86   <td class="tabledata">Run the installer script (again).<br>Check if the lang directory has the correct permissions set so that they can be read.</td>\r
  87  </tr>\r
  88  <tr>\r
  89   <td class="tabledata">When starting Xestia Scanner Server, a critical error message appears saying that the language file has invalid permissions set.</td>\r
  90   <td class="tabledata">The language file has invalid permissions set.</td>\r
  91   <td class="tabledata">Change the permissions on the language file so that they can be read.</td>\r
  92  </tr>\r
  93  <tr>\r
  94   <td class="tabledata">When trying to scan, the scanner does not appear in the scanner list.</td>\r
  95   <td class="tabledata">Either the scanner is:<br>\r
  96     Unplugged.<br>\r
  97     Not turned on.<br>\r
  98     Permissions not set correctly.<br>\r
  99     Not supported by the SANE subsystem.</td>\r
 100   <td class="tabledata">Plug the scanner in.<br>\r
 101     Turn the scanner on.<br>\r
 102     Permissions should have been set correctly automatically upon plugging in and may be a bug with the operating system.<br>\r
 103     Check the scanner manufactuer’s website to see if they support the scanner through SANE.\r
 104     </td>\r
 105  </tr>\r
 106  <tr>\r
 107   <td class="tabledata">When trying to scan, it is not possible due to invalid permissions set on the user account.</td>\r
 108   <td class="tabledata">The administrator operating the Xestia Scanner Server installation has set your account to not use this scanner.</td>\r
 109   <td class="tabledata">Speak to the administrator operating the Xestia Scanner Server installation.</td>\r
 110  </tr>\r
 111  <tr>\r
 112   <td class="tabledata">When trying to scan, it is not possible due to an error message caused by the scanner.</td>\r
 113   <td class="tabledata">The scanner may be malfunctioning.</td>\r
 114   <td class="tabledata">Read the manual that came with the scanner and follow the troubleshooting procedure (if any) or contact the manufactuer of the scanner.</td>\r
 115  </tr>\r
 116  <tr>\r
 117   <td class="tabledata">When trying to output an image, an error occurs.</td>\r
 118   <td class="tabledata">The output module was configured incorrectly.</td>\r
 119   <td class="tabledata">Either check the settings used for the output module or see the administrator operating the Xestia Scanner Server Installation as the administrator may need to set file permissions or configure the system.</td>\r
 120  </tr>\r
 121  <tr>\r
 122   <td class="tabledata">When trying to export an image, an error occurs.</td>\r
 123   <td class="tabledata">The export module was configured incorrectly.</td>\r
 124   <td class="tabledata">Either check the settings used for the export module or see the administrator operating the Xestia Scanner Server Installation as the administrator may need to set file permissions or configure the system.</td>\r
 125  </tr>\r
 126  <tr>\r
 127   <td class="tabledata">An error message appears when trying to login despite entering the correct username and password.</td>\r
 128   <td class="tabledata">The user account has been disabled or the password has been changed by the administrator.</td>\r
 129   <td class="tabledata">Check with the administrator operating the Xestia Scanner Server installation.</td>\r
 130  </tr>\r
 131  <tr>\r
 132   <td class="tabledata">I get logged out whilst using the Xestia Scanner Server.</td>\r
 133   <td class="tabledata">Your session has expired or the administrator has used the ‘Logout All Users’ feature.</td>\r
 134   <td class="tabledata">Login again.</td>\r
 135  </tr>\r
 136 </table>\r
 137 \r
 138 <div class="footnote">\r
 139 <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
 140 </div>\r
 141                 </div>\r
 142         </body>\r
 143 </html>\r