YaBook Install

• Requirements
• Quick Install
• Upgrading to a newer version

Requirements

• Any kind of operating system. YaBook has been tested on both Linux and Windows.
• Apache webserver (http://www.apache.org). YaBook works on both Apache 1.3.xx or 2.0.x. On Windows, it might work on IIS as well, but currently we are not doing any testing on it.
• One of the following database systems:
  • MySQL 4.0.x database or later version (http://www.mysql.com).
  • PostgreSQL (http://www.postgresql.org)
  • SQLite (http://www.sqlite.com)
  • Microsoft SQL Server 2000 (http://www.microsoft.com/sql/)
  • The following database systems might be supported in the near future: FrontBase, Borland InterBase, Sybase
• PHP 5 or later version. PHP 4.3.x won't work! Any versions below 5.0.0 (final) are not supported!

• of course all of it working together ... and a HTML-browser

For your information: the YaBook demonstration we are using currently is actually served by a PHP 5.0.4 and ZendEngine 2.0.4-dev backend.

Quick Install

Installation of YaBook is EASY! There is not even an installation script required to run, because YaBook automatically detects a new installation. The current installation instructions are located in your YaBook distribution: /private/doc/INSTALL.

[1] Unzip the distribution and make sure you keep the file-structure

[2] Edit config.inc.php and enter your database information
    At least, change the following settings:
    
    $conf['dsn'] = array(
        'username' => 'xxxxxxxx',
        'password' => 'xxxxxxxx',
        'database' => 'xxxxxxxx'
    );

[3] Make the following directory writable:
    
    /private/log     chmod 777
    
    If your webserver runs under the same group as your user, chmod 660
    might as well do it.

[4] Run YaBook!
    That's it, you won't need any further install instructions, as
    YaBook does automatically detect a new installation and creates
    the needed tables in your database. Default configuration is good
    in most cases.
    
    Run index.php from your browser and enjoy YaBook!

[5] To configure your new installation, please log-in with the default
    admin user:
    
    username= admin
    password= 1234
    
    You should then enter the "User Administration" (link on top of page).
    Either create your own user(s) and delete the default admin user or 
    at least change his password.

Upgrading to a newer version

Upgrading to a newer version of YaBook is easy. All you need to do is to replace the whole YaBook directory with the newer release files. You only need to re-enter the connection options of your database connection in the new config.inc.php. There is no further action required. YaBook will automatically upgrade your database scheme if required on the first web access to your YaBook installation. It will detect your previous version information and automatically runs an incremental upgrade.