OPENDAM (v1.0.0)

What

OpenDAM is an Open-source digital asset management platform to centralize, organize , manage and share picture and video files.

For more information, please visit Wikipixel

Forum: Forum

Translate OpenDAM to your language: Start now

System requirements

The OpenDam application requires :

• A Web Server with an OS(Debian, Ubuntu, etc.),
• PHP 5.3 minimum,
• A Connection to a MySql Database,
• The Application NODE.JS,
• The Application FFMPEG,
• The Application IMAGEMAGICK.

Installation

When you have finished downloading the application , unzip it in the directory "web" of your server (/var/www/ou /home/www/ in most cases). You should have a path such as /var/www/opendam/.

Configuration

Directory Permissions

First, look for the cache/ and log/ directories in the application root, alongside web/, src/, etc. If they do not exist (e.g. if you are cloning the git repository) you must create them. Either way, you must then set their permissions:

mkdir -p cache log
chmod 777 cache/ log/

You should also authorize permission to the file to upload media :

chmod 767 -R web/data/

Web server

Replace /path/to/application/ the path to the application folder.

Listen 80
NameVirtualHost 127.0.0.1:80

<VirtualHost 127.0.0.1:80>
    DocumentRoot "/path/to/application/web"
    DirectoryIndex index.php

    <Directory "/path/to/application/web">
        Options -Indexes FollowSymLinks MultiViews
        AllowOverride All
        Allow from All
    </Directory>

    Alias /sf /path/to/application/lib/vendor/symfony/data/web/sf
    <Directory "/path/to/application/lib/vendor/symfony/data/web/sf">
        AllowOverride All
        Allow from all
    </Directory>
</VirtualHost>

Make sure that mod_rewrite is installed and enabled.

Restart Apache, so the modifications can be reloaded.

From the server, open a browser and type in the address bar http://localhost/ . You arrive at the login screen of the application. Do not try to log in yet.

PHP

Some guidelines PHP must be enabled / disabled. Must edit the files /etc/php5/cli/php.ini and /etc/php5/apache2/php.ini If these directives are prefixed by the character ; it must be removed.

mbstring.language = UTF-8  
mbstring.internal_encoding  = UTF-8
mbstring.http_input = auto
mbstring.http_output = UTF-8

mbstring.encoding_translation = On ; (If you are using a version of PHP < 5.4)
mbstring.detect_order = auto
mbstring.substitute_character = none

expose_php = Off
display_errors = Off
log_errors = On
short_open_tag = Off
magic_quotes_gpc = Off
register_globals = Off
session.auto_start = 0

Restart Apache for the changes to be loaded.

Node.js

You must then install the less for the node.js module

npm install -g less

FFMPEG

To ensure the proper functioning video conversion tool , the following libraries must be installed and configured for FFMPEG :

• LAME,
• x264,
• libvpx.

To check your version of ffmpeg has been configured , enter :

ffmpeg

Among the lines of the command output , you should see :

configuration: --enable-libmp3lame --enable-libx264 --enable-libvpx

This means that FFMPEG does support the essential OpenDam modules.

MySql

To create the database , run the file located in config/data/database.sql, e.g. mysql -u root -p < config/data/database.sql. This will create a new database "opendam" and install the schema and initial content.

You will then need to create the database user and set its permissions yourself.

Then edit the config/databses.yml file and change the SQL as well as the login and password (myHost, myDatabase, myUsername and myPassword).

all:
  propel:
    class: sfPropelDatabase
    param:
      classname: PropelPDO
      dsn: 'mysql:host=myHost;dbname=myDatabase'
      username: myUsername
      password: myPassword
      encoding: utf8
      persistent: true
      pooling: true

Once you are done, you need to clear the cache of the application by the command:

php symfony cc

Use

The application contains a default set of tests to show you a taste of OpenDam solution.

A default admin user has been created for you. Enter the email [email protected] and password opendam to log in.

From there, you should create your own (real) admin user and delete the default user or change its password.

Français

What

OpenDAM est une plateforme cloud Open-source de gestion et partage de fichiers images et vidéos.

