Installation check
Explanation
This page executes various checks regarding the environment and the installation directory of BicBucStriim. It checks for typical problems that users had in the past.
 |
Everything ok. |
 |
There could be a problem, click on the info button to see the explanation. |
 |
A problem, please click on the info button to see the explanation. |
Calibre library check
Enter the path to your Calibre library to check accessibility. A Calibre library directory contains the file metadata.db plus various subdirectories for authors and books.
The test tries to find metadata.db in the directory you enter, and will check if that directory is readable for the application.
If the test fails (red light), check:
- that the directory really exists
- that it contains the files mentioned above
- that it is readable for the application (see also the open_basedir check below)
|
{% if cd == 0 %}
{% else %}
{% if cd == 1 %}
{% else %}
{% endif %}
{% endif %}
|
Environment checks
-
info Apache web server?
{% if is_a == true %}
Yes, {{srv}}.
{% else %}
No.
{%endif%} -
info PHP version 5.2+?
{% if is_a == true %}
Yes, found version {{phpv}}.
{% else %}
No, found version {{phpv}}.
{%endif%} -
info Does .htaccess exist?
{% if htaccess == true %}
Yes.
{% else %} {% if is_a == true %}
No.
{% else %}
No Apache, please ensure URL rewriting manually.
{% endif %} {% endif %} -
info Is URL rewriting enabled?
{% if mre == true %}
Yes.
{% else %} {% if is_a == true %}
No.
{% else %}
No Apache, please verify manually.
{% endif %} {% endif %} -
info Is Mcrypt enabled?
{% if mcrypt == true %}
Yes.
{% else %}
No.
{% endif %} -
info Is Sqlite3 installed?
{% if hsql != false %}
Yes.
{% else %}
No.
{% endif %} -
info Is GD version 2 (or higher) installed?
{% if hgd2 == true %}
Yes, found version {{hgd2v}}.
{% else %}
{% if hgd2v == "" %} No. {% else %} No, found {{hgd2v}}. {% endif %}
{% endif %} -
info Is the open_basedir restriction in effect?
{% if opd == "" %}
No.
{% else %}
Yes, open_basedir = {{opd}}
{% endif %} -
info Is the data directory writeable?
{% if dwrit == true %}
Yes.
{% else %}
No.
{% endif %} -
info Is data/data.db writeable?
{% if mwrit == true %}
Yes.
{% else %}
No.
{% endif %}
The PHP open_basedir setting is a security measure that restricts file access for PHP applications to a list of specified directories mentioned in the variable. Many NAS devices use this setting.
If your Calibre library is located outside your web server root, which is often the case,
it should be included in the open_basedir list. To include it, just append the name of your
Calibre directory to this list, e.g. ...:/volume1/books (don't forget the colon in front).
BicBucStriim contains a .htaccess file that enables URL rewriting on Apache servers automatically. If the check failed this is probably due to an unpack problem. Sometime unzippers don't unpack hidden files (i.e. files whose names start with a dot) properly. Try a different unzip application.
BicBucStriim contains a .htaccess file that enables URL rewriting on Apache servers automatically. If this is an Apache web server and the check failed, please change the URL rewriting (mod_rewrite) settings of your server/device.
If this is no Apache web server, you have to verify manually that URL rewriting is enabled.
Mcrypt is used to encrypt browser cookies that contain passwords. BicBucStriim works without it, but then transmits passwords unencrypted. In a secure home network this is usually not a problem.
In case you are using BicBucStriim over the Internet, you might consider enabling mcrypt to protect your password information. In order to enable mcrypt, install a module like php5-mcrypt.
The Sqlite3 database library is required to read the Calibre library data. Sqlite support for PHP is often contained in a module like php5-sqlite. Please install the Sqlite3 support if the check failed.
The GD image library is necessary for thumbnail generation. GD support for PHP is often contained in a module like php5-gd. Please install or update the module if the check failed.
The bbs/data directory contains the configuration database and thumbnails. If it doesn't exist or is not writeable the application can't store anything. If the check failed, please create the directory and/or change the access rights.
The file bbs/data/data.db is part of the BicBucStriim package and stores your configuration data. If the check failed, please verify that it exists and is writeable.
BicBucStriim requires PHP 5.2 or higher. Otherwise some functions might fail.
BicBucStriim works with Apache and other web servers. However, the included configuration file .htaccess is for Apache only. If you are using a different web server please make sure that features like URL rewriting are enabled.