Installation et utilisation des paquets APT

Les paquets APT de S-Filer Portal sont des paquets Linux destinés à être installés sur des serveurs utilisant des systèmes d'exploitation basés sur Debian, tels que Debian ou Ubuntu. Ces paquets ne fonctionnent que sur ces systèmes d'exploitation.

Installation des paquets

Voici une liste de tous les paquets de S-Filer Portal :

Paquet
sfiler-server	Serveur
sfiler-gateway	Passerelle entre l'utilisateur et le serveur via une multitude de protocoles
sfiler-config-cli	Outil en ligne de commande utilisé pour configurer S-Filer au niveau de la base de données
sfiler-cli	Outil en ligne de commande pour les utilisateurs S-Filer Portal
sfiler-admin-cli	Outil en ligne de commande pour les administrateurs S-Filer Portal

Afin de construire une nouvelle instance de S-Filer Portal, vous aurez besoin au minimum de sfiler-server et sfiler-gateway.

Vous pouvez configurer un environnement S-Filer Portal sur une seule machine en y installant ces deux paquets. Il est aussi possible de faire l'installation du serveur (paquet sfiler-server) et l'installation de la passerelle (paquet sfiler-gateway) sur des machines différentes.

Note

L'exécutable de l'interface CLI de configuration est distribué avec le paquet sfiler-server. Il n'est donc pas nécessaire d'installer le paquet sfiler-config-cli sur la machine du serveur. Le script sfiler-config-cli.sh est disponible à la racine de l'installation du serveur (/opt/sfiler-server).

Ajouter la source Okiok

La source S-Filer Portal d'OKIOK est hébergée sur Google Cloud Platform Artifact Registry. Afin de permettre à votre machine de se connecter à Artifact Registry, vous devez installer le plugin APT apt-transport-artifact-registry.

Mettez d'abord à jour toutes vos sources et mettez à niveau les paquets obsolètes.

sudo apt update
sudo apt upgrade

Installation de apt-transport-artifact-registry

Importez la clé GPG source de Google APT et ajoutez sa source à APT.

curl -fsSL https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/cloud.google.gpg
echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list

sudo apt update

Installez apt-transport-artifact-registry.

sudo apt install apt-transport-artifact-registry

Connexion au registre d'artefacts de S-Filer

Pour vous connecter au registre, vous aurez besoin d'une clé d'accès à Google Cloud Platform qui devrait vous avoir été fournie.

Spécifiez le chemin vers votre clé dans la configuration apt-transport-artifact-registry située dans /etc/apt/apt.conf.d/90artifact-registry.

Acquire::gar {
    Service-Account-JSON "/etc/gcloud/key.json"
}

Ajoutez la source APT de S-Filer.

echo "deb [arch=all] ar+https://northamerica-northeast1-apt.pkg.dev/projects/sfiler-portal sfiler-portal main" | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list

Mettez à jour la source pour permettre à APT de commencer à installer des paquets.

sudo apt update

Installation des paquets

Il suffit alors d'installer les paquets nécessaires comme vous le feriez pour d'autres paquets.

sudo apt install sfiler-server sfiler-gateway

Configuration d'un environnement S-Filer Portal

Installation du serveur

Pilote JDBC de la base de données

Afin d'utiliser sfiler-server, vous devrez fournir un pilote JDBC sous la forme d'un fichier .jar. Les pilotes pour les systèmes de gestion de bases de données Microsoft SQL Server et MariaDB sont déjà inclus dans les distributions de S-Filer Portal.

Placez ce fichier dans le répertoire /lib/sfiler-server/ext.

Voici la liste de tous les systèmes de gestion de base de données compatibles et l'endroit où vous trouverez leurs pilotes JDBC respectifs :

Système de gestion de base de données	Lien pour télécharger le pilote JDBC
MySQL	https://dev.mysql.com/downloads/connector/j/
MariaDB	https://mariadb.com/kb/en/about-mariadb-connector-j/
Microsoft SQL Server	https://docs.microsoft.com/en-us/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver15
Oracle DB	https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html

Fichier de configuration

Le serveur S-Filer Portal ne fonctionnera pas directement lors de l'installation. Vous devez modifier le fichier /etc/sfiler-server/sfiler.conf pour adapter les paramètres de configuration à votre environnement.

cfg.sfiler.instance.name=serverdemo
cfg.server.configurator.start=true
cfg.server.webserver.configurator.jetty.server.ssl=false
cfg.server.webserver.configurator.jetty.server.ssl.sni.host.check=true
cfg.server.webserver.configurator.jetty.server.ssl.cipher.management.mode=AUTOMATIC
cfg.server.webserver.configurator.jetty.server.ssl.custom.ciphers=TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
cfg.server.webserver.configurator.jetty.server.port=8090
cfg.configurator.clickjacking.protection=true
cfg.configurator.hsts.header.support=true
cfg.configurator.hsts.header.support.max.age=3600
cfg.sfiler.keystore=
cfg.sfiler.keystore.password=
cfg.configurator.private.key=
cfg.server.local.config.user=sfiler-user
cfg.server.local.config.password=sfiler-pwd
cfg.server.local.config.url=jdbc:mariadb://127.0.0.1:3306/sfiler
cfg.server.local.config.driver=org.mariadb.jdbc.Driver
cfg.server.local.config.jdbc.fetch_size=0
cfg.server.local.config.database.auto.update.schema=false

Note

Vous pouvez maintenant indiquer au serveur si vous souhaitez qu'il mette automatiquement à jour le schéma de la base de données (sans utiliser le CLI de configuration) à chaque démarrage en utilisant la propriété cfg.server.local.config.database.auto.update.schema, qui par défaut est fixée à false.

