Project-Id-Version: Trac 0.12
Report-Msgid-Bugs-To: trac-dev@googlegroups.com
POT-Creation-Date: 2008-01-30 09:20+0100
PO-Revision-Date: 2010-07-19 23:05+0200
Last-Translator: Jeroen Ruigrok van der Werven <asmodai@in-nomine.org>
Language-Team: en_US <trac-dev@googlegroups.com>
Plural-Forms: nplurals=2; plural=(n != 1)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Generated-By: Babel 0.9.6

Warning: Can't synchronize with repository "(default)" (Unsupported version control system "git": Can't find an appropriate component, maybe the corresponding plugin was not enabled? ). Look in the Trac log for more information.
Last modified 5 years ago Last modified on 07/13/12 22:20:43

This page describes the initial setup procedure of phTagr to initialize and configure phTagr. It assumes that you successfully installed all the required software (see HowToInstall or HowToInstallInUserDir).

You init phTagr either through the system wide environment http://localhost/phtagr/setup or through your home directory http://YOUR_SERVER_URL/~YOUR_NAME/phtagr/setup.

Assumtions
All modifications assumes that you are in the directory of phtagr (e.g. /var/www/phtagr or ~/public_html/phtagr).

Watch the setup procedure at youtube

Embed(youtube=wm3LuxoB8Xw)?

If you receive only warning text with something like Warning: _cake_core_ cache was unable to write 'cake_dev_en-us' to File cache in /mnt/raid/var/www/tests/phtagr/cakephp/lib/Cake/Cache/Cache.php on line 306 (See screenshot you need to set the file permission of your ./tmp directory properly.

Security Salt

phTagr has a security salt which is used for password and session encryption. Therefore this must be changed first (otherwise the setup session would not working properly). If the file ./Config/core.php is writeable phTagr changes the security salt by its own. Otherwise you get an hint to change it manually

http://demo.phtagr.org/media/thumb/334

Setup

If your web server, cake and phTagr are working properly (and the security salt is changed), you get an welcome screen

http://demo.phtagr.org/media/thumb/328

Continue on clicking on Start installation.

Paths

phTagr checks if the required paths are writeable. Usually it should be already done in the install procedure but maybe something went wrong. So you get following screen to change the paths

Information: The user path is uses to store all uploaded data and preview cache files of the users. The tmp directory is used for system cache files and for debug and log files.

http://demo.phtagr.org/media/thumb/335

Database Connection

Now phTagr request the correct database connection. If phTagr can write into the path ./Config you will get following screen to complete all the settings for you database connection

http://demo.phtagr.org/media/thumb/329

If the directory ./Config is not writable you get an sample file for the database which should be writen to ./Config/database.php. Please edit the page by your own.

http://demo.phtagr.org/media/thumb/336

An example configuration ./Config/database.php file looks like:

<?php

class DATABASE_CONFIG {

  /**
   * Default database connection configuration
   */
  var $default = array(
                  'datasource' => 'Database/Mysql',
                  'persistent' => true,
                  'host' => 'localhost',
                  'database' => 'phtagr',
                  'login' => 'phtagr',
                  'password' => 'phtagr',
                  'prefix' => 'pt_',
                  'encoding' => 'utf8'
                 );

  /**
   * Database connection configuration for test environment
   */
  var $test = array(
                  'datasource' => 'Database/Mysql',
                  'persistent' => true,
                  'host' =>; 'localhost',
                  'database' => 'phtagr',
                  'login' => 'phtagr',
                  'password' => 'phtagr',
                  'prefix' => 'pt_test_',
                  'encoding' =>'utf8'
                 );
}

After successful database connection phTagr initializes now all the required tables.

Admin User

phTagr requests now some data for the admin account.

http://demo.phtagr.org/media/thumb/330

Please fill out the form with our prefered name, password and email. This email will be used for password recovery or comment notification.

Note: The admin account gets an initial upload quota of 100 MB. This could be changed later in the system preferences.

External Programs

phTagr could use some external programs for some advanced features (e.g. create video thumnails, flash videos, or writing meta data back to the photos). These external helper programs are optional and could be set here. phTagr searches in /usr/bin, and /usr/local/bin for these files. You have to enter it manually if phTagr could not find it - or you can set them later in the system preferences.

Note: To create proper flash videos ffmpeg should be built with mp3 support! See CreateFlashVideo

http://demo.phtagr.org/media/thumb/331

Final

phTagr is now completely installed and ready to rock! Congratulations! Now continue with the FirstSteps...

http://demo.phtagr.org/media/thumb/332