This file is a database of FLUKA website Errors explanation.
--------------------------------------------------------
UPDATED===09.10.2008.18.47.52
TITLE===Website error
TYPE===database
--------------------------------------------------------

uniquied line described test code (spaces and special chars not permitted!)
::::::::::::
test line in PHP
::::::::::::
explanation

--------------------------------------------------------

STAT_4
::::::::::::
(file_exists(<ROOT>/htmls/website_common))
::::::::::::
make symbolic link from website_common to htmls/website_common:<br />
<span style="font-family: courier;">ln -s $PWD/website_common $PWD/htmls/website_common</span>

--------------------------------------------------------

STAT_3
::::::::::::
(file_exists(<ROOT>/html/website_common))
::::::::::::
make symbolic link from website_common to html/website_common:<br />
<span style="font-family: courier;">ln -s $PWD/website_common $PWD/html/website_common</span>

--------------------------------------------------------

STAT_1
::::::::::::
(file_exists(<ROOT>/html/website_style))
::::::::::::
make symbolic link from website_style to html/website_style:<br />
<span style="font-family: courier;">ln -s $PWD/website_style $PWD/html/website_style</span>

--------------------------------------------------------

STAT_2
::::::::::::
(file_exists(<ROOT>/htmls/website_style))
::::::::::::
make symbolic link from website_style to htmls/website_style:<br />
<span style="font-family: courier;">ln -s $PWD/website_style $PWD/htmls/website_style</span>


--------------------------------------------------------

TEMP_1
::::::::::::
(is_writable(<ROOT>/website_temp))
::::::::::::
directory for temporary use in not writeable:<br />
<span style="font-family: courier;">chmod -R 777 $PWD/website_temp</span>


--------------------------------------------------------

TEMP_2
::::::::::::
(is_writable(<ROOT>/website_temp/manual/))
::::::::::::
directory for online manual generator in not writeable:<br />
<span style="font-family: courier;">chmod -R 777 $PWD/website_temp/manual/</span>

--------------------------------------------------------

TEMP_3
::::::::::::
(is_writable(<ROOT>/website_temp/logs/))
::::::::::::
directory for website logs in not writeable:<br />
<span style="font-family: courier;">chmod -R 777 $PWD/website_temp/logs/</span>

--------------------------------------------------------

TEMP_4
::::::::::::
(is_writable(<ROOT>/website_temp/stats/))
::::::::::::
directory for website statistics in not writeable:<br />
<span style="font-family: courier;">chmod -R 777 $PWD/website_temp/stats/</span>

--------------------------------------------------------

TEMP_5
::::::::::::
(is_writable(<ROOT>/website_temp/lock/))
::::::::::::
directory for website edit content interface in not writeable:<br />
<span style="font-family: courier;">chmod -R 777 $PWD/website_temp/lock/</span>

--------------------------------------------------------

TEMP_FILE_1
::::::::::::
((file_exists(<ROOT>/website_temp/backups.txt) && is_writeable(<ROOT>/website_temp/backups.txt)) || (!file_exists(<ROOT>/website_temp/backups.txt)) || (fileowner(<ROOT>/website_temp/frame.dump) == APACHE_ID))
::::::::::::
Wrong permissions for file: <ROOT>/website_temp/backups.txt<br />
This file is generated when admin wish to download some backuped USER DATABASEs.<br />
<span style="font-family: courier;">chmod 777 $PWD/website_temp/backups.txt (if file exists)</span>

--------------------------------------------------------

TEMP_FILE_2
::::::::::::
((file_exists(<ROOT>/website_temp/frame.dump) && is_writeable(<ROOT>/website_temp/frame.dump)) || (!file_exists(<ROOT>/website_temp/frame.dump)) || (fileowner(<ROOT>/website_temp/frame.dump) == APACHE_ID))
::::::::::::
Wrong permissions for file: <ROOT>/website_temp/frame.dump<br />
This file is a content-only stripped subpage for printing purposes.<br />
<span style="font-family: courier;">chmod 777 $PWD/website_temp/frame.dump (if file exists)</span>

