AME V1.6 P2 Release Notes. 5 Février 2014

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-mm- SS.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-01- 17_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