Documentation main page
Features
Installation
Administration
Usage
Developers
FibuSQL login
FibuSQL - Installation
This document describes the installation of the FibuSQL
server. FibuSQL is completely web-based, so the clients only
need a web browser and network access to the server.
Preliminaries
- Webserver supporting PHP that allows installing own scripts. It
is called
fibu-www
here.
- The FibuSQL files. The archive can be downloaded from my
project page.
- Installed PEAR library; if it
is not already installed, too old, or not accessible because of
PHP's safe mode, then a fitting part of it (containing only the
required PEAR::DB) can be downloaded from the
project page.
- A database supported by PEAR::DB (currently mySQL,
PostgreSQL, InterBase, Mini SQL, MS SQL Server, Oracle 7/8/8i,
Sybase, Informix, FrontBase, or ODBC; up to now, mySQL and
PostgreSQL have been tested). The database must be accessible from
fibu-www
. The computer hosting the database is called
fibu-db
here.
Installation
- Creation of a database: On
fibu-db
a
database has to be created (by you or your friendly system
operator). No tables have to be created, this is done in a later
step. You need the following information about it:
- which computer hosts it (
fibu-db
)
- its name
- user name
- password (optional; may be not necessary for private use)
- Extraction of archive into target directory:
- On
fibu-www
, change into a directory that is
reachable for the web server. This can be a site-wide directory
(differs from system to system) or a private one
(~/public_html/
by convention). Create a
subdirectory fibu
there and extract the downloaded
archive into that directory.
- If you downloaded the PEAR::DB archive, it has to be
extracted into the same target directory as FibuSQL.
- First test: Open your preferred web browser and open
FibuSQL's start page. The URL depends on the path you installed
FibuSQL to. E. g. if you used the personal directory of user
myuser
and unpacked FibuSQL into
public_html/fibu
, the address will be
http://fibu-www/~myuser/fibu/
- First login: Now you should see the login page of
FibuSQL. Enter the database information from step 1 (leave the
password field empty if no password is used) and click on
"Login". If an error message about a failing database
connection appears, then either the login data was wrong or the
database does not allow access from
fibu-www
(this can
only be fixed by the system administrator).
- Presetting the login data (optional): If you want and your
security policy allows it, you can preset the login data such that users do
not need to enter the login data. Open the file
fibusql.conf
with an ASCII editor and assign the data to the respective variables. You can
also change some settings for the user interface here. The file is documented
quite verbosely; please let me know if you cannot figure it out, and tell me
what is not intelligible.
- Initialisation of the database: Choose
"Administration" in the menu bar and click on
"Initialize database". This will create the necessary
tables (journal, account list, etc.).
Since this step creates objects, you have to login as the owner of
the database for this step. After that, FibuSQL can be used also by
other database users that have the following privileges: SELECT,
INSERT, UPDATE, and DELETE.