--------------------------------------------------------

TEMP_FILE_3
::::::::::::
((file_exists(<ROOT>/website_temp/userpwd_last_downloaded.txt) && is_writeable(<ROOT>/website_temp/userpwd_last_downloaded.txt)) || (!file_exists(<ROOT>/website_temp/userpwd_last_downloaded.txt)) || (fileowner(<ROOT>/website_temp/userpwd_last_downloaded.txt) == APACHE_ID))
::::::::::::
Wrong permissions for file: <ROOT>/website_temp/userpwd_last_downloaded.txt<br />
This file store date information when admin has downloaded last time USER DATABASE.<br />
<span style="font-family: courier;">chmod 777 $PWD/website_temp/frame.dump (if file exists)</span>

--------------------------------------------------------

DIR_1
::::::::::::
(is_writable(<ROOT>/html/frame/))
::::::::::::
Directory has wrong privileges.<br />
This directory is used to generate content-only stripped subpage for printing purposes output.<br />
<span style="font-family: courier;">chmod -R 777 $PWD/html/frame/</span>

--------------------------------------------------------

DIR_2
::::::::::::
(is_writable(<ROOT>/htmls/free_download/))
::::::::::::
Directory has wrong privileges.<br />
This directory is used for some admin and user downloading without any access restrictions.<br />
<span style="font-family: courier;">chmod -R 777 $PWD/htmls/free_download/</span>

--------------------------------------------------------

BCK_1
::::::::::::
(shell_exec(find <ROOT> -name *~))
::::::::::::
System-like backups (ending with ~) found in the tree of the website.<br />
May generate some strange errors/secuirity leackage and consume space.

--------------------------------------------------------

DB_1
::::::::::::
(is_writable(<ROOT>/website_restricted/backup/))
::::::::::::
Directory for USER DATABASE backups have wrong privileges.<br />
<span style="font-family: courier;">chmod -R 777 $PWD/website_restricted/backup/</span>

--------------------------------------------------------

DB_2
::::::::::::
(file_exists(<ROOT>/website_restricted/userpwd.txt))
::::::::::::
Existance of the USER DATABASE (flat file).

--------------------------------------------------------

DB_3
::::::::::::
(is_writeable(<ROOT>/website_restricted/userpwd.txt) || (fileowner(<ROOT>/website_restricted/userpwd.txt) == APACHE_ID))
::::::::::::
USER DATABASE file have wrong privileges.<br />
<span style="font-family: courier;">chmod 777 $PWD/website_restricted/userpwd.txt</span>

--------------------------------------------------------

DB_4
::::::::::::
$update = trim(file_get_contents(<ROOT>/website_temp/userpwd_last_downloaded.txt));<br />
(FN_dateDiff(date("d.m.Y"), $update) > DAYS_DB_DOWNLOAD)
::::::::::::
Download the USER DATABASE to have extra backup.<br />
DAYS_DB_DOWNLOAD is defined in the <span style="font-family: courier;">config.txt</span>.

--------------------------------------------------------

HT_1
::::::::::::
CONFIGURATION IN: <span style="font-family: courier;">/etc/httpd/conf/httpd.conf</span> for packages download
::::::::::::
Configuration for FLUKA package download access is not pointing to the correct database.<br />
Correct configuration.<br />
Previously (for Milano machine):<br />
<span style="font-family: courier;">
<Directory /Fluka/www/htmls/packages><br />
  AllowOverride None<br />
  AuthName "FLUKA download interface"<br />
  AuthType Basic<br />
  AuthUserFile /Fluka/www/website_restricted/.htpasswd_packages<br />
  require valid-user<br />
</Directory>
</span>

--------------------------------------------------------

