Mise-à-jour S-Filer Portal 4.20.0

Ce document décrit les étapes nécessaires à la mise à niveau vers S-Filer Portal 4.20.0.

Modification au fichier wrapper.conf du serveur

Le fichier wrapper.conf du serveur a été mis à jour pour changer l'ordre de chargement des librairies.

Avant

wrapper.java.classpath.1=lib/*.jar
wrapper.java.classpath.2=etc
wrapper.java.classpath.3=conf
wrapper.java.classpath.4=ext/lib/*.jar

Après*

wrapper.java.classpath.1=ext/lib/*.jar
wrapper.java.classpath.2=lib/*.jar
wrapper.java.classpath.3=etc
wrapper.java.classpath.4=conf

Le fichier wrapper.conf de la passerelle n'a quant à lui pas été modifié.

Nouveau paramètre de configuration pour l'exécution des tâches planifiées

Un nouveau paramètre de configuration nommé « cfg.server.batch.start » a été ajouté au fichier sfiler.conf du serveur. L’objectif de ce paramètre de configuration est de déterminer si le serveur doit prendre en charge les tâches planifiées. L’introduction de ce nouveau paramètre est nécessaire pour empêcher l’exécution simultanée de tâches planifiées dans un environnement comprenant plusieurs serveurs. Si la valeur n’est pas définie, la valeur sera considérée comme « true » et ajouté automatiquement au fichier sfiler.conf après le démarrage du serveur. Cela signifie que les tâches planifiées seront exécutées. Dans le cas d’un déploiement multi-serveurs de la solution S-Filer Portal, il est essentiel d’avoir un seul serveur responsable de l’exécution des tâches planifiées.

Si vous utiliser la commande "export-server-config" pour générer le fichier de configuration sfiler.conf, vous devez considérer la nouvelle option "-bs" qui permet de spécifier la valeur que vous souhaitez pour le paramètre de configuration "cfg.server.batch.start".

Importation des modèles de notification dans la base de données

Imaginer une structure de répertoire similaire à celle-ci :

# ls -al etc/mail
total 0
drwxrwxr-x. 5 sfiler sfiler  64 Aug 16 13:52 .
drwxrwxr-x. 4 sfiler sfiler 119 Feb 22  2021 ..
drwxr-xr-x. 7 sfiler sfiler  82 Aug 16 13:52 mon-theme-1
drwxr-xr-x. 7 sfiler sfiler  82 Aug 16 13:52 mon-theme-2
drwxrwxr-x. 7 sfiler sfiler  82 Feb 22  2024 notification
#

Les notifications qui se trouvaient à l'origine sur le système de fichiers sont maintenant stockées dans la base de données. Le processus d'importation consiste à prendre les modèles de notification du système de fichiers et à les importer dans la base de données. Pour ce faire, vous devez suivre les étapes suivantes :

Étape 1 : Exécuter la commande suivante pour importer les modèles de notification du système de fichiers vers la base de données :

Cette commande est réversible. Les thèmes qui seront importés dans la base de données peuvent ensuite être supprimés à partir de l'interface web. Nous recommandons d'utiliser cette option à moins de vouloir couvrir un cas d'utilisation spécifique.

./sfiler-config-cli.sh -l my-user -p my-password -cf "conf/sfiler.conf" import-notification-themes -p "etc/mail" -all

Cette exécution, en utilisant la structure de données exposées ci-dessus, importera tous les thèmes de notification se trouvant dans le répertoire etc/mail dans la base de données et produira le résultat suivant à la console :

# ./sfiler-config-cli.sh -l my-user -p my-password -cf "conf/sfiler.conf" import-notification-themes -p "etc/mail" -all

The import notification themes command ran successfully. See the details below for the results.

The following themes have been imported.
notification
mon-theme-1
mon-theme-2
#

Une fois la commande exécutée, les thèmes de notification seront disponibles dans la base de données et pourront être utilisés à travers l'interface web.

Il est possible de modifier le contenu des notifications à même l'interface web et ainsi les personnaliser selon vos besoins. Les changements effectués dans l'interface web ne seront pas répercutés sur le système de fichiers car celui-ci n'est plus pertinent à partir de cette version.

Étape 2 : Exécuter la commande suivante pour ajuster la configuration des groupes :

Les groupes peuvent avoir un thème de notification associé qui a été identifié à l'origine par son nom de dossier sur le système de fichiers. Dans les versions précédentes, le thème de notification était exprimé sous la forme d'une chaine de caractère dans l'écran de détail des groupes :

Comme les thèmes de notification ne se trouvent plus sur le système de fichiers, nous voulons exécuter une commande qui sera en mesure de faire le lien entre son précédent nom sur le système de fichier et l'entrée en base de données. Pour réaliser cette opération, vous devez exécuter la commande suivante :

./sfiler-config-cli.sh -l my-user -p my-password -cf "conf/sfiler.conf" migrate-themes --dry-run

Notez que le paramètre --dry-run permet de simuler la migration des thèmes de notification sans les migrer réellement. Si une erreur est détectée, il est recommandé de noter les groupes problématiques et de procéder à la correction de leurs thèmes de notification respectif en utilisant l'interface web.

Au terme de cette étape, le migration des thèmes de notification sera complétée. Vous pouvez valider un des groupes pour lequel il existait préalablement un thème de notification et vous assurez ainsi que la migration s'est bien déroulée.

Revision des notifications importées

Le format de notification a été modifié pour permettre une plus grande flexibilité dans la création de modèles. La version précédente utilisait un mécanisme de substitution de texte statique propre à la solution S-Filer Portal. La nouvelle version utilise la bibliothèque [MVEL] (https://github.com/mvel/mvel) pour générer des modèles de notification. Cette bibliothèque est largement utilisée dans l'industrie et offre une grande flexibilité dans la création de modèles de notification.

Par exemple, la notification suivante :

<div class="salutations">
    <h1>Bonjour <b>:userfullname (:username)</b>,</h1>
</div>

<div id="container">
    <p class="subtitle">
        En tant qu'utilisateur autoris&eacute; du domaine <b>:domainname</b>, nous vous avisons que l'utilisateur <b>:sendername</b> a transmis &agrave; votre attention le fichier
        <b>:filename</b> qui est maintenant disponible dans votre bo&icirc;te de r&eacute;ception personnelle du portail S-Filer Portal.
    </p>

    <p>
        <span class="mainmessage">Pour acc&eacute;der &agrave; ce fichier, veuillez suivre le lien suivant: <B><a href=":url">:url</a></B></span>
    </p>

</div>

:messagetorecipients

Sera remplacée par :

<div class="salutations">
    <h1>Bonjour <b>@{userfullname} (@{username})</b>,</h1>
</div>

<div id="container">
    <p class="subtitle">
        En tant qu'utilisateur autoris&eacute; du domaine <b>@{domainname}</b>, nous vous avisons que l'utilisateur <b>@{sendername}</b> a transmis &agrave; votre attention le fichier
        <b>@{filename}</b> qui est maintenant disponible dans votre bo&icirc;te de r&eacute;ception personnelle du portail S-Filer Portal.
    </p>

    <p>
        <span class="mainmessage">Pour acc&eacute;der &agrave; ce fichier, veuillez suivre le lien suivant: <B><a href="@{url}">@{url}</a></B></span>
    </p>

</div>

@{messagetorecipients}

Cependant, il est essentiel de valider que le processus d'importation a fonctionné correctement et que les modèles initialement présents sur le système de fichiers ont été importés correctement. Pour ce faire, vous devez utiliser l'interface administrative et parcourir les différentes notifications dans les langues utilisées par votre instance de S-Filer Portal.