Pour plus d'informations, visitez Wikipixel

Pré-requis

Système

L'application OpenDam nécessite :

• un serveur web sous Linux (Debian, Ubuntu, etc.),
• PHP 5.3 minimum,
• une connexion à une base de données MySql,
• l'application NODE.JS,
• l'application FFMPEG,
• l'application IMAGEMAGICK.

Installation

Lorsque vous avez terminé de télécharger l'application, décompressez-la dans le répertoire "web" de votre serveur (/var/www/ou /home/www/ dans la plupart des cas). Vous devriez alors avoir un chemin du type /var/www/opendam/.

Configuration

Droits sur les répertoires

Vous devez avant toute chose, modifier les droits d'accès aux répertoires cache/et log/ pour que l'application puisse écrire dedans :

chmod 777 cache/ log/

Il faut aussi autoriser l'écriture dans le dossier d'upload des médias :

chmod 767 -R web/data/

Serveur web

Remplacez /path/to/application/ par le chemin absolu vers le dossier de l'application.

Listen 80
NameVirtualHost 127.0.0.1:80

<VirtualHost 127.0.0.1:80>
	DocumentRoot "/path/to/application/web"
    DirectoryIndex index.php

	<Directory "/path/to/application/web">
		Options -Indexes FollowSymLinks MultiViews
		AllowOverride All
		Allow from All
	</Directory>

	Alias /sf /path/to/application/lib/vendor/symfony/data/web/sf
	<Directory "/path/to/application/lib/vendor/symfony/data/web/sf">
		AllowOverride All
		Allow from all
	</Directory>
</VirtualHost>

Redémarrez Apache, pour que les modifications soient chargées.

Depuis le serveur, lancez un navigateur et tapez dans la barre d'adresse http://localhost/. Vous arrivez sur l'écran de connexion de l'application.

PHP

Certaines directives de PHP doivent être activées / désactivées. Il faut modifier les fichiers /etc/php5/cli/php.iniet /etc/php5/apache2/php.ini. Si ces directives sont préfixées par le caractère de mise en commentaire ;, il faut le supprimer.

mbstring.language = UTF-8  
mbstring.internal_encoding  = UTF-8
mbstring.http_input = auto
mbstring.http_output = UTF-8

mbstring.encoding_translation = On (Si la version de PHP < 5.4)
mbstring.detect_order = auto
mbstring.substitute_character = none

expose_php = Off
display_errors = Off
log_errors = On
short_open_tag = Off
magic_quotes_gpc = Off
register_globals = Off
session.auto_start = 0

Redémarrez Apache, pour que les modifications soient chargées.

Node.js

Il faut installer ensuite le module lesspour node.js :

npm install -g less

FFMPEG

Pour assurer le bon fonctionnement des conversions vidéos de l'outil, les librairies suivantes doivent être installées et configurées pour FFMPEG :

• LAME,
• x264,
• libvpx.

Pour vérifier que votre version de ffmpeg a bien été configurée, saisissez :

ffmpeg

Parmi les lignes de résultats de la commande, vous devriez voir :

configuration: --enable-libmp3lame --enable-libx264 --enable-libvpx

Cela signifie que FFMPEG prend bien en charge les modules indispensables à OpenDam.

MySql

Pour créer la base de données, exécutez le fichier qui se trouve dans config/data/database.sql.

Éditez ensuite le fichier config/databses.yml et modifiez le serveur SQL ainsi que le login et mot de passe (myHost, myDatabase, myUsername et ```myPassword``).

all:
  propel:
    class: sfPropelDatabase
    param:
      classname: PropelPDO
      dsn: 'mysql:host=myHost;dbname=myDatabase'
      username: myUsername
      password: myPassword
      encoding: utf8
      persistent: true
      pooling: true

Une fois les modifications effectuées, il vous faut vider le cache de l'application par la commande :

php symfony cc

Utilisation

L'application contient, par défaut, un jeu de test pour vous montrer un avant-goût de la solution OpenDam. Pour vous connecter, il vous suffit de saisir un email ([email protected]) et un mot de passe (opendam).