HT_2
::::::::::::
CONFIGURATION IN: <span style="font-family: courier;">/etc/httpd/conf/httpd.conf</span> for source download
::::::::::::
Configuration for FLUKA source download access is not pointing to the correct database.<br />
Correct configuration.<br />
Previously (for Milano machine):<br />
<span style="font-family: courier;">
<Directory /Fluka/www/htmls/source><br />
  AllowOverride None<br />
  AuthName "FLUKA source download interface"<br />
  AuthType Basic<br />
  AuthUserFile /Fluka/www/website_restricted/.htpasswd_source<br />
  require valid-user<br />
</Directory>
</span>

--------------------------------------------------------

HT_3
::::::::::::
(file_exists(<ROOT>/website_restricted/.htpasswd_packages))
::::::::::::
Existance of password file for Apache during access to packages.<br />
This file may not exists if:<br />
- admin block access<br />
- website is fresh and admin did not allow access

--------------------------------------------------------

HT_4
::::::::::::
(file_exists(<ROOT>/website_restricted/.htpasswd_source))
::::::::::::
Existance of password file for Apache during access to source.<br />
This file may not exists if:<br />
- admin block access<br />
- website is fresh and admin did not allow access

--------------------------------------------------------

WL_1
::::::::::::
(file_exists(<ROOT>/website_restricted/trusted.txt))
::::::::::::
Existance of whitelist.

--------------------------------------------------------

WL_2
::::::::::::
(is_writeable(<ROOT>/website_restricted/trusted.txt))
::::::::::::
Write pivileges the whitelist.

--------------------------------------------------------

PACK_0
::::::::::::
(file_exists(<ROOT>/htmls/source/PACKAGE_0))
::::::::::::
Source package not exists in source download directory.<br />
PACKAGE_0 is defined in <span style="font-family: courier;">config.txt</span>.

--------------------------------------------------------

PACK_1
::::::::::::
(file_exists(<ROOT>/htmls/source/PACKAGE_X))
::::::::::::
One of the packages: PACKAGE_1, 2, ... defined in <span style="font-family: courier;">config.txt</span> not exists in package download directory.<br />
PACKAGE_1, 2, ... are defined in <span style="font-family: courier;">config.txt</span>.

--------------------------------------------------------

TXT_1
::::::::::::
(file_exists(<ROOT>/website_common/txt))
::::::::::::
Existance of the subpages directory.

--------------------------------------------------------

TXT_2
::::::::::::
(is_writeable(<ROOT>/website_common/txt))
::::::::::::
Write pivileges of the subpages directory.

--------------------------------------------------------

TXT_3
::::::::::::
(file_exists(<ROOT>/website_common/txt/backup) && is_writeable(<ROOT>/website_common/txt/backup))
::::::::::::
Existance and write pivileges of the subpages backup directory.

--------------------------------------------------------