Mise à jour du schéma de la base de données

Assurez-vous d'avoir une base de données compatible en marche et qui est accessible à partir de la machine du serveur S-Filer Portal.

sfiler-config-cli.sh test-connectivity

Le CLI devrait vous indiquer que la connexion a été effectuée avec succès.

Validate JDBC connection successful.

Vous devez configurer votre schéma de base de données pour qu'il soit à la bonne version de S-Filer Portal.

sfiler-config-cli.sh -l <USAGER_BD> -p <MOT_DE_PASSE_BD> update-db-schema

Ajout d'une instance de serveur

Ajoutez un serveur S-Filer en utilisant le CLI

 sfiler-config-cli.sh -l <USAGER_BD> -p <MOT_DE_PASSE_BD> add-server -l <LICENSE> -n serverdemo -h localhost -e alice@example.ca

Utilisation du service sfiler-server

L'installation du paquet sfiler-server va créer un service dans systemd appelé sfiler-server.

Au début, il ne sera pas activé ni démarré. Après avoir configuré le serveur, activez le service pour vous assurer qu'il continuera à fonctionner lorsque vous redémarrerez votre machine. Utilisez l'option --now pour démarrer le service immédiatement.

sudo systemctl enable sfiler-server --now

Installation de la passerelle

Ajoutez une passerelle et une interface web en utilisant la console d'administration de S-Filer (en accédant à http:/sfilerServerHostname:8090) ou en utilisant le CLI de configuration de S-Filer.

sfiler-config-cli.sh -l <USAGER_BD> -p <MOT_DE_PASSE_BD> add-gateway -n gatewaydemo

sfiler-config-cli.sh -l <USAGER_BD> -p <MOT_DE_PASSE_BD> add-gui -n guidemo

Importation de configurations

Vous devez fournir les fichiers de configuration de la passerelle et de l'interface web dans le répertoire /etc/sfiler-gateway. Vous pouvez modifier les fichiers sfiler.conf et gui.conf ou simplement exporter la configuration existante depuis la base de données, en utilisant le CLI de configuration.

sfiler-config-cli.sh -l <USAGER_BD> -p <MOT_DE_PASSE_BD> export-config -ccf /etc/sfiler-gateway/sfiler.conf -n gatewaydemo

sfiler-config-cli.sh -l <USAGER_BD> -p <MOT_DE_PASSE_BD> export-config -ccf /etc/sfiler-gateway/gui.conf -n guidemo

Note

Assurez-vous d'exécuter ces commandes sur une machine qui a accès à la base de données. Vous pouvez prendre l'exécutable du CLI de configuration qui est installé avec le serveur S-Filer Portal ou installer et configurer le paquet sfiler-config-cli. Si la passerelle est installée sur une machine différente que celle où sont exécutées ces commandes, il faudra déplacer les fichiers produits dans le répertoire /etc/sfiler-gateway sur la passerelle.

Note

Assurez-vous de remplir correctement les fichiers *.conf si vous le faites manuellement. La passerelle S-Filer Portal ne pourra pas se connecter au serveur si l'information fournie est incorrecte.

Utiliser le service sfiler-gateway.

Tout comme le serveur, un service appelé sfiler-gateway est installé avec le paquet de la passerelle.

Au début, il ne sera pas activé ni démarré. Après avoir configuré la passerelle et l'interface web, activez le service pour vous assurer qu'il continuera à fonctionner lorsque vous redémarrerez votre machine. Utilisez l'option --now pour démarrer le service immédiatement.

sudo systemctl enable sfiler-gateway --now

Mise à jour d'un environnement S-Filer Portal existant

Récupérez les sources des versions les plus récentes des paquets :

sudo apt update

Mettez à jour vos paquets vers leur version la plus récente

sudo apt upgrade

Note

Cette commande mettra à jour tous les paquets qui peuvent être mis à jour (pour voir la liste de ces paquets, lancez sudo apt list --upgradable). Si le dépôt Okiok contient une version plus récente de S-Filer que celle que vous avez, elle sera mise à jour.

Si vous souhaitez ne pas mettre à jour un paquet S-Filer pendant un certain temps, vous pouvez suspendre sa mise à jour pendant un moment en utilisant APT.

sudo apt-mark hold sfiler-server

Marquez-le comme prêt à être mis à jour en utilisant unhold.

sudo apt-mark unhold sfiler-server

Désinstallation d'un environnement S-Filer Portal

Pour supprimer un paquet APT de S-Filer Portal, exécutez la commande suivante

sudo apt remove sfiler-<cli|config-cli|admin-cli|server|gateway>

APT supprimera automatiquement les exécutables et les dépendances utilisés pour faire fonctionner S-Filer, et supprimera les services dans le cas des composants Serveur et Passerelle.

Veuillez noter que par défaut, les fichiers de configuration ne seront pas supprimés par cette commande. Si vous souhaitez supprimer tout ce qui est lié à l'un des paquets de S-Filer Portal, exécutez la commande suivante.

sudo apt purge sfiler-<cli|config-cli|admin-cli|server|gateway>

Important

Veuillez faire preuve de prudence si vous exécutez cette commande, car elle peut entraîner la suppression permanente de vos fichiers de configuration.

Suppression des dépendances inutilisées

Les paquets de S-Filer Portal dépendent d'autres paquets APT. Ceux-ci ne sont pas automatiquement supprimés lors de la suppression d'un paquet S-Filer. Si ces dépendances ne sont pas utilisées par un autre paquet installé et n'ont pas été installées manuellement par l'utilisateur, elles peuvent être supprimées en utilisant la commande suivante

sudo apt autoremove