Requirements:

• OS: Windows, Linux, Mac OS X
• Apache web server (automatically installed with Windows and Ubuntu installers)¹
• PHP5.2 with PDO and PDO_SQLite extensions (automatically installed with Windows and Ubuntu installers)
• a web browser (IE6 and 7 are not supported)
• (optional) a PDF reader plugin

Windows installation instructions:

• Before you start, uninstall Microsoft IIS (if you have it installed; you can check in Control Panel->Add or Remove Programs->Add or Remove Windows Components). Close Skype or any other software using port 80.
• Download and start I, Librarian installer with included Apache and PHP.
• Follow the instructions.
• Open your web browser and go to http://localhost/librarian.

• Before you start, uninstall Microsoft IIS (if you have it installed; you can check in Control Panel->Add or Remove Programs->Add or Remove Windows Components). Close Skype or any other software using port 80.
• ²Install Apache 2.2 (Server Name: localhost [for private use], static IP or DNS name [for groupware use]). Tutorial
• ²Install PHP 5.3 with Windows installer (.msi). Make sure that the SQLite extension in the PDO subtree is selected for installation.
• Edit Apache configuration file (httpd.conf). Append this at the end using Notepad:
  
  
  Alias /librarian "C:\I, Librarian"
  <Directory "C:\I, Librarian">
   AllowOverride None
   Order deny,allow
   Deny from all
   Allow from 127.0.0.1
   <IfModule mod_php5.c>
    php_value upload_max_filesize 200M
    php_value post_max_size 800M
    php_value max_input_time 120
   </IfModule>
  </Directory>
  <Directory "C:\I, Librarian\library">
   IndexIgnore *
   AddType text/plain .html .htm .shtml
   <IfModule mod_php5.c>
    php_admin_flag engine off
   </IfModule>
   <FilesMatch "\.sq3$">
    Order allow,deny
   </FilesMatch>
  </Directory>
  
  You may change "C:\I, Librarian" to any directory where you want to have I, Librarian, including an external drive! For groupware use, you need to allow access to more IP numbers or domain names. Just add more Allow from directives.
• Restart either Apache server or the computer.
• Unzip I, Librarian files into the directory defined by Alias in httpd.conf file (step 4).
• Open your web browser and go to http://localhost/librarian (or your static IP, or server name).

Ubuntu (Debian) installation instructions:

• Download either the deb or the console installer package.
• In case of the deb package, double-click the deb file and install.
• In case of the console installer right-click (not double-click) the tar.gz package and select Extract here, read instructions in readme.txt.
• Both installers now install into /usr/share/i-librarian/www to conform with Debian policies. If you installed into /var/www before, simply copy librarian subdirectory to the new place:
  sudo cp -pr /var/www/librarian/library /usr/share/i-librarian/www
• Open your web browser and go to http://127.0.0.1/librarian.

Linux installation instructions:

• Make sure you have Apache and PHP5 with both pdo.so and pdo_sqlite.so extensions enabled. Some Linux distros install PDO and PDO-SQLite with the PHP5. Others require installing packages usually called php-pdo, php-sqlite or php5-sqlite on top of PHP5. Fedora 13 comes with Apache preinstalled (it is called httpd), you need to install php and php-pdo packages and start Apache server. Note that you need root privileges to execute this installation. Complete list of required packages:
  apache2 (may also be named httpd)
  - a web server (you may run I, Librarian with a diffrent web server as well)
  php5 (may also be called php)
  - I, Librarian is written in PHP5
  php5-sqlite (may also be named php-pdo)
  - SQLite database for PHP5
  php5-gd (may also be named php-gd)
  -GD library for PHP5; required for image copying in the built-in PDF viewer
  poppler-utils
  -required for PDF indexing and for the built-in PDF viewer
  bibutils
  - required for import/export from bibtex format
  ghostscript
  - required for the built-in PDF viewer
  
• Download I, Librarian tar.gz file for Linux.
• Extract the tar file into DocumentRoot. Example:
  tar zxpf *.tar.gz -C /var/www/html/librarian
  DocumentRoot in Fedora, RedHat, CentOS, Mandriva: /var/www/html
  DocumentRoot in OpenSUSE: /srv/www/htdocs
