Installation Instructions

Requirements:

  • a web server (Apache automatically installed with Windows and Ubuntu installers)
  • PHP 5.3 or newer with PDO and PDO_SQLite extensions (automatically installed with Windows and Ubuntu installers)
  • a web browser (IE6, 7 and 8 are not supported) with an optional PDF reader plugin

Windows Ubuntu Linux OS X

Windows instructions

Installation using an installer with or without Apache and PHP

  • Download and start I, Librarian installer. Use the installer with Apache and PHP, if you want to install all prerequisites. If you already have Apache and PHP installed, use the smaller installer.
  • Follow the installer instructions.
  • Open your web browser and go to http://127.0.0.1:8080/librarian. If you used the smaller installer, open your web server's librarian URI.

Manual installation Windows using zip

  • It is assumed that you have Apache and PHP installed and properly configured.
  • Edit Apache configuration file (httpd.conf). Append this at the end using Notepad:

    Alias /librarian "C:\I, Librarian"
    <Directory "C:\I, Librarian">
     AllowOverride None
     Require local
     <IfModule mod_php5.c>
      php_value upload_max_filesize 200M
      php_value post_max_size 800M
     </IfModule>
    </Directory>
    <Directory "C:\I, Librarian\library">
     Require all denied
    </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.
  • Open your web browser and go to open your web server's librarian URI.

Ubuntu instructions

  • Download either the deb or the console installer package.
  • In case of the deb package, double-click the deb file and install. However, Ubuntu Software Center is often broken, therefore we recommend gdebi to install downloaded debs.
  • In case of the console installer right-click (not double-click) the tar.gz package and select Extract here, read instructions in readme.
  • Both installers now install into /usr/share/i-librarian/www to conform with Debian policies. The console installer is more flexible.
  • Open your web browser and go to http://127.0.0.1/librarian.

Linux generic instructions

  1. 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. Incomplete list of required packages:
    • apache2 (may also be named httpd)
    • php5 (may also be called php)
    • php5-sqlite (may also be named php-pdo)
    • php5-gd (may also be named php-gd)
    • php5-curl (may also be named php-curl)
    • poppler-utils or poppler
    • ghostscript
    • tesseract-ocr
    • libreoffice
  2. Download I, Librarian tar.xz file for Linux and extract it into DocumentRoot.

    tar xpf *.tar.gz -C /var/www/html/librarian
    Alternatively, extract the package somewhere else /home/user/Documents/i-librarian and create Alias in your Apache httpd.conf:

    Alias /librarian /home/user/Documents/i-librarian
  3. 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
  4. Insert a safe setting like this example into your Apache configuration file:

    <Directory "/var/www/html/librarian">
     AllowOverride None
     Require local
     <IfModule mod_php5.c>
      php_value upload_max_filesize 200M
      php_value post_max_size 800M
     </IfModule>
    </Directory>
    <Directory "/var/www/html/librarian/library">
     Require all denied
    </Directory>
  5. Restart Apache.
  6. 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 instructions

Generic Manual installation

  • Install an Apache-PHP stack of your choice.
  • Edit httpd.conf:
    Alias /librarian /Users/yourusername/Sites/librarian
    <Directory /Users/Yourusername/Sites/librarian>
     AllowOverride None
     Require local
     <IfModule mod_php5.c>
      php_value upload_max_filesize 200M
      php_value post_max_size 800M
     </IfModule>
    </Directory>
    <Directory /Users/Yourusername/Sites/librarian/library>
     Require all denied
    </Directory>
    Don't forget to change "yourusername" to your actual user name. You can find out your user name by typing whoami in Terminal.
  • Restart Apache.
  • Download and install LibreOffice, Tesseract OCR, Ghostscript, and Poppler.
  • Download I, Librarian for Mac OS X and double-click the file to extract its contents.
  • Rename the extracted directory to "librarian" and move it to your Sites folder. Make sure that your Sites folder is accessible to Others. Use the Get Info dialog of the Sites directory to change permissions for Everyone to access and read. You also need to make sure Everyone has Execute permissions for your home directory.
  • Change the owner of the "library" subfolder to Apache, example:

    sudo chown -R _www /Users/yourusername/Sites/librarian/library
  • Open your web browser and go to http://127.0.0.1/librarian.