Configuration de la base de données

Cette section décrit comment configurer la base de données.

Prérequis

La base de données doit être créée avant d'installer la solution. Vous aurez besoin des informations de la base de données (hôte, port ou URL) et des identifiants (compte de service) pour la configurer.

Important

La base de données doit être configurée pour utiliser l'encodage Unicode (UTF-8) par défaut pour toutes les tables. La solution prend en charge de nombreuses langues et cela garantit qu'elles sont correctement supportées.

Configuration

La solution utilise JDBC pour se connecter à la base de données, ce qui permet de prendre en charge plusieurs fournisseurs de bases de données. Cela standardise la configuration à quelques paramètres.

Ces paramètres sont définis dans le fichier [Dossier d'installation]/server/conf/sfiler.conf:

properties

cfg.server.local.config.url=[URL de la base de données]
cfg.server.local.config.user=[nom du compte de service]
cfg.server.local.config.password=[mot de passe du compte de service]
cfg.server.local.config.driver=[nom de la classe du pilote JDBC]

Dialecte Hibernate

Le paramètre cfg.server.local.config.hibernate.dialect est optionnel. Si vous ne le spécifiez pas, la solution utilisera le dialecte par défaut de Hibernate.

Les guides détaillés pour chaque fournisseur de base de données sont listés ci-dessous et indiqueront les valeurs à utiliser pour chaque paramètre.

Configuration système

Une note rapide sur la configuration système : La solution dispose d'une CLI et d'une console web (appelée Configurateur) pour configurer le système. Ces outils nécessitent des identifiants de base de données pour se connecter et effectuer des modifications dans la base de données. Ces identifiants peuvent être différents du compte de service utilisé par la solution.

Recommandation

OKIOK recommande que chaque administrateur utilise ses propres identifiants de base de données pour effectuer des modifications de configuration plutôt que le compte de service utilisé par la solution.

Gestion du schéma

La solution utilise Liquibase pour gérer automatiquement le schéma de la base de données. Liquibase suit tous les changements apportés au schéma et s'assure que la base de données est toujours dans l'état souhaité.

Initialisation de la base de données

L'outil utilisé pour initialiser la base de données est sfiler-config-cli, qui est automatiquement installé avec le serveur. Il existe un script appelé sfiler-config-cli (.bat pour Windows et .sh pour Linux) situé dans le dossier [répertoire d'installation]/server.

Note

Avant de lancer la commande permettant d'initialiser la base de données, assurez-vous d'avoir bien déposé dans le répertoire [répertoire d'installation]/server/ext/lib le pilote JDBC correspondant à votre base de données.

Vous devez exécuter la commande suivante :

shell

sfiler-config-cli.[bat/sh] -l db_user_name -p db_password update-db-schema

Les paramètres db_user_name et db_password représentent les informations d'identification qui seront utilisées pour se connecter à la base de données et effectuer les modifications. Cela nécessitera des accès de type alter, create, drop et autres. Assurez-vous donc que l'utilisateur de la base de données spécifié dans la commande a un rôle d'administrateur.

Si vous souhaitez que l'on vous demande le mot de passe au lieu de l'indiquer sur la ligne de commande, n'utilisez pas l'option -p, n'indiquez aucune option pour le mot de passe.

Pour plus de détails sur cette commande, veuillez consulter la documentation de la commande update-db-schema.