PHOTO ORGANIZER INTRODUCTION

 

Introduction | Install | Uninstall | Configure | OpenBSD | Migration | License

 

Thanks

Thank you for chosing Photo Organizer. The format of this document is still fluid and will change significantly during the following releases. This section lists the system requirements and briefly presents the installation process.

System Requirements

Mandatory requirements (PO might work with older software versions than specified inhere):

  1. An Apache 2.0.40+ HTTP server with PHP 4.3.10+ compiled with support for PGSQL, BCMATH,, and SOCKETS.
  2. A PostgreSQL 7.4.1+ database server that accepts TCP/IP connections even if the database server and the HTTP server are located on the same computer.
  3. ImageMagick 5.4.7+
Optional requirements:
  1. If ExifTool is installed, PO will use it for EXIF extraction.
  2. An mail transfer agent is needed and PHP must be configured to use this mail transfer agent if you wish to use e-mail notifications.
  3. If tar and/or unzip is available PO will support bulk upload.
  4. ps2pdf must be installed in order to enable printing in PDF format.
  5. dcraw must be installed in order to support raw image formats.
Additionally, to complete the installation you will also have to:
  1. Log in as a superuser on the computer where you install the system.
  2. Access a PostgreSQL user account which is allowed to create new databases and database users and new languages (plpgsql).
  3. Read and understand the licence conditions described in the Licence section.

Brief Install Instructions

You can chose to upgrage an exisiting Photo Organizer installation (older than PHP.2.5.C-SQL.2.5.C) or to install a new system. Photo Organizer's database has been developed in such way that it can be easily upgraded with minimal service interruption. Back up your database before starting the upgrade, however you should experience no problems in case your database is a genuine Photo Organizer database.

To install the software manually follow the instructions listed in the Install section. For an automated installation run the install script. This will do the following:

  1. Collect setup information.
  2. Check for an existing Photo Organizer installation.
  3. If found:
    1. If a repository migration is needed convert the old repository into the new one.
    2. Alter and upgrade the database.
    3. Remove old Photo Organizer php files.
  4. if not found:
    1. Create a database user.
    2. Create a database for the previous user.
    3. Create the database structures and load static data.
    4. Create a new image repository.
    5. Create the target directory where Photo Organizer files will live.
  5. Copy the Photo Organizer php files into the target directory.
  6. Reconfigure Photo Organizer to access the image repository and the database server.
  7. Change the ownership of the installation and the image repository.

If you installed Photo Organizer into the HTTP server's document root directory, your system is ready and it can be accessed via

http://yourhost.yourdomain/po

After installation, you can relocate Photo Organizer's PHP files to any location in the HTTP server's document root, but you will have to update include/config.php file in your PO installation, specifying the new URL of your PO installation.

Similarly, if you relocate Photo Organizer's Image Repository you will have to tell update the include/config.php file in your PO installation, specifying the new location of your repository.

You can safely rename volumes via the Admin interface, but it's not a good idea to rename volumes via shell commands or to modify the image repository's file structure in any way. Unless you know exactly what you do, avoid making changes in the repository.

Photo Organizer's administrator account is created during installation. You can log in as:

username: admin
password: admin

Make sure you change the administrator username and the password.

Comments and corrections are welcome at balint@k-i-s.net.