Skip to content

fr_Configuring VIVO

michel-heon edited this page Mar 11, 2026 · 5 revisions

Configuration de VIVO

🇬🇧 This page is also available in English: Configuring-VIVO

La configuration de VIVO est écrite dans /etc/vivo/install.conf et appliquée à runtime.properties lors du premier démarrage. Pour les déploiements Marketplace, fournissez ces valeurs via le champ Avancé → Données personnalisées (voir fr_Deploying-from-Marketplace). Pour les déploiements ARM directs, le modèle ARM écrit le fichier automatiquement.


Fichier de configuration principal

/etc/vivo/install.conf

Contenu :

VIVO_NAMESPACE=http://vivo.myuniversity.edu/individual/
VIVO_ADMIN_EMAIL=vivo_root@myuniversity.edu
VIVO_LANGUAGES=en_US
VIVO_LANGUAGE_FILTER=false
TOMCAT_HEAP_MIN=2g
TOMCAT_HEAP_MAX=6g
DATA_DISK_SIZE_GB=128
ADMIN_USERNAME=azureuser
# VIVO_FQDN=vivo.myuniversity.edu   # optionnel : active le certificat TLS Let's Encrypt automatique

Emplacement de runtime.properties

Le fichier de configuration principal de VIVO se trouve dans le répertoire home de VIVO :

/data/vivo/home/config/runtime.properties

Il s'agit du chemin vivo_home_dir/config/runtime.properties référencé dans la documentation officielle VIVO.


Modifier le namespace VIVO

Le namespace est un identifiant permanent pour les entités RDF de votre institution. Il doit être défini correctement avant d'ajouter des données.

Pour le mettre à jour :

sudo sed -i 's|^Vitro.defaultNamespace.*|Vitro.defaultNamespace = http://vivo.myuniversity.edu/individual/|' \
  /data/vivo/home/config/runtime.properties
sudo systemctl restart tomcat

Modifier le mot de passe administrateur

Le mot de passe administrateur initial est rootPassword (codé en dur dans Vitro). VIVO exige un changement de mot de passe lors du premier login.

  1. Connectez-vous à VIVO à l'adresse https://<public-ip>/ avec l'adresse courriel de VIVO_ADMIN_EMAIL et le mot de passe rootPassword
  2. Cliquez sur votre nom (en haut à droite) → Edit profile
  3. Mettez à jour le champ mot de passe

Ou réinitialisez-le via l'interface d'administration VIVO à https://<public-ip>/admin/sparql.


Certificat TLS (Let's Encrypt)

Si vous définissez VIVO_FQDN dans le bloc Données personnalisées (ou /etc/vivo/install.conf), le script de premier démarrage demande automatiquement un certificat Let's Encrypt via certbot --nginx.

# Optionnel — à ajouter dans votre bloc Données personnalisées
VIVO_FQDN=vivo.monuniversite.edu

Prérequis :

  • Le FQDN doit résoudre vers l'IP publique de la VM avant le premier démarrage (défi ACME HTTP-01).
  • Le port 80 doit être accessible depuis Internet (le modèle ARM ajoute cette règle NSG automatiquement).
  • Si omis ou si certbot échoue, le certificat auto-signé intégré à l'image est conservé.

Le renouvellement est géré automatiquement via certbot.timer (systemd) ou /etc/cron.d/certbot.


Internationalisation (i18n)

VIVO supporte deux modes de langue, contrôlés par VIVO_LANGUAGES et VIVO_LANGUAGE_FILTER dans /etc/vivo/install.conf.

Paramètres de configuration

Variable Défaut Description
VIVO_LANGUAGES en_US Liste de codes de locale séparés par des virgules (ex. : en_US,fr_CA)
VIVO_LANGUAGE_FILTER false Filtrer les données RDF selon la langue active (true / false)

Mode 1 — Locale unique (une valeur dans VIVO_LANGUAGES)

L'interface est verrouillée sur la locale spécifiée — aucun sélecteur de langue n'est affiché.

# /data/vivo/home/config/runtime.properties (défini automatiquement au premier démarrage)
languages.forceLocale = en_US
RDFService.languageFilter = false

Utilisez ce mode lorsque votre instance sert un public unilingue.

Mode 2 — Multi-locale (deux valeurs ou plus dans VIVO_LANGUAGES)

Un sélecteur de langue apparaît dans l'interface VIVO. La première locale de la liste est celle par défaut.

# /data/vivo/home/config/runtime.properties (défini automatiquement au premier démarrage)
languages.selectableLocales = en_US, fr_CA
RDFService.languageFilter = true

Utilisez ce mode lorsque vos données RDF contiennent des valeurs rdfs:label dans plusieurs langues et que vous souhaitez permettre aux utilisateurs de basculer entre elles.

Filtre de langue RDF (RDFService.languageFilter)

Lorsqu'il est activé (true), VIVO filtre les triplets RDF pour n'afficher que les valeurs correspondant à la langue active de l'utilisateur. Si aucune correspondance exacte n'est trouvée, VIVO utilise la balise de langue la plus proche.

Définissez-le à false si vos données ne sont pas systématiquement étiquetées avec des littéraux de langue — les chaînes non étiquetées seront toujours affichées quelle que soit la locale.

Note : Les codes de locale utilisent un tiret bas dans runtime.properties (fr_CA) mais un tiret dans les fichiers de données RDF (@fr-CA). Il s'agit du comportement standard de l'i18n Java.

Locales supportées

Cette image Marketplace est livrée avec des packs de langue pour :

Code de locale Langue
en_US Anglais (États-Unis)
en_CA Anglais (Canada)
fr_CA Français (Canada)
de_DE Allemand
es Espagnol
pt_BR Portugais (Brésil)
ru_RU Russe
sr_Latn_RS Serbe (latin, Serbie)

Source : vivo-project/VIVO-languages et vivo-project/Vitro i18n.

Pour d'autres locales, consultez la page Créer de nouveaux fichiers de langue dans la documentation officielle VIVO.

Modifier les paramètres de langue après le déploiement

Modifiez directement runtime.properties sur la VM :

Basculer vers une locale unique :

sudo sed -i \
  -e 's|^languages\.selectableLocales|#languages.selectableLocales|' \
  -e 's|^#\?languages\.forceLocale.*|languages.forceLocale = en_US|' \
  -e 's|^RDFService\.languageFilter.*|RDFService.languageFilter = false|' \
  /data/vivo/home/config/runtime.properties
sudo systemctl restart tomcat

Basculer vers le mode multi-locale :

sudo sed -i \
  -e 's|^languages\.forceLocale|#languages.forceLocale|' \
  -e 's|^#\?languages\.selectableLocales.*|languages.selectableLocales = en_US, fr_CA|' \
  -e 's|^RDFService\.languageFilter.*|RDFService.languageFilter = true|' \
  /data/vivo/home/config/runtime.properties
sudo systemctl restart tomcat

Vérifier les paramètres i18n actuels :

grep -E "languageFilter|forceLocale|selectableLocales" \
  /data/vivo/home/config/runtime.properties

Références


Page originale (English) : Configuring-VIVO

Clone this wiki locally