Gallery

Pre Install

Before you start with your gallery install, make sure that you have apache with php "Apache Modules PHP" working properly.

Installing Gallery (via. GUI)

First download the necessary applications:

emerge Apache-Gallery unzip jhead

Then put gallery into setup mode:

cd /var/www/localhost/htdocs/gallery
./configure.sh

The setup webpage will first show you the status of the gallery setup (if you need to download anything else), then it will guide you through all of the steps needed for your configuration.

http://your.webserver.test/gallery/setup/index.php

Once the setup is complete, the webpage will be repointed to the main gallary url. You now should have a working version of gallery 1.x!!! (you might be asked in the setup stage to make some modifications to make everything work. Those specifics would be out of the range of this doc. ... so far.)

The final stage would be to make the config page secure again. To do this, at the command prompt, enter the following:

/var/www/localhost/htdocs/gallery/secure.sh

I'll write down how to install and configure gallery for multiple users.

The configuration I use is

• vhosts ( /var/www/<hostname>/htdocs )
• postgresql
• apache2

I'm writing this HOWTO as I go on with my own installation. The plan is to enable several diffent users, on different vhosts to have their own independent galleries.

The instructions are written, and the installation works (for me), this article could do with some editing though.

Emerge gallery

 USE="vhosts" emerge -av gallery

Install gallery using webapp-config

 webapp-config -I -s <http_server> -h <installation_host> -d <installation_dir> --user=<owner> <what_to_install>

A short explanation of webapps parameters

• -I
  • install
• -s <http_server>
  • Use webapp-config --list-servers to see supported web servers.
• -h <installation host>
  • which vhost to install gallery onto
• -d <installation_dir>
  • what directory to install to, this will result in vhost/htdocs/installation_dir

• --user=<owner>
  • the user owning the gallery
• <what to install>
  • what application to install, I used "gallery 2.0.4" when writing this.
• --pretend
  • use pretend at first to verify that you haven't mocked something up

So, as root execute the command as you choose.

I installed it on the host "localhost" and the dir "gallery-tempelate" as I intend to let a variety of users use their own galleries.

After running this you'll be alerted that you need to create the databases (I preffer to call it databanks, as they called it in the 70-80ies ;))

As stated in the configuration part, we'll be using postgreSQL and assuming you have it all setup.

First, we need a gallery2 database

  createdb -U your_user -W -E UNICODE gallery2

Now surf to

   http://localhost/gallery-tempelate/install

• set your language

• on the next page gallery will display a string which you need to place into the file login.txt

  echo <your_string> > /var/www/localhost/htdocs/gallery-tempelate/login.txt

• systemsettings, I needed to increase the memlimit of php and chown and chmod /var/www/localhost/htdocs/gallery-tempelate/modules/ffmpeg/classes/FfmpegToolkit.clas

  chown jav:apache /var/www/localhost/htdocs/gallery-tempelate/modules/ffmpeg/classes/FfmpegToolkit.class
  chmod 660 /var/www/localhost/htdocs/gallery-tempelate/modules/ffmpeg/classes/FfmpegToolkit.class

• Choose installation type, as specified earlier we want a multi user enviroment, so we choose Multisite installation and specify the real installation path

Make sure you make the directory writable for your webserver, or that you touch the specified files and make them writable to the webserver.

• select a path where all photos are saved, the default value is most likley fine. If it is not, it is very likely that you have done something wrong earlier. I will rely on regulating http access to the directory with .htaccess (and I will let the director reside within htdocs)

• choose database server, I use postgreSQL8, however it works fine with postgreSQL7
  • dbhostname: localhost
  • dbusername: your_postgre_user
  • dbpassword: your_postgree_password
  • dbname: note that you shuld _not_ use the same db as for the codebase, but create a new one

  createdb -U your_user -W -E UNICODE gallery2_prefix

• • tableprefix: choose the default
  • columnprefix: choose the default

• setup the admin account

• make sure your http-server can write to config.php

• continue with no modules (I'm getting impatient)

• check your installation dir rights, I'm fine with mine (you'll have to think by yourself here)

See also

• Gallery website