TXT_4
::::::::::::
((!is_readable(<ROOT>/website_common/txt/*.txt) || !is_writeable(<ROOT>/website_common/txt/*.txt)) && (fileowner(<ROOT>/website_common/txt/*.txt) != APACHE_ID))
::::::::::::
Wrong privileges of particular file in <ROOT>/website_common/txt/.<br />
Sometimes newly uploaded file (by ssh, scp) can rise this error.<br />
If you try to edit & save the file without changes and the error will not disappear:<br />
<span style="font-family: courier;">chmod 777 $PWD/website_common/txt/<<em>name_of_the_file</em>></span>

--------------------------------------------------------

OVER_1
::::::::::::
Overload of <ROOT>/website_restricted/backup/
::::::::::::
Too many files in: <ROOT>/website_restricted/backup/ (backups of USER DATABASE).<br />
NM_BACKUPS_ALLOWED can be modified in <span style="font-family: courier;">config.txt</span>.
Too much files can consume a lot of disk space.

--------------------------------------------------------

OVER_2
::::::::::::
Overload of <ROOT>/website_common/txt/backup/
::::::::::::
Too many files in: <ROOT>/website_common/txt/backup/ (backups of website subpages).<br />
NM_BACKUPS_ALLOWED can be modified in <span style="font-family: courier;">config.txt</span>.
Too much files can consume a lot of disk space.

--------------------------------------------------------

TR_1
::::::::::::
$file_arr is the array of files in <span style="font-family: courier;"><ROOT>/htmls/free_download/</span> directory.<br />
((!IS_SECURED || !CH_adminPresence()) && (count($file_arr) > 0))
::::::::::::
<span style="font-family: courier;"><ROOT>/htmls/free_download/</span> contain some files - might be secuirity leackage
if still contain something even if the admin logout.<br />
In most cases it will not harm anything.

--------------------------------------------------------

TXT_FILE_1
::::::::::::
list($title, $contents, $update) = FN_stripTxtFile(basename(<ROOT>/website_common/txt/*.txt));<br />
$data = explode(TXT_SEPARATOR, file_get_contents(<ROOT>/website_common/txt/*.txt));
((count($data) < 3) || !$title || !$contents || !$update || (trim($title) == "") || (trim($update) == "") || (trim($contents) == ""))
::::::::::::
Website subpage txt file corrupted/not well formatted.

--------------------------------------------------------

TXT_FILE_2
::::::::::::
list($title, $contents, $update) = FN_stripTxtFile(basename(<ROOT>/website_common/txt/*.txt));<br />
((!isset($update)) || FN_dateDiff(date("d.m.Y"), trim($update)) > DAYS_UPDATE)
::::::::::::
Some files needs update or last update variable is not set properly inside txt file.

--------------------------------------------------------

TXT_FILE_3
::::::::::::
list($title, $contents, $update) = FN_stripTxtFile(basename(<ROOT>/website_common/txt/*.txt));<br />
((!isset($update)) || FN_dateDiff(date("d.m.Y"), trim($update)) > DAYS_UPDATE_CRITICAL)
::::::::::::
Some files critically needs update or last update variable is not set properly inside txt file.

--------------------------------------------------------

MAN_1
::::::::::::
(file_exists(<ROOT>/website_temp/manual/chapter0.txt) && file_exists(<ROOT>/website_temp/manual/chapter_index.txt))
::::::::::::
If those two files not exists propably rest of the files too.<br />
Regenerate the manual!

--------------------------------------------------------

STAT_1
::::::::::::
$filename = <ROOT>/website_temp/stats/yesterday_counter_frame.txt<br />
(int) (trim(file_get_contents($filename))) > 10
::::::::::::
If the website was not viewed yesterday for sure this means some critical problem!<br />
Crawlers also generate some traffic.

--------------------------------------------------------

STAT_2
::::::::::::
$filename = <ROOT>/website_temp/stats/yesterday_counter_register.txt<br />
(int) (trim(file_get_contents($filename))) > 0
::::::::::::
If this warning will be present test the registration procedure for errors.

--------------------------------------------------------

STAT_3
::::::::::::
For each defined PACKAGE_<<em>number</em>><br />
$filename = <ROOT>/website_temp/stats/yesterday_counter_download_<<em>number</em>>.txt
(int) (trim(file_get_contents($filename))) > 0
::::::::::::
If this warning will be present test the downloading procedure for errors.

--------------------------------------------------------

INT_1
::::::::::::
(!file_exists(<ROOT>/website_restricted/internal.txt))
::::::::::::
File containig password for internal access.<br />
Regenerate this file using admin interface.

--------------------------------------------------------

INT_2
::::::::::::
(!file_exists(<ROOT>/website_restricted/upload.txt))
::::::::::::
File containig password for internal (upload) access.<br />
Regenerate this file using admin interface.

--------------------------------------------------------

LOG_1
::::::::::::
Existance of log files: website_temp/logs/*
::::::::::::
If there are no logs something may be wrong with privileges of this directory.