la release note au format pdf

AME V1.6 P2
Release Notes
5 Février 2014
1. Introduction
Ce document décrit les évolutions et correctifs principaux apportés par la version V1.6 P2 de l'AME
depuis la version V1.5
La 1.6
•
•
•
contient quelques fonctionnalités importantes comme:
La gestion des volumes.
Le suivi des travaux d'ingestion
La gestion de la mise à jour de la version précédente lors de l'installation
Cette version intègre aussi un ensemble d'améliorations et de simplifications du produit.
Ce document est cumulatif et contient les modifications apportées pour chacun des patchs. La
version de départ est la 1.6 P1. Le détail des modifications par patch est décrit dans un chapitre à
la fin de ce document.
2. Pré-requis d'installation et de mise à jour
La Version 1.6 de l'AME est développée pour fonctionner, avec la version V4.0.2 d'Active Circle et la
version 4.0.5 de l'API Active Circle (ACAPI).
L'AME est conçu pour fonctionner sur Linux CentOS 6.3 et 6.4
3. Installation
Il faut s'assurer que les pré-requis d'installation cités précédemment concernant la version
d'ActiveCircle et de l'API sont bien remplis. Dans le cas contraire, il est nécessaire d'effectuer la
mise à jour de ces 2 éléments comme préalable à installation de l'AME.
La méthode d'installation de la 1.6 se fait avec 2 distributions qu'il faut télécharger sur le site ftp
d'ActiveCircle
•
La distribution qui permet d'installer les packages Linux nécéessaires : ame_install_package.bz2.run
•
La distribution de l'AME 1.6 sur le site ftp d'ActiveCircle qui a la forme suivante :ame_install_V1.6.p#.YYYY-MM-DD_HH-MM-SS. ggggggg.bz2run
Il faut ensuite exécuter chacune des distribution en étant « root » sur la machine, en commençant
par l'installation des packages ./ame_install_package.bz2.run puis
./ame_install_V1.6.p#.YYYY-MM-DD_HH-MM-SS. ggggggg.bz2run. A noter que pour éxécuter
ce script d'installation en répondant oui a toutes les questions, il faut passer l'option -- -y
Après l'installation, il faut modifier le fichier /etc/rc.local pour activer le démarrage automatique de
l'AME lors du démarrage de la machine. Il faut aussi modifier les paramètres /etc/cron.d/ame-ingest
ET /etc/cron.d/ame-sync pour définir les fréquences d'ingestion ET les fréquences de mise à jour de
méta données active circle. Puis démarrer le service (service ame start) et se connecter à l'interface de l'AME avec un browser WEB.
4. Mise à jour
L'installateur de la 1.6 gère la mise à jour de l'AME à partir d'une version 1.5 ou à partir d'une
version 1.6PX, dont le numéro de patch est inférieur à celui de la version que vous installez.
Mise à jour 1.5 vers 1.6
Il faut s'assurer que les pré-requis d'installation cités précédemment concernant la version
d'ActiveCircle et de l'API sont bien remplis. Dans le cas contraire, il est nécessaire d'effectuer la
mise à jour de ces 2 éléments comme préalable à toute mise à jour de l'AME.
Active Circle
2/8
AME 1.6 P2
Pour mettre à jour une Version 1.5 avec une Version 1.6, il faut récupérer la dernière distribution de
l'AME 1.6 sur le site ftp Active Circle, la distribution est un exécutable qui a cette forme : ame_install_V1.6.p#.YYYY-MM-DD_HH-MM-SS.ggggggg.bz2run.
Il faut ensuite exécuter, sans arrêter l'AME, cette distribution en lui passant l'option -- -u. Si vous
omettez l'option, le script d'installation détectera que c'est une mise à jour et demandera confirmation que vous voulez effectuer l'upgrade. Exemple : ame_install_V1.6.p#.2014-01-17_HH-MMSS.ggggggg.bz2run -- -u
ATTENTION : L'upgrade met à jour l'installation de la machine pour ajouter un package manquant
(php-mbstring) et nécessite donc un accès à internet pendant l'installation. Si cet accès n'est pas
possible, l'upgrade ne fera la mise à jour que de l'AME. Charge à l'administrateur de la machine de
récupérer le package manquant et de l'installer faute de quoi l'AME ne pourra pas fonctionner correctement.
Après l'upgrade, il faut modifier le fichier /etc/rc.local pour modifier le démarrage automatique de
l'AME lors du démarrage de la machine. Il faut aussi modifier les fichiers /etc/cron.d/ame-ingest
ET /etc/cron.d/ame-sync pour définir, redéfinir les fréquences d'ingestion ET les fréquences de mise
à jour de méta données active circle.
Mise à jour 1.6 vers 1.6
Pour mettre à jour une version 1.6 pX avec une version de numéro de patch supérieur 1.6 pY, il faut
récupérer la distribution ame_install_V1.6.pY.YYYY-MM-DD_HH-MM-SS.ggggggg.bz2run sur
le site ftp Active Circle et exécuter cette distribution en lui passant l'option -- -u. Si vous omettez
l'option, le script d'installation détectera que c'est une mise à jour et demandera confirmation que
vous voulez bien effectuer la mise à jour
5. Nouvelles Fonctionnalités
Les nouvelles fonctionnalités principales apportées par la version V1.6 P1 sont les suivantes :
Gestion des Volumes
L'AME 1.6 permet de définir, via l'interface graphique, les partages, montages et répertoires qui
vont être pris en compte lors de la recherche les médias à ingérer.
Cette gestion des volumes permet de définir des volumes ayant une seule localisation pouvant être
de 3 types : Partage Active Circle, Montage d'un Système de fichier distant ou répertoire local.
La gestion des volumes permet aussi de définir des volumes avec 2 localisations. Une localisation
primaire NON Active Circle et une localisation d'archivage de type Active Circle.
Les méta-données Active Circle ne seront disponibles que pour les médias qui sont localisés sur un
Volume ayant une localisation de type Active Circle. Cela concerne les Volume ayant une seule localisation de type Active Circle et les volumes ayant 2 localisations dont la deuxième est nécessairement de type Active Circle.
Suivi des jobs d'ingestion
Il est possible d'avoir accès, dans l'interface graphique de l'AME, au suivi des travaux d'ingestion de
médias. Cela permet de voir, à quel moment les ingestions ont eu lieu et si elles ont ingéré des
nouveaux médias.
Fichiers Associés
Il est maintenant possible de configurer graphiquement les fichiers qui seront associés automatiquement à un média lors de l'ingestion.
Re génération de miniatures
L'AME 1.6 apporte deux améliorations concernant la génération des miniatures de médias:
•
Permettre à l'utilisateur de demander le re-calcul de miniatures via l'interface graphique.
•
Ré-essayer automatiquement de re-générer une miniature lors de l'ingestion un certain
nombre de fois
Nouvelle Organisation de la page d'administration
La page Administration a été réorganisée de manière plus cohérente
Active Circle
3/8
AME 1.6 P2
Elle contient maintenant les liens suivants :
•
Gestion des Médias
Accès à la Page de gestion des médias qui regroupe une liste de liens
•
Accès à la configuration de l'ingestion
•
Recherches spécifiques de médias
•
Gestion de certains paramètres de champs
•
Gestion des Médias supprimés
Accès à la Page de gestion des médias supprimés par l'utilisateur ou par des scripts ou processus
•
Gestion des demandes
Accès à la page de gestion des demandes de médias.
•
Gestion des utilisateurs
Accès à la page de gestion des utilisateurs qui permet de lister, créer, éditer, supprimer et
rechercher des médias.
•
Gestion des groupes d'utilisateurs
Accès à une page de gestion des groupes d'utilisateurs qui permet de lister et chercher les
groupes d'utilisateurs et les droits associés
•
Gestion des volumes de stockage
Accès à la page de gestion des volumes de stockage. Permet de lister, créer, éditer, supprimer des volumes.
•
Gestion des domaines
•
Accès aux tâches de l'AME AME (jobs)
Accès à la page qui liste les jobs de l'AME à savoir les travaux d'ingestion et de purge des
médias.
•
Voir les travaux Active Circle
Accès à la page qui liste les travaux de transfert et mise en cache déclenchés par l'AME via
l'API Active Circle.
•
Voir les statistiques
•
Voir les rapports
•
Export des données
•
Vérification de l'installation
•
Gestion des modules d'extension (plugins)
•
Configuration de la base de données
Gestion de droits par médias
La 1.6 donne la possibilité de donner, pour un média particulier, des droits de lecture et téléchargement à un groupe d'utilisateurs particulier et ce, indépendamment de la gestion des domaines.
Cela permet de partager un média avec un groupe d'utilisateurs, même si les utilisateurs de ce
groupe n'ont pas accès aux médias du domaine du média.
Suppression de média
Possibilité de choisir la suppression définitive d'un média de la base de données de l'AME lors de la
suppression d'un média.
Timecode de départ
Un nouveau champ a été ajouté aux médias de type vidéo, c'est le temps de démarrage de la vidéo. (Start Timecode). Ce champ est défini en secondes, et permet de démarrer la lecture de la miniature d'une vidéo au temps précisé. Sa valeur par défaut est modifiable (voir chapitre suivant )
Active Circle
4/8
AME 1.6 P2
Donner des valeurs par défaut à certains champs
Il est possible de modifier les valeurs par défaut de certains champs de type texte via l'interface
graphique.
Cette fonctionnalité est accessible dans la page d'administration via la page de gestion des médias
en cliquant sur le lien «Gérer les options et les valeurs pas défaut des champs".
Possibilité d'ajouter une image en filigrane dans les miniatures vidéos
Cela se définit dans la page de configuration du plugin ffmpeg ou on définit une image qui sera intégrée dans la miniature de vidéo calculée en filigrane (watermark)
Exports en pdf et csv
On peut exporter le résultat d'une recherche ou le contenu d'une sélection dans un format CSV ou
format PDF. Le format PDF est une extension de la « planche contact » qui existait déjà en 1.5. Il
remplace d'ailleurs l'outil « planche contact » d'une sélection.
Les exports sont accessibles en haut de la page de résultat d'une recherche, ou dans la liste des
outils d'une sélection. Une page de configuration permet de choisir les champs de méta données
que l'on veut voir exportés avant de générer le fichier d'export
Plugin d'import de méta-données lors de l'ingestion
Un nouveau plugin Active Circle d'import de méta données (ac_import_metadata) existe dans la
version 1.6. Il permet de définir pour chaque médias ingéré ( et éventuellement chaque média recalculé ), un script à exécuter qui reçoit en paramètre le path absolu du média ingéré et qui retourne un fichier Xml contenant des méta données associées au média en cours de traitement.
Ce script doit retourner un fichier Xml dont le format est décrit dans la documentation et le
readme.txt du plugin ?
La syntaxe du fichier Xml permet de définir la valeur à donner pour chaque méta donnée AME en la
désignant soit par son nom, soit par son identifiant dans la base.
Pouvoir ignorer les médias Hors Ligne ou proches pour l'ingestion
Il est possible d'ignorer les médias qui sont Hors Ligne (Offline) et/ou proches (Nearline) lors de l'ingestion. Cette fonctionnalité est configurable dans la page de configuration du plugin ac_acapi.
Critère de recherche des médias sans miniature
Il existe un nouveau critère de recherche sous la forme du mot clé «!noimage » qui permet de chercher les médias qui n'ont pas de miniature.
Ce mot clé s'utilise seul dans le champ général de recherche simple ou dans le champs « Tous les
champs » de la recherche avancée.
Nouvelle version du lecteur vidéo
L'AME 1.6 intègre la dernière version 6.7 de jwplayer (sortie en Novembre 2013)
Page de configuration du plugin ac
La page de configuration du plugin ac a été réorganisée sous forme d'onglets. La liste des onglets
est la suivante :
•
Fonctionnalités de l'interface
•
Champs de méta données
•
Comportement de l'ingestion
•
Médias à ingérer
•
Suppression définitive
•
Demande de médias
•
Dépôt de médias
Active Circle
5/8
AME 1.6 P2
Gestion de la demande de média OffLine
Lorsqu'un média est « offline », l'AME offre la possibilité à l'utilisateur d'émettre une requête auprès
de l'administrateur. En fonction de la configuration, cette requête sera soit envoyée par email, soit
enregistrée dans la liste des demandes de requêtes de l'administrateur.
Le moyen d'émettre une requête se fait en cliquant sur le bouton qui sert habituellement au
« Download ».
L'activation de cette fonctionnalité s'effectue via la page de configuration du plugin ac et l'onglet
« Demande de médias »
Configuration de l'envoi d'email
il est possible de configurer la gestion des email via la page de configuration du plugin ac et l'onglet
« Demande de médias ». Vous pouvez y configurer
•
L'adresse email du destinataire des requêtes
•
L'adresse email de l'envoyeur
•
Possibilité de configurer les paramètres d'un serveur smtp pour envoyer les mails si le service de mail ne fonctionne pas sur le serveur AME.
Configuration graphique des médias à ingérer
Il est possible de définir dans l'interface graphique, via la page de configuration du plugin ac ou via
la page de gestion des médias
•
les types de médias à ingérer avec leur extension
•
pour chaque type, de quel type de AME il s'agit
•
pour chaque type, si on calcule ou non un proxy
•
pour chaque type, les types mime (pour le téléchargement par exemple)
•
Le comportement par défaut si un fichier trouvé ne correspond a aucun type
Dans cette page, on peut aussi voir la liste des codecs et formats supportés par les outils utilisés
pour générer les miniatures que sont : ffmpeg pour la vidéo ou le son, imagemagick pour les
images.
Configuration graphique de la visibilité des champs de données
Il est possible de définir dans l'interface graphique, via la page de configuration du plugin ac, onglet
« Champs de Méta Données » quels champs seront visualisés dans l'interface. Cette page permet
de choisir :
•
•
•
Les champs affichés dans la vue « liste »
Les champs affichés dans la vue « vignette »
Les champs affichés dans l'info bulle (ToolTip)
Recherche avancée sur intervalle de dates
Il est possible de d'activer la recherche de date sur un intervalle de dates dans la recherche avancée. Cela remplace la recherche sur une simple date. Pour le configurer, il faut le faire dans la page
de configuration du plugin ac.
Ajout du jour dans la Recherche simple
Il est possible de d'activer l'ajout du jour pour chercher une date dans la recherche simple. Pour le
configurer, il faut le faire dans la page de configuration du plugin ac.
Possibilité de choisir le titre des médias ingérés
Il est possible de choisir si on veut que les médias ingérés se voient attribué le titre original du média (extrait pas exiftool), si il existe ou bien le titre généré automatiquement à base du nom de fichier et éventuellement du path.
Active Circle
6/8
AME 1.6 P2
Mise à jour des Méta Données Active Circle via l'interface
Pour mettre à jour immédiatement les méta données Active Circle d'un média sans attendre la mise
à jour automatique programmée (Effectuée par le script update_metadata_ac.php), il est possible
de le faire directement dans l'interface de l'AME via un lien «Rafraîchir» dans le bas de l'onglet Active Circle de la fiche du média.
Ingestion rapide au fil de l'eau pour les Volumes Active Circle
En supplément de l'ingestion classique qui parcoure la totalité des volume (Effectuée par le script
“ingest.php”), l'AME fourni un mode d'ingestion incrémental pour ingérer les média le plus rapidement possible après leur dépôt dans un volume Active Circle.(Effectuée par le script
“ingest_by_api.php”)
Installation d'une Version 1.6
La méthode d'installation de la 1.6 est identique à celle de la 1.5. Il faut télécharger 2 distributions:
La distribution pour installer les packages Linux nécessaires au bon fonctionnement de l'AME
(ame_install_package.bz2.run ) et la distribution de l'AME 1.6 (ame_install_V1.6.p1.2014-0117_HH-MM-SS. ggggggg.bz2run). Il faut ensuite les exécuter successivement en étant root.
Mise à jour de Version antérieure lors de l'installation
L'installeur de la version 1.6 gère l'upgrade à partir d'une version AME 1.5 et à partir d'une version
de patch inférieure de la 1.6
Ame devient un service unix pour faciliter l'Arrêt et redémarrage de l'AME
L'AME est maintenant un service pour permettre de l'arrêter et le démarrer de manière plus simple.
La gestion de ce service se fait avec la commande service. Les paramètres que l'on peut passer
sont : start/stop/restart/reload/status.
Le démarrage de l'AME lors du démarrage de la machine se configure dans /etc/rc.local
Intégration Resource Space 4.4
Cette version contient les fonctionnalités ajoutées dans la version 4.4 de Resource Space.
Nouveaux Scripts utilitaires
•
Le script update_file_path.php permet le déplacement de médias
•
Le script set_domain.php (permet de donner un nom de domaine a un ou plusieurs médias.
•
Le script user.php (dans plugins/ac/tools), permet de créer ou modifier un utilisateur.
•
Le script create_previews.php permet de forcer la re-génération des miniatures (preview)
de certains médias.
•
Le script clean_metadata_ac.php permet supprimer et remettre a zéro les méta données
Active Circle de tous les médias
•
Le script volume.php permet de gérer le démarrage et l'arrêt des volumes
•
Le script server.php permet permet de lister, créer et supprimer des serveurs associés à
des volumes dans la base de données de l'AME
•
Le script test_mail.php permet de tester si la configuration de l'AME pour envoyer des mails
est correcte.
•
Le script clean_metadata_ac.php permet de supprimer toutes les métas données Active
Circle associées à des média qui ne seraient pas dans les volumes Active Circle.
•
Le script de détection et suppression des doublons (media_delete_double.php) devient interactif pour permettre de choisir quel doublon on supprime dans le cas ou il y aurait des
données différentes dans chacun des doublons
Active Circle
7/8
AME 1.6 P2
•
Le script get_unavailable_media_list.php affiche la liste des médias qui n'ont pas à priori de
miniature associées avec le nombre d'essai pour chaque média.
Changement de noms de scripts
Certains scripts ont été renommés
•
•
•
•
•
update_metadata_ac.php remplace synchronize_with_ac.php
ingest.php remplace activesync_index.php
media_delete_without_origina.php remplace activesync_delete.php
media_purge_deleted.php remplace purge_deleted_resources.php
media_delete_double.php remplace delete_double.php
6. Corrections de problèmes
La version 1.6 intègre un certain nombre de corrections de problèmes. On indique ici les corrections
des bugs les plus gênants pour un utilisateur.
•
La recherche sur le champ «archivé» fonctionne correctement
•
Modification des paramètres du ffmpeg pour générer les miniatures afin que les mp4 générés soient lisibles sur un plus grand nombre de versions de QuickTime
•
Ajout de la fonctionnalité de recherche d'un domaine dans la page de liste de gestion des
domaine
•
Ajout de la fonctionnalité de recherche d'un groupe dans la page de gestion des groupes
•
Lors du dépôt (upload) d'un fichier, si l'utilisateur n'a pas spécifié de titre pour le média, il
aura un titre automatiquement correspondant a celui qu'on lui aurait donné lors de l'ingestion. A savoir le nom du fichier OU le nom du fichier incluant sont path.
7. Apports du patch 2 (AME 1.6 P2)
La version 1.6 P2 apporte les modifications suivantes :
Récupération du MD5 de chaque média calculé dans Active Circle
Ajout d'un nouveau champ de méta données Active Circle qui contient le MD5 si celui-ci.
Ce champ s'appelle « acchecksum » , son identifiant est 113 et il est renseigné par l'update_metadata_ac.php à condition que le MD5 ait été calculé coté Active Circle.
Choix de l'ordre des onglets
Le choix de l'ordre dans lequel apparaissent les onglets dans la fiche du média est modifiable et
configurable dans la page de configuration du plugin ac, onglet « Champs de Méta-données ». Il
suffit de déplacer les intitulés des onglets avec la souris. Seul l'onglet « Description » n'est pas déplaçable.
Petites Modifications
•
•
•
Création d'un log de type « download » pour chaque média transféré via FTP. Il sera ainsi
comptabilisé dans le rapport sur les média téléchargés.
Utilisation de l'auto complétion de noms lors de la création d'une règle de type «path absolu» de domaine
Nouveau rapport qui comptabilise les médias modifiés
Correction de problèmes
•
•
Correction du problème de mise à jour du domaine lors de l'upload
Correction de plusieurs problèmes lors de l'upgrade de version (Sauvegarde des fichiers de
configuration, upgrade des volumes et serveurs de volumes)
Active Circle
8/8
AME 1.6 P2