• Alternatively, extract the package into /usr/share/i-librarian/www and create Alias in your Apache httpd.conf:
  Alias /librarian /usr/share/i-librarian/www
• Change the owner of the library subfolder to Apache. Example:
  chown -R apache:apache /var/www/html/librarian/library
  chown root:root /var/www/html/librarian/library/.htaccess
  Apache owner:group in:
  Fedora, RedHat, CentOS, Mandriva: apache:apache
  OpenSUSE: wwwrun:www
• Insert a safe setting like this example into your Apache configuration file:
  
  
  <Directory "/var/www/html/librarian">
   AllowOverride None
   Order deny,allow
   Deny from all
   Allow from 127.0.0.1
   <IfModule mod_php5.c>
    php_value upload_max_filesize 200M
    php_value post_max_size 800M
    php_value max_input_time 120
   </IfModule>
  </Directory>
  <Directory "/var/www/html/librarian/library">
   IndexIgnore *
   AddType text/plain .html .htm .shtml
   <IfModule mod_php5.c>
    php_admin_flag engine off
   </IfModule>
   <FilesMatch "\.sq3$">
    Order allow,deny
   </FilesMatch>
  </Directory>
  
  
• Restart Apache.
• Open your web browser and go to http://127.0.0.1/librarian (depending where you installed I, Librarian), or your static IP, or DNS name of your server (look for ServerName in your conf file).

Mac OS X installation instructions:

• Start Apache: Go to System Preferences->Sharing, and check Web Sharing checkbox.
• Install PHP from http://php-osx.liip.ch/ using this command:
  curl -s http://php-osx.liip.ch/install.sh | bash -
• Download I, Librarian for Mac OS X and double-click the file to extract its contents.
• Rename the extracted directory (e.g. to librarian) and move it to your Sites folder.
  
• Change the owner of the "library" subfolder to Apache. Open X11 terminal and write:
  cd Sites/librarian
  sudo chown -R _www:_www library
• Insert a safe setting like this example into your Apache configuration file (/private/etc/apache2/users/yourusername.conf):
  
  
  <Directory "/Users/Yourusername/Sites/librarian">
   AllowOverride None
   Order deny,allow
   Deny from all
   Allow from 127.0.0.1
   <IfModule mod_php5.c>
    php_value upload_max_filesize 200M
    php_value post_max_size 800M
    php_value max_input_time 120
   </IfModule>
  </Directory>
  <Directory "/Users/Yourusername/Sites/librarian/library">
   IndexIgnore *
   AddType text/plain .html .htm .shtml
   <IfModule mod_php5.c>
    php_admin_flag engine off
   </IfModule>
   <FilesMatch "\.sq3$">
    Order allow,deny
   </FilesMatch>
  </Directory>
  
  
• Restart Apache by unchecking and checking Web Sharing checkbox.
• Open your web browser and go to http://127.0.0.1/~YourUsername/librarian.

IMPORTANT! Please note, that the PDF files that you possess are subject to copyright and thus must not be accessible to anyone but who is authorized. Therefore, it is strongly recommended that you restrict access to your virtual library.

Librarian is not intended to be an internet application! You can use your PDF Library remotely from any computer on internet, but ALWAYS use the configuration below to enable access to authorized users only.

Access can be restricted in the Apache configuration file by inserting IP numbers or domain names of allowed computers between the "Directory" tags, for example:

<Directory "C:/library/">
   Order Deny,Allow
   Deny from all
   Allow from 111.111.55.50
   Allow from 111.111.55.51
   Allow from 111.111.56
   Allow from somedomain.edu
</Directory>

If you don't have access to the Apache configuration file, ask the administrator of your server to do this for you. Visit Apache site, if you want to learn more.

IMPORTANT! Note that it is absolutely essential to make backups of both the database and PDF files in your library on regular basis. Everything important is stored in the "/library" subfolder. Either use Backup Assistant in I, Librarian, or stop Apache and simply copy this directory onto a DVD or an external hard drive.