setup phraseanet

Phraseanet is a Digital Asset Management application that runs on LAMP. It's been open-sourced recently (by Alchemy.fr) and looks really impressive, but the available documentation is scarse and the installation procedure isn't exactly trivial. Here's a write-up of how you could install Phraseanet DAM on Debian 6 squeeze.

install required stuff

install a LAMP server (Linux, Apache, MySQL, PHP). Phraseanet recommends MariaDB as replacement for MySQL

install extra php modules

 
apt-get install php5-mysql php-pear php5-xcache php5-curl php5-gd php5-xsl \ 
php5-mcrypt php5-json php-mail php5-imagick php-gettext php5-mhash         \
php-xml-parser php-net-socket php-mail-mime

install extra apache modules

 apt-get install memcached libmemcached5 php5-memcached

install 3rd party helper apps that will provide additional functionality (image, doc and sound processing) :
```
 apt-get install imagemagick ufraw ffmpeg xpdf exif  ghostscript gs-gpl unoconv mplayer
```
consider : install swftools (flash support) - no debian ubuntu packages available - TODO

enable apache mod rewrite :
```
a2enmod rewrite 
```

build phraseanet specific php extensions

I couldn't find those in the tarbal I downloaded so I compiled them from source, following the method descibed on the Phrasenet documentation website http://docs.phraseanet.com/en/Admin/Prerequisite.html

extra required packages voor build :

 
      apt-get install build-essential linux-headers-$(uname -r)
      apt-get install php5-dev libmysql++-dev libxml2-dev libexpat1-dev

create dir for software build
```
mkdir  /opt/src
cd /opt/src    
```

note that the phraseanet docu says 'https://' in the github URL. That doesn't work, use 'git' protocol

phraseanet2 php extension

re: http://docs.phraseanet.com/en/Admin/Prerequisite.html

cd /opt/src
git clone git://github.com/alchemy-fr/Phraseanet-Extension php-phrasea
cd php-phrasea
./configure
make
make test
make install

output van make :

 Libraries have been installed in:   /opt/src/php-phrasea/modules

output van make install :
```
 Installing shared extensions: /usr/lib/php5/20090626+lfs/
```
→ needs reference in php.ini, zie further

phraseanet-indexer

re: http://docs.phraseanet.com/en/Admin/Prerequisite.html

cd /opt/src
git clone git://github.com/alchemy-fr/Phraseanet-Indexer phraseanet_indexer
cd phraseanet_indexer
aclocal
automake -a
autoconf
./configure
make
make install

installs to /usr/local/bin/phraseanet_indexer

setup phraseanet

required to unpack a .zip archive with multiple members :
```
 apt-get install zip unzip
```
download phraseanet source : http://sourceforge.net/projects/phraseanet/files/

unzip :

 unzip alchemy-fr-Phraseanet-v3.5.9.zip -d /var/www/

⇒ all files go in /var/www/Phraseanet

give webserver ownership (it will need write permissions to edit config files, handle uploads, ... ):
```
chown -R www-data /var/www/Phraseanet 
```
create a website (apache vhost) - see further
update php.ini
- both :
  - /etc/php5/apache2/php.ini
  - /etc/php5/cli/php.ini
- re. phraseanet php extension, zie hoger
```
extension=/usr/lib/php5/20090626+lfs/phrasea2.so 
```
- file uploads via webui toelaten, file size groter dan default (2M)
```
 
   upload_max_filesize = 50M 
   max_file_uploads = 100
```
xcache.ini : /etc/php5/apache2/conf.d/xcache.ini - has a default of xcache.var_size = 0M which makes phraseanet crash
```
xcache.var_size  =           500M

; set to cpu count (cat /proc/cpuinfo |grep -c processor)
xcache.count =                 4

xcache.size  =                 64M
```
frankly, I have no idea what this does - just blindly edited the values to make the problems go away
apache2 reload
check locales : phraseanet expects UTF-8.
For English, default to en_GB to get English language correctly in the web interface (en_US results in a mix of English and French)
```
 dpkg-reconfigure locales
| en_GB.UTF8  UTF-8   -> set default; 
| en_US.UTF8  UTF-8
| nl_BE.UTF-8 UTF-8
```

run config check :

 :/var/www/Phraseanet#  php bin/console system:configCheck

+ resolve errors, take note of warnings (fix now or later)

handle later : (warnings, non fatal)

	/!\	memcache not loaded
		memcached loaded
	/!\	redis not loaded

create a separate directory voor file storage
- must be owned by www-data (webserver account) !
```
 mkdir /srv/mediateek ; chown www-data /srv/mediateek ; 
```
- the web-based installer will need this path later on
you also need to create database -- see further
The rest of the setup and configuration will be handled by the web-based installer : http://testphraseanet.example.com → redirect to http://testphraseanet.example.com/setup/installer (file: /var/www/Phraseanet/www/setup/installer.php )

Apache setup

this looks a bit of a quick and dirty "dump everything in the webserver root" installation, which might impact the webserver's security

create Databases

The databases will be configured by the installer later on, but they need to exist, and you'll want a separate account (not your mysql root) to use them.

you need 2 databases 1 voor phraseanet, and 1 for “DataBox”. We let them be used by the same account.

Final setup and configuration by web-based installer

use a browser to go to the url where your phraseanet lives. On first use, you'll be redirected to the web-based installer. Here are some hints as to what goes where :

additional packages

I'm assuming most of those will be installed automatically as dependencies for the packages mentiond higher up, but I keep them listed here in case you (or I) need a hint for package names that might add functionality or fix an issue.

Phraseanet 3.5 on Debian 6 Howto

Digital Asset Management

Contents

install required stuff

build phraseanet specific php extensions

phraseanet2 php extension

phraseanet-indexer

setup phraseanet

Apache setup

create Databases

Final setup and configuration by web-based installer

additional packages