Index:


Release Notes:


OpenBiblio 0.5.x Install Instructions (New Systems):

  1. Install a web server such as Apache that is compatible with PHP. If you install Apache, get familiar with starting and stopping your Apache Web Server. If you are running Windows 95/98/ME there will be a apache.exe at the install-directory, which you can start. You may want to consider adding the "Start Apache" icon to your startup folder. If you are running Windows NT/2000/XP you can add Apache as a service which will be running, even if you are logged off. If you are running Linux your Apache server should be packaged with your Linux installation and will start when you start Linux. Attention: Under Windows ME there are much reports about problems with Apache 2.0.x (in my practice it doesn't run, as long as i had installed networkcards, the tcp/ip-driver of ME seems buggy), take Apache 1.3.33 in this case.
  2. Add PHP to your web server as a CGI or a module. If you are using Apache 2.0, I would highly recommend that you install PHP as a module instead of a cgi application. In my experience the Apache PHP module performed over 4 times faster than the cgi PHP. See Example 3-9. PHP and Apache 2.0 as Module in the PHP Manual for more info on how to install PHP as a module.

    OpenBiblio uses session data. Therefore, you will need to make sure PHP sessions is turned on. Be sure to create a directory for your session data on your server and specify the session.save_path in your php.ini file. The default php.ini sets session.save_path to "/tmp". Therefore, you have to create a directory called c:/tmp (for Windows) users. However, I usually create a more descriptive name inside my PHP directory and then change my php.ini file to match it.

    Example php.ini directive:

    session.save_path = d:\PHP\sessiondata

    See section XCIII. Session handling functions in the PHP manual for more details on PHP sessions.

    If you are running Linux PHP should be also packaged with your Linux installation, maybe you have to install it from your distribution-CD. (You should use PHP4).

    Attention: You have to use PHP 4.2.x or higher!

  3. Install the MySQL database from http://www.mysql.com/. Get familiar with starting and stopping your MySQL Server. See Starting MySQL on Windows 95 or Windows 98 for more information.

    If you are running Windows NT/2000/XP, setup MySQL as a service so it starts whenever the machine powers up. See Starting MySQL on Windows NT or Windows 2000 for more information on starting MySQL as a service.

    If you are running Linux, MySQL should be packaged with your Linux installation and will start when you start Linux.
  4. Get familiar with logging into MySQL with your admin account within a DOS prompt window (or within the Linuxprompt). You can use the following command sequence as a test.
    C:\>c:\mysql\bin\mysql -uroot mysql
    (Linux:\>mysql -uroot mysql)
    Enter password: *********
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 8 to server version: 4.0.23
    
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer
    
    mysql> show databases;
    +--------------+
    | Database     |
    +--------------+
    | mysql        |
    | test         |
    +--------------+
    6 rows in set (0.00 sec)
    
    mysql> exit
    Bye
    
    C:\>
    
  5. Create an OpenBiblio database. To do this, log into MySQL with your admin account and run the following SQL command.
    mysql> create database OpenBiblio;
    
    To check to make sure the OpenBiblio database was created properly run the following command.
    mysql> show databases;
    +--------------+
    | Database     |
    +--------------+
    | mysql        |
    | OpenBiblio   |
    | test         |
    +--------------+
    
  6. Create an OpenBiblio database user. To do this login to MySQL under the admin userid and run the following SQL command, substituting obiblio_user and obiblio_password with the userid and password of your choice.
    mysql> grant all privileges on OpenBiblio.* to obiblio_user@localhost
        -> identified by 'obiblio_password';
    
  7. Only with MySQL 4.1.x and higher you have to do the following step
    mysql> SET PASSWORD FOR
        -> obiblio_user@localhost = OLD_PASSWORD('obiblio_password');
    
  8. Verify your OpenBiblio database and user by logging into the new MySQL database under the new user.
    C:\mysql\bin\mysql -uobiblio_user -pobiblio_password OpenBiblio
    
  9. Copy the openbiblio directory and all of its contents into your web server's htdocs root or any subdirectory within the htdocs root.
  10. Edit the database_constants.php file (located in the main openbiblio directory) with the text editor of your choice. Change the username and password to match the new MySQL user and password that you created in the previous steps. Set the variable MAIN_LOCALE to your locale, in english you have to use "en"
  11. Create the OpenBiblio database tables. To do this run the install php script located at http://localhost/openbiblio/install/index.php, assuming you placed the openbiblio directory in the root htdocs directory.
  12. Access your new library automation system at http://localhost/openbiblio/index.html assuming you placed the openbiblio directory in the root htdocs directory. Enter "admin" for both the userid and password whenever you are prompted to signon. You can change the admin password from the "Admin" tab -> staff list, where you can also add more library staff members.

Updating Your System From OpenBiblio 0.5.1.3 to higher versions Instructions:

  1. Copy the openbiblio directory and all of its contents into your web server's htdocs root or any subdirectory within the htdocs root.
  2. Edit the database_constants.php file (located in the main openbiblio directory) with the text editor of your choice. Change the username, password and the MAIN_LOCALES to match the settings of the old version.
  3. No update of the database is necessary.
  4. If you want to use geman locales log in in openbiblio and go to admin/Settings, change the language to "Deutsch"

Updating Your System to Openbiblio 0.5.1.3 and higher (from previous versions including originalversion)

  1. Copy the openbiblio directory and all of its contents into your web server's htdocs root or any subdirectory within the htdocs root.
  2. Edit the database_constants.php file (located in the main openbiblio directory) with the text editor of your choice. Change the username, password and the MAIN_LOCALES to match the settings of the old version.
  3. Do the following Steps with mysql (if you used versions, for those you made some of the following changes, use only the new changes):
    C:\>C:\mysql\bin\mysql -uobiblio_user -pobiblio_password OpenBiblio
    (Linux:\>mysql -uobiblio_user -pobiblio_password OpenBiblio)
    Enter password: *********
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 8 to server version: 4.0.23
    
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer
    
    mysql> alter table staff modify pwd char(50) NOT NULL;
    mysql> update staff set pwd = md5(lower('admin'));
    mysql> ALTER TABLE biblio_copy ADD renewal_count TINYINT UNSIGNED NOT NULL ;
    mysql> update biblio_copy set renewal_count = 0;
    mysql> ALTER TABLE biblio_status_hist ADD renewal_count TINYINT UNSIGNED NOT
    NULL ;
    mysql> update biblio_status_hist set renewal_count = 0;
    mysql> ALTER TABLE material_type_dm ADD adult_renewal_limit TINYINT UNSIGNED
    NOT NULL ;
    mysql> ALTER TABLE material_type_dm ADD juvenile_renewal_limit TINYINT UNSIGN
    ED NOT NULL ;
    mysql> update material_type_dm set adult_renewal_limit = 2;
    mysql> update material_type_dm set juvenile_renewal_limit = 1;
    mysql> insert into usmarc_indicator_dm values (901,1,'#','Undefined');
    mysql> insert into usmarc_indicator_dm values (901,2,'#','Undefined');
    mysql> insert into usmarc_indicator_dm values (902,1,'#','Undefined');
    mysql> insert into usmarc_indicator_dm values (902,2,'#','Undefined');
    mysql> insert into usmarc_subfield_dm values (901,'a','min. Player','N');
    mysql> insert into usmarc_subfield_dm values (901,'b','max. Player','N');
    mysql> insert into usmarc_subfield_dm values (901,'c','min. Age','N');
    mysql> insert into usmarc_subfield_dm values (901,'d','max. Age','N');
    mysql> insert into usmarc_subfield_dm values (901,'e','Duration','N');
    mysql> insert into usmarc_subfield_dm values (902,'a','Bibliography Picture','N');
    mysql> insert into usmarc_tag_dm values (9,901,'Fields for Games','Undefiniert','Undefiniert','Y');
    mysql> insert into usmarc_tag_dm values (9,902,'Additional Fields','Undefiniert','Undefiniert','Y');
    mysql> ALTER TABLE member ADD mbrshipend DATE NOT NULL;
    
    (This will set all Staff-passwords to 'admin', you have to change it later!).
  4. Now you can work with your system!
  5. If you want to use geman locales log in in openbiblio and go to admin/Settings, change the language to "Deutsch"

Updating Your System From OpenBiblio 0.3.x to 0.5.x Instructions:

  1. Copy the openbiblio directory and all of its contents into your web server's htdocs root or any subdirectory within the htdocs root.
  2. Edit the database_constants.php file (located in the main openbiblio directory) with the text editor of your choice. Change the username, password and the MAIN_LOCALES to match the settings of the old version.
  3. Backup your database. See your MySQL documentation for instructions.
  4. Update your OpenBiblio database tables by using the conversion tool located at http://localhost/openbiblio/install/index.php, assuming you placed the openbiblio directory in the root htdocs directory.

Updating Your System From OpenBiblio 0.4.x to 0.5.x Instructions:

  1. Copy the openbiblio directory and all of its contents into your web server's htdocs root or any subdirectory within the htdocs root.
  2. Edit the database_constants.php file (located in the main openbiblio directory) with the text editor of your choice. Change the username, password and the MAIN_LOCALES to match the settings of the old version.
  3. No update of the database is necessary.

Implementing Z3950-Search

  1. You have to do this, after you installed Openbiblio (see above).
  2. At first install yaz-support for php. At windows-php since 4.2.x yaz is delivered with PHP. You have to copy the file php_yaz.dll in your windows-system-directory (you'll need the zip-Version of php, not the installer-version), in addition you have to remove the ; in the line ;extension=php_yaz.dll at the php.ini.
  3. Now you have to copy the file biblio_new_form.php.z3950 over the file biblio_new_form.php in the directory openbiblio/catalog.
  4. Now you can search a Bibliography by ISBN, ISSN or LCC at the "New Bibliography"-Dialog in the National Library Of Congress and complete the empty fields with the searchresult.