Migrer Talend Dictionary Service vers une version 8.0.1 R2025-02 ou supérieure

À partir de la version 8.0.1 R2024-05, l'instance embarquée de MongoDB n'est plus fournie. La première section décrit la migration depuis les installations avec MongoDB embarqué (8.0.1 R2023-10 ou antérieures) vers une nouvelle installation avec une instance externe de MongoDB. La section suivante s'applique aux installations qui utilisent déjà une instance externe de MongoDB.

Migrer depuis une version 8.0.1 R2023-10 ou antérieure (avec MongoDB embarqué) vers une version 8.0.1 R2025-02 ou supérieure

Avant de commencer

Vous avez téléchargé Talend Dictionary Service 8.0.1 R2025-02.

Procédure

Arrêtez votre instance de la version précédente de Talend Dictionary Service, mais laissez l'instance de MongoDB en cours d'exécution.
Copiez <Tomcat>/conf/data-quality.properties vers un emplacement sécurisé.

Effectuez une sauvegarde de la base de données de Talend Dictionary Service en exécutant la commande suivante :

mongodump -h <mongodb.host>:<mongodb.port> -d <mongodb.database> -u
<mongodb.user> -p <mongodb.password> -o <dump_output>

Pour plus d'informations, consultez la documentation de MongoDB (en anglais).

Les valeurs par défaut des propriétés de l'instance MongoDB embarquée sont les suivantes :

Propriété	Valeur
mongodb.host	localhost
mongodb.port	27017
mongodb.database	dqdict
mongodb.user	dqdict-user
mongodb.password	duser

Exemple

mongodump -h localhost:27017 -d dqdict -u dqdict-user -p duser -o dump\

Après avoir sauvegardé MongoDB, arrêtez l'instance.
Désinstallez la version précédente de Talend Dictionary Service.
Assurez-vous que l'instance embarquée de MongoDB a été désinstallée.
Téléchargez une instance de MongoDB depuis la page MongoDB Download (en anglais) et installez-la.
- Pour plus d'informations concernant l'installation de MongoDB, consultez la documentation de MongoDB (en anglais).
- Pour plus d'informations concernant les bases de données MongoDB supportées, consultez Bases de données compatibles.
- Si vous souhaitez sécuriser les connexions de MongoDB en utilisant le SSL, installez manuellement MongoDB Enterprise Server sur votre machine. Pour plus d'informations, consultez la page MongoDB Security (en anglais).
Ajoutez MongoDB à la variable d'environnement PATH.
Démarrez votre instance externe de MongoDB.
Pour plus d'informations, consultez la documentation de MongoDB (en anglais).
Depuis une invite de commande MongoDB, créez la base de données de Talend Dictionary Servicedans MongoDB à l'aide de la commande suivante :
```
use dqdict
```
Créez l'utilisateur ou l'utilisatrice suivant·e dans la base de données de Talend Dictionary Service dans MongoDB :
- Username (Identifiant) : dqdict-user
- Password (Mot de passe) : duser
Pour ce faire, utilisez la commande suivante :
```
db.createUser( { user: "dqdict-user", pwd: "duser", roles: [{ role: "readWrite", db: "dqdict"}]})
```

Restaurez la sauvegarde de MongoDB en exécutant la commande suivante :

mongorestore -h mongodb.host:mongodb.port \
-u mongodb.user \
-p mongodb.password \
-d mongodb.database \
backup_location

Installez Talend Dictionary Service en version 8.0.1 R2025-02.
Assurez-vous de configurer les paramètres comme dans l'instance précédente. Si vous avez personnalisé le fichier <Tomcat>/conf/data-quality.properties, copiez les valeurs de l'ancien fichier de configuration dans le nouveau.
Démarrez Talend Dictionary Service en version 8.0.1 R2025-02.

Résultats

Vous avez migré vos données vers Talend Dictionary Service 8.0.1 R2025-02.

Migrer depuis la version 8.0.1 R2024-05 vers une version 8.0.1 R2025-02 ou supérieure avec une instance MongoDB externe

Avant de commencer

Vous avez téléchargé Talend Dictionary Service 8.0.1 R2025-02.

Procédure

Arrêtez votre instance de la version précédente de Talend Dictionary Service.
Copiez <Tomcat>/conf/data-quality.properties vers un emplacement sécurisé.

Facultatif : Si nécessaire, effectuez une sauvegarde de la base de données de Talend Dictionary Service en exécutant la commande suivante.

mongodump -h <mongodb.host>:<mongodb.port> -d <mongodb.database> -u
<mongodb.user> -p <mongodb.password> -o <dump_output>

Les valeurs par défaut des propriétés de l'instance MongoDB embarquée sont les suivantes :

Propriété	Valeur
mongodb.host	localhost
mongodb.port	27017
mongodb.database	dqdict
mongodb.user	dqdict-user
mongodb.password	duser

Exemple

mongodump -h localhost:27017 -d dqdict -u dqdict-user -p duser -o dump\

Désinstallez la version précédente de Talend Dictionary Service.
Installez Talend Dictionary Service en version 8.0.1 R2025-02.
- Assurez-vous de configurer les paramètres comme dans l'instance précédente. Si vous avez personnalisé le fichier <Tomcat>/conf/data-quality.properties, copiez les valeurs de l'ancien fichier de configuration dans le nouveau.
- Assurez-vous que les paramètres sont bien configurés pour vous connecter à votre instance externe de MongoDB.
Démarrez Talend Dictionary Service en version 8.0.1 R2025-02.
Confirmez que les données sont accessibles depuis Talend Dictionary Service. Si nécessaire, vous pouvez restaurer la base de données de Talend Dictionary Service en exécutant la commande suivante :
```
mongorestore -h mongodb.host:mongodb.port \
-u mongodb.user \
-p mongodb.password \
-d mongodb.database \
backup_location
```

Résultats

Vous avez migré vos données vers Talend Dictionary Service 8.0.1 R2025